# monish1107n/taloria architecture

> Architecture diagram of the GitHub repository monish1107n/taloria, 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/monish1107n/taloria
- Repository: https://github.com/monish1107n/taloria

## Overview

TALORIA connects athletes, scouts, tournament organizers, and sponsors through profile discovery, tournament applications, selection, and sponsorship. The frontend routes role-specific screens through a typed API client to an Express backend, whose domain routes implement the platform workflows over PostgreSQL. The graph preserves documented verification, messaging, notifications, and administration capabilities. Evidence is strongest for sampled route dispatch and several workflow modules; some listed subsystems are unsampled, so their internal calls are not inferred.

Main entry points: [`backend/src/app.js`](https://github.com/monish1107n/taloria/blob/main/backend/src/app.js) (HTTP application), [`backend/src/config/db.js`](https://github.com/monish1107n/taloria/blob/main/backend/src/config/db.js) (PostgreSQL data), [`backend/src/routes/tournaments.routes.js`](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/tournaments.routes.js) (Tournament management), [`frontend/src/App.tsx`](https://github.com/monish1107n/taloria/blob/main/frontend/src/App.tsx) (Role-based screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_routing["Role-based screens<br/>[App.tsx]"]
  node_authui["Session state<br/>[AuthProvider.tsx]"]
  node_api_client["Typed API client<br/>[endpoints.ts]"]
end

subgraph group_api["Backend platform"]
  node_server_app["HTTP application<br/>[app.js]"]
  node_auth_routes["Authentication<br/>[auth.routes.js]"]
  node_auth_middleware["Identity and roles<br/>[authenticate.js]"]
  node_database[("PostgreSQL data<br/>[db.js]")]
end

subgraph group_opportunities["Tournament lifecycle"]
  node_tournaments["Tournament management"]
  node_applications["Applications and selection"]
  node_statistics["Performance statistics<br/>[statistics.js]"]
  node_sponsorships["Tournament sponsorship"]
  node_sports["Sports categories<br/>[sports.routes.js]"]
end

subgraph group_community["Discovery and operations"]
  node_athletes["Athlete profiles<br/>[athletes.routes.js]"]
  node_scouting["Athlete discovery<br/>[scouting.routes.js]"]
  node_verification["Profile verification"]
  node_messaging["Platform messaging<br/>[messages.routes.js]"]
  node_notifications["Notifications"]
  node_administration["Platform administration<br/>[admin.routes.js]"]
  node_public_browse["Public browsing<br/>[public.routes.js]"]
end

node_participants(("Platform users"))

node_participants -->|"use platform"| node_routing
node_routing -->|"checks session"| node_authui
node_routing -.->|"loads domain data"| node_api_client
node_api_client -->|"sends REST requests"| node_server_app
node_server_app -->|"mounts"| node_auth_routes
node_server_app -->|"mounts"| node_athletes
node_server_app -->|"mounts"| node_tournaments
node_server_app -->|"mounts"| node_applications
node_server_app -->|"mounts"| node_sponsorships
node_server_app -->|"mounts"| node_messaging
node_server_app -->|"mounts"| node_notifications
node_server_app -->|"mounts"| node_verification
node_server_app -->|"mounts"| node_administration
node_server_app -->|"mounts"| node_public_browse
node_server_app -->|"mounts"| node_scouting
node_server_app -->|"mounts"| node_sports
node_auth_routes -->|"queries"| node_database
node_athletes -->|"queries"| node_database
node_tournaments -->|"queries"| node_database
node_applications -->|"queries"| node_database
node_sponsorships -->|"queries"| node_database
node_messaging -->|"queries"| node_database
node_athletes -->|"uses statistics"| node_statistics
node_tournaments -->|"validates performance"| node_statistics
node_participants -->|"publish events"| node_tournaments
node_participants -->|"apply and decide"| node_applications
node_participants -->|"discover talent"| node_scouting
node_participants -->|"support events"| node_sponsorships
node_participants -->|"request review"| node_verification
node_participants -->|"contact platform users"| node_messaging
node_participants -->|"receive updates"| node_notifications
node_participants -->|"administer platform"| node_administration

click node_routing "https://github.com/monish1107n/taloria/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/monish1107n/taloria/blob/main/frontend/src/auth/AuthProvider.tsx"
click node_api_client "https://github.com/monish1107n/taloria/blob/main/frontend/src/lib/endpoints.ts"
click node_server_app "https://github.com/monish1107n/taloria/blob/main/backend/src/app.js"
click node_auth_routes "https://github.com/monish1107n/taloria/blob/main/backend/src/routes/auth.routes.js"
click node_auth_middleware "https://github.com/monish1107n/taloria/blob/main/backend/src/middleware/authenticate.js"
click node_athletes "https://github.com/monish1107n/taloria/blob/main/backend/src/routes/athletes.routes.js"
click node_tournaments "https://github.com/monish1107n/taloria/blob/main/backend/src/routes/tournaments.routes.js"
click node_applications "https://github.com/monish1107n/taloria/blob/main/backend/src/routes/applications.routes.js"
click node_statistics "https://github.com/monish1107n/taloria/blob/main/backend/src/services/statistics.js"
click node_scouting "https://github.com/monish1107n/taloria/blob/main/backend/src/routes/scouting.routes.js"
click node_sponsorships "https://github.com/monish1107n/taloria/blob/main/backend/src/routes/sponsorships.routes.js"
click node_verification "https://github.com/monish1107n/taloria/blob/main/backend/src/routes/verification.routes.js"
click node_messaging "https://github.com/monish1107n/taloria/blob/main/backend/src/routes/messages.routes.js"
click node_notifications "https://github.com/monish1107n/taloria/blob/main/backend/src/routes/notifications.routes.js"
click node_administration "https://github.com/monish1107n/taloria/blob/main/backend/src/routes/admin.routes.js"
click node_sports "https://github.com/monish1107n/taloria/blob/main/backend/src/routes/sports.routes.js"
click node_public_browse "https://github.com/monish1107n/taloria/blob/main/backend/src/routes/public.routes.js"
click node_database "https://github.com/monish1107n/taloria/blob/main/backend/src/config/db.js"

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_routing,node_authui,node_api_client,node_participants toneBlue
class node_server_app,node_auth_routes,node_auth_middleware,node_database toneAmber
class node_tournaments,node_applications,node_statistics,node_sponsorships,node_sports toneMint
class node_athletes,node_scouting,node_verification,node_messaging,node_notifications,node_administration,node_public_browse toneRose
```

## Components

### Web application

- [Role-based screens](https://github.com/monish1107n/taloria/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Session state](https://github.com/monish1107n/taloria/blob/main/frontend/src/auth/AuthProvider.tsx): `frontend/src/auth/AuthProvider.tsx`
- [Typed API client](https://github.com/monish1107n/taloria/blob/main/frontend/src/lib/endpoints.ts): `frontend/src/lib/endpoints.ts`

### Backend platform

- [HTTP application](https://github.com/monish1107n/taloria/blob/main/backend/src/app.js): `backend/src/app.js`
- [Authentication](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/auth.routes.js): `backend/src/routes/auth.routes.js`
- [Identity and roles](https://github.com/monish1107n/taloria/blob/main/backend/src/middleware/authenticate.js): `backend/src/middleware/authenticate.js`
- [PostgreSQL data](https://github.com/monish1107n/taloria/blob/main/backend/src/config/db.js): `backend/src/config/db.js`

### Tournament lifecycle

- [Tournament management](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/tournaments.routes.js): `backend/src/routes/tournaments.routes.js`
- [Applications and selection](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/applications.routes.js): `backend/src/routes/applications.routes.js`
- [Performance statistics](https://github.com/monish1107n/taloria/blob/main/backend/src/services/statistics.js): `backend/src/services/statistics.js`
- [Tournament sponsorship](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/sponsorships.routes.js): `backend/src/routes/sponsorships.routes.js`
- [Sports categories](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/sports.routes.js): `backend/src/routes/sports.routes.js`

### Discovery and operations

- [Athlete profiles](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/athletes.routes.js): `backend/src/routes/athletes.routes.js`
- [Athlete discovery](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/scouting.routes.js): `backend/src/routes/scouting.routes.js`
- [Profile verification](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/verification.routes.js): `backend/src/routes/verification.routes.js`
- [Platform messaging](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/messages.routes.js): `backend/src/routes/messages.routes.js`
- [Notifications](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/notifications.routes.js): `backend/src/routes/notifications.routes.js`
- [Platform administration](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/admin.routes.js): `backend/src/routes/admin.routes.js`
- [Public browsing](https://github.com/monish1107n/taloria/blob/main/backend/src/routes/public.routes.js): `backend/src/routes/public.routes.js`

### Other components

- **Platform users**

## Connections

- Platform users → Role-based screens: use platform (evidence: `README.md`)
- Role-based screens → Session state: checks session (evidence: `frontend/src/App.tsx`)
- Role-based screens → Typed API client: loads domain data
- Typed API client → HTTP application: sends REST requests (evidence: `frontend/src/lib/endpoints.ts`)
- HTTP application → Authentication: mounts (evidence: `backend/src/app.js`)
- HTTP application → Athlete profiles: mounts (evidence: `backend/src/app.js`)
- HTTP application → Tournament management: mounts (evidence: `backend/src/app.js`)
- HTTP application → Applications and selection: mounts (evidence: `backend/src/app.js`)
- HTTP application → Tournament sponsorship: mounts (evidence: `backend/src/app.js`)
- HTTP application → Platform messaging: mounts (evidence: `backend/src/app.js`)
- HTTP application → Notifications: mounts (evidence: `backend/src/app.js`)
- HTTP application → Profile verification: mounts (evidence: `backend/src/app.js`)
- HTTP application → Platform administration: mounts (evidence: `backend/src/app.js`)
- HTTP application → Public browsing: mounts (evidence: `backend/src/app.js`)
- HTTP application → Athlete discovery: mounts (evidence: `backend/src/app.js`)
- HTTP application → Sports categories: mounts (evidence: `backend/src/app.js`)
- Authentication → PostgreSQL data: queries (evidence: `backend/src/routes/auth.routes.js`)
- Athlete profiles → PostgreSQL data: queries (evidence: `backend/src/routes/athletes.routes.js`)
- Tournament management → PostgreSQL data: queries (evidence: `backend/src/routes/tournaments.routes.js`)
- Applications and selection → PostgreSQL data: queries (evidence: `backend/src/routes/applications.routes.js`)
- Tournament sponsorship → PostgreSQL data: queries (evidence: `backend/src/routes/sponsorships.routes.js`)
- Platform messaging → PostgreSQL data: queries (evidence: `backend/src/routes/messages.routes.js`)
- Athlete profiles → Performance statistics: uses statistics (evidence: `backend/src/routes/athletes.routes.js`)
- Tournament management → Performance statistics: validates performance (evidence: `backend/src/routes/tournaments.routes.js`)
- Platform users → Tournament management: publish events (evidence: `README.md`)
- Platform users → Applications and selection: apply and decide (evidence: `README.md`)
- Platform users → Athlete discovery: discover talent (evidence: `README.md`)
- Platform users → Tournament sponsorship: support events (evidence: `README.md`)
- Platform users → Profile verification: request review (evidence: `README.md`)
- Platform users → Platform messaging: contact platform users (evidence: `README.md`)
- Platform users → Notifications: receive updates (evidence: `README.md`)
- Platform users → Platform administration: administer platform (evidence: `README.md`)
