How ministryofjustice/opg-digideps works
Complete the deputy report is a Symfony service with deputy-facing reporting and a VPN-restricted case-manager review area. The principal workflow is deputies using the frontend to prepare and submit reports, with case managers reviewing submissions in the admin area. The repository also contains user registration, organisation management, deputyship ingestion, and reporting/statistics capabilities. The excerpts show frontend report operations calling the REST client and backend report handling; many other routes and integrations are documented only by the file tree, so their connections are not asserted here.
Main entry points: RestClient.php REST Client · ReportApi.php Report API Client · ReportController.php Report Controller · UserApi.php User API Client
Components 26
Deputy and Admin Frontend
- User and Registration UI
client/app/src/Controller/UserController.php - Report UI
client/app/src/Controller/Report/ReportController.php - Admin Review
client/app/src/Controller/Admin/Client/ReportController.php - Organisation UI
client/app/src/Controller/Org/OrganisationController.php - REST Client
client/app/src/Service/Client/RestClient.php - User API Client
client/app/src/Service/Client/Internal/UserApi.php - Report API Client
client/app/src/Service/Client/Internal/ReportApi.php - GOV Table
client/app/src/Components/GOV/Table/Table.php
API and Domain
- API Controllers
api/app/src/Controller - Report Controller
api/app/src/Controller/Report/ReportController.php - User Controller
api/app/src/Controller/UserController.php - Report Service
api/app/src/Service/ReportService.php - Deputyship Registration
api/app/src/v2/Registration
Domain Data
- Report Data
api/app/src/Entity/Report/Report.php - Checklist Data
api/app/src/Entity/Report/Checklist.php - Client Data
api/app/src/Entity/Client.php - User Data
api/app/src/Entity/User.php - Client Repository
api/app/src/Repository/ClientRepository.php - User Repository
api/app/src/Repository/UserRepository.php
Supporting Services
- Audit Events
api/app/src/Service/Audit/AuditEvents.php - Event Dispatcher
api/app/src/EventDispatcher/ObservableEventDispatcher.php - Token Storage
api/app/src/Service/Client/TokenStorage/RedisStorage.php - File Storage
api/app/src/Service/File/Storage/S3Storage.php - Registration Data
common/src/Registration/SelfRegisterData.php
Other components
- Deputies
- Case Managers
Connections 20
- Deputies → User and Registration UI: register
- Deputies → Report UI: prepare reports
- Case Managers → Admin Review: review submissions
- Report UI → Report API Client: submits via
client/app/src/Controller/Report/ReportController.php - Report API Client → REST Client: calls
client/app/src/Service/Client/Internal/ReportApi.php - User and Registration UI → REST Client: calls
client/app/src/Controller/UserController.php - User API Client → REST Client: calls
client/app/src/Service/Client/Internal/UserApi.php - REST Client → API Controllers: sends HTTP requests
- API Controllers → Report Controller: routes report requests
api/app/src/Controller/Report/ReportController.php - Report Controller → Report Data: handles report data
api/app/src/Controller/Report/ReportController.php - Report Controller → Report Service: uses
api/app/src/Controller/Report/ReportController.php - User Controller → User Repository: queries users
api/app/src/Controller/UserController.php - User Controller → Client Repository: queries clients
api/app/src/Controller/UserController.php - Report Data → Client Data: belongs to
api/app/src/Entity/Report/Report.php - User Data → Client Data: relates users
api/app/src/Entity/User.php - Admin Review → Report API Client: loads report data
client/app/src/Controller/Admin/Client/ReportController.php - Deputyship Registration → Registration Data: uses registration data
- Report API Client → Event Dispatcher: dispatches submission events
client/app/src/Service/Client/Internal/ReportApi.php - User API Client → Event Dispatcher: dispatches user events
client/app/src/Service/Client/Internal/UserApi.php - REST Client → Token Storage: reads auth tokens
client/app/src/Service/Client/RestClient.php