# sakamuriajithsai09-png/parallel architecture

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

- Interactive diagram: https://gitdiagram.com/sakamuriajithsai09-png/parallel
- Repository: https://github.com/sakamuriajithsai09-png/parallel

## Overview

PARALLEL is a smart-campus complaint and issue-management application. Its core workflow is student submission and automatic categorization, admin assignment, staff repair and proof upload, admin verification, then student review or reopening. The server also serves the student and landing-page interfaces, supports role-based authentication, and exposes complaint and staff queries. Source excerpts show these responsibilities in server.js; the README is empty, and the HTML, data files, and most server routes were not sampled, so connections involving them are limited to directly evidenced ones.

Main entry points: [`server.js`](https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js) (Express API), [`db.json`](https://github.com/sakamuriajithsai09-png/parallel/blob/main/db.json) (JSON data store), [`public/parallel_student_app.html`](https://github.com/sakamuriajithsai09-png/parallel/blob/main/public/parallel_student_app.html) (Student app), [`public/index.html`](https://github.com/sakamuriajithsai09-png/parallel/blob/main/public/index.html) (Landing page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web entry points"]
  node_server["Express API<br/>[server.js]"]
  node_studentui["Student app"]
  node_landing["Landing page<br/>[index.html]"]
  node_vercelentry["Serverless entry<br/>[index.js]"]
  node_zipasset["Project download"]
end

subgraph group_auth["Identity"]
  node_authroutes["Role authentication<br/>[server.js]"]
  node_supabase["Supabase Auth"]
  node_migration["Account migration"]
end

subgraph group_complaints["Complaint lifecycle"]
  node_complaintsapi["Complaint queries<br/>[server.js]"]
  node_triage["AI classification<br/>[server.js]"]
  node_assignment["Staff assignment<br/>[server.js]"]
  node_staffwork["Repair and proof<br/>[server.js]"]
  node_verification["Proof verification<br/>[server.js]"]
  node_satisfaction["Student review<br/>[server.js]"]
  node_staffdirectory["Staff workload<br/>[server.js]"]
end

subgraph group_data["Persistence"]
  node_jsonstore[("JSON data store<br/>[db.json]")]
  node_complaintseed["Complaint seed data<br/>[complaints.json]"]
end

node_student(("Student"))
node_admin(("Admin"))
node_staff(("Staff"))

node_studentui -->|"serves interface"| node_student
node_landing -->|"served by"| node_server
node_student -.->|"submits requests"| node_server
node_server -->|"serves route"| node_studentui
node_server -->|"serves root"| node_landing
node_server -->|"downloads file"| node_zipasset
node_vercelentry -->|"exports app"| node_server
node_server -->|"registers routes"| node_authroutes
node_authroutes -->|"authenticates users"| node_supabase
node_migration -->|"migrates accounts"| node_supabase
node_admin -.->|"uses API"| node_server
node_staff -.->|"uses API"| node_server
node_server -->|"registers routes"| node_complaintsapi
node_complaintsapi -->|"reads and writes"| node_jsonstore
node_complaintsapi -.->|"classifies submission"| node_triage
node_admin -.->|"assigns work"| node_assignment
node_staff -.->|"updates repair"| node_staffwork
node_admin -.->|"reviews proof"| node_verification
node_student -.->|"rates resolution"| node_satisfaction
node_assignment -->|"updates complaint"| node_jsonstore
node_staffwork -->|"updates complaint"| node_jsonstore
node_verification -->|"updates complaint"| node_jsonstore
node_satisfaction -->|"updates complaint"| node_jsonstore
node_staffdirectory -->|"reads workload"| node_jsonstore

click node_server "https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js"
click node_studentui "https://github.com/sakamuriajithsai09-png/parallel/blob/main/public/parallel_student_app.html"
click node_landing "https://github.com/sakamuriajithsai09-png/parallel/blob/main/public/index.html"
click node_authroutes "https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js"
click node_migration "https://github.com/sakamuriajithsai09-png/parallel/blob/main/scripts/migrate-supabase-users.js"
click node_complaintsapi "https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js"
click node_triage "https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js"
click node_assignment "https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js"
click node_staffwork "https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js"
click node_verification "https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js"
click node_satisfaction "https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js"
click node_staffdirectory "https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js"
click node_jsonstore "https://github.com/sakamuriajithsai09-png/parallel/blob/main/db.json"
click node_complaintseed "https://github.com/sakamuriajithsai09-png/parallel/blob/main/data/complaints.json"
click node_vercelentry "https://github.com/sakamuriajithsai09-png/parallel/blob/main/api/index.js"
click node_zipasset "https://github.com/sakamuriajithsai09-png/parallel/blob/main/public/parallel-project.zip"

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_server,node_studentui,node_landing,node_vercelentry,node_zipasset toneBlue
class node_authroutes,node_supabase,node_migration toneAmber
class node_complaintsapi,node_triage,node_assignment,node_staffwork,node_verification,node_satisfaction,node_staffdirectory toneMint
class node_jsonstore,node_complaintseed toneRose
class node_student,node_admin,node_staff toneIndigo
```

## Components

### Web entry points

- [Express API](https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js): `server.js`
- [Student app](https://github.com/sakamuriajithsai09-png/parallel/blob/main/public/parallel_student_app.html): `public/parallel_student_app.html`
- [Landing page](https://github.com/sakamuriajithsai09-png/parallel/blob/main/public/index.html): `public/index.html`
- [Serverless entry](https://github.com/sakamuriajithsai09-png/parallel/blob/main/api/index.js): `api/index.js`
- [Project download](https://github.com/sakamuriajithsai09-png/parallel/blob/main/public/parallel-project.zip): `public/parallel-project.zip`

### Identity

- [Role authentication](https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js): `server.js`
- **Supabase Auth**
- [Account migration](https://github.com/sakamuriajithsai09-png/parallel/blob/main/scripts/migrate-supabase-users.js): `scripts/migrate-supabase-users.js`

### Complaint lifecycle

- [Complaint queries](https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js): `server.js`
- [AI classification](https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js): `server.js`
- [Staff assignment](https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js): `server.js`
- [Repair and proof](https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js): `server.js`
- [Proof verification](https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js): `server.js`
- [Student review](https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js): `server.js`
- [Staff workload](https://github.com/sakamuriajithsai09-png/parallel/blob/main/server.js): `server.js`

### Persistence

- [JSON data store](https://github.com/sakamuriajithsai09-png/parallel/blob/main/db.json): `db.json`
- [Complaint seed data](https://github.com/sakamuriajithsai09-png/parallel/blob/main/data/complaints.json): `data/complaints.json`

### Other components

- **Student**
- **Admin**
- **Staff**

## Connections

- Student app → Student: serves interface
- Landing page → Express API: served by (evidence: `server.js`)
- Student → Express API: submits requests
- Express API → Student app: serves route (evidence: `server.js`)
- Express API → Landing page: serves root (evidence: `server.js`)
- Express API → Project download: downloads file (evidence: `server.js`)
- Serverless entry → Express API: exports app (evidence: `api/index.js`)
- Express API → Role authentication: registers routes (evidence: `server.js`)
- Role authentication → Supabase Auth: authenticates users (evidence: `server.js`)
- Account migration → Supabase Auth: migrates accounts (evidence: `scripts/migrate-supabase-users.js`)
- Admin → Express API: uses API
- Staff → Express API: uses API
- Express API → Complaint queries: registers routes (evidence: `server.js`)
- Complaint queries → JSON data store: reads and writes (evidence: `server.js`)
- Complaint queries → AI classification: classifies submission (evidence: `server.js`)
- Admin → Staff assignment: assigns work
- Staff → Repair and proof: updates repair
- Admin → Proof verification: reviews proof
- Student → Student review: rates resolution
- Staff assignment → JSON data store: updates complaint (evidence: `server.js`)
- Repair and proof → JSON data store: updates complaint (evidence: `server.js`)
- Proof verification → JSON data store: updates complaint (evidence: `server.js`)
- Student review → JSON data store: updates complaint (evidence: `server.js`)
- Staff workload → JSON data store: reads workload (evidence: `server.js`)
