# abdeladimabid/problem-solving-discord-bot-plateforme architecture

> Architecture diagram of the GitHub repository abdeladimabid/problem-solving-discord-bot-plateforme, 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/abdeladimabid/problem-solving-discord-bot-plateforme
- Repository: https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme

## Overview

ClassBot is a Discord programming-class bot paired with a private teacher dashboard. Students enter through Discord or student-facing pages to practise challenges, compete, take assessments, and connect GitHub work; teachers use the dashboard to manage class settings, programme, activities, briefs, assessments, and project reviews. Both Workers share D1-backed class state. The graph preserves documented capabilities, but unsampled routes and cron internals are represented only where the README or source index supports them.

Main entry points: [`src/bot/index.ts`](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/bot/index.ts) (Public Worker), [`src/bot/interactions.ts`](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/bot/interactions.ts) (Discord interactions), [`src/admin/api.ts`](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/admin/api.ts) (Dashboard API), [`src/shared/review/debrief.ts`](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/review/debrief.ts) (Briefs and debriefs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Worker entrypoints"]
  node_bot_worker["Public Worker<br/>[index.ts]"]
  node_interactions["Discord interactions<br/>[interactions.ts]"]
  node_cron["Scheduled jobs<br/>[cron.ts]"]
  node_admin_worker["Admin Worker<br/>[index.ts]"]
  node_admin_api["Dashboard API<br/>[api.ts]"]
end

subgraph group_learner["Learner experience"]
  node_practice["Challenges and games<br/>[interactions.ts]"]
  node_editor["Code editor<br/>[editor.ts]"]
  node_assessments["Assessments<br/>[assess.ts]"]
  node_learning_pages["Learning pages<br/>[learning.js]"]
end

subgraph group_teacher["Teaching workflow"]
  node_dashboard["Teacher dashboard<br/>[app.js]"]
  node_curriculum["Programme and competencies<br/>[program.ts]"]
  node_activities["Daily activities<br/>[activities.ts]"]
  node_project_reviews["Briefs and debriefs<br/>[debrief.ts]"]
  node_review_engine["Review checks<br/>[engine.ts]"]
  node_github_followup["GitHub follow-up<br/>[github.ts]"]
end

subgraph group_shared["Shared services"]
  node_ai["AI services<br/>[ai.ts]"]
  node_identity["Class identity<br/>[identity.ts]"]
  node_discord_api["Discord API helpers<br/>[discord.ts]"]
  node_database[("Shared D1 data<br/>[db.ts]")]
  node_program_seed["Built-in programme<br/>[dwwm-2026.ts]"]
end

subgraph group_integrations["External systems"]
  node_discord(("Discord"))
  node_github_ext(("GitHub"))
  node_hackerrank{{"HackerRank"}}
  node_code_runners{{"Code runners"}}
  node_ai_providers{{"AI providers"}}
end

node_students(("Students"))
node_teachers(("Teachers"))

node_students -->|"use commands"| node_discord
node_discord -->|"sends interactions"| node_bot_worker
node_bot_worker -->|"routes requests"| node_interactions
node_interactions -.->|"handles practice"| node_practice
node_students -->|"open student pages"| node_bot_worker
node_bot_worker -->|"routes editor"| node_editor
node_students -->|"browse learning"| node_learning_pages
node_students -->|"complete assessments"| node_assessments
node_teachers -->|"manage class"| node_dashboard
node_dashboard -->|"calls dashboard"| node_admin_worker
node_admin_worker -->|"routes API"| node_admin_api
node_admin_api -->|"manages programme"| node_curriculum
node_admin_api -->|"manages activities"| node_activities
node_admin_api -->|"manages reviews"| node_project_reviews
node_project_reviews -->|"uses checks"| node_review_engine
node_project_reviews -->|"reads project work"| node_github_followup
node_github_ext -->|"sends webhook"| node_bot_worker
node_github_followup -->|"fetches repositories"| node_github_ext
node_bot_worker -->|"runs scheduled work"| node_cron
node_cron -->|"updates class jobs"| node_database
node_curriculum -->|"loads built-in"| node_program_seed
node_admin_api -->|"reads and writes"| node_database
node_interactions -.->|"uses shared data"| node_database
node_assessments -->|"stores assessments"| node_database
node_interactions -.->|"sends messages"| node_discord_api
node_project_reviews -->|"requests AI review"| node_ai
node_ai -.->|"generates responses"| node_ai_providers
node_practice -->|"uses contest boards"| node_hackerrank
node_editor -->|"runs submissions"| node_code_runners
node_interactions -.->|"resolves class identity"| node_identity

click node_bot_worker "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/bot/index.ts"
click node_interactions "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/bot/interactions.ts"
click node_cron "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/bot/cron.ts"
click node_admin_worker "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/admin/index.ts"
click node_admin_api "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/admin/api.ts"
click node_dashboard "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/public/app.js"
click node_practice "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/bot/interactions.ts"
click node_editor "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/bot/editor.ts"
click node_assessments "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/assess.ts"
click node_learning_pages "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/public/learning.js"
click node_curriculum "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/program.ts"
click node_activities "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/activities.ts"
click node_project_reviews "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/review/debrief.ts"
click node_review_engine "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/review/engine.ts"
click node_github_followup "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/github.ts"
click node_ai "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/ai.ts"
click node_identity "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/identity.ts"
click node_discord_api "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/discord.ts"
click node_database "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/db.ts"
click node_program_seed "https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/programs/dwwm-2026.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_bot_worker,node_interactions,node_cron,node_admin_worker,node_admin_api toneBlue
class node_practice,node_editor,node_assessments,node_learning_pages toneAmber
class node_dashboard,node_curriculum,node_activities,node_project_reviews,node_review_engine,node_github_followup toneMint
class node_ai,node_identity,node_discord_api,node_database,node_program_seed toneRose
class node_discord,node_github_ext,node_hackerrank,node_code_runners,node_ai_providers,node_students,node_teachers toneIndigo
```

## Components

### Worker entrypoints

- [Public Worker](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/bot/index.ts): `src/bot/index.ts`
- [Discord interactions](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/bot/interactions.ts): `src/bot/interactions.ts`
- [Scheduled jobs](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/bot/cron.ts): `src/bot/cron.ts`
- [Admin Worker](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/admin/index.ts): `src/admin/index.ts`
- [Dashboard API](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/admin/api.ts): `src/admin/api.ts`

### Learner experience

- [Challenges and games](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/bot/interactions.ts): `src/bot/interactions.ts`
- [Code editor](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/bot/editor.ts): `src/bot/editor.ts`
- [Assessments](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/assess.ts): `src/shared/assess.ts`
- [Learning pages](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/public/learning.js): `public/learning.js`

### Teaching workflow

- [Teacher dashboard](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/public/app.js): `public/app.js`
- [Programme and competencies](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/program.ts): `src/shared/program.ts`
- [Daily activities](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/activities.ts): `src/shared/activities.ts`
- [Briefs and debriefs](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/review/debrief.ts): `src/shared/review/debrief.ts`
- [Review checks](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/review/engine.ts): `src/shared/review/engine.ts`
- [GitHub follow-up](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/github.ts): `src/shared/github.ts`

### Shared services

- [AI services](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/ai.ts): `src/shared/ai.ts`
- [Class identity](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/identity.ts): `src/shared/identity.ts`
- [Discord API helpers](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/discord.ts): `src/shared/discord.ts`
- [Shared D1 data](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/db.ts): `src/shared/db.ts`
- [Built-in programme](https://github.com/abdeladimabid/problem-solving-discord-bot-plateforme/blob/main/src/shared/programs/dwwm-2026.ts): `src/shared/programs/dwwm-2026.ts`

### External systems

- **Discord**
- **GitHub**
- **HackerRank**
- **Code runners**
- **AI providers**

### Other components

- **Students**
- **Teachers**

## Connections

- Students → Discord: use commands (evidence: `README.md`)
- Discord → Public Worker: sends interactions (evidence: `README.md`)
- Public Worker → Discord interactions: routes requests (evidence: `src/bot/index.ts`)
- Discord interactions → Challenges and games: handles practice
- Students → Public Worker: open student pages (evidence: `README.md`)
- Public Worker → Code editor: routes editor (evidence: `src/bot/index.ts`)
- Students → Learning pages: browse learning (evidence: `README.md`)
- Students → Assessments: complete assessments (evidence: `README.md`)
- Teachers → Teacher dashboard: manage class (evidence: `README.md`)
- Teacher dashboard → Admin Worker: calls dashboard (evidence: `README.md`)
- Admin Worker → Dashboard API: routes API (evidence: `src/admin/index.ts`)
- Dashboard API → Programme and competencies: manages programme (evidence: `src/admin/api.ts`)
- Dashboard API → Daily activities: manages activities (evidence: `src/admin/api.ts`)
- Dashboard API → Briefs and debriefs: manages reviews
- Briefs and debriefs → Review checks: uses checks (evidence: `src/shared/review/debrief.ts`)
- Briefs and debriefs → GitHub follow-up: reads project work (evidence: `src/shared/review/debrief.ts`)
- GitHub → Public Worker: sends webhook (evidence: `README.md`)
- GitHub follow-up → GitHub: fetches repositories (evidence: `README.md`)
- Public Worker → Scheduled jobs: runs scheduled work (evidence: `README.md`)
- Scheduled jobs → Shared D1 data: updates class jobs (evidence: `README.md`)
- Programme and competencies → Built-in programme: loads built-in (evidence: `src/shared/program.ts`)
- Dashboard API → Shared D1 data: reads and writes (evidence: `src/admin/api.ts`)
- Discord interactions → Shared D1 data: uses shared data
- Assessments → Shared D1 data: stores assessments (evidence: `src/shared/assess.ts`)
- Discord interactions → Discord API helpers: sends messages
- Briefs and debriefs → AI services: requests AI review (evidence: `src/shared/review/debrief.ts`)
- AI services → AI providers: generates responses
- Challenges and games → HackerRank: uses contest boards (evidence: `README.md`)
- Code editor → Code runners: runs submissions (evidence: `README.md`)
- Discord interactions → Class identity: resolves class identity
