# shantcodes/talent-of-schools architecture

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

- Interactive diagram: https://gitdiagram.com/shantcodes/talent-of-schools
- Repository: https://github.com/shantcodes/talent-of-schools

## Overview

Krtakan is a school performance-competition platform: students register and join events with performance submissions; jurors score participants, while administrators manage events, users, roles, and schools. The React client routes users to these role-specific workflows and the API is the HTTP boundary. Application services implement use cases over domain repository contracts, with Infrastructure providing EF Core persistence and file storage. Several feature pages and services are represented from the tree and README; their internal links are omitted where excerpts do not show the calls.

Main entry points: [`src/Krtakan.Api/ClientApp/src/App.tsx`](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/ClientApp/src/App.tsx) (Route application), [`src/Krtakan.Application/Services/AuthService.cs`](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Application/Services/AuthService.cs) (Authentication use case), [`src/Krtakan.Application/Services/EventParticipantService.cs`](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Application/Services/EventParticipantService.cs) (Participant workflow), [`src/Krtakan.Domain/Interfaces/IUserRepository.cs`](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Domain/Interfaces/IUserRepository.cs) (User repository contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Route application<br/>[App.tsx]"]
  node_authui["Sign-in and signup<br/>[auth]"]
  node_landing["Landing and events<br/>[landing]"]
  node_studentui["Student events<br/>[EventsPage.tsx]"]
  node_juryui["Jury scoring<br/>[JuryPage.tsx]"]
  node_adminui["Admin management<br/>[admin]"]
  node_accountui["Account<br/>[AccountPage.tsx]"]
end

subgraph group_api["HTTP API"]
  node_authapi["Authentication API<br/>[AuthController.cs]"]
  node_eventsapi["Events API"]
  node_participantsapi["Participant API"]
  node_scoringapi["Scoring API"]
  node_usersapi["Users API<br/>[UsersController.cs]"]
end

subgraph group_application["Application use cases"]
  node_authservice["Authentication use case<br/>[AuthService.cs]"]
  node_participantservice["Participant workflow"]
  node_eventservices["Event and scoring use cases<br/>[Services]"]
  node_userservice["User administration<br/>[UserService.cs]"]
end

subgraph group_domain["Competition domain"]
  node_domainmodel["Competition entities<br/>[Entities]"]
  node_usercontract["User repository contract<br/>[IUserRepository.cs]"]
end

subgraph group_infrastructure["Infrastructure"]
  node_database[("SQLite data store<br/>[AppDbContext.cs]")]
  node_repositories["EF repositories<br/>[Repositories]"]
  node_jwt["JWT token service<br/>[JwtTokenService.cs]"]
  node_filestore["Local media storage"]
end

node_visitor(("Site user"))

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_studentui
node_app -->|"routes to"| node_juryui
node_app -->|"routes to"| node_adminui
node_app -->|"routes to"| node_accountui
node_visitor -->|"HTTP requests"| node_authapi
node_authapi -->|"delegates to"| node_authservice
node_authservice -->|"queries users"| node_usercontract
node_authservice -->|"creates tokens"| node_jwt
node_authservice -->|"persists tokens"| node_repositories
node_eventsapi -->|"delegates to"| node_eventservices
node_participantsapi -->|"delegates to"| node_participantservice
node_participantservice -->|"uses entities"| node_domainmodel
node_usersapi -->|"delegates to"| node_userservice
node_userservice -->|"queries users"| node_usercontract
node_repositories -->|"reads and writes"| node_database
node_usercontract -->|"specifies access"| node_domainmodel
node_visitor -->|"HTTP requests"| node_scoringapi
node_participantservice -.->|"stores submissions"| node_filestore

click node_app "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/ClientApp/src/App.tsx"
click node_authui "https://github.com/shantcodes/talent-of-schools/tree/main/src/Krtakan.Api/ClientApp/src/features/auth"
click node_landing "https://github.com/shantcodes/talent-of-schools/tree/main/src/Krtakan.Api/ClientApp/src/features/landing"
click node_studentui "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/ClientApp/src/pages/student/EventsPage.tsx"
click node_juryui "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/ClientApp/src/pages/jury/JuryPage.tsx"
click node_adminui "https://github.com/shantcodes/talent-of-schools/tree/main/src/Krtakan.Api/ClientApp/src/pages/admin"
click node_accountui "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/ClientApp/src/pages/account/AccountPage.tsx"
click node_authapi "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/Controllers/AuthController.cs"
click node_eventsapi "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/Controllers/EventsController.cs"
click node_participantsapi "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/Controllers/EventParticipantController.cs"
click node_scoringapi "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/Controllers/ScoringController.cs"
click node_usersapi "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/Controllers/UsersController.cs"
click node_authservice "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Application/Services/AuthService.cs"
click node_participantservice "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Application/Services/EventParticipantService.cs"
click node_eventservices "https://github.com/shantcodes/talent-of-schools/tree/main/src/Krtakan.Application/Services"
click node_userservice "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Application/Services/UserService.cs"
click node_domainmodel "https://github.com/shantcodes/talent-of-schools/tree/main/src/Krtakan.Domain/Entities"
click node_usercontract "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Domain/Interfaces/IUserRepository.cs"
click node_database "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Infrastructure/Persistence/AppDbContext.cs"
click node_repositories "https://github.com/shantcodes/talent-of-schools/tree/main/src/Krtakan.Infrastructure/Repositories"
click node_jwt "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Infrastructure/Security/JwtTokenService.cs"
click node_filestore "https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Infrastructure/Storage/LocalFileStorage.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_app,node_authui,node_landing,node_studentui,node_juryui,node_adminui,node_accountui,node_visitor toneBlue
class node_authapi,node_eventsapi,node_participantsapi,node_scoringapi,node_usersapi toneAmber
class node_authservice,node_participantservice,node_eventservices,node_userservice toneMint
class node_domainmodel,node_usercontract toneRose
class node_database,node_repositories,node_jwt,node_filestore toneIndigo
```

## Components

### React client

- [Route application](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/ClientApp/src/App.tsx): `src/Krtakan.Api/ClientApp/src/App.tsx`
- [Sign-in and signup](https://github.com/shantcodes/talent-of-schools/tree/main/src/Krtakan.Api/ClientApp/src/features/auth): `src/Krtakan.Api/ClientApp/src/features/auth`
- [Landing and events](https://github.com/shantcodes/talent-of-schools/tree/main/src/Krtakan.Api/ClientApp/src/features/landing): `src/Krtakan.Api/ClientApp/src/features/landing`
- [Student events](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/ClientApp/src/pages/student/EventsPage.tsx): `src/Krtakan.Api/ClientApp/src/pages/student/EventsPage.tsx`
- [Jury scoring](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/ClientApp/src/pages/jury/JuryPage.tsx): `src/Krtakan.Api/ClientApp/src/pages/jury/JuryPage.tsx`
- [Admin management](https://github.com/shantcodes/talent-of-schools/tree/main/src/Krtakan.Api/ClientApp/src/pages/admin): `src/Krtakan.Api/ClientApp/src/pages/admin`
- [Account](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/ClientApp/src/pages/account/AccountPage.tsx): `src/Krtakan.Api/ClientApp/src/pages/account/AccountPage.tsx`

### HTTP API

- [Authentication API](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/Controllers/AuthController.cs): `src/Krtakan.Api/Controllers/AuthController.cs`
- [Events API](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/Controllers/EventsController.cs): `src/Krtakan.Api/Controllers/EventsController.cs`
- [Participant API](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/Controllers/EventParticipantController.cs): `src/Krtakan.Api/Controllers/EventParticipantController.cs`
- [Scoring API](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/Controllers/ScoringController.cs): `src/Krtakan.Api/Controllers/ScoringController.cs`
- [Users API](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Api/Controllers/UsersController.cs): `src/Krtakan.Api/Controllers/UsersController.cs`

### Application use cases

- [Authentication use case](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Application/Services/AuthService.cs): `src/Krtakan.Application/Services/AuthService.cs`
- [Participant workflow](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Application/Services/EventParticipantService.cs): `src/Krtakan.Application/Services/EventParticipantService.cs`
- [Event and scoring use cases](https://github.com/shantcodes/talent-of-schools/tree/main/src/Krtakan.Application/Services): `src/Krtakan.Application/Services`
- [User administration](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Application/Services/UserService.cs): `src/Krtakan.Application/Services/UserService.cs`

### Competition domain

- [Competition entities](https://github.com/shantcodes/talent-of-schools/tree/main/src/Krtakan.Domain/Entities): `src/Krtakan.Domain/Entities`
- [User repository contract](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Domain/Interfaces/IUserRepository.cs): `src/Krtakan.Domain/Interfaces/IUserRepository.cs`

### Infrastructure

- [SQLite data store](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Infrastructure/Persistence/AppDbContext.cs): `src/Krtakan.Infrastructure/Persistence/AppDbContext.cs`
- [EF repositories](https://github.com/shantcodes/talent-of-schools/tree/main/src/Krtakan.Infrastructure/Repositories): `src/Krtakan.Infrastructure/Repositories`
- [JWT token service](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Infrastructure/Security/JwtTokenService.cs): `src/Krtakan.Infrastructure/Security/JwtTokenService.cs`
- [Local media storage](https://github.com/shantcodes/talent-of-schools/blob/main/src/Krtakan.Infrastructure/Storage/LocalFileStorage.cs): `src/Krtakan.Infrastructure/Storage/LocalFileStorage.cs`

### Other components

- **Site user**

## Connections

- Site user → Route application: uses (evidence: `src/Krtakan.Api/ClientApp/src/App.tsx`)
- Route application → Sign-in and signup: routes to (evidence: `src/Krtakan.Api/ClientApp/src/App.tsx`)
- Route application → Landing and events: routes to (evidence: `src/Krtakan.Api/ClientApp/src/App.tsx`)
- Route application → Student events: routes to (evidence: `src/Krtakan.Api/ClientApp/src/App.tsx`)
- Route application → Jury scoring: routes to (evidence: `src/Krtakan.Api/ClientApp/src/App.tsx`)
- Route application → Admin management: routes to (evidence: `src/Krtakan.Api/ClientApp/src/App.tsx`)
- Route application → Account: routes to (evidence: `src/Krtakan.Api/ClientApp/src/App.tsx`)
- Site user → Authentication API: HTTP requests (evidence: `README.md`)
- Authentication API → Authentication use case: delegates to (evidence: `src/Krtakan.Api/Controllers/AuthController.cs`)
- Authentication use case → User repository contract: queries users (evidence: `src/Krtakan.Application/Services/AuthService.cs`)
- Authentication use case → JWT token service: creates tokens (evidence: `src/Krtakan.Application/Services/AuthService.cs`)
- Authentication use case → EF repositories: persists tokens (evidence: `src/Krtakan.Application/Services/AuthService.cs`)
- Events API → Event and scoring use cases: delegates to (evidence: `src/Krtakan.Api/Controllers/EventsController.cs`)
- Participant API → Participant workflow: delegates to (evidence: `src/Krtakan.Api/Controllers/EventParticipantController.cs`)
- Participant workflow → Competition entities: uses entities (evidence: `src/Krtakan.Application/Services/EventParticipantService.cs`)
- Users API → User administration: delegates to (evidence: `src/Krtakan.Api/Controllers/UsersController.cs`)
- User administration → User repository contract: queries users (evidence: `src/Krtakan.Application/Services/UserService.cs`)
- EF repositories → SQLite data store: reads and writes (evidence: `src/Krtakan.Infrastructure/Repositories/EfRepository.cs`)
- User repository contract → Competition entities: specifies access (evidence: `src/Krtakan.Domain/Interfaces/IUserRepository.cs`)
- Site user → Scoring API: HTTP requests (evidence: `README.md`)
- Participant workflow → Local media storage: stores submissions
