How dilasathapa/provisional-certificate-portal works
The Provisional Certificate Portal supports account access, authenticated application creation and review, required PDF uploads, submission, and acknowledgment downloads. The frontend guides applicants through these stages and presents application status; the Express API enforces authentication and ownership while application services coordinate persistence and PDF storage. The README documents MongoDB and S3 roles. Some subsystem links rely on that documentation or SOURCE INDEX references because their implementation files were not excerpted; uncertain connections are omitted.
Main entry points: NewApplication.jsx Application wizard · application.service.js Application service · AppRoutes.jsx Page routing · application.routes.js Application routes
Components 33
Applicant web app
- React portal
frontend/src/App.jsx - Sign in and signup
frontend/src/pages/Login.jsx - Registration page
frontend/src/pages/Signup.jsx - Session state
frontend/src/context/AuthContext.jsx - Page routing
frontend/src/routes/AppRoutes.jsx - Application dashboard
frontend/src/pages/Dashboard.jsx - Application wizard
frontend/src/pages/applications/NewApplication.jsx - Personal details
frontend/src/pages/applications/steps/PersonalDetailsStep.jsx - Document upload step
frontend/src/pages/applications/steps/DocumentsStep.jsx - Review and submit
frontend/src/pages/applications/steps/ReviewStep.jsx - Application API client
frontend/src/api/application.api.js - Document API client
frontend/src/api/document.api.js - HTTP client
frontend/src/api/axios.js
API and access
- Express API
backend/src/app.js - Authentication routes
backend/src/routes/auth.routes.js - Authentication handlers
backend/src/controllers/auth.controller.js - Authentication service
backend/src/services/auth.service.js - JWT access check
backend/src/middleware/auth.middleware.js - Application routes
backend/src/routes/application.routes.js - Application handlers
backend/src/controllers/application.controller.js - Document routes
backend/src/routes/document.routes.js - Document handlers
backend/src/controllers/document.controller.js
Application workflow
- Application service
backend/src/services/application.service.js - Acknowledgment generation
backend/src/services/application-pdf.service.js - Reference generation
backend/src/utils/reference.util.js - Document service
backend/src/services/document.service.js
Persistence and files
- Application records
backend/src/models/Application.js - Document records
backend/src/models/Document.js - User records
backend/src/models/User.js - MongoDB
- S3 storage service
backend/src/services/storage.service.js - Amazon S3
Other components
- Applicant
Connections 44
- Applicant → React portal: uses
README.md - React portal → Session state: provides session
frontend/src/App.jsx - React portal → Page routing: renders routes
frontend/src/App.jsx - Page routing → Sign in and signup: routes to
frontend/src/routes/AppRoutes.jsx - Page routing → Registration page: routes to
frontend/src/routes/AppRoutes.jsx - Page routing → Application dashboard: routes to
frontend/src/routes/AppRoutes.jsx - Page routing → Application wizard: routes to
frontend/src/routes/AppRoutes.jsx - Sign in and signup → Session state: uses
frontend/src/pages/Login.jsx - Registration page → Session state: uses
frontend/src/pages/Signup.jsx - Session state → HTTP client: calls
frontend/src/context/AuthContext.jsx - Application wizard → Personal details: renders
frontend/src/pages/applications/NewApplication.jsx - Application wizard → Document upload step: renders
frontend/src/pages/applications/NewApplication.jsx - Application wizard → Review and submit: renders
frontend/src/pages/applications/NewApplication.jsx - Application wizard → Application API client: calls
frontend/src/pages/applications/NewApplication.jsx - Application wizard → Document API client: calls
frontend/src/pages/applications/NewApplication.jsx - Application API client → HTTP client: uses
frontend/src/api/application.api.js - Document API client → HTTP client: uses
frontend/src/api/document.api.js - Application API client → Application routes: sends REST requests
README.md - Document API client → Document routes: sends REST requests
README.md - Application dashboard → Application routes: retrieves applications
README.md - Express API → Authentication routes: mounts
backend/src/app.js - Express API → Application routes: mounts
backend/src/app.js - Express API → Document routes: mounts
backend/src/app.js - Authentication routes → Authentication handlers: dispatches
backend/src/routes/auth.routes.js - Application routes → JWT access check: authenticates
backend/src/routes/application.routes.js - Application routes → Application handlers: dispatches
backend/src/routes/application.routes.js - Document routes → JWT access check: authenticates
backend/src/routes/document.routes.js - Document routes → Document handlers: dispatches
backend/src/routes/document.routes.js - Authentication handlers → Authentication service: calls
backend/src/controllers/auth.controller.js - JWT access check → User records: looks up user
backend/src/middleware/auth.middleware.js - Application handlers → Application service: calls
backend/src/controllers/application.controller.js - Document handlers → Document service: calls
backend/src/controllers/document.controller.js - Application service → Application records: creates and queries
backend/src/services/application.service.js - Application service → Document records: checks required files
backend/src/services/application.service.js - Application service → Reference generation: generates reference
backend/src/services/application.service.js - Application service → Acknowledgment generation: generates acknowledgment
backend/src/services/application.service.js - Application service → S3 storage service: requests signed URL
backend/src/services/application.service.js - Document service → Document records: stores metadata
backend/src/services/document.service.js - Document service → S3 storage service: uploads files
backend/src/services/document.service.js - Acknowledgment generation → S3 storage service: stores PDF
- Application records → MongoDB: persists
README.md - Document records → MongoDB: persists
README.md - User records → MongoDB: persists
README.md - S3 storage service → Amazon S3: reads and writes
backend/src/services/storage.service.js