How abdeladimabid/problem-solving-discord-bot-plateforme works
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: index.ts Public Worker · interactions.ts Discord interactions · api.ts Dashboard API · debrief.ts Briefs and debriefs
Components 27
Worker entrypoints
- Public Worker
src/bot/index.ts - Discord interactions
src/bot/interactions.ts - Scheduled jobs
src/bot/cron.ts - Admin Worker
src/admin/index.ts - Dashboard API
src/admin/api.ts
Learner experience
- Challenges and games
src/bot/interactions.ts - Code editor
src/bot/editor.ts - Assessments
src/shared/assess.ts - Learning pages
public/learning.js
Teaching workflow
- Teacher dashboard
public/app.js - Programme and competencies
src/shared/program.ts - Daily activities
src/shared/activities.ts - Briefs and debriefs
src/shared/review/debrief.ts - Review checks
src/shared/review/engine.ts - GitHub follow-up
src/shared/github.ts
Shared services
- AI services
src/shared/ai.ts - Class identity
src/shared/identity.ts - Discord API helpers
src/shared/discord.ts - Shared D1 data
src/shared/db.ts - Built-in programme
src/shared/programs/dwwm-2026.ts
External systems
- Discord
- GitHub
- HackerRank
- Code runners
- AI providers
Other components
- Students
- Teachers
Connections 30
- Students → Discord: use commands
README.md - Discord → Public Worker: sends interactions
README.md - Public Worker → Discord interactions: routes requests
src/bot/index.ts - Discord interactions → Challenges and games: handles practice
- Students → Public Worker: open student pages
README.md - Public Worker → Code editor: routes editor
src/bot/index.ts - Students → Learning pages: browse learning
README.md - Students → Assessments: complete assessments
README.md - Teachers → Teacher dashboard: manage class
README.md - Teacher dashboard → Admin Worker: calls dashboard
README.md - Admin Worker → Dashboard API: routes API
src/admin/index.ts - Dashboard API → Programme and competencies: manages programme
src/admin/api.ts - Dashboard API → Daily activities: manages activities
src/admin/api.ts - Dashboard API → Briefs and debriefs: manages reviews
- Briefs and debriefs → Review checks: uses checks
src/shared/review/debrief.ts - Briefs and debriefs → GitHub follow-up: reads project work
src/shared/review/debrief.ts - GitHub → Public Worker: sends webhook
README.md - GitHub follow-up → GitHub: fetches repositories
README.md - Public Worker → Scheduled jobs: runs scheduled work
README.md - Scheduled jobs → Shared D1 data: updates class jobs
README.md - Programme and competencies → Built-in programme: loads built-in
src/shared/program.ts - Dashboard API → Shared D1 data: reads and writes
src/admin/api.ts - Discord interactions → Shared D1 data: uses shared data
- Assessments → Shared D1 data: stores assessments
src/shared/assess.ts - Discord interactions → Discord API helpers: sends messages
- Briefs and debriefs → AI services: requests AI review
src/shared/review/debrief.ts - AI services → AI providers: generates responses
- Challenges and games → HackerRank: uses contest boards
README.md - Code editor → Code runners: runs submissions
README.md - Discord interactions → Class identity: resolves class identity