# harshith2507375/certifypro-final architecture

> Architecture diagram of the GitHub repository harshith2507375/certifypro-final, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harshith2507375/certifypro-final
- Repository: https://github.com/harshith2507375/certifypro-final

## Overview

CertifyPro is presented in the README as a Spring/React authentication-and-RBAC phase, while the repository tree also contains a broader certification and examination platform, including service-separated modules. The main user workflow represented by that broader tree runs from role-based access through programme enrolment and exam operations to marking, result publication, and certification; reporting and notifications are supporting capabilities. Edges are limited to the README and sampled source/index evidence; many business modules are present in the tree but were not inspected, so their internal call relationships are not asserted.

Main entry points: [`backend/src/main/java/com/certifypro/service/ResultService.java`](https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/service/ResultService.java) (Result computation), [`backend/src/main/java/com/certifypro/service/AuthService.java`](https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/service/AuthService.java) (Auth and tokens), [`frontend/src/App.jsx`](https://github.com/harshith2507375/certifypro-final/blob/main/frontend/src/App.jsx) (React application), [`frontend/src/pages/Login.jsx`](https://github.com/harshith2507375/certifypro-final/blob/main/frontend/src/pages/Login.jsx) (Login and registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and identity"]
  node_web["React application<br/>[App.jsx]"]
  node_login["Login and registration<br/>[Login.jsx]"]
  node_auth_api["Authentication API"]
  node_auth_service["Auth and tokens<br/>[AuthService.java]"]
  node_security["JWT and RBAC"]
  node_user_store[("User records")]
end

subgraph group_candidate["Candidate lifecycle"]
  node_candidate_ops["Candidates and enrolment"]
  node_programs["Programmes and grading"]
end

subgraph group_exam["Exam operations"]
  node_exam_windows["Exam scheduling"]
  node_centres["Centres and seating"]
  node_question_bank["Questions and papers"]
end

subgraph group_outcomes["Results and credentials"]
  node_marking["Mark entry"]
  node_results["Result computation<br/>[ResultService.java]"]
  node_certificates["Certificates and renewal"]
end

subgraph group_support["Platform services"]
  node_reports["Analytics reports<br/>[ReportService.java]"]
  node_notifications["Notifications"]
  node_audit["Audit logging"]
  node_gateway["API gateway"]
end

node_user(("Role-based actors"))

node_user -->|"signs in"| node_login
node_login -.->|"submits credentials"| node_auth_api
node_auth_api -.->|"handles auth"| node_auth_service
node_auth_service -->|"reads and saves"| node_user_store
node_auth_service -->|"creates tokens"| node_security
node_user -->|"uses platform"| node_web
node_web -.->|"routes API calls"| node_gateway
node_exam_windows -.->|"uses programme data"| node_programs
node_centres -.->|"allocates by window"| node_exam_windows
node_question_bank -.->|"supplies exam papers"| node_marking
node_marking -.->|"provides marks"| node_results
node_results -->|"issues on pass"| node_certificates
node_results -->|"notifies publication"| node_notifications
node_results -->|"records actions"| node_audit
node_user -.->|"enrols"| node_candidate_ops
node_user -.->|"requests reports"| node_reports

click node_web "https://github.com/harshith2507375/certifypro-final/blob/main/frontend/src/App.jsx"
click node_login "https://github.com/harshith2507375/certifypro-final/blob/main/frontend/src/pages/Login.jsx"
click node_auth_api "https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/controller/AuthController.java"
click node_auth_service "https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/service/AuthService.java"
click node_security "https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/config/SecurityConfig.java"
click node_user_store "https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/repository/UserRepository.java"
click node_candidate_ops "https://github.com/harshith2507375/certifypro-final/blob/main/microservices/candidate-service/src/main/java/com/certifypro/candidate/service/EnrolmentService.java"
click node_programs "https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/service/ProgramService.java"
click node_exam_windows "https://github.com/harshith2507375/certifypro-final/blob/main/microservices/exam-service/src/main/java/com/certifypro/exam/service/ExamWindowService.java"
click node_centres "https://github.com/harshith2507375/certifypro-final/blob/main/microservices/exam-service/src/main/java/com/certifypro/exam/service/SeatAllocationService.java"
click node_question_bank "https://github.com/harshith2507375/certifypro-final/blob/main/microservices/question-service/src/main/java/com/certifypro/question/service/QuestionPaperService.java"
click node_marking "https://github.com/harshith2507375/certifypro-final/blob/main/microservices/result-service/src/main/java/com/certifypro/result/service/MarksEntryService.java"
click node_results "https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/service/ResultService.java"
click node_certificates "https://github.com/harshith2507375/certifypro-final/blob/main/microservices/certificate-service/src/main/java/com/certifypro/certificate/service/CertificateService.java"
click node_reports "https://github.com/harshith2507375/certifypro-final/blob/main/microservices/analytics-service/src/main/java/com/certifypro/analytics/service/ReportService.java"
click node_notifications "https://github.com/harshith2507375/certifypro-final/blob/main/microservices/notification-service/src/main/java/com/certifypro/notification/service/NotificationService.java"
click node_audit "https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/service/AuditLogService.java"
click node_gateway "https://github.com/harshith2507375/certifypro-final/blob/main/microservices/api-gateway/src/main/java/com/certifypro/gateway/ApiGatewayApplication.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_login,node_auth_api,node_auth_service,node_security,node_user_store toneBlue
class node_candidate_ops,node_programs toneAmber
class node_exam_windows,node_centres,node_question_bank toneMint
class node_marking,node_results,node_certificates toneRose
class node_reports,node_notifications,node_audit,node_gateway,node_user toneIndigo
```

## Components

### Access and identity

- [React application](https://github.com/harshith2507375/certifypro-final/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Login and registration](https://github.com/harshith2507375/certifypro-final/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Authentication API](https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/controller/AuthController.java): `backend/src/main/java/com/certifypro/controller/AuthController.java`
- [Auth and tokens](https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/service/AuthService.java): `backend/src/main/java/com/certifypro/service/AuthService.java`
- [JWT and RBAC](https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/config/SecurityConfig.java): `backend/src/main/java/com/certifypro/config/SecurityConfig.java`
- [User records](https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/repository/UserRepository.java): `backend/src/main/java/com/certifypro/repository/UserRepository.java`

### Candidate lifecycle

- [Candidates and enrolment](https://github.com/harshith2507375/certifypro-final/blob/main/microservices/candidate-service/src/main/java/com/certifypro/candidate/service/EnrolmentService.java): `microservices/candidate-service/src/main/java/com/certifypro/candidate/service/EnrolmentService.java`
- [Programmes and grading](https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/service/ProgramService.java): `backend/src/main/java/com/certifypro/service/ProgramService.java`

### Exam operations

- [Exam scheduling](https://github.com/harshith2507375/certifypro-final/blob/main/microservices/exam-service/src/main/java/com/certifypro/exam/service/ExamWindowService.java): `microservices/exam-service/src/main/java/com/certifypro/exam/service/ExamWindowService.java`
- [Centres and seating](https://github.com/harshith2507375/certifypro-final/blob/main/microservices/exam-service/src/main/java/com/certifypro/exam/service/SeatAllocationService.java): `microservices/exam-service/src/main/java/com/certifypro/exam/service/SeatAllocationService.java`
- [Questions and papers](https://github.com/harshith2507375/certifypro-final/blob/main/microservices/question-service/src/main/java/com/certifypro/question/service/QuestionPaperService.java): `microservices/question-service/src/main/java/com/certifypro/question/service/QuestionPaperService.java`

### Results and credentials

- [Mark entry](https://github.com/harshith2507375/certifypro-final/blob/main/microservices/result-service/src/main/java/com/certifypro/result/service/MarksEntryService.java): `microservices/result-service/src/main/java/com/certifypro/result/service/MarksEntryService.java`
- [Result computation](https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/service/ResultService.java): `backend/src/main/java/com/certifypro/service/ResultService.java`
- [Certificates and renewal](https://github.com/harshith2507375/certifypro-final/blob/main/microservices/certificate-service/src/main/java/com/certifypro/certificate/service/CertificateService.java): `microservices/certificate-service/src/main/java/com/certifypro/certificate/service/CertificateService.java`

### Platform services

- [Analytics reports](https://github.com/harshith2507375/certifypro-final/blob/main/microservices/analytics-service/src/main/java/com/certifypro/analytics/service/ReportService.java): `microservices/analytics-service/src/main/java/com/certifypro/analytics/service/ReportService.java`
- [Notifications](https://github.com/harshith2507375/certifypro-final/blob/main/microservices/notification-service/src/main/java/com/certifypro/notification/service/NotificationService.java): `microservices/notification-service/src/main/java/com/certifypro/notification/service/NotificationService.java`
- [Audit logging](https://github.com/harshith2507375/certifypro-final/blob/main/backend/src/main/java/com/certifypro/service/AuditLogService.java): `backend/src/main/java/com/certifypro/service/AuditLogService.java`
- [API gateway](https://github.com/harshith2507375/certifypro-final/blob/main/microservices/api-gateway/src/main/java/com/certifypro/gateway/ApiGatewayApplication.java): `microservices/api-gateway/src/main/java/com/certifypro/gateway/ApiGatewayApplication.java`

### Other components

- **Role-based actors**

## Connections

- Role-based actors → Login and registration: signs in (evidence: `README.md`)
- Login and registration → Authentication API: submits credentials
- Authentication API → Auth and tokens: handles auth
- Auth and tokens → User records: reads and saves (evidence: `backend/src/main/java/com/certifypro/service/AuthService.java`)
- Auth and tokens → JWT and RBAC: creates tokens (evidence: `backend/src/main/java/com/certifypro/service/AuthService.java`)
- Role-based actors → React application: uses platform (evidence: `README.md`)
- React application → API gateway: routes API calls
- Exam scheduling → Programmes and grading: uses programme data
- Centres and seating → Exam scheduling: allocates by window
- Questions and papers → Mark entry: supplies exam papers
- Mark entry → Result computation: provides marks
- Result computation → Certificates and renewal: issues on pass (evidence: `microservices/certificate-service/src/main/java/com/certifypro/certificate/service/CertificateService.java`)
- Result computation → Notifications: notifies publication (evidence: `backend/src/main/java/com/certifypro/service/ResultService.java`)
- Result computation → Audit logging: records actions (evidence: `backend/src/main/java/com/certifypro/service/ResultService.java`)
- Role-based actors → Candidates and enrolment: enrols
- Role-based actors → Analytics reports: requests reports
