# ahmedsheikh27/agentic_student_management architecture

> Architecture diagram of the GitHub repository ahmedsheikh27/agentic_student_management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ahmedsheikh27/agentic_student_management
- Repository: https://github.com/ahmedsheikh27/agentic_student_management

## Overview

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: [`campus-backend/main.py`](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/main.py) (FastAPI app), [`campus-backend/database.py`](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/database.py) (DB sessions), [`campus-backend/tools.py`](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/tools.py) (Admin tools), [`campus-backend/models.py`](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/models.py) (Student and activity models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Admin frontend"]
  node_chat_ui["Chat interface<br/>[page.tsx]"]
  node_student_ui["Student screens<br/>[page.tsx]"]
  node_analytics_ui["Analytics screens<br/>[page.tsx]"]
  node_app_shell["App shell<br/>[layout.tsx]"]
end

subgraph group_api["Backend API"]
  node_api_app["FastAPI app<br/>[main.py]"]
  node_student_router["Student router<br/>[students.py]"]
  node_request_schemas["Request schemas<br/>[schemas.py]"]
end

subgraph group_assistant["Agent and tools"]
  node_agent["Campus agent<br/>[agent.py]"]
  node_tool_suite["Admin tools<br/>[tools.py]"]
  node_guardrails["Message guardrail<br/>[guardrails.py]"]
end

subgraph group_data["Data and knowledge"]
  node_db_session["DB sessions<br/>[database.py]"]
  node_settings["DB settings<br/>[config.py]"]
  node_student_models["Student and activity models<br/>[models.py]"]
  node_sql_store[("Supabase Postgres")]
  node_faq_index[("FAQ vector index<br/>[tools.py]")]
end

node_admin(("Administrator"))

node_admin -->|"asks questions"| node_chat_ui
node_chat_ui -->|"posts chat"| node_api_app
node_api_app -->|"runs agent"| node_agent
node_agent -->|"registers tools"| node_tool_suite
node_agent -->|"imports guardrail"| node_guardrails
node_api_app -->|"validates requests"| node_request_schemas
node_api_app -->|"gets DB sessions"| node_db_session
node_api_app -->|"queries records"| node_student_models
node_student_router -->|"opens sessions"| node_db_session
node_student_router -->|"queries records"| node_student_models
node_tool_suite -->|"opens sessions"| node_db_session
node_tool_suite -->|"queries records"| node_student_models
node_db_session -->|"loads URL"| node_settings
node_db_session -->|"creates engine"| node_sql_store
node_student_models -->|"uses base"| node_db_session
node_tool_suite -->|"searches FAQs"| node_faq_index
node_admin -.->|"manages records"| node_student_ui
node_admin -.->|"views analytics"| node_analytics_ui
node_student_ui -.->|"requests records"| node_api_app
node_analytics_ui -.->|"requests analytics"| node_api_app
node_app_shell -.->|"hosts page"| node_chat_ui

click node_chat_ui "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/chat-fe/app/page.tsx"
click node_student_ui "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/chat-fe/app/students/page.tsx"
click node_analytics_ui "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/chat-fe/app/analytics/page.tsx"
click node_app_shell "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/chat-fe/app/layout.tsx"
click node_api_app "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/main.py"
click node_student_router "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/routers/students.py"
click node_request_schemas "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/schemas.py"
click node_agent "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/agent.py"
click node_tool_suite "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/tools.py"
click node_guardrails "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/utils/guardrails.py"
click node_db_session "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/database.py"
click node_settings "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/config.py"
click node_student_models "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/models.py"
click node_faq_index "https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/tools.py"

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_chat_ui,node_student_ui,node_analytics_ui,node_app_shell toneBlue
class node_api_app,node_student_router,node_request_schemas toneAmber
class node_agent,node_tool_suite,node_guardrails toneMint
class node_db_session,node_settings,node_student_models,node_sql_store,node_faq_index toneRose
class node_admin toneIndigo
```

## Components

### Admin frontend

- [Chat interface](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/chat-fe/app/page.tsx): `chat-fe/app/page.tsx`
- [Student screens](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/chat-fe/app/students/page.tsx): `chat-fe/app/students/page.tsx`
- [Analytics screens](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/chat-fe/app/analytics/page.tsx): `chat-fe/app/analytics/page.tsx`
- [App shell](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/chat-fe/app/layout.tsx): `chat-fe/app/layout.tsx`

### Backend API

- [FastAPI app](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/main.py): `campus-backend/main.py`
- [Student router](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/routers/students.py): `campus-backend/routers/students.py`
- [Request schemas](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/schemas.py): `campus-backend/schemas.py`

### Agent and tools

- [Campus agent](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/agent.py): `campus-backend/agent.py`
- [Admin tools](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/tools.py): `campus-backend/tools.py`
- [Message guardrail](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/utils/guardrails.py): `campus-backend/utils/guardrails.py`

### Data and knowledge

- [DB sessions](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/database.py): `campus-backend/database.py`
- [DB settings](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/config.py): `campus-backend/config.py`
- [Student and activity models](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/models.py): `campus-backend/models.py`
- **Supabase Postgres**
- [FAQ vector index](https://github.com/ahmedsheikh27/agentic_student_management/blob/master/campus-backend/tools.py): `campus-backend/tools.py`

### Other components

- **Administrator**

## Connections

- Administrator → Chat interface: asks questions (evidence: `chat-fe/app/page.tsx`)
- Chat interface → FastAPI app: posts chat (evidence: `chat-fe/app/page.tsx`)
- FastAPI app → Campus agent: runs agent (evidence: `campus-backend/main.py`)
- Campus agent → Admin tools: registers tools (evidence: `campus-backend/agent.py`)
- Campus agent → Message guardrail: imports guardrail (evidence: `campus-backend/agent.py`)
- FastAPI app → Request schemas: validates requests (evidence: `campus-backend/main.py`)
- FastAPI app → DB sessions: gets DB sessions (evidence: `campus-backend/main.py`)
- FastAPI app → Student and activity models: queries records (evidence: `campus-backend/main.py`)
- Student router → DB sessions: opens sessions (evidence: `campus-backend/routers/students.py`)
- Student router → Student and activity models: queries records (evidence: `campus-backend/routers/students.py`)
- Admin tools → DB sessions: opens sessions (evidence: `campus-backend/tools.py`)
- Admin tools → Student and activity models: queries records (evidence: `campus-backend/tools.py`)
- DB sessions → DB settings: loads URL (evidence: `campus-backend/database.py`)
- DB sessions → Supabase Postgres: creates engine (evidence: `campus-backend/database.py`)
- Student and activity models → DB sessions: uses base (evidence: `campus-backend/models.py`)
- Admin tools → FAQ vector index: searches FAQs (evidence: `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
