# blaqcodex/apdj-project-dut architecture

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

- Interactive diagram: https://gitdiagram.com/blaqcodex/apdj-project-dut
- Repository: https://github.com/blaqcodex/apdj-project-dut

## Overview

CampusPulse is a student, lecturer and administrator platform built around a cloud REST API and shared academic data. The main student journey runs from mobile registration or sign-in through API authentication and persistence, then into student-facing profile, timetable, attendance and notification features. Lecturer and admin workflows form separate branches into the same API. The README documents the broad three-application architecture; source excerpts confirm selected authentication, registration, recovery-email, lecturer assignment and attendance behavior. Other feature links are omitted where their implementations were not sampled.

Main entry points: [`CampusPulse.Infrastructure/Data/CampusPulseDbContext.cs`](https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.Infrastructure/Data/CampusPulseDbContext.cs) (Academic database), [`CampusPulse.API/Controllers/AuthController.cs`](https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.API/Controllers/AuthController.cs) (Authentication API), [`CampusPulse.Student`](https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Student) (Student app), [`CampusPulse.Infrastructure/Repositories`](https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Infrastructure/Repositories) (Repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student["Student portal"]
  node_student_app["Student app"]
  node_student_auth["Student authentication"]
  node_student_features["Student features"]
end

subgraph group_desktop["Admin and lecturer"]
  node_admin_console["Admin console<br/>[CampusPulse.Admin]"]
  node_lecturer_console["Lecturer console<br/>[CampusPulse.Admin]"]
end

subgraph group_api["Cloud API"]
  node_api_host["API host<br/>[Program.cs]"]
  node_auth_api["Authentication API<br/>[AuthController.cs]"]
  node_admin_api["Academic administration<br/>[Controllers]"]
  node_lecturer_api["Lecturer workflows<br/>[Controllers]"]
  node_student_api["Student services API<br/>[Controllers]"]
  node_recovery["Recovery verification"]
  node_email["Brevo email"]
  node_jwt["JWT tokens<br/>[JwtTokenService.cs]"]
end

subgraph group_application["Application services"]
  node_registration["Student registration"]
  node_authentication["Authentication service"]
end

subgraph group_data["Persistence"]
  node_repositories["Repositories<br/>[Repositories]"]
  node_database[("Academic database")]
  node_domain["Academic entities<br/>[Entities]"]
end

node_student_actor(("Student"))
node_admin_actor(("Administrator"))
node_lecturer_actor(("Lecturer"))
node_azure_sql[("Azure SQL")]

node_student_actor -->|"uses"| node_student_app
node_student_app -->|"signs in"| node_student_auth
node_student_auth -->|"HTTP requests"| node_auth_api
node_student_actor -->|"registers"| node_student_app
node_auth_api -->|"registers student"| node_registration
node_auth_api -->|"authenticates"| node_authentication
node_auth_api -->|"issues tokens"| node_jwt
node_registration -->|"uses repositories"| node_repositories
node_authentication -->|"looks up user"| node_repositories
node_api_host -->|"configures"| node_database
node_api_host -->|"registers services"| node_repositories
node_repositories -->|"queries and saves"| node_database
node_database -->|"maps entities"| node_domain
node_admin_actor -->|"administers"| node_admin_console
node_admin_console -.->|"admin workflows"| node_admin_api
node_admin_api -->|"queries and updates"| node_database
node_lecturer_actor -->|"manages classes"| node_lecturer_console
node_lecturer_console -.->|"lecturer workflows"| node_lecturer_api
node_lecturer_api -->|"manages attendance"| node_database
node_student_api -.->|"student data access"| node_database
node_student_app -.->|"opens"| node_student_features
node_recovery -->|"sends verification"| node_email
node_recovery -->|"stores verification"| node_database
node_api_host -->|"connects in deployment"| node_azure_sql

click node_student_app "https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Student"
click node_student_auth "https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.Student/Services/AuthenticationApiService.cs"
click node_student_features "https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Student"
click node_admin_console "https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Admin"
click node_lecturer_console "https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Admin"
click node_api_host "https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.API/Program.cs"
click node_auth_api "https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.API/Controllers/AuthController.cs"
click node_admin_api "https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.API/Controllers"
click node_lecturer_api "https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.API/Controllers"
click node_student_api "https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.API/Controllers"
click node_recovery "https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.API/Services/RecoveryEmailVerificationService.cs"
click node_email "https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.API/Services/BrevoEmailService.cs"
click node_registration "https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.Application/Services/RegistrationService.cs"
click node_authentication "https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.Application/Services/AuthenticationService.cs"
click node_jwt "https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.API/Services/JwtTokenService.cs"
click node_repositories "https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Infrastructure/Repositories"
click node_database "https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.Infrastructure/Data/CampusPulseDbContext.cs"
click node_domain "https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Domain/Entities"

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_student_app,node_student_auth,node_student_features toneBlue
class node_admin_console,node_lecturer_console,node_azure_sql toneAmber
class node_api_host,node_auth_api,node_admin_api,node_lecturer_api,node_student_api,node_recovery,node_email,node_jwt toneMint
class node_registration,node_authentication toneRose
class node_repositories,node_database,node_domain,node_student_actor,node_admin_actor,node_lecturer_actor toneIndigo
```

## Components

### Student portal

- [Student app](https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Student): `CampusPulse.Student`
- [Student authentication](https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.Student/Services/AuthenticationApiService.cs): `CampusPulse.Student/Services/AuthenticationApiService.cs`
- [Student features](https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Student): `CampusPulse.Student`

### Admin and lecturer

- [Admin console](https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Admin): `CampusPulse.Admin`
- [Lecturer console](https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Admin): `CampusPulse.Admin`

### Cloud API

- [API host](https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.API/Program.cs): `CampusPulse.API/Program.cs`
- [Authentication API](https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.API/Controllers/AuthController.cs): `CampusPulse.API/Controllers/AuthController.cs`
- [Academic administration](https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.API/Controllers): `CampusPulse.API/Controllers`
- [Lecturer workflows](https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.API/Controllers): `CampusPulse.API/Controllers`
- [Student services API](https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.API/Controllers): `CampusPulse.API/Controllers`
- [Recovery verification](https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.API/Services/RecoveryEmailVerificationService.cs): `CampusPulse.API/Services/RecoveryEmailVerificationService.cs`
- [Brevo email](https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.API/Services/BrevoEmailService.cs): `CampusPulse.API/Services/BrevoEmailService.cs`
- [JWT tokens](https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.API/Services/JwtTokenService.cs): `CampusPulse.API/Services/JwtTokenService.cs`

### Application services

- [Student registration](https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.Application/Services/RegistrationService.cs): `CampusPulse.Application/Services/RegistrationService.cs`
- [Authentication service](https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.Application/Services/AuthenticationService.cs): `CampusPulse.Application/Services/AuthenticationService.cs`

### Persistence

- [Repositories](https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Infrastructure/Repositories): `CampusPulse.Infrastructure/Repositories`
- [Academic database](https://github.com/blaqcodex/apdj-project-dut/blob/main/CampusPulse.Infrastructure/Data/CampusPulseDbContext.cs): `CampusPulse.Infrastructure/Data/CampusPulseDbContext.cs`
- [Academic entities](https://github.com/blaqcodex/apdj-project-dut/tree/main/CampusPulse.Domain/Entities): `CampusPulse.Domain/Entities`

### Other components

- **Student**
- **Administrator**
- **Lecturer**
- **Azure SQL**

## Connections

- Student → Student app: uses
- Student app → Student authentication: signs in (evidence: `CampusPulse.Student/Services/AuthenticationApiService.cs`)
- Student authentication → Authentication API: HTTP requests (evidence: `CampusPulse.Student/Services/AuthenticationApiService.cs`)
- Student → Student app: registers
- Authentication API → Student registration: registers student (evidence: `CampusPulse.API/Controllers/AuthController.cs`)
- Authentication API → Authentication service: authenticates (evidence: `CampusPulse.API/Controllers/AuthController.cs`)
- Authentication API → JWT tokens: issues tokens (evidence: `CampusPulse.API/Controllers/AuthController.cs`)
- Student registration → Repositories: uses repositories (evidence: `CampusPulse.Application/Services/RegistrationService.cs`)
- Authentication service → Repositories: looks up user (evidence: `CampusPulse.Application/Services/AuthenticationService.cs`)
- API host → Academic database: configures (evidence: `CampusPulse.API/Program.cs`)
- API host → Repositories: registers services (evidence: `CampusPulse.API/Program.cs`)
- Repositories → Academic database: queries and saves (evidence: `CampusPulse.Infrastructure/Repositories/StudentRepository.cs`)
- Academic database → Academic entities: maps entities (evidence: `CampusPulse.Infrastructure/Data/CampusPulseDbContext.cs`)
- Administrator → Admin console: administers
- Admin console → Academic administration: admin workflows
- Academic administration → Academic database: queries and updates (evidence: `CampusPulse.API/Controllers/AdminLecturerAssignmentsController.cs`)
- Lecturer → Lecturer console: manages classes
- Lecturer console → Lecturer workflows: lecturer workflows
- Lecturer workflows → Academic database: manages attendance (evidence: `CampusPulse.API/Controllers/LecturerAttendanceController.cs`)
- Student services API → Academic database: student data access (evidence: `CampusPulse.API/Controllers/AdminLecturerAssignmentsController.cs`)
- Student app → Student features: opens
- Recovery verification → Brevo email: sends verification (evidence: `CampusPulse.API/Services/RecoveryEmailVerificationService.cs`)
- Recovery verification → Academic database: stores verification (evidence: `CampusPulse.API/Services/RecoveryEmailVerificationService.cs`)
- API host → Azure SQL: connects in deployment
