# ddobrev86/leetstat architecture

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

## Overview

LeetStat is a Bulgarian probability-problem practice app. A user authenticates, browses and filters problems, opens one, enters answers or self-grades, and submits for a verdict; the app also tracks progress and provides curated lists, contests, leaderboards, and administration. The graph includes the documented checker and content capabilities. Some server and client modules were not excerpted, so their internal relationships are omitted or shown as unverified rather than inferred.

Main entry points: [`client/src/app.tsx`](https://github.com/ddobrev86/leetstat/blob/main/client/src/app.tsx) (App routing), [`server/src/app.ts`](https://github.com/ddobrev86/leetstat/blob/main/server/src/app.ts) (HTTP routes), [`server/src/checker/index.ts`](https://github.com/ddobrev86/leetstat/blob/main/server/src/checker/index.ts) (Answer checker), [`client/src/services/api.ts`](https://github.com/ddobrev86/leetstat/blob/main/client/src/services/api.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Practice interface"]
  node_app["App routing<br/>[app.tsx]"]
  node_authui["Authentication UI<br/>[index.tsx]"]
  node_authstate["Session state<br/>[auth-context.tsx]"]
  node_problem_list["Problem browser<br/>[index.tsx]"]
  node_problem_page["Problem workspace<br/>[index.tsx]"]
  node_answer_panel["Answer entry<br/>[index.tsx]"]
  node_math_input["Math editor<br/>[index.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_important["Curated problems<br/>[index.tsx]"]
  node_contests_ui["Contest interface<br/>[index.tsx]"]
  node_stats_ui["Progress statistics<br/>[index.tsx]"]
  node_leaderboard_ui["Leaderboard interface<br/>[index.tsx]"]
  node_admin_ui["Admin interface<br/>[index.tsx]"]
end

subgraph group_server["Application API"]
  node_api["HTTP routes<br/>[app.ts]"]
  node_auth["Accounts and invites<br/>[auth.ts]"]
  node_contest_api["Contest services<br/>[contests.ts]"]
  node_content_loader["Content loading<br/>[content.ts]"]
end

subgraph group_checker["Answer evaluation"]
  node_checker_entry["Answer checker<br/>[index.ts]"]
  node_parser["Expression parser<br/>[parser.ts]"]
  node_lexer["Input lexer<br/>[lexer.ts]"]
  node_evaluator["Expression evaluator<br/>[evaluate.ts]"]
  node_constraints["Answer constraints<br/>[constraint.ts]"]
end

subgraph group_data["Content and persistence"]
  node_problem_content["Problem content"]
  node_database[("PostgreSQL store<br/>[db.ts]")]
end

node_user(("Learner or admin"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_problem_list
node_app -->|"routes to"| node_problem_page
node_app -->|"routes to"| node_important
node_app -->|"routes to"| node_contests_ui
node_app -->|"routes to"| node_stats_ui
node_app -->|"routes to"| node_leaderboard_ui
node_app -->|"routes to"| node_admin_ui
node_app -->|"reads session"| node_authstate
node_authstate -->|"requests session"| node_api_client
node_problem_list -->|"loads problems"| node_api_client
node_problem_page -->|"loads and submits"| node_api_client
node_problem_page -->|"renders"| node_answer_panel
node_answer_panel -->|"renders"| node_math_input
node_api_client -.->|"calls HTTP API"| node_api
node_api -->|"mounts routes"| node_auth
node_api -->|"mounts routes"| node_contest_api
node_api -->|"checks submissions"| node_checker_entry
node_api -->|"uses content"| node_content_loader
node_api -->|"queries"| node_database
node_auth -->|"queries"| node_database
node_checker_entry -->|"parses expressions"| node_parser
node_checker_entry -->|"evaluates answers"| node_evaluator
node_checker_entry -->|"parses constraints"| node_constraints
node_parser -->|"tokenizes input"| node_lexer
node_content_loader -.->|"loads problems"| node_problem_content
node_database -.->|"stores progress"| node_problem_content
node_user -->|"registers or logs in"| node_authui
node_user -->|"enters answers"| node_answer_panel

click node_app "https://github.com/ddobrev86/leetstat/blob/main/client/src/app.tsx"
click node_authui "https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/auth/index.tsx"
click node_authstate "https://github.com/ddobrev86/leetstat/blob/main/client/src/context/auth-context.tsx"
click node_problem_list "https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/problem-list/index.tsx"
click node_problem_page "https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/problem/index.tsx"
click node_answer_panel "https://github.com/ddobrev86/leetstat/blob/main/client/src/components/answer-panel/index.tsx"
click node_math_input "https://github.com/ddobrev86/leetstat/blob/main/client/src/components/math-input/index.tsx"
click node_api_client "https://github.com/ddobrev86/leetstat/blob/main/client/src/services/api.ts"
click node_important "https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/important/index.tsx"
click node_contests_ui "https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/contests/index.tsx"
click node_stats_ui "https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/stats/index.tsx"
click node_leaderboard_ui "https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/leaderboard/index.tsx"
click node_admin_ui "https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/admin/index.tsx"
click node_api "https://github.com/ddobrev86/leetstat/blob/main/server/src/app.ts"
click node_auth "https://github.com/ddobrev86/leetstat/blob/main/server/src/auth.ts"
click node_contest_api "https://github.com/ddobrev86/leetstat/blob/main/server/src/contests.ts"
click node_content_loader "https://github.com/ddobrev86/leetstat/blob/main/server/src/content.ts"
click node_checker_entry "https://github.com/ddobrev86/leetstat/blob/main/server/src/checker/index.ts"
click node_parser "https://github.com/ddobrev86/leetstat/blob/main/server/src/checker/parser.ts"
click node_lexer "https://github.com/ddobrev86/leetstat/blob/main/server/src/checker/lexer.ts"
click node_evaluator "https://github.com/ddobrev86/leetstat/blob/main/server/src/checker/evaluate.ts"
click node_constraints "https://github.com/ddobrev86/leetstat/blob/main/server/src/checker/constraint.ts"
click node_problem_content "https://github.com/ddobrev86/leetstat/tree/main/content"
click node_database "https://github.com/ddobrev86/leetstat/blob/main/server/src/db.ts"

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_authstate,node_problem_list,node_problem_page,node_answer_panel,node_math_input,node_api_client,node_important,node_contests_ui,node_stats_ui,node_leaderboard_ui,node_admin_ui toneBlue
class node_api,node_auth,node_contest_api,node_content_loader toneAmber
class node_checker_entry,node_parser,node_lexer,node_evaluator,node_constraints toneMint
class node_problem_content,node_database toneRose
class node_user toneIndigo
```

## Components

### Practice interface

- [App routing](https://github.com/ddobrev86/leetstat/blob/main/client/src/app.tsx): `client/src/app.tsx`
- [Authentication UI](https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/auth/index.tsx): `client/src/pages/auth/index.tsx`
- [Session state](https://github.com/ddobrev86/leetstat/blob/main/client/src/context/auth-context.tsx): `client/src/context/auth-context.tsx`
- [Problem browser](https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/problem-list/index.tsx): `client/src/pages/problem-list/index.tsx`
- [Problem workspace](https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/problem/index.tsx): `client/src/pages/problem/index.tsx`
- [Answer entry](https://github.com/ddobrev86/leetstat/blob/main/client/src/components/answer-panel/index.tsx): `client/src/components/answer-panel/index.tsx`
- [Math editor](https://github.com/ddobrev86/leetstat/blob/main/client/src/components/math-input/index.tsx): `client/src/components/math-input/index.tsx`
- [API client](https://github.com/ddobrev86/leetstat/blob/main/client/src/services/api.ts): `client/src/services/api.ts`
- [Curated problems](https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/important/index.tsx): `client/src/pages/important/index.tsx`
- [Contest interface](https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/contests/index.tsx): `client/src/pages/contests/index.tsx`
- [Progress statistics](https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/stats/index.tsx): `client/src/pages/stats/index.tsx`
- [Leaderboard interface](https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/leaderboard/index.tsx): `client/src/pages/leaderboard/index.tsx`
- [Admin interface](https://github.com/ddobrev86/leetstat/blob/main/client/src/pages/admin/index.tsx): `client/src/pages/admin/index.tsx`

### Application API

- [HTTP routes](https://github.com/ddobrev86/leetstat/blob/main/server/src/app.ts): `server/src/app.ts`
- [Accounts and invites](https://github.com/ddobrev86/leetstat/blob/main/server/src/auth.ts): `server/src/auth.ts`
- [Contest services](https://github.com/ddobrev86/leetstat/blob/main/server/src/contests.ts): `server/src/contests.ts`
- [Content loading](https://github.com/ddobrev86/leetstat/blob/main/server/src/content.ts): `server/src/content.ts`

### Answer evaluation

- [Answer checker](https://github.com/ddobrev86/leetstat/blob/main/server/src/checker/index.ts): `server/src/checker/index.ts`
- [Expression parser](https://github.com/ddobrev86/leetstat/blob/main/server/src/checker/parser.ts): `server/src/checker/parser.ts`
- [Input lexer](https://github.com/ddobrev86/leetstat/blob/main/server/src/checker/lexer.ts): `server/src/checker/lexer.ts`
- [Expression evaluator](https://github.com/ddobrev86/leetstat/blob/main/server/src/checker/evaluate.ts): `server/src/checker/evaluate.ts`
- [Answer constraints](https://github.com/ddobrev86/leetstat/blob/main/server/src/checker/constraint.ts): `server/src/checker/constraint.ts`

### Content and persistence

- [Problem content](https://github.com/ddobrev86/leetstat/tree/main/content): `content`
- [PostgreSQL store](https://github.com/ddobrev86/leetstat/blob/main/server/src/db.ts): `server/src/db.ts`

### Other components

- **Learner or admin**

## Connections

- Learner or admin → App routing: uses (evidence: `README.md`)
- App routing → Authentication UI: routes to (evidence: `client/src/app.tsx`)
- App routing → Problem browser: routes to (evidence: `client/src/app.tsx`)
- App routing → Problem workspace: routes to (evidence: `client/src/app.tsx`)
- App routing → Curated problems: routes to (evidence: `client/src/app.tsx`)
- App routing → Contest interface: routes to (evidence: `client/src/app.tsx`)
- App routing → Progress statistics: routes to (evidence: `client/src/app.tsx`)
- App routing → Leaderboard interface: routes to (evidence: `client/src/app.tsx`)
- App routing → Admin interface: routes to (evidence: `client/src/app.tsx`)
- App routing → Session state: reads session (evidence: `client/src/app.tsx`)
- Session state → API client: requests session (evidence: `client/src/context/auth-context.tsx`)
- Problem browser → API client: loads problems (evidence: `client/src/pages/problem-list/index.tsx`)
- Problem workspace → API client: loads and submits (evidence: `client/src/pages/problem/index.tsx`)
- Problem workspace → Answer entry: renders (evidence: `client/src/pages/problem/index.tsx`)
- Answer entry → Math editor: renders (evidence: `client/src/components/answer-panel/index.tsx`)
- API client → HTTP routes: calls HTTP API
- HTTP routes → Accounts and invites: mounts routes (evidence: `server/src/app.ts`)
- HTTP routes → Contest services: mounts routes (evidence: `server/src/app.ts`)
- HTTP routes → Answer checker: checks submissions (evidence: `server/src/app.ts`)
- HTTP routes → Content loading: uses content (evidence: `server/src/app.ts`)
- HTTP routes → PostgreSQL store: queries (evidence: `server/src/app.ts`)
- Accounts and invites → PostgreSQL store: queries (evidence: `server/src/auth.ts`)
- Answer checker → Expression parser: parses expressions (evidence: `server/src/checker/index.ts`)
- Answer checker → Expression evaluator: evaluates answers (evidence: `server/src/checker/index.ts`)
- Answer checker → Answer constraints: parses constraints (evidence: `server/src/checker/index.ts`)
- Expression parser → Input lexer: tokenizes input (evidence: `server/src/checker/parser.ts`)
- Content loading → Problem content: loads problems
- PostgreSQL store → Problem content: stores progress
- Learner or admin → Authentication UI: registers or logs in (evidence: `README.md`)
- Learner or admin → Answer entry: enters answers (evidence: `README.md`)
