# sps-trutnov-eps/projekt-4ep-teacher_control architecture

> Architecture diagram of the GitHub repository sps-trutnov-eps/projekt-4ep-teacher_control, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sps-trutnov-eps/projekt-4ep-teacher_control
- Repository: https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control

## Overview

Teacher Control is a web application for teacher-related school features. The visible frontend workflow initializes the app, provides authentication context, and routes signed-in users to feature pages; the API exposes controller-based features backed by registered services and a shared database context. The data model documents reviews, late arrivals, bingo, and semester titles/votes. The README gives development database/login details, but the sampled sources do not establish frontend-to-API calls or feature persistence flows, so those links are omitted.

Main entry points: [`src/TeacherControl.Api/Data/AppDbContext.cs`](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Data/AppDbContext.cs) (Database context), [`src/TeacherControl.Api/Program.cs`](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Program.cs) (API host), [`src/TeacherControl.web/src/App.tsx`](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/App.tsx) (App shell), [`src/TeacherControl.web/src/main.tsx`](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/main.tsx) (Web bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_web_entry["Web bootstrap<br/>[main.tsx]"]
  node_app_shell["App shell<br/>[App.tsx]"]
  node_routes["Route pages<br/>[index.tsx]"]
  node_vzor["Vzor feature<br/>[vzor]"]
  node_vzor_form["Vzor form<br/>[VzorForm.tsx]"]
  node_vzor_api["Vzor API module<br/>[api.ts]"]
end

subgraph group_identity["Identity"]
  node_auth_context["Auth interface<br/>[AuthContext.tsx]"]
  node_mock_auth["Mock auth provider"]
  node_auth_guard["Auth guard<br/>[RequireAuth.tsx]"]
end

subgraph group_api["API features"]
  node_api_host["API host<br/>[Program.cs]"]
  node_absence_controller["Absence controller"]
  node_absence_service["Absence service<br/>[AbstenceService.cs]"]
  node_bingo_controller["Bingo controller"]
  node_bingo_service["Bingo service"]
end

subgraph group_data["Domain and persistence"]
  node_db_context[("Database context<br/>[AppDbContext.cs]")]
  node_teacher_review["Teachers and reviews<br/>[Entities]"]
  node_absence_data["Late arrivals<br/>[Entities]"]
  node_bingo_data["Bingo boards and quotes<br/>[Entities]"]
  node_title_data["Titles and votes<br/>[Entities]"]
  node_user_data["User identity data<br/>[UserEntity.cs]"]
end

node_user(("School user"))
node_postgres[("PostgreSQL")]

node_user -->|"opens"| node_web_entry
node_web_entry -->|"renders"| node_app_shell
node_web_entry -->|"provides auth"| node_mock_auth
node_mock_auth -->|"implements"| node_auth_context
node_app_shell -->|"reads user"| node_auth_context
node_app_shell -->|"guards pages"| node_auth_guard
node_app_shell -->|"renders routes"| node_routes
node_routes -->|"routes to"| node_vzor
node_vzor -->|"renders"| node_vzor_form
node_vzor_form -->|"uses"| node_vzor_api
node_api_host -->|"configures"| node_db_context
node_api_host -->|"registers"| node_absence_service
node_api_host -->|"registers"| node_bingo_service
node_api_host -->|"configures connection"| node_postgres
node_absence_controller -->|"receives service"| node_absence_service
node_bingo_controller -->|"receives service"| node_bingo_service
node_db_context -->|"maps entities"| node_teacher_review
node_db_context -->|"maps entities"| node_absence_data
node_db_context -->|"maps entities"| node_bingo_data
node_db_context -->|"maps entities"| node_title_data
node_db_context -->|"maps entities"| node_user_data

click node_web_entry "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/main.tsx"
click node_app_shell "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/App.tsx"
click node_routes "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/routes/index.tsx"
click node_vzor "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/tree/staging/src/TeacherControl.web/src/features/vzor"
click node_vzor_form "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/features/vzor/components/VzorForm.tsx"
click node_vzor_api "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/features/vzor/api.ts"
click node_auth_context "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/shared/auth/AuthContext.tsx"
click node_mock_auth "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/shared/auth/MockAuthProvider.tsx"
click node_auth_guard "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/shared/auth/RequireAuth.tsx"
click node_api_host "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Program.cs"
click node_absence_controller "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Features/Abstence/Controllers/AbstenceController.cs"
click node_absence_service "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Features/Abstence/Services/AbstenceService.cs"
click node_bingo_controller "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Features/TeacherBingo/Controllers/TeacherBingoController.cs"
click node_bingo_service "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Features/TeacherBingo/Services/TeacherBingoService.cs"
click node_db_context "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Data/AppDbContext.cs"
click node_teacher_review "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/tree/staging/src/TeacherControl.Api/Entities"
click node_absence_data "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/tree/staging/src/TeacherControl.Api/Entities"
click node_bingo_data "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/tree/staging/src/TeacherControl.Api/Entities"
click node_title_data "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/tree/staging/src/TeacherControl.Api/Entities"
click node_user_data "https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Entities/UserEntity.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_web_entry,node_app_shell,node_routes,node_vzor,node_vzor_form,node_vzor_api,node_user toneBlue
class node_auth_context,node_mock_auth,node_auth_guard,node_postgres toneAmber
class node_api_host,node_absence_controller,node_absence_service,node_bingo_controller,node_bingo_service toneMint
class node_db_context,node_teacher_review,node_absence_data,node_bingo_data,node_title_data,node_user_data toneRose
```

## Components

### Web application

- [Web bootstrap](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/main.tsx): `src/TeacherControl.web/src/main.tsx`
- [App shell](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/App.tsx): `src/TeacherControl.web/src/App.tsx`
- [Route pages](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/routes/index.tsx): `src/TeacherControl.web/src/routes/index.tsx`
- [Vzor feature](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/tree/staging/src/TeacherControl.web/src/features/vzor): `src/TeacherControl.web/src/features/vzor`
- [Vzor form](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/features/vzor/components/VzorForm.tsx): `src/TeacherControl.web/src/features/vzor/components/VzorForm.tsx`
- [Vzor API module](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/features/vzor/api.ts): `src/TeacherControl.web/src/features/vzor/api.ts`

### Identity

- [Auth interface](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/shared/auth/AuthContext.tsx): `src/TeacherControl.web/src/shared/auth/AuthContext.tsx`
- [Mock auth provider](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/shared/auth/MockAuthProvider.tsx): `src/TeacherControl.web/src/shared/auth/MockAuthProvider.tsx`
- [Auth guard](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.web/src/shared/auth/RequireAuth.tsx): `src/TeacherControl.web/src/shared/auth/RequireAuth.tsx`

### API features

- [API host](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Program.cs): `src/TeacherControl.Api/Program.cs`
- [Absence controller](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Features/Abstence/Controllers/AbstenceController.cs): `src/TeacherControl.Api/Features/Abstence/Controllers/AbstenceController.cs`
- [Absence service](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Features/Abstence/Services/AbstenceService.cs): `src/TeacherControl.Api/Features/Abstence/Services/AbstenceService.cs`
- [Bingo controller](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Features/TeacherBingo/Controllers/TeacherBingoController.cs): `src/TeacherControl.Api/Features/TeacherBingo/Controllers/TeacherBingoController.cs`
- [Bingo service](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Features/TeacherBingo/Services/TeacherBingoService.cs): `src/TeacherControl.Api/Features/TeacherBingo/Services/TeacherBingoService.cs`

### Domain and persistence

- [Database context](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Data/AppDbContext.cs): `src/TeacherControl.Api/Data/AppDbContext.cs`
- [Teachers and reviews](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/tree/staging/src/TeacherControl.Api/Entities): `src/TeacherControl.Api/Entities`
- [Late arrivals](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/tree/staging/src/TeacherControl.Api/Entities): `src/TeacherControl.Api/Entities`
- [Bingo boards and quotes](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/tree/staging/src/TeacherControl.Api/Entities): `src/TeacherControl.Api/Entities`
- [Titles and votes](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/tree/staging/src/TeacherControl.Api/Entities): `src/TeacherControl.Api/Entities`
- [User identity data](https://github.com/sps-trutnov-eps/projekt-4ep-teacher_control/blob/staging/src/TeacherControl.Api/Entities/UserEntity.cs): `src/TeacherControl.Api/Entities/UserEntity.cs`

### Other components

- **School user**
- **PostgreSQL**

## Connections

- School user → Web bootstrap: opens (evidence: `src/TeacherControl.web/src/main.tsx`)
- Web bootstrap → App shell: renders (evidence: `src/TeacherControl.web/src/main.tsx`)
- Web bootstrap → Mock auth provider: provides auth (evidence: `src/TeacherControl.web/src/main.tsx`)
- Mock auth provider → Auth interface: implements (evidence: `src/TeacherControl.web/src/shared/auth/MockAuthProvider.tsx`)
- App shell → Auth interface: reads user (evidence: `src/TeacherControl.web/src/App.tsx`)
- App shell → Auth guard: guards pages (evidence: `src/TeacherControl.web/src/App.tsx`)
- App shell → Route pages: renders routes (evidence: `src/TeacherControl.web/src/App.tsx`)
- Route pages → Vzor feature: routes to (evidence: `src/TeacherControl.web/src/routes/index.tsx`)
- Vzor feature → Vzor form: renders (evidence: `src/TeacherControl.web/src/features/vzor/VzorPage.tsx`)
- Vzor form → Vzor API module: uses (evidence: `src/TeacherControl.web/src/features/vzor/components/VzorForm.tsx`)
- API host → Database context: configures (evidence: `src/TeacherControl.Api/Program.cs`)
- API host → Absence service: registers (evidence: `src/TeacherControl.Api/Program.cs`)
- API host → Bingo service: registers (evidence: `src/TeacherControl.Api/Program.cs`)
- API host → PostgreSQL: configures connection (evidence: `src/TeacherControl.Api/Program.cs`)
- Absence controller → Absence service: receives service (evidence: `src/TeacherControl.Api/Features/Abstence/Controllers/AbstenceController.cs`)
- Bingo controller → Bingo service: receives service (evidence: `src/TeacherControl.Api/Features/TeacherBingo/Controllers/TeacherBingoController.cs`)
- Database context → Teachers and reviews: maps entities (evidence: `src/TeacherControl.Api/Data/AppDbContext.cs`)
- Database context → Late arrivals: maps entities (evidence: `src/TeacherControl.Api/Data/AppDbContext.cs`)
- Database context → Bingo boards and quotes: maps entities (evidence: `src/TeacherControl.Api/Data/AppDbContext.cs`)
- Database context → Titles and votes: maps entities (evidence: `src/TeacherControl.Api/Data/AppDbContext.cs`)
- Database context → User identity data: maps entities (evidence: `src/TeacherControl.Api/Data/AppDbContext.cs`)
