How pranali-5/certificate-portal works
Civicert is a provisional-certificate application portal. Applicants authenticate, enter application details, upload required PDFs, review and submit, then download a generated acknowledgment; they can revisit applications and documents on the dashboard. The backend owns authenticated application workflows, persistence, upload verification, receipt generation, and notifications. The README documents the major integrations and flow; sampled source confirms several route and service calls, while unsampled implementation details are represented only where documented.
Main entry points: server.ts Express routes · ApplicationForm.tsx Application form · Dashboard.tsx Dashboard · page.tsx Session view
Components 20
Applicant portal
- Session view
frontend/src/app/page.tsx - Sign-in
frontend/src/components/AuthScreen.tsx - Dashboard
frontend/src/components/Dashboard.tsx - Application form
frontend/src/components/ApplicationForm.tsx - Document upload
frontend/src/components/DocumentInput.tsx - Download helpers
frontend/src/lib/api.ts - Brand display
frontend/src/components/Brand.tsx - Auth fields
frontend/src/components/Field.tsx - Form fields
frontend/src/components/FormInput.tsx - Review rows
frontend/src/components/ReviewLine.tsx - Frontend types
frontend/src/types.ts
Application API
- Express routes
backend/src/server.ts - Runtime config
backend/src/config.ts - Error handling
backend/src/errors.ts
Document services
- Receipt generation
backend/src/services/certificate.ts - Email notifications
backend/src/services/email.ts
Other components
- Applicant
- PostgreSQL
backend/prisma/schema.prisma - Private S3
- Amazon SES
Connections 26
- Applicant → Session view: uses
README.md - Session view → Express routes: checks session
frontend/src/app/page.tsx - Session view → Sign-in: shows unauthenticated
frontend/src/app/page.tsx - Session view → Dashboard: shows authenticated
frontend/src/app/page.tsx - Sign-in → Express routes: auth requests
frontend/src/components/AuthScreen.tsx - Sign-in → Auth fields: renders
frontend/src/components/AuthScreen.tsx - Dashboard → Express routes: loads applications
frontend/src/components/Dashboard.tsx - Dashboard → Application form: opens
frontend/src/components/Dashboard.tsx - Dashboard → Download helpers: downloads files
frontend/src/components/Dashboard.tsx - Dashboard → Brand display: renders
frontend/src/components/Dashboard.tsx - Application form → Express routes: creates and submits
frontend/src/components/ApplicationForm.tsx - Application form → Document upload: renders upload controls
frontend/src/components/ApplicationForm.tsx - Application form → Form fields: renders fields
frontend/src/components/ApplicationForm.tsx - Application form → Review rows: renders review
frontend/src/components/ApplicationForm.tsx - Application form → Download helpers: requests receipt
frontend/src/components/ApplicationForm.tsx - Document upload → Express routes: requests upload URL
README.md - Document upload → Private S3: uploads PDF
README.md - Download helpers → Express routes: requests download URL
frontend/src/lib/api.ts - Express routes → Runtime config: uses clients
backend/src/server.ts - Express routes → Error handling: uses handlers
backend/src/server.ts - Express routes → PostgreSQL: reads and writes
README.md - Express routes → Private S3: signs and verifies uploads
backend/src/server.ts - Express routes → Receipt generation: generates receipt
backend/src/server.ts - Express routes → Email notifications: sends notifications
backend/src/server.ts - Receipt generation → Private S3: stores PDF
backend/src/services/certificate.ts - Email notifications → Amazon SES: sends email
backend/src/services/email.ts