# kishoreselvam4567-pixel/amala-school-erp architecture

> Architecture diagram of the GitHub repository kishoreselvam4567-pixel/amala-school-erp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kishoreselvam4567-pixel/amala-school-erp
- Repository: https://github.com/kishoreselvam4567-pixel/amala-school-erp

## Overview

School ERP is a role-separated campus portal: students and parents use the public site, while staff and administrators use an unlinked internal site. The main evidenced flow is login, role/profile validation, then portal access; documented portal capabilities include attendance, marks, exams, notes, homework, announcements, and staff administration. The sampled code shows Supabase-backed authentication and data helpers. Most dashboard implementations were not sampled, so their feature relationships are documented at the subsystem level rather than inferred as call chains.

Main entry points: [`public/student/dashboard.html`](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/student/dashboard.html) (Student portal), [`public/internal/admin/dashboard.html`](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/admin/dashboard.html) (Admin portal), [`public/login.html`](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/login.html) (Public login), [`public/internal/login.html`](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/login.html) (Staff login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public portals"]
  node_public_login["Public login<br/>[login.html]"]
  node_registration["Self-registration<br/>[register.html]"]
  node_student_portal["Student portal<br/>[dashboard.html]"]
  node_parent_portal["Parent portal<br/>[dashboard.html]"]
end

subgraph group_internal["Internal portals"]
  node_internal_login["Staff login<br/>[login.html]"]
  node_staff_portal["Staff portal<br/>[dashboard.html]"]
  node_admin_portal["Admin portal<br/>[dashboard.html]"]
  node_staff_admin["Staff administration<br/>[dashboard.html]"]
end

subgraph group_shared["Shared services"]
  node_public_auth["Public auth helpers<br/>[auth.js]"]
  node_public_config["Public Supabase config<br/>[supabase-config.js]"]
  node_internal_auth["Internal auth helpers<br/>[auth.js]"]
  node_internal_config["Internal Supabase config<br/>[supabase-config.js]"]
  node_notifications["Live notifications<br/>[notifications.js]"]
  node_supabase[("Supabase services")]
  node_attendance["Attendance"]
  node_marks_exams["Marks and exams"]
  node_learning_materials["Notes and homework"]
  node_announcements["Announcements<br/>[notifications.js]"]
end

subgraph group_login["Login entry"]
  node_login_page["Login page<br/>[page.js]"]
  node_supabase_client["Next Supabase client<br/>[supabase.js]"]
end

node_visitor(("School user"))

node_visitor -->|"enters credentials"| node_login_page
node_login_page -->|"authenticates and queries"| node_supabase_client
node_supabase_client -->|"connects to"| node_supabase
node_visitor -->|"opens portal"| node_public_login
node_visitor -->|"registers account"| node_registration
node_visitor -->|"opens staff URL"| node_internal_login
node_public_auth -->|"loads config"| node_public_config
node_internal_auth -->|"loads config"| node_internal_config
node_public_auth -->|"authenticates and accesses data"| node_supabase
node_internal_auth -->|"authenticates and accesses data"| node_supabase
node_notifications -->|"uses query helpers"| node_public_auth
node_public_login -->|"routes by role"| node_student_portal
node_public_login -->|"routes by role"| node_parent_portal
node_internal_login -->|"checks role then admits"| node_staff_portal
node_internal_login -->|"checks role then admits"| node_admin_portal
node_admin_portal -->|"creates staff accounts"| node_staff_admin
node_student_portal -->|"provides access to"| node_attendance
node_staff_portal -->|"manages"| node_attendance
node_admin_portal -->|"provides management"| node_marks_exams
node_student_portal -->|"provides access to"| node_marks_exams
node_student_portal -->|"provides access to"| node_learning_materials
node_staff_portal -->|"manages"| node_learning_materials
node_notifications -->|"subscribes to"| node_announcements
node_admin_portal -.->|"publishes"| node_announcements

click node_login_page "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/app/page.js"
click node_supabase_client "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/lib/supabase.js"
click node_public_auth "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/js/auth.js"
click node_public_config "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/js/supabase-config.js"
click node_internal_auth "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/js/auth.js"
click node_internal_config "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/js/supabase-config.js"
click node_notifications "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/js/notifications.js"
click node_public_login "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/login.html"
click node_registration "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/register.html"
click node_student_portal "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/student/dashboard.html"
click node_parent_portal "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/parent/dashboard.html"
click node_internal_login "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/login.html"
click node_staff_portal "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/staff/dashboard.html"
click node_admin_portal "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/admin/dashboard.html"
click node_attendance "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/supabase-schema.sql"
click node_marks_exams "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/supabase-schema.sql"
click node_learning_materials "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/supabase-schema.sql"
click node_announcements "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/js/notifications.js"
click node_staff_admin "https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/admin/dashboard.html"

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_login,node_registration,node_student_portal,node_parent_portal,node_visitor toneBlue
class node_internal_login,node_staff_portal,node_admin_portal,node_staff_admin toneAmber
class node_public_auth,node_public_config,node_internal_auth,node_internal_config,node_notifications,node_supabase,node_attendance,node_marks_exams,node_learning_materials,node_announcements toneMint
class node_login_page,node_supabase_client toneRose
```

## Components

### Public portals

- [Public login](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/login.html): `public/login.html`
- [Self-registration](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/register.html): `public/register.html`
- [Student portal](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/student/dashboard.html): `public/student/dashboard.html`
- [Parent portal](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/parent/dashboard.html): `public/parent/dashboard.html`

### Internal portals

- [Staff login](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/login.html): `public/internal/login.html`
- [Staff portal](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/staff/dashboard.html): `public/internal/staff/dashboard.html`
- [Admin portal](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/admin/dashboard.html): `public/internal/admin/dashboard.html`
- [Staff administration](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/admin/dashboard.html): `public/internal/admin/dashboard.html`

### Shared services

- [Public auth helpers](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/js/auth.js): `public/js/auth.js`
- [Public Supabase config](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/js/supabase-config.js): `public/js/supabase-config.js`
- [Internal auth helpers](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/js/auth.js): `public/internal/js/auth.js`
- [Internal Supabase config](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/internal/js/supabase-config.js): `public/internal/js/supabase-config.js`
- [Live notifications](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/js/notifications.js): `public/js/notifications.js`
- **Supabase services**
- [Attendance](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/supabase-schema.sql): `supabase-schema.sql`
- [Marks and exams](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/supabase-schema.sql): `supabase-schema.sql`
- [Notes and homework](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/supabase-schema.sql): `supabase-schema.sql`
- [Announcements](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/public/js/notifications.js): `public/js/notifications.js`

### Login entry

- [Login page](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/app/page.js): `app/page.js`
- [Next Supabase client](https://github.com/kishoreselvam4567-pixel/amala-school-erp/blob/main/lib/supabase.js): `lib/supabase.js`

### Other components

- **School user**

## Connections

- School user → Login page: enters credentials (evidence: `app/page.js`)
- Login page → Next Supabase client: authenticates and queries (evidence: `app/page.js`)
- Next Supabase client → Supabase services: connects to (evidence: `lib/supabase.js`)
- School user → Public login: opens portal (evidence: `README.md`)
- School user → Self-registration: registers account (evidence: `README.md`)
- School user → Staff login: opens staff URL (evidence: `README.md`)
- Public auth helpers → Public Supabase config: loads config (evidence: `public/js/auth.js`)
- Internal auth helpers → Internal Supabase config: loads config (evidence: `public/internal/js/auth.js`)
- Public auth helpers → Supabase services: authenticates and accesses data (evidence: `public/js/auth.js`)
- Internal auth helpers → Supabase services: authenticates and accesses data (evidence: `public/internal/js/auth.js`)
- Live notifications → Public auth helpers: uses query helpers (evidence: `public/js/notifications.js`)
- Public login → Student portal: routes by role (evidence: `README.md`)
- Public login → Parent portal: routes by role (evidence: `README.md`)
- Staff login → Staff portal: checks role then admits (evidence: `README.md`)
- Staff login → Admin portal: checks role then admits (evidence: `README.md`)
- Admin portal → Staff administration: creates staff accounts (evidence: `README.md`)
- Student portal → Attendance: provides access to (evidence: `README.md`)
- Staff portal → Attendance: manages (evidence: `README.md`)
- Admin portal → Marks and exams: provides management (evidence: `README.md`)
- Student portal → Marks and exams: provides access to (evidence: `README.md`)
- Student portal → Notes and homework: provides access to (evidence: `README.md`)
- Staff portal → Notes and homework: manages (evidence: `README.md`)
- Live notifications → Announcements: subscribes to (evidence: `public/js/notifications.js`)
- Admin portal → Announcements: publishes
