# abhinavvel2006/student-enrollment-system architecture

> Architecture diagram of the GitHub repository abhinavvel2006/student-enrollment-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abhinavvel2006/student-enrollment-system
- Repository: https://github.com/abhinavvel2006/student-enrollment-system

## Overview

This Flask student-enrollment system supports applicant submissions, staff review and decisions, and ongoing student account/profile access; it also provides a rule-based enrollment chatbot. Requests enter through the Flask routes, which dispatch to user or admin handlers. Those handlers query MySQL directly, while configuration supplies database and session settings. The tree also shows a joined-date migration and an email integration used by the admin module, though the sampled admin excerpts do not show the email call site. Template and other unsampled UI relationships are omitted where source evidence is unavailable.

Main entry points: [`main.py`](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/main.py) (Route dispatcher), [`config.py`](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/config.py) (Runtime configuration), [`auth/user_auth/user.py`](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/user_auth/user.py) (Admission submission), [`auth/admin_auth/admin.py`](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/admin_auth/admin.py) (Application review and decisions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web entry and UI"]
  node_flask["Route dispatcher<br/>[main.py]"]
  node_landing["Enrollment landing page<br/>[index.html]"]
  node_chat_ui["Chat interface<br/>[Script.js]"]
end

subgraph group_enrollment["Enrollment workflows"]
  node_admission["Admission submission<br/>[user.py]"]
  node_chatbot["Enrollment chatbot<br/>[user.py]"]
  node_admin_auth["Admin authentication<br/>[admin.py]"]
  node_application_review["Application review and decisions<br/>[admin.py]"]
end

subgraph group_records["Student records"]
  node_student_access["Student login and profile<br/>[user.py]"]
  node_student_management["Student admission and management<br/>[admin.py]"]
end

subgraph group_integrations["State and integrations"]
  node_mysql[("MySQL records")]
  node_configuration["Runtime configuration<br/>[config.py]"]
  node_email_sender["Admission email sender<br/>[email.py]"]
  node_joined_migration["Joined-date migration"]
end

node_applicant(("Applicant"))
node_administrator(("Administrator"))
node_brevo["Brevo email service"]

node_applicant -->|"submits requests"| node_flask
node_administrator -->|"uses admin routes"| node_flask
node_flask -->|"renders"| node_landing
node_flask -->|"dispatches admission"| node_admission
node_flask -->|"dispatches chat"| node_chatbot
node_flask -->|"dispatches student access"| node_student_access
node_flask -->|"dispatches admin login"| node_admin_auth
node_flask -->|"dispatches decisions"| node_application_review
node_flask -->|"dispatches management"| node_student_management
node_chat_ui -->|"posts messages"| node_chatbot
node_admission -->|"writes application"| node_mysql
node_student_access -->|"reads student records"| node_mysql
node_application_review -->|"reads and updates"| node_mysql
node_student_management -->|"reads and updates"| node_mysql
node_flask -->|"loads secret key"| node_configuration
node_admission -->|"loads database settings"| node_configuration
node_student_access -->|"loads database settings"| node_configuration
node_admin_auth -->|"loads database settings"| node_configuration
node_application_review -.->|"may send acceptance email"| node_email_sender
node_email_sender -->|"sends email"| node_brevo
node_joined_migration -->|"backfills joined dates"| node_mysql
node_joined_migration -->|"loads database settings"| node_configuration

click node_flask "https://github.com/abhinavvel2006/student-enrollment-system/blob/main/main.py"
click node_landing "https://github.com/abhinavvel2006/student-enrollment-system/blob/main/templates/user/index.html"
click node_admission "https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/user_auth/user.py"
click node_chatbot "https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/user_auth/user.py"
click node_student_access "https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/user_auth/user.py"
click node_admin_auth "https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/admin_auth/admin.py"
click node_application_review "https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/admin_auth/admin.py"
click node_student_management "https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/admin_auth/admin.py"
click node_configuration "https://github.com/abhinavvel2006/student-enrollment-system/blob/main/config.py"
click node_email_sender "https://github.com/abhinavvel2006/student-enrollment-system/blob/main/utils/email.py"
click node_joined_migration "https://github.com/abhinavvel2006/student-enrollment-system/blob/main/database/migrate_joined_at.py"
click node_chat_ui "https://github.com/abhinavvel2006/student-enrollment-system/blob/main/static/js/Script.js"

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_flask,node_landing,node_chat_ui toneBlue
class node_admission,node_chatbot,node_admin_auth,node_application_review toneAmber
class node_student_access,node_student_management toneMint
class node_mysql,node_configuration,node_email_sender,node_joined_migration toneRose
class node_applicant,node_administrator,node_brevo toneIndigo
```

## Components

### Web entry and UI

- [Route dispatcher](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/main.py): `main.py`
- [Enrollment landing page](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/templates/user/index.html): `templates/user/index.html`
- [Chat interface](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/static/js/Script.js): `static/js/Script.js`

### Enrollment workflows

- [Admission submission](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/user_auth/user.py): `auth/user_auth/user.py`
- [Enrollment chatbot](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/user_auth/user.py): `auth/user_auth/user.py`
- [Admin authentication](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/admin_auth/admin.py): `auth/admin_auth/admin.py`
- [Application review and decisions](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/admin_auth/admin.py): `auth/admin_auth/admin.py`

### Student records

- [Student login and profile](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/user_auth/user.py): `auth/user_auth/user.py`
- [Student admission and management](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/auth/admin_auth/admin.py): `auth/admin_auth/admin.py`

### State and integrations

- **MySQL records**
- [Runtime configuration](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/config.py): `config.py`
- [Admission email sender](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/utils/email.py): `utils/email.py`
- [Joined-date migration](https://github.com/abhinavvel2006/student-enrollment-system/blob/main/database/migrate_joined_at.py): `database/migrate_joined_at.py`

### Other components

- **Applicant**
- **Administrator**
- **Brevo email service**

## Connections

- Applicant → Route dispatcher: submits requests (evidence: `main.py`)
- Administrator → Route dispatcher: uses admin routes (evidence: `main.py`)
- Route dispatcher → Enrollment landing page: renders (evidence: `main.py`)
- Route dispatcher → Admission submission: dispatches admission (evidence: `main.py`)
- Route dispatcher → Enrollment chatbot: dispatches chat (evidence: `main.py`)
- Route dispatcher → Student login and profile: dispatches student access (evidence: `main.py`)
- Route dispatcher → Admin authentication: dispatches admin login (evidence: `main.py`)
- Route dispatcher → Application review and decisions: dispatches decisions (evidence: `main.py`)
- Route dispatcher → Student admission and management: dispatches management (evidence: `main.py`)
- Chat interface → Enrollment chatbot: posts messages (evidence: `static/js/Script.js`)
- Admission submission → MySQL records: writes application (evidence: `auth/user_auth/user.py`)
- Student login and profile → MySQL records: reads student records (evidence: `auth/user_auth/user.py`)
- Application review and decisions → MySQL records: reads and updates (evidence: `auth/admin_auth/admin.py`)
- Student admission and management → MySQL records: reads and updates (evidence: `auth/admin_auth/admin.py`)
- Route dispatcher → Runtime configuration: loads secret key (evidence: `main.py`)
- Admission submission → Runtime configuration: loads database settings (evidence: `auth/user_auth/user.py`)
- Student login and profile → Runtime configuration: loads database settings (evidence: `auth/user_auth/user.py`)
- Admin authentication → Runtime configuration: loads database settings (evidence: `auth/admin_auth/admin.py`)
- Application review and decisions → Admission email sender: may send acceptance email (evidence: `auth/admin_auth/admin.py`)
- Admission email sender → Brevo email service: sends email (evidence: `utils/email.py`)
- Joined-date migration → MySQL records: backfills joined dates (evidence: `database/migrate_joined_at.py`)
- Joined-date migration → Runtime configuration: loads database settings (evidence: `database/migrate_joined_at.py`)
