How agent369ai-cloud/school-operations-agent-platform works
This is a FastAPI school-operations backend: school administrators authenticate and provide roster or assignment data, while student chat updates and scheduled reminders support ongoing operations. The assignment path parses a brief, holds ambiguous details as a draft for clarification, and records workflow events; chat messages are routed to student-status intents and published to a live SSE stream. Authentication and tenant checks protect school data, with relational entities and a correlation-ID audit ledger underpinning workflows. Edges reflect shown imports, calls, or README claims; Telegram and submission behavior are represented from the tree and documentation, but their implementation details were not sampled.
Main entry points: models.py School domain and audit records · main.py FastAPI app · chat_mock.py Chat intent router · ingestion.py Assignment and roster intake
Components 21
API and interfaces
- FastAPI app
app/main.py - Dashboard page
app/templates/dashboard.html - SSE updates and timeline
app/routers/chat_mock.py - Telegram webhook
app/routers/telegram_webhook.py - Telegram integration
app/integrations/telegram.py - Message envelope
app/integrations/envelope.py
School workflows
- Chat intent router
app/routers/chat_mock.py - Assignment and roster intake
app/routers/ingestion.py - Brief parser
app/services/ai_parser.py - Parsed assignment schema
app/schemas.py - Reminder and policy engine
app/services/scheduler.py - Submission service
app/services/submission_service.py
Identity and access
- School registration and login
app/routers/auth.py - Token and role checks
app/auth/deps.py
Data and trace
- Runtime settings
app/config.py - Database sessions
app/database.py - School domain and audit records
app/models.py - Audit service
app/services/audit.py
Other components
- Teacher / admin
- Student / messaging client
- LLM service
Connections 23
- FastAPI app → Database sessions: initializes on startup
app/main.py - FastAPI app → Chat intent router: mounts router
app/main.py - FastAPI app → Assignment and roster intake: mounts router
app/main.py - FastAPI app → School registration and login: mounts router
app/main.py - FastAPI app → Dashboard page: renders page
app/main.py - Teacher / admin → Assignment and roster intake: uploads briefs and rosters
README.md - Assignment and roster intake → Brief parser: parses brief
app/routers/ingestion.py - Brief parser → LLM service: requests extraction
app/services/ai_parser.py - Brief parser → Parsed assignment schema: validates result
app/services/ai_parser.py - Assignment and roster intake → Reminder and policy engine: triggers reminders
app/routers/ingestion.py - Student / messaging client → Chat intent router: sends message
README.md - Chat intent router → SSE updates and timeline: publishes update
app/routers/chat_mock.py - Chat intent router → School domain and audit records: records event
app/routers/chat_mock.py - SSE updates and timeline → School domain and audit records: reads timeline
app/routers/chat_mock.py - School registration and login → School domain and audit records: reads and writes accounts
app/routers/auth.py - Token and role checks → Database sessions: uses sessions
app/auth/deps.py - Token and role checks → School domain and audit records: checks user and logs denial
app/auth/deps.py - Token and role checks → Runtime settings: uses signing settings
app/auth/deps.py - Database sessions → School domain and audit records: creates ORM tables
app/database.py - Audit service → School domain and audit records: uses audit records
app/services/audit.py - Reminder and policy engine → School domain and audit records: uses domain models
app/services/scheduler.py - Telegram webhook → Telegram integration
- Telegram webhook → Message envelope