# akshatthakur22/safexam architecture

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

- Interactive diagram: https://gitdiagram.com/akshatthakur22/safexam
- Repository: https://github.com/akshatthakur22/safexam

## Overview

SafeExam is a full-stack online examination platform. Its documented user journey spans assessment creation, publishing and registration, timed student assessments, evaluation, and reporting; separate capabilities include AI-assisted authoring, coding assessments, and integrity monitoring. The README describes a React/Next.js frontend, FastAPI REST backend, PostgreSQL, and external service categories, but this public showcase contains no implementation excerpts. Accordingly, the graph captures documented capabilities and stack components, not unverified runtime calls or data flows.

Main entry points: [`README.md`](https://github.com/akshatthakur22/safexam/blob/main/README.md) (SafeExam Platform)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_assessment["Assessment Workflow"]
  node_safeexam["SafeExam Platform<br/>[README.md]"]
  node_creation["Exam Creation<br/>[README.md]"]
  node_publishing["Publishing<br/>[README.md]"]
  node_registration["Student Registration<br/>[README.md]"]
  node_timed_exam["Timed Assessment<br/>[README.md]"]
  node_evaluation["Evaluation<br/>[README.md]"]
  node_results["Results Management<br/>[README.md]"]
end

subgraph group_capabilities["Assessment Capabilities"]
  node_ai_authoring["AI Question Generation<br/>[README.md]"]
  node_question_bank[("Question Bank<br/>[README.md]")]
  node_coding["Coding Assessments<br/>[README.md]"]
  node_integrity["Integrity Monitoring<br/>[README.md]"]
  node_analytics["Analytics &amp; Reporting<br/>[README.md]"]
end

subgraph group_platform["Platform Layers"]
  node_frontend["Web Frontend<br/>[README.md]"]
  node_backend["REST Backend<br/>[README.md]"]
  node_database[("PostgreSQL<br/>[README.md]")]
  node_ai_services["AI Services"]
  node_execution_engine["Code Execution Engine"]
  node_auth_services["Authentication Services"]
  node_email_services["Email Services"]
end

node_educator(("Educator"))
node_student(("Student"))
node_institution(("Institution"))

node_educator -->|"creates exams"| node_creation
node_institution -->|"uses assessments"| node_safeexam
node_creation -->|"publishes exams"| node_publishing
node_student -->|"registers for exams"| node_registration
node_student -->|"takes assessment"| node_timed_exam
node_safeexam -->|"automates evaluation"| node_evaluation
node_safeexam -->|"manages results"| node_results
node_safeexam -->|"supports generation"| node_ai_authoring
node_safeexam -->|"supports management"| node_question_bank
node_safeexam -->|"offers assessments"| node_coding
node_safeexam -->|"supports monitoring"| node_integrity
node_safeexam -->|"provides reporting"| node_analytics
node_safeexam -->|"includes frontend"| node_frontend
node_safeexam -->|"includes backend"| node_backend
node_safeexam -->|"uses PostgreSQL"| node_database
node_safeexam -.->|"lists integration"| node_ai_services
node_safeexam -.->|"lists integration"| node_execution_engine
node_safeexam -.->|"lists integration"| node_auth_services
node_safeexam -.->|"lists integration"| node_email_services

click node_safeexam "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_creation "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_publishing "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_registration "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_timed_exam "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_evaluation "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_results "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_ai_authoring "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_question_bank "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_coding "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_integrity "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_analytics "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_frontend "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_backend "https://github.com/akshatthakur22/safexam/blob/main/README.md"
click node_database "https://github.com/akshatthakur22/safexam/blob/main/README.md"

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_safeexam,node_creation,node_publishing,node_registration,node_timed_exam,node_evaluation,node_results toneBlue
class node_ai_authoring,node_question_bank,node_coding,node_integrity,node_analytics toneAmber
class node_frontend,node_backend,node_database,node_ai_services,node_execution_engine,node_auth_services,node_email_services toneMint
class node_educator,node_student,node_institution toneIndigo
```

## Components

### Assessment Workflow

- [SafeExam Platform](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- [Exam Creation](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- [Publishing](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- [Student Registration](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- [Timed Assessment](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- [Evaluation](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- [Results Management](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`

### Assessment Capabilities

- [AI Question Generation](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- [Question Bank](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- [Coding Assessments](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- [Integrity Monitoring](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- [Analytics & Reporting](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`

### Platform Layers

- [Web Frontend](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- [REST Backend](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- [PostgreSQL](https://github.com/akshatthakur22/safexam/blob/main/README.md): `README.md`
- **AI Services**
- **Code Execution Engine**
- **Authentication Services**
- **Email Services**

### Other components

- **Educator**
- **Student**
- **Institution**

## Connections

- Educator → Exam Creation: creates exams (evidence: `README.md`)
- Institution → SafeExam Platform: uses assessments (evidence: `README.md`)
- Exam Creation → Publishing: publishes exams (evidence: `README.md`)
- Student → Student Registration: registers for exams (evidence: `README.md`)
- Student → Timed Assessment: takes assessment (evidence: `README.md`)
- SafeExam Platform → Evaluation: automates evaluation (evidence: `README.md`)
- SafeExam Platform → Results Management: manages results (evidence: `README.md`)
- SafeExam Platform → AI Question Generation: supports generation (evidence: `README.md`)
- SafeExam Platform → Question Bank: supports management (evidence: `README.md`)
- SafeExam Platform → Coding Assessments: offers assessments (evidence: `README.md`)
- SafeExam Platform → Integrity Monitoring: supports monitoring (evidence: `README.md`)
- SafeExam Platform → Analytics & Reporting: provides reporting (evidence: `README.md`)
- SafeExam Platform → Web Frontend: includes frontend (evidence: `README.md`)
- SafeExam Platform → REST Backend: includes backend (evidence: `README.md`)
- SafeExam Platform → PostgreSQL: uses PostgreSQL (evidence: `README.md`)
- SafeExam Platform → AI Services: lists integration (evidence: `README.md`)
- SafeExam Platform → Code Execution Engine: lists integration (evidence: `README.md`)
- SafeExam Platform → Authentication Services: lists integration (evidence: `README.md`)
- SafeExam Platform → Email Services: lists integration (evidence: `README.md`)