# umesh-patra/bput-erp architecture

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

- Interactive diagram: https://gitdiagram.com/umesh-patra/bput-erp
- Repository: https://github.com/umesh-patra/bput-erp

## Overview

BPUT Digital Campus is a university portal with public notices, student self-service, and an admin/dean console. The main workflow is a student entering through student authentication, using dashboard services to submit or track campus requests, with changes persisted and synchronized through Supabase. Admins handle those requests and publish student-facing materials. The README documents these product capabilities, but the frontend implementation files it lists are absent from the supplied tree; therefore, feature nodes point to the available HTML pages, and frontend-to-Supabase links reflect documentation rather than inspected code.

Main entry points: [`student.html`](https://github.com/umesh-patra/bput-erp/blob/main/student.html) (Student Dashboard), [`admin.html`](https://github.com/umesh-patra/bput-erp/blob/main/admin.html) (Admin Console), [`index.html`](https://github.com/umesh-patra/bput-erp/blob/main/index.html) (Public Portal), [`student-auth.html`](https://github.com/umesh-patra/bput-erp/blob/main/student-auth.html) (Student Login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["Web Portals"]
  node_public_portal["Public Portal<br/>[index.html]"]
  node_student_auth["Student Login<br/>[student-auth.html]"]
  node_student_dashboard["Student Dashboard<br/>[student.html]"]
  node_admin_auth["Admin Login<br/>[admin-auth.html]"]
  node_admin_console["Admin Console<br/>[admin.html]"]
end

subgraph group_student["Student Services"]
  node_campus_requests["Campus Requests<br/>[student.html]"]
  node_student_materials["Assignments &amp; Datesheets<br/>[student.html]"]
  node_lost_found["Lost &amp; Found<br/>[index.html]"]
end

subgraph group_admin["Administration"]
  node_request_review["Request Handling<br/>[admin.html]"]
  node_campus_notices["Notices &amp; Circulars<br/>[admin.html]"]
  node_academic_uploads["Academic Uploads<br/>[admin.html]"]
end

subgraph group_runtime["Serving and Data"]
  node_supabase[("Supabase")]
  node_node_server["Node Static Server<br/>[server.js]"]
  node_python_server["Python Static Server<br/>[server.py]"]
end

node_student_actor(("Student"))
node_admin_actor(("Admin / Dean"))

node_student_actor -->|"signs in"| node_student_auth
node_student_auth -.->|"enters portal"| node_student_dashboard
node_student_actor -->|"views notices"| node_public_portal
node_student_dashboard -->|"uses services"| node_campus_requests
node_student_dashboard -->|"views materials"| node_student_materials
node_student_dashboard -->|"uses board"| node_lost_found
node_admin_actor -->|"signs in"| node_admin_auth
node_admin_auth -.->|"enters console"| node_admin_console
node_admin_console -->|"handles requests"| node_request_review
node_admin_console -->|"manages notices"| node_campus_notices
node_admin_console -->|"uploads materials"| node_academic_uploads
node_student_dashboard -.->|"persists changes"| node_supabase
node_supabase -.->|"syncs updates"| node_student_dashboard
node_node_server -->|"serves files"| node_public_portal
node_python_server -->|"serves files"| node_public_portal

click node_public_portal "https://github.com/umesh-patra/bput-erp/blob/main/index.html"
click node_student_auth "https://github.com/umesh-patra/bput-erp/blob/main/student-auth.html"
click node_student_dashboard "https://github.com/umesh-patra/bput-erp/blob/main/student.html"
click node_admin_auth "https://github.com/umesh-patra/bput-erp/blob/main/admin-auth.html"
click node_admin_console "https://github.com/umesh-patra/bput-erp/blob/main/admin.html"
click node_campus_requests "https://github.com/umesh-patra/bput-erp/blob/main/student.html"
click node_student_materials "https://github.com/umesh-patra/bput-erp/blob/main/student.html"
click node_lost_found "https://github.com/umesh-patra/bput-erp/blob/main/index.html"
click node_request_review "https://github.com/umesh-patra/bput-erp/blob/main/admin.html"
click node_campus_notices "https://github.com/umesh-patra/bput-erp/blob/main/admin.html"
click node_academic_uploads "https://github.com/umesh-patra/bput-erp/blob/main/admin.html"
click node_node_server "https://github.com/umesh-patra/bput-erp/blob/main/server.js"
click node_python_server "https://github.com/umesh-patra/bput-erp/blob/main/server.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_public_portal,node_student_auth,node_student_dashboard,node_admin_auth,node_admin_console toneBlue
class node_campus_requests,node_student_materials,node_lost_found toneAmber
class node_request_review,node_campus_notices,node_academic_uploads toneMint
class node_supabase,node_node_server,node_python_server toneRose
class node_student_actor,node_admin_actor toneIndigo
```

## Components

### Web Portals

- [Public Portal](https://github.com/umesh-patra/bput-erp/blob/main/index.html): `index.html`
- [Student Login](https://github.com/umesh-patra/bput-erp/blob/main/student-auth.html): `student-auth.html`
- [Student Dashboard](https://github.com/umesh-patra/bput-erp/blob/main/student.html): `student.html`
- [Admin Login](https://github.com/umesh-patra/bput-erp/blob/main/admin-auth.html): `admin-auth.html`
- [Admin Console](https://github.com/umesh-patra/bput-erp/blob/main/admin.html): `admin.html`

### Student Services

- [Campus Requests](https://github.com/umesh-patra/bput-erp/blob/main/student.html): `student.html`
- [Assignments & Datesheets](https://github.com/umesh-patra/bput-erp/blob/main/student.html): `student.html`
- [Lost & Found](https://github.com/umesh-patra/bput-erp/blob/main/index.html): `index.html`

### Administration

- [Request Handling](https://github.com/umesh-patra/bput-erp/blob/main/admin.html): `admin.html`
- [Notices & Circulars](https://github.com/umesh-patra/bput-erp/blob/main/admin.html): `admin.html`
- [Academic Uploads](https://github.com/umesh-patra/bput-erp/blob/main/admin.html): `admin.html`

### Serving and Data

- **Supabase**
- [Node Static Server](https://github.com/umesh-patra/bput-erp/blob/main/server.js): `server.js`
- [Python Static Server](https://github.com/umesh-patra/bput-erp/blob/main/server.py): `server.py`

### Other components

- **Student**
- **Admin / Dean**

## Connections

- Student → Student Login: signs in (evidence: `README.md`)
- Student Login → Student Dashboard: enters portal
- Student → Public Portal: views notices (evidence: `README.md`)
- Student Dashboard → Campus Requests: uses services (evidence: `README.md`)
- Student Dashboard → Assignments & Datesheets: views materials (evidence: `README.md`)
- Student Dashboard → Lost & Found: uses board (evidence: `README.md`)
- Admin / Dean → Admin Login: signs in (evidence: `README.md`)
- Admin Login → Admin Console: enters console
- Admin Console → Request Handling: handles requests (evidence: `README.md`)
- Admin Console → Notices & Circulars: manages notices (evidence: `README.md`)
- Admin Console → Academic Uploads: uploads materials (evidence: `README.md`)
- Student Dashboard → Supabase: persists changes (evidence: `README.md`)
- Supabase → Student Dashboard: syncs updates (evidence: `README.md`)
- Node Static Server → Public Portal: serves files (evidence: `server.js`)
- Python Static Server → Public Portal: serves files (evidence: `server.py`)
