How timwonderer/classroom-token-hub works
Classroom Token Hub is a multi-tenant classroom management platform built around a simulated token economy. Teachers configure classes and features, then manage attendance, payroll, store purchases, rent, insurance, and student issues; students use a portal to participate, transact, and request help. Ledger effects begin pending and scheduled settlement admits them to immutable posted history. The graph reflects documented product stages and major capabilities; several route-to-domain links are inferred from the product description because the sampled route and feature source was incomplete.
Main entry points: admin.py Teacher portal · student.py Student portal · ledger_command_service.py Ledger services · obligations_service.py Rent obligations
Components 19
User surfaces
- Teacher portal
app/routes/admin.py - Student portal
app/routes/student.py - Admin portal
app/routes/system_admin.py
Classroom operations
- Class configuration
app/feats/class_configuration - Attendance
app/services/attendance_service.py - Payroll
app/services/payroll - Classroom store
app/services/store_service.py - Rent obligations
app/services/obligations_service.py - Insurance
app/services/insurance_claim_service.py - Account recovery
app/services/recovery_service.py - Issue handling
app/services/issue_service.py
Economic services
- Economic engine
app/services/economic_engine.py - Ledger services
app/services/ledger_command_service.py - Cycle interpretation
app/services/interpretation/read_service.py
Platform runtime
- PostgreSQL state
app/models.py - Scheduled jobs
app/scheduled_tasks.py
Other components
- Teacher
- Student
- System admin
Connections 30
- Teacher → Teacher portal: uses
- Student → Student portal: uses
- System admin → Admin portal: uses
- Teacher portal → Class configuration: configures
- Teacher portal → Attendance: manages
- Teacher portal → Payroll: runs
- Teacher portal → Classroom store: manages
- Teacher portal → Rent obligations: reconciles
- Teacher portal → Insurance: manages
- Student portal → Attendance: records
- Student portal → Classroom store: purchases
- Student portal → Rent obligations: views
- Student portal → Insurance: claims
- Student portal → Account recovery: requests
- Student portal → Issue handling: reports
- Class configuration → Economic engine: evolves policy
- Economic engine → PostgreSQL state: reads and versions
- Attendance → PostgreSQL state: records sessions
- Payroll → Ledger services: posts pay
- Classroom store → Ledger services: records purchases
- Rent obligations → Ledger services: records dues
- Insurance → Rent obligations: checks premiums
- Ledger services → PostgreSQL state: writes pending entries
- Scheduled jobs → Ledger services: settles entries
- Scheduled jobs → Payroll: runs cycles
- Scheduled jobs → Rent obligations: reconciles rent
- Cycle interpretation → Ledger services: reads history
- Cycle interpretation → Payroll: corroborates events
- Cycle interpretation → PostgreSQL state: reads cycle facts
- Admin portal → PostgreSQL state: reviews accounts