# luvanidixit101/gvp_ai_hackathon_2026 architecture

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

- Interactive diagram: https://gitdiagram.com/luvanidixit101/gvp_ai_hackathon_2026
- Repository: https://github.com/luvanidixit101/gvp_ai_hackathon_2026

## Overview

This Django application lets staff manage students, record attendance and marks, and review calculated reports and warnings. The main workflow is browser request → project and tracker routing → view logic → model-backed data and helper calculations → rendered page. Sample-data generation is a separate view workflow that creates students and their attendance and marks. The README also documents Django admin access. The view excerpt is partial, so links for unsampled view behavior are limited to documented features and visible routing.

Main entry points: [`tracker/views.py`](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/views.py) (Request workflows), [`tracker/models.py`](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/models.py) (Student records), [`tracker/admin.py`](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/admin.py) (Admin interface), [`attendance_tracker/settings.py`](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/attendance_tracker/settings.py) (SQLite database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_project_routes["Project routes<br/>[urls.py]"]
  node_tracker_routes["Tracker routes<br/>[urls.py]"]
  node_pages["Tracker pages"]
end

subgraph group_workflow["Tracker workflows"]
  node_views["Request workflows<br/>[views.py]"]
  node_helpers["AI-assisted helpers<br/>[ai_helpers.py]"]
  node_admin["Admin interface<br/>[admin.py]"]
end

subgraph group_domain["Domain and storage"]
  node_students["Student records<br/>[models.py]"]
  node_attendance["Attendance records<br/>[models.py]"]
  node_marks["Marks records<br/>[models.py]"]
  node_database[("SQLite database<br/>[settings.py]")]
end

node_staff(("Staff user"))

node_staff -->|"sends request"| node_project_routes
node_project_routes -->|"includes routes"| node_tracker_routes
node_tracker_routes -->|"dispatches"| node_views
node_views -->|"calls"| node_helpers
node_views -->|"reads and writes"| node_students
node_views -->|"reads and writes"| node_attendance
node_views -->|"reads and writes"| node_marks
node_views -->|"renders"| node_pages
node_students -->|"relates records"| node_attendance
node_students -->|"relates records"| node_marks
node_students -->|"persists"| node_database
node_attendance -->|"persists"| node_database
node_marks -->|"persists"| node_database
node_staff -.->|"uses admin"| node_admin
node_admin -->|"manages records"| node_students
node_admin -->|"manages records"| node_attendance
node_admin -->|"manages records"| node_marks

click node_project_routes "https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/attendance_tracker/urls.py"
click node_tracker_routes "https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/urls.py"
click node_pages "https://github.com/luvanidixit101/gvp_ai_hackathon_2026/tree/main/tracker/templates/tracker"
click node_views "https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/views.py"
click node_helpers "https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/ai_helpers.py"
click node_admin "https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/admin.py"
click node_students "https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/models.py"
click node_attendance "https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/models.py"
click node_marks "https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/models.py"
click node_database "https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/attendance_tracker/settings.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_project_routes,node_tracker_routes,node_pages,node_staff toneBlue
class node_views,node_helpers,node_admin toneAmber
class node_students,node_attendance,node_marks,node_database toneMint
```

## Components

### Web interface

- [Project routes](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/attendance_tracker/urls.py): `attendance_tracker/urls.py`
- [Tracker routes](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/urls.py): `tracker/urls.py`
- [Tracker pages](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/tree/main/tracker/templates/tracker): `tracker/templates/tracker`

### Tracker workflows

- [Request workflows](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/views.py): `tracker/views.py`
- [AI-assisted helpers](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/ai_helpers.py): `tracker/ai_helpers.py`
- [Admin interface](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/admin.py): `tracker/admin.py`

### Domain and storage

- [Student records](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/models.py): `tracker/models.py`
- [Attendance records](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/models.py): `tracker/models.py`
- [Marks records](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/tracker/models.py): `tracker/models.py`
- [SQLite database](https://github.com/luvanidixit101/gvp_ai_hackathon_2026/blob/main/attendance_tracker/settings.py): `attendance_tracker/settings.py`

### Other components

- **Staff user**

## Connections

- Staff user → Project routes: sends request
- Project routes → Tracker routes: includes routes
- Tracker routes → Request workflows: dispatches
- Request workflows → AI-assisted helpers: calls
- Request workflows → Student records: reads and writes
- Request workflows → Attendance records: reads and writes
- Request workflows → Marks records: reads and writes
- Request workflows → Tracker pages: renders
- Student records → Attendance records: relates records
- Student records → Marks records: relates records
- Student records → SQLite database: persists
- Attendance records → SQLite database: persists
- Marks records → SQLite database: persists
- Staff user → Admin interface: uses admin
- Admin interface → Student records: manages records
- Admin interface → Attendance records: manages records
- Admin interface → Marks records: manages records