# pulengtshaba/training-management-solution architecture

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

- Interactive diagram: https://gitdiagram.com/pulengtshaba/training-management-solution
- Repository: https://github.com/pulengtshaba/training-management-solution

## Overview

This is a monolithic ASP.NET Core API whose demonstrated workflows are employee management and account authentication. Employee requests pass through a controller, service, repository, EF Core context, and SQL Server; authentication checks credentials and issues a token. The README describes broader training, attendance, notification, and reporting capabilities, but the supplied tree and source index show no distinct implementation for them, so they are not expanded into runtime components. The employee and authentication paths are evidenced in excerpts; wiring is supported by the Program.cs source-index references.

Main entry points: [`TrainingManagement.Api/Program.cs`](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Program.cs) (API host), [`TrainingManagement.Api/Services/AuthService.cs`](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Services/AuthService.cs) (Auth service), [`TrainingManagement.Api/Data/ApplicationDbContext.cs`](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Data/ApplicationDbContext.cs) (EF Core context), [`TrainingManagement.Api/Controllers/EmployeeController.cs`](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Controllers/EmployeeController.cs) (Employee controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and composition"]
  node_host["API host<br/>[Program.cs]"]
  node_employee_controller["Employee controller"]
  node_auth_controller["Auth controller<br/>[AuthController.cs]"]
end

subgraph group_employees["Employee management"]
  node_employee_service["Employee service<br/>[EmployeeService.cs]"]
  node_employee_contracts["Employee DTOs<br/>[DTOs]"]
  node_employee_paging["Paged results<br/>[PagedResult.cs]"]
  node_employee_model["Employee model<br/>[Employee.cs]"]
end

subgraph group_identity["Authentication"]
  node_auth_service["Auth service<br/>[AuthService.cs]"]
  node_auth_contracts["Auth DTOs<br/>[DTOs]"]
  node_user_model["User model<br/>[User.cs]"]
  node_token_service["Token service<br/>[TokenService.cs]"]
end

subgraph group_persistence["Persistence"]
  node_employee_repository["Employee repository"]
  node_db_context["EF Core context"]
end

node_client(("API client"))
node_sql_server[("SQL Server")]

node_client -->|"sends requests"| node_host
node_host -.->|"routes requests"| node_employee_controller
node_host -.->|"routes requests"| node_auth_controller
node_employee_controller -->|"calls"| node_employee_service
node_employee_controller -->|"accepts and returns"| node_employee_contracts
node_employee_controller -->|"returns paged data"| node_employee_paging
node_employee_service -->|"queries and saves"| node_employee_repository
node_employee_service -->|"maps entities"| node_employee_model
node_employee_repository -->|"queries and changes"| node_db_context
node_db_context -->|"maps entity"| node_employee_model
node_db_context -->|"maps entity"| node_user_model
node_db_context -.->|"persists data"| node_sql_server
node_auth_controller -.->|"delegates auth"| node_auth_service
node_auth_controller -->|"accepts and returns"| node_auth_contracts
node_auth_service -->|"reads and saves users"| node_db_context
node_auth_service -->|"checks credentials"| node_user_model
node_auth_service -->|"creates token"| node_token_service
node_host -->|"registers services"| node_employee_service
node_host -->|"registers repository"| node_employee_repository
node_host -->|"registers service"| node_auth_service
node_host -->|"registers service"| node_token_service

click node_host "https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Program.cs"
click node_employee_controller "https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Controllers/EmployeeController.cs"
click node_auth_controller "https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Controllers/AuthController.cs"
click node_employee_service "https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Services/EmployeeService.cs"
click node_employee_contracts "https://github.com/pulengtshaba/training-management-solution/tree/main/TrainingManagement.Api/DTOs"
click node_employee_paging "https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Common/PagedResult.cs"
click node_employee_model "https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Models/Employee.cs"
click node_employee_repository "https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Repositories/EmployeeRepository.cs"
click node_db_context "https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Data/ApplicationDbContext.cs"
click node_auth_service "https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Services/AuthService.cs"
click node_auth_contracts "https://github.com/pulengtshaba/training-management-solution/tree/main/TrainingManagement.Api/DTOs"
click node_user_model "https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Models/User.cs"
click node_token_service "https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Services/TokenService.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_host,node_employee_controller,node_auth_controller,node_client toneBlue
class node_employee_service,node_employee_contracts,node_employee_paging,node_employee_model,node_sql_server toneAmber
class node_auth_service,node_auth_contracts,node_user_model,node_token_service toneMint
class node_employee_repository,node_db_context toneRose
```

## Components

### API and composition

- [API host](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Program.cs): `TrainingManagement.Api/Program.cs`
- [Employee controller](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Controllers/EmployeeController.cs): `TrainingManagement.Api/Controllers/EmployeeController.cs`
- [Auth controller](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Controllers/AuthController.cs): `TrainingManagement.Api/Controllers/AuthController.cs`

### Employee management

- [Employee service](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Services/EmployeeService.cs): `TrainingManagement.Api/Services/EmployeeService.cs`
- [Employee DTOs](https://github.com/pulengtshaba/training-management-solution/tree/main/TrainingManagement.Api/DTOs): `TrainingManagement.Api/DTOs`
- [Paged results](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Common/PagedResult.cs): `TrainingManagement.Api/Common/PagedResult.cs`
- [Employee model](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Models/Employee.cs): `TrainingManagement.Api/Models/Employee.cs`

### Authentication

- [Auth service](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Services/AuthService.cs): `TrainingManagement.Api/Services/AuthService.cs`
- [Auth DTOs](https://github.com/pulengtshaba/training-management-solution/tree/main/TrainingManagement.Api/DTOs): `TrainingManagement.Api/DTOs`
- [User model](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Models/User.cs): `TrainingManagement.Api/Models/User.cs`
- [Token service](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Services/TokenService.cs): `TrainingManagement.Api/Services/TokenService.cs`

### Persistence

- [Employee repository](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Repositories/EmployeeRepository.cs): `TrainingManagement.Api/Repositories/EmployeeRepository.cs`
- [EF Core context](https://github.com/pulengtshaba/training-management-solution/blob/main/TrainingManagement.Api/Data/ApplicationDbContext.cs): `TrainingManagement.Api/Data/ApplicationDbContext.cs`

### Other components

- **API client**
- **SQL Server**

## Connections

- API client → API host: sends requests (evidence: `README.md`)
- API host → Employee controller: routes requests
- API host → Auth controller: routes requests
- Employee controller → Employee service: calls (evidence: `TrainingManagement.Api/Controllers/EmployeeController.cs`)
- Employee controller → Employee DTOs: accepts and returns (evidence: `TrainingManagement.Api/Controllers/EmployeeController.cs`)
- Employee controller → Paged results: returns paged data (evidence: `TrainingManagement.Api/Controllers/EmployeeController.cs`)
- Employee service → Employee repository: queries and saves (evidence: `TrainingManagement.Api/Services/EmployeeService.cs`)
- Employee service → Employee model: maps entities (evidence: `TrainingManagement.Api/Services/EmployeeService.cs`)
- Employee repository → EF Core context: queries and changes (evidence: `TrainingManagement.Api/Repositories/EmployeeRepository.cs`)
- EF Core context → Employee model: maps entity (evidence: `TrainingManagement.Api/Data/ApplicationDbContext.cs`)
- EF Core context → User model: maps entity (evidence: `TrainingManagement.Api/Data/ApplicationDbContext.cs`)
- EF Core context → SQL Server: persists data
- Auth controller → Auth service: delegates auth
- Auth controller → Auth DTOs: accepts and returns (evidence: `TrainingManagement.Api/Controllers/AuthController.cs`)
- Auth service → EF Core context: reads and saves users (evidence: `TrainingManagement.Api/Services/AuthService.cs`)
- Auth service → User model: checks credentials (evidence: `TrainingManagement.Api/Services/AuthService.cs`)
- Auth service → Token service: creates token (evidence: `TrainingManagement.Api/Services/AuthService.cs`)
- API host → Employee service: registers services (evidence: `TrainingManagement.Api/Program.cs`)
- API host → Employee repository: registers repository (evidence: `TrainingManagement.Api/Program.cs`)
- API host → Auth service: registers service (evidence: `TrainingManagement.Api/Program.cs`)
- API host → Token service: registers service (evidence: `TrainingManagement.Api/Program.cs`)
