# shoralbrt/ritocode architecture

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

- Interactive diagram: https://gitdiagram.com/shoralbrt/ritocode
- Repository: https://github.com/shoralbrt/ritocode

## Overview

Ritocode is a training platform for judging AI-written code in context. Learners browse tasks, inspect a project and its brief, diagnose findings, choose treatments, and review outcomes; the README describes this product workflow. The graph also preserves content authoring/ingest, accounts, administration, and feedback. Source excerpts show frontend routing and task-list requests, content loading and ingest, and authentication behavior. Most backend endpoint wiring and the task-submission path were not sampled, so those relationships are not asserted.

Main entry points: [`frontend/src/routes.tsx`](https://github.com/shoralbrt/ritocode/blob/main/frontend/src/routes.tsx) (Page routing), [`src/Ritocode.Api/Program.cs`](https://github.com/shoralbrt/ritocode/blob/main/src/Ritocode.Api/Program.cs) (API host), [`frontend/src/pages/TasksPage.tsx`](https://github.com/shoralbrt/ritocode/blob/main/frontend/src/pages/TasksPage.tsx) (Task browsing), [`src/Modules/Ritocode.Modules.Content/Ingest/ContentIngest.cs`](https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Content/Ingest/ContentIngest.cs) (Content ingest)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learner experience"]
  node_webapp["Web application<br/>[App.tsx]"]
  node_routes["Page routing<br/>[routes.tsx]"]
  node_taskbrowse["Task browsing<br/>[TasksPage.tsx]"]
  node_taskwork["Task workspace<br/>[TaskPage.tsx]"]
  node_review["Attempt review<br/>[ReviewPage.tsx]"]
  node_profile["Learner profile<br/>[ProfilePage.tsx]"]
  node_adminui["Admin pages"]
end

subgraph group_platform["API platform"]
  node_api["API client<br/>[client.ts]"]
  node_resource["Resource state<br/>[useApiResource.ts]"]
  node_attempts["Attempts and scoring"]
  node_attemptstore[("Attempt storage")]
  node_webapi["API host<br/>[Program.cs]"]
end

subgraph group_content["Content lifecycle"]
  node_catalogue["Content catalogue"]
  node_contentload["Content validation<br/>[ContentLoader.cs]"]
  node_ingest["Content ingest<br/>[ContentIngest.cs]"]
  node_contentstore[("Content storage")]
  node_authoring["Content authoring tools<br/>[Program.cs]"]
end

subgraph group_identity["Identity and operations"]
  node_auth["Sign-in and sessions"]
  node_users[("User accounts<br/>[User.cs]")]
  node_feedback["Feedback intake"]
end

node_learner(("Learner"))

node_learner -.->|"uses"| node_webapp
node_webapp -->|"renders routes"| node_routes
node_routes -->|"routes to"| node_taskbrowse
node_routes -->|"routes to"| node_taskwork
node_routes -->|"routes to"| node_review
node_routes -->|"routes to"| node_profile
node_routes -->|"routes to"| node_adminui
node_taskbrowse -->|"loads through"| node_resource
node_taskbrowse -->|"requests tasks"| node_api
node_api -.->|"calls API"| node_webapi
node_webapi -.->|"dispatches requests"| node_attempts
node_attempts -.->|"reads and writes"| node_attemptstore
node_webapi -.->|"serves content"| node_catalogue
node_ingest -->|"loads and validates"| node_contentload
node_ingest -->|"writes content"| node_contentstore
node_authoring -->|"loads content"| node_contentload
node_authoring -->|"exports catalogue"| node_catalogue
node_webapi -.->|"configures authentication"| node_auth
node_auth -.->|"uses accounts"| node_users

click node_webapp "https://github.com/shoralbrt/ritocode/blob/main/frontend/src/App.tsx"
click node_routes "https://github.com/shoralbrt/ritocode/blob/main/frontend/src/routes.tsx"
click node_taskbrowse "https://github.com/shoralbrt/ritocode/blob/main/frontend/src/pages/TasksPage.tsx"
click node_taskwork "https://github.com/shoralbrt/ritocode/blob/main/frontend/src/pages/task/TaskPage.tsx"
click node_review "https://github.com/shoralbrt/ritocode/blob/main/frontend/src/pages/task/ReviewPage.tsx"
click node_profile "https://github.com/shoralbrt/ritocode/blob/main/frontend/src/pages/profile/ProfilePage.tsx"
click node_adminui "https://github.com/shoralbrt/ritocode/tree/main/frontend/src/pages/admin"
click node_api "https://github.com/shoralbrt/ritocode/blob/main/frontend/src/api/client.ts"
click node_resource "https://github.com/shoralbrt/ritocode/blob/main/frontend/src/hooks/useApiResource.ts"
click node_attempts "https://github.com/shoralbrt/ritocode/tree/main/src/Modules/Ritocode.Modules.Attempts"
click node_attemptstore "https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Attempts/Persistence/AttemptsDbContext.cs"
click node_catalogue "https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Content/Catalogue/ContentCatalogue.cs"
click node_contentload "https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Content/Format/ContentLoader.cs"
click node_ingest "https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Content/Ingest/ContentIngest.cs"
click node_contentstore "https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Content/Persistence/ContentDbContext.cs"
click node_authoring "https://github.com/shoralbrt/ritocode/blob/main/src/Ritocode.ContentTool/Program.cs"
click node_auth "https://github.com/shoralbrt/ritocode/tree/main/src/Modules/Ritocode.Modules.Auth"
click node_users "https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Users/Domain/User.cs"
click node_feedback "https://github.com/shoralbrt/ritocode/blob/main/src/Ritocode.Api/Feedback/FeedbackEndpoints.cs"
click node_webapi "https://github.com/shoralbrt/ritocode/blob/main/src/Ritocode.Api/Program.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_webapp,node_routes,node_taskbrowse,node_taskwork,node_review,node_profile,node_adminui toneBlue
class node_api,node_resource,node_attempts,node_attemptstore,node_webapi toneAmber
class node_catalogue,node_contentload,node_ingest,node_contentstore,node_authoring toneMint
class node_auth,node_users,node_feedback toneRose
class node_learner toneIndigo
```

## Components

### Learner experience

- [Web application](https://github.com/shoralbrt/ritocode/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Page routing](https://github.com/shoralbrt/ritocode/blob/main/frontend/src/routes.tsx): `frontend/src/routes.tsx`
- [Task browsing](https://github.com/shoralbrt/ritocode/blob/main/frontend/src/pages/TasksPage.tsx): `frontend/src/pages/TasksPage.tsx`
- [Task workspace](https://github.com/shoralbrt/ritocode/blob/main/frontend/src/pages/task/TaskPage.tsx): `frontend/src/pages/task/TaskPage.tsx`
- [Attempt review](https://github.com/shoralbrt/ritocode/blob/main/frontend/src/pages/task/ReviewPage.tsx): `frontend/src/pages/task/ReviewPage.tsx`
- [Learner profile](https://github.com/shoralbrt/ritocode/blob/main/frontend/src/pages/profile/ProfilePage.tsx): `frontend/src/pages/profile/ProfilePage.tsx`
- [Admin pages](https://github.com/shoralbrt/ritocode/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`

### API platform

- [API client](https://github.com/shoralbrt/ritocode/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Resource state](https://github.com/shoralbrt/ritocode/blob/main/frontend/src/hooks/useApiResource.ts): `frontend/src/hooks/useApiResource.ts`
- [Attempts and scoring](https://github.com/shoralbrt/ritocode/tree/main/src/Modules/Ritocode.Modules.Attempts): `src/Modules/Ritocode.Modules.Attempts`
- [Attempt storage](https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Attempts/Persistence/AttemptsDbContext.cs): `src/Modules/Ritocode.Modules.Attempts/Persistence/AttemptsDbContext.cs`
- [API host](https://github.com/shoralbrt/ritocode/blob/main/src/Ritocode.Api/Program.cs): `src/Ritocode.Api/Program.cs`

### Content lifecycle

- [Content catalogue](https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Content/Catalogue/ContentCatalogue.cs): `src/Modules/Ritocode.Modules.Content/Catalogue/ContentCatalogue.cs`
- [Content validation](https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Content/Format/ContentLoader.cs): `src/Modules/Ritocode.Modules.Content/Format/ContentLoader.cs`
- [Content ingest](https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Content/Ingest/ContentIngest.cs): `src/Modules/Ritocode.Modules.Content/Ingest/ContentIngest.cs`
- [Content storage](https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Content/Persistence/ContentDbContext.cs): `src/Modules/Ritocode.Modules.Content/Persistence/ContentDbContext.cs`
- [Content authoring tools](https://github.com/shoralbrt/ritocode/blob/main/src/Ritocode.ContentTool/Program.cs): `src/Ritocode.ContentTool/Program.cs`

### Identity and operations

- [Sign-in and sessions](https://github.com/shoralbrt/ritocode/tree/main/src/Modules/Ritocode.Modules.Auth): `src/Modules/Ritocode.Modules.Auth`
- [User accounts](https://github.com/shoralbrt/ritocode/blob/main/src/Modules/Ritocode.Modules.Users/Domain/User.cs): `src/Modules/Ritocode.Modules.Users/Domain/User.cs`
- [Feedback intake](https://github.com/shoralbrt/ritocode/blob/main/src/Ritocode.Api/Feedback/FeedbackEndpoints.cs): `src/Ritocode.Api/Feedback/FeedbackEndpoints.cs`

### Other components

- **Learner**

## Connections

- Learner → Web application: uses (evidence: `README.md`)
- Web application → Page routing: renders routes (evidence: `frontend/src/App.tsx`)
- Page routing → Task browsing: routes to (evidence: `frontend/src/routes.tsx`)
- Page routing → Task workspace: routes to (evidence: `frontend/src/routes.tsx`)
- Page routing → Attempt review: routes to (evidence: `frontend/src/routes.tsx`)
- Page routing → Learner profile: routes to (evidence: `frontend/src/routes.tsx`)
- Page routing → Admin pages: routes to (evidence: `frontend/src/routes.tsx`)
- Task browsing → Resource state: loads through (evidence: `frontend/src/pages/TasksPage.tsx`)
- Task browsing → API client: requests tasks (evidence: `frontend/src/pages/TasksPage.tsx`)
- API client → API host: calls API
- API host → Attempts and scoring: dispatches requests
- Attempts and scoring → Attempt storage: reads and writes (evidence: `src/Modules/Ritocode.Modules.Attempts/Contracts/TaskStatusLookup.cs`)
- API host → Content catalogue: serves content
- Content ingest → Content validation: loads and validates (evidence: `src/Modules/Ritocode.Modules.Content/Ingest/ContentIngest.cs`)
- Content ingest → Content storage: writes content (evidence: `src/Modules/Ritocode.Modules.Content/Ingest/ContentIngest.cs`)
- Content authoring tools → Content validation: loads content (evidence: `src/Ritocode.ContentTool/Program.cs`)
- Content authoring tools → Content catalogue: exports catalogue (evidence: `src/Ritocode.ContentTool/Program.cs`)
- API host → Sign-in and sessions: configures authentication
- Sign-in and sessions → User accounts: uses accounts
