How ahmedsheikh27/agentic_student_management works
Campus Admin AI is a student-record and campus-information application. Administrators use the chat UI to ask questions or request record changes; the frontend sends chat requests to the FastAPI app, which runs the agent and returns a reply. The app also exposes direct student and analytics endpoints, while the agent’s tools query student/activity data and retrieve FAQ context from a FAISS index. The sampled chat page confirms its HTTP calls; connections from the separate student and analytics screens are left unverified because their request code was not excerpted.
Main entry points: main.py FastAPI app · database.py DB sessions · tools.py Admin tools · models.py Student and activity models
Components 16
Admin frontend
- Chat interface
chat-fe/app/page.tsx - Student screens
chat-fe/app/students/page.tsx - Analytics screens
chat-fe/app/analytics/page.tsx - App shell
chat-fe/app/layout.tsx
Backend API
- FastAPI app
campus-backend/main.py - Student router
campus-backend/routers/students.py - Request schemas
campus-backend/schemas.py
Agent and tools
- Campus agent
campus-backend/agent.py - Admin tools
campus-backend/tools.py - Message guardrail
campus-backend/utils/guardrails.py
Data and knowledge
- DB sessions
campus-backend/database.py - DB settings
campus-backend/config.py - Student and activity models
campus-backend/models.py - Supabase Postgres
- FAQ vector index
campus-backend/tools.py
Other components
- Administrator
Connections 21
- Administrator → Chat interface: asks questions
chat-fe/app/page.tsx - Chat interface → FastAPI app: posts chat
chat-fe/app/page.tsx - FastAPI app → Campus agent: runs agent
campus-backend/main.py - Campus agent → Admin tools: registers tools
campus-backend/agent.py - Campus agent → Message guardrail: imports guardrail
campus-backend/agent.py - FastAPI app → Request schemas: validates requests
campus-backend/main.py - FastAPI app → DB sessions: gets DB sessions
campus-backend/main.py - FastAPI app → Student and activity models: queries records
campus-backend/main.py - Student router → DB sessions: opens sessions
campus-backend/routers/students.py - Student router → Student and activity models: queries records
campus-backend/routers/students.py - Admin tools → DB sessions: opens sessions
campus-backend/tools.py - Admin tools → Student and activity models: queries records
campus-backend/tools.py - DB sessions → DB settings: loads URL
campus-backend/database.py - DB sessions → Supabase Postgres: creates engine
campus-backend/database.py - Student and activity models → DB sessions: uses base
campus-backend/models.py - Admin tools → FAQ vector index: searches FAQs
campus-backend/tools.py - Administrator → Student screens: manages records
- Administrator → Analytics screens: views analytics
- Student screens → FastAPI app: requests records
- Analytics screens → FastAPI app: requests analytics
- App shell → Chat interface: hosts page