Teaching Vacancies

Teaching Vacancies is a free job-listing service from the Department for Education. Teachers can search and apply for jobs at schools or trusts in England, save jobs and set up job alerts.

This repository contains the source code and infrastructure definitions for the main Teaching Vacancies service, a Ruby on Rails application with PostgreSQL and Redis backing services.

Onboarding

Welcome to the team! 🐯

You should have been added to our Github team ahead of time, if not, remind your delivery manager or tech lead to do that and also complete the other onboarding steps!

Project documentation

Team

• Onboarding developers
• Onboarding other team members
• Continuous delivery
• Business Analyst activities

Development

Setup

• Developers quick start

Tooling

• Tests and linting
• Data: Seends and external
• Secrets detection
• Devcontainer

Agreed Practices

• Development practices agreed by our dev team

AI coding agents

• Guidance for AI coding agents

Operations

Infrastructure

• Hosting
• Infrastructure
• Aws roles and cli tools
• DNS Records
• Docker
• Terraform

Deployment

• Deployments
• Rollback
• Github Actions

Monitoring

• Service Outages monitoring and alerting
• Monitoring
• Alert Runbook
• Sentry

Maintenance

• Database backups
• BAU tasks
• Disaster Recovery
• Maintenance Mode
• Offline Site
• Application secrets
• User Support Requests

Service

• System overview

Users management

• Publishers - DSI Integration
• Support users - Supportal access and DSI fallback
• Jobseekers - GOV.UK One Login Integration

Integrations

• Integrations with other job posting services
• Publisher ATS API
• DWP Find a Job
• Find and Use an API (FaUAPI)

Technical approaches

• Searching by location
• Our Front-end
• Landing Pages
• Rails View components
• File uploads virus scan: Microsoft Defender for Cloud
• Bot mitigation
• Tracking vacancy views