# shayalsammil/student-mgmt-dvops architecture

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

- Interactive diagram: https://gitdiagram.com/shayalsammil/student-mgmt-dvops
- Repository: https://github.com/shayalsammil/student-mgmt-dvops

## Overview

This is a small Express-based student management app. The browser workflow displays students and submits create or update requests; Express routes dispatch those requests to handlers that validate or modify student records stored in a JSON file. The create handler constructs Student model instances, while the read and update handlers operate on parsed records. The source excerpts show these paths, but do not expose the HTML wiring or all page behavior, so those relationships are omitted.

Main entry points: [`index.js`](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/index.js) (Express app and routes), [`utils/ShayalSammilUtil.js`](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/utils/ShayalSammilUtil.js) (Create student handler), [`utils/AvielUtil.js`](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/utils/AvielUtil.js) (Read students handler), [`utils/GlenOngUtil.js`](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/utils/GlenOngUtil.js) (Update student handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Browser interface"]
  node_browser["Web page<br/>[index.html]"]
  node_create_ui["Create form logic<br/>[shayal-sammil.js]"]
  node_read_ui["Student table logic<br/>[aviel-chua.js]"]
  node_update_ui["Update form logic<br/>[glen-ong.js]"]
end

subgraph group_server["Express application"]
  node_express["Express app and routes<br/>[index.js]"]
end

subgraph group_students["Student operations"]
  node_create["Create student handler"]
  node_read["Read students handler<br/>[AvielUtil.js]"]
  node_update["Update student handler<br/>[GlenOngUtil.js]"]
  node_student_model["Student model<br/>[Student.js]"]
end

subgraph group_storage["File storage"]
  node_student_file[("Student JSON data")]
  node_template["Initial data template"]
end

node_user(("Student user"))

node_user -.->|"uses"| node_browser
node_create_ui -->|"POST request"| node_express
node_update_ui -->|"PUT request"| node_express
node_read_ui -->|"fetches students"| node_express
node_express -->|"routes POST"| node_create
node_express -->|"routes PUT"| node_update
node_express -->|"routes GET"| node_read
node_create -->|"constructs"| node_student_model
node_create -->|"reads and writes"| node_student_file
node_create -->|"loads fallback"| node_template
node_read -->|"reads"| node_student_file
node_update -->|"reads and writes"| node_student_file

click node_browser "https://github.com/shayalsammil/student-mgmt-dvops/blob/main/public/index.html"
click node_create_ui "https://github.com/shayalsammil/student-mgmt-dvops/blob/main/public/js/shayal-sammil.js"
click node_read_ui "https://github.com/shayalsammil/student-mgmt-dvops/blob/main/public/js/aviel-chua.js"
click node_update_ui "https://github.com/shayalsammil/student-mgmt-dvops/blob/main/public/js/glen-ong.js"
click node_express "https://github.com/shayalsammil/student-mgmt-dvops/blob/main/index.js"
click node_create "https://github.com/shayalsammil/student-mgmt-dvops/blob/main/utils/ShayalSammilUtil.js"
click node_read "https://github.com/shayalsammil/student-mgmt-dvops/blob/main/utils/AvielUtil.js"
click node_update "https://github.com/shayalsammil/student-mgmt-dvops/blob/main/utils/GlenOngUtil.js"
click node_student_model "https://github.com/shayalsammil/student-mgmt-dvops/blob/main/models/Student.js"
click node_template "https://github.com/shayalsammil/student-mgmt-dvops/blob/main/utils/students.template.json"

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_browser,node_create_ui,node_read_ui,node_update_ui,node_user toneBlue
class node_express toneAmber
class node_create,node_read,node_update,node_student_model toneMint
class node_student_file,node_template toneRose
```

## Components

### Browser interface

- [Web page](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/public/index.html): `public/index.html`
- [Create form logic](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/public/js/shayal-sammil.js): `public/js/shayal-sammil.js`
- [Student table logic](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/public/js/aviel-chua.js): `public/js/aviel-chua.js`
- [Update form logic](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/public/js/glen-ong.js): `public/js/glen-ong.js`

### Express application

- [Express app and routes](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/index.js): `index.js`

### Student operations

- [Create student handler](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/utils/ShayalSammilUtil.js): `utils/ShayalSammilUtil.js`
- [Read students handler](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/utils/AvielUtil.js): `utils/AvielUtil.js`
- [Update student handler](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/utils/GlenOngUtil.js): `utils/GlenOngUtil.js`
- [Student model](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/models/Student.js): `models/Student.js`

### File storage

- **Student JSON data**
- [Initial data template](https://github.com/shayalsammil/student-mgmt-dvops/blob/main/utils/students.template.json): `utils/students.template.json`

### Other components

- **Student user**

## Connections

- Student user → Web page: uses
- Create form logic → Express app and routes: POST request (evidence: `public/js/shayal-sammil.js`)
- Update form logic → Express app and routes: PUT request (evidence: `public/js/glen-ong.js`)
- Student table logic → Express app and routes: fetches students (evidence: `public/js/aviel-chua.js`)
- Express app and routes → Create student handler: routes POST (evidence: `index.js`)
- Express app and routes → Update student handler: routes PUT (evidence: `index.js`)
- Express app and routes → Read students handler: routes GET (evidence: `index.js`)
- Create student handler → Student model: constructs (evidence: `utils/ShayalSammilUtil.js`)
- Create student handler → Student JSON data: reads and writes (evidence: `utils/ShayalSammilUtil.js`)
- Create student handler → Initial data template: loads fallback (evidence: `utils/ShayalSammilUtil.js`)
- Read students handler → Student JSON data: reads (evidence: `utils/AvielUtil.js`)
- Update student handler → Student JSON data: reads and writes (evidence: `utils/GlenOngUtil.js`)
