# aliahsan9/examdynamicsapi architecture

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

- Interactive diagram: https://gitdiagram.com/aliahsan9/examdynamicsapi
- Repository: https://github.com/aliahsan9/examdynamicsapi

## Overview

ExamDynamicsAPI is an ASP.NET Core examination backend. Its principal documented workflow is that students authenticate, participate in exams, and receive recorded results and performance reports; teachers and administrators manage exams and question banks. The tree also shows profile, contact, answer, and AI/RAG capabilities. The graph reflects documented REST and authentication behavior plus sampled service/database calls; several controller-to-service associations rely on Program.cs dependency registrations, while unsampled service internals are not inferred.

Main entry points: [`Infrastructure/Data/ExamDynamicsDbContext.cs`](https://github.com/aliahsan9/examdynamicsapi/blob/main/Infrastructure/Data/ExamDynamicsDbContext.cs) (SQL Server data), [`Applications/Services/PerformanceService.cs`](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/PerformanceService.cs) (Performance tracking), [`WebAPI/Controllers/ChatController.cs`](https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/ChatController.cs) (Chat API), [`WebAPI/Controllers/AuthController.cs`](https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/AuthController.cs) (Authentication API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_auth_api["Authentication API<br/>[AuthController.cs]"]
  node_exam_api["Exam API<br/>[ExamController.cs]"]
  node_question_api["Question API"]
  node_option_api["Option API"]
  node_answer_api["Answer API"]
  node_performance_api["Performance API"]
  node_profile_api["Student profile API"]
  node_user_api["User API<br/>[UserController.cs]"]
  node_contact_api["Contact API"]
  node_chat_api["Chat API<br/>[ChatController.cs]"]
end

subgraph group_application["Application Services"]
  node_auth_service["Auth completion"]
  node_token_service["JWT tokens<br/>[TokenService.cs]"]
  node_exam_service["Exam management<br/>[ExamService.cs]"]
  node_question_service["Question management<br/>[QuestionService.cs]"]
  node_option_service["Option management<br/>[OptionService.cs]"]
  node_answer_service["Answer management<br/>[AnswerService.cs]"]
  node_performance_service["Performance tracking"]
  node_profile_service["Student profiles"]
  node_user_service["User management<br/>[UserService.cs]"]
  node_contact_service["Contact messages"]
  node_activity_service["Activity logging"]
end

subgraph group_domain["Domain and Persistence"]
  node_database[("SQL Server data")]
  node_exam_entity["Exam and attempt entities<br/>[ExamAttempt.cs]"]
  node_question_entity["Question bank entities<br/>[Question.cs]"]
  node_user_entity["User and activity entities<br/>[ApplicationUser.cs]"]
end

subgraph group_intelligence["AI Assistance"]
  node_openai_service["AI service<br/>[OpenAIService.cs]"]
  node_rag_service["Question context search<br/>[RagService.cs]"]
end

node_client(("Frontend client"))

node_client -->|"authenticates"| node_auth_api
node_client -->|"uses REST"| node_exam_api
node_client -->|"uses REST"| node_question_api
node_client -->|"views results"| node_performance_api
node_client -->|"uses REST"| node_profile_api
node_auth_api -->|"completes login"| node_auth_service
node_auth_service -->|"generates token"| node_token_service
node_exam_api -->|"dispatches to"| node_exam_service
node_question_api -->|"dispatches to"| node_question_service
node_option_api -->|"dispatches to"| node_option_service
node_answer_api -->|"dispatches to"| node_answer_service
node_performance_api -->|"dispatches to"| node_performance_service
node_profile_api -->|"dispatches to"| node_profile_service
node_user_api -->|"dispatches to"| node_user_service
node_contact_api -->|"dispatches to"| node_contact_service
node_chat_api -.->|"optional AI"| node_openai_service
node_chat_api -.->|"optional retrieval"| node_rag_service
node_performance_service -->|"reads and writes"| node_database
node_performance_service -->|"logs completion"| node_activity_service
node_rag_service -->|"searches questions"| node_database
node_database -->|"persists"| node_exam_entity
node_database -->|"persists"| node_question_entity
node_database -->|"persists"| node_user_entity

click node_auth_api "https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/AuthController.cs"
click node_exam_api "https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/ExamController.cs"
click node_question_api "https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/QuestionController.cs"
click node_option_api "https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/OptionController.cs"
click node_answer_api "https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/AnswerController.cs"
click node_performance_api "https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/PerformanceController.cs"
click node_profile_api "https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/StudentProfileController.cs"
click node_user_api "https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/UserController.cs"
click node_contact_api "https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/ContactController.cs"
click node_chat_api "https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/ChatController.cs"
click node_auth_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/Auth/ExternalAuthCompletionService.cs"
click node_token_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/Auth/TokenService.cs"
click node_exam_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/ExamService.cs"
click node_question_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/QuestionService.cs"
click node_option_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/OptionService.cs"
click node_answer_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/AnswerService.cs"
click node_performance_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/PerformanceService.cs"
click node_profile_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/StudentProfileService.cs"
click node_user_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/UserService.cs"
click node_contact_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/ContactMessageService.cs"
click node_activity_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/ActivityLogService.cs"
click node_openai_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/OpenAIService.cs"
click node_rag_service "https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/RagService.cs"
click node_database "https://github.com/aliahsan9/examdynamicsapi/blob/main/Infrastructure/Data/ExamDynamicsDbContext.cs"
click node_exam_entity "https://github.com/aliahsan9/examdynamicsapi/blob/main/Core/Models/ExamAttempt.cs"
click node_question_entity "https://github.com/aliahsan9/examdynamicsapi/blob/main/Core/Models/Question.cs"
click node_user_entity "https://github.com/aliahsan9/examdynamicsapi/blob/main/Core/Models/ApplicationUser.cs"

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_auth_api,node_exam_api,node_question_api,node_option_api,node_answer_api,node_performance_api,node_profile_api,node_user_api,node_contact_api,node_chat_api,node_client toneBlue
class node_auth_service,node_token_service,node_exam_service,node_question_service,node_option_service,node_answer_service,node_performance_service,node_profile_service,node_user_service,node_contact_service,node_activity_service toneAmber
class node_database,node_exam_entity,node_question_entity,node_user_entity toneMint
class node_openai_service,node_rag_service toneRose
```

## Components

### HTTP API

- [Authentication API](https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/AuthController.cs): `WebAPI/Controllers/AuthController.cs`
- [Exam API](https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/ExamController.cs): `WebAPI/Controllers/ExamController.cs`
- [Question API](https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/QuestionController.cs): `WebAPI/Controllers/QuestionController.cs`
- [Option API](https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/OptionController.cs): `WebAPI/Controllers/OptionController.cs`
- [Answer API](https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/AnswerController.cs): `WebAPI/Controllers/AnswerController.cs`
- [Performance API](https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/PerformanceController.cs): `WebAPI/Controllers/PerformanceController.cs`
- [Student profile API](https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/StudentProfileController.cs): `WebAPI/Controllers/StudentProfileController.cs`
- [User API](https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/UserController.cs): `WebAPI/Controllers/UserController.cs`
- [Contact API](https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/ContactController.cs): `WebAPI/Controllers/ContactController.cs`
- [Chat API](https://github.com/aliahsan9/examdynamicsapi/blob/main/WebAPI/Controllers/ChatController.cs): `WebAPI/Controllers/ChatController.cs`

### Application Services

- [Auth completion](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/Auth/ExternalAuthCompletionService.cs): `Applications/Services/Auth/ExternalAuthCompletionService.cs`
- [JWT tokens](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/Auth/TokenService.cs): `Applications/Services/Auth/TokenService.cs`
- [Exam management](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/ExamService.cs): `Applications/Services/ExamService.cs`
- [Question management](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/QuestionService.cs): `Applications/Services/QuestionService.cs`
- [Option management](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/OptionService.cs): `Applications/Services/OptionService.cs`
- [Answer management](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/AnswerService.cs): `Applications/Services/AnswerService.cs`
- [Performance tracking](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/PerformanceService.cs): `Applications/Services/PerformanceService.cs`
- [Student profiles](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/StudentProfileService.cs): `Applications/Services/StudentProfileService.cs`
- [User management](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/UserService.cs): `Applications/Services/UserService.cs`
- [Contact messages](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/ContactMessageService.cs): `Applications/Services/ContactMessageService.cs`
- [Activity logging](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/ActivityLogService.cs): `Applications/Services/ActivityLogService.cs`

### Domain and Persistence

- [SQL Server data](https://github.com/aliahsan9/examdynamicsapi/blob/main/Infrastructure/Data/ExamDynamicsDbContext.cs): `Infrastructure/Data/ExamDynamicsDbContext.cs`
- [Exam and attempt entities](https://github.com/aliahsan9/examdynamicsapi/blob/main/Core/Models/ExamAttempt.cs): `Core/Models/ExamAttempt.cs`
- [Question bank entities](https://github.com/aliahsan9/examdynamicsapi/blob/main/Core/Models/Question.cs): `Core/Models/Question.cs`
- [User and activity entities](https://github.com/aliahsan9/examdynamicsapi/blob/main/Core/Models/ApplicationUser.cs): `Core/Models/ApplicationUser.cs`

### AI Assistance

- [AI service](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/OpenAIService.cs): `Applications/Services/OpenAIService.cs`
- [Question context search](https://github.com/aliahsan9/examdynamicsapi/blob/main/Applications/Services/RagService.cs): `Applications/Services/RagService.cs`

### Other components

- **Frontend client**

## Connections

- Frontend client → Authentication API: authenticates
- Frontend client → Exam API: uses REST
- Frontend client → Question API: uses REST
- Frontend client → Performance API: views results
- Frontend client → Student profile API: uses REST
- Authentication API → Auth completion: completes login (evidence: `WebAPI/Controllers/AuthController.cs`)
- Auth completion → JWT tokens: generates token (evidence: `Applications/Services/Auth/ExternalAuthCompletionService.cs`)
- Exam API → Exam management: dispatches to
- Question API → Question management: dispatches to
- Option API → Option management: dispatches to
- Answer API → Answer management: dispatches to
- Performance API → Performance tracking: dispatches to (evidence: `WebAPI/Controllers/PerformanceController.cs`)
- Student profile API → Student profiles: dispatches to
- User API → User management: dispatches to (evidence: `WebAPI/Controllers/UserController.cs`)
- Contact API → Contact messages: dispatches to
- Chat API → AI service: optional AI
- Chat API → Question context search: optional retrieval
- Performance tracking → SQL Server data: reads and writes (evidence: `Applications/Services/PerformanceService.cs`)
- Performance tracking → Activity logging: logs completion (evidence: `Applications/Services/PerformanceService.cs`)
- Question context search → SQL Server data: searches questions (evidence: `Applications/Services/RagService.cs`)
- SQL Server data → Exam and attempt entities: persists (evidence: `Infrastructure/Data/ExamDynamicsDbContext.cs`)
- SQL Server data → Question bank entities: persists (evidence: `Infrastructure/Data/ExamDynamicsDbContext.cs`)
- SQL Server data → User and activity entities: persists (evidence: `Infrastructure/Data/ExamDynamicsDbContext.cs`)
