# a1ex1in/site architecture

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

- Interactive diagram: https://gitdiagram.com/a1ex1in/site
- Repository: https://github.com/a1ex1in/site

## Overview

This is a course-management portal for students and teachers. Students register, await teacher approval, then access courses, materials and assignments, submit work, and view feedback; teachers manage course content, review submissions, and grade work. Static frontend pages call an Express API backed by PostgreSQL, with uploaded files stored on disk. The principal routes and several workflow stages are visible in excerpts; frontend-to-API calls and unsampled route details are not, so those connections are omitted rather than inferred.

Main entry points: [`backend/app.js`](https://github.com/a1ex1in/site/blob/main/backend/app.js) (API routing and sessions), [`backend/db.js`](https://github.com/a1ex1in/site/blob/main/backend/db.js) (PostgreSQL client), [`backend/routes/teacher.js`](https://github.com/a1ex1in/site/blob/main/backend/routes/teacher.js) (Teacher course API), [`backend/config.js`](https://github.com/a1ex1in/site/blob/main/backend/config.js) (Runtime configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web interface"]
  node_student_ui["Student portal<br/>[student.js]"]
  node_teacher_ui["Teacher portal<br/>[teacher.js]"]
  node_login_ui["Login and registration<br/>[login.js]"]
  node_register_ui["Registration form<br/>[register.js]"]
end

subgraph group_api["API and access"]
  node_app["API routing and sessions<br/>[app.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_access["Role access checks<br/>[auth.js]"]
  node_config["Runtime configuration<br/>[config.js]"]
  node_server["HTTP server<br/>[server.js]"]
end

subgraph group_learning["Learning workflows"]
  node_groups["Group directory<br/>[groups.js]"]
  node_student_api["Student learning API<br/>[student.js]"]
  node_teacher_api["Teacher course API<br/>[teacher.js]"]
  node_approval["Student approval<br/>[students.js]"]
end

subgraph group_persistence["Persistence and files"]
  node_assign_upload["Assignment uploads"]
  node_material_upload["Material uploads<br/>[materialUpload.js]"]
  node_submission_upload["Submission uploads"]
  node_db_client["PostgreSQL client<br/>[db.js]"]
  node_database[("Portal records<br/>[schema.sql]")]
  node_disk[("Uploaded files")]
end

node_student_actor(("Student"))
node_teacher_actor(("Teacher"))

node_server -->|"starts"| node_app
node_app -->|"mounts routes"| node_auth
node_app -->|"mounts routes"| node_groups
node_app -->|"mounts routes"| node_student_api
node_app -->|"mounts routes"| node_teacher_api
node_app -->|"mounts routes"| node_approval
node_app -->|"configures sessions"| node_db_client
node_app -->|"reads settings"| node_config
node_auth -->|"checks identity"| node_access
node_auth -->|"queries users"| node_db_client
node_approval -->|"checks roles"| node_access
node_approval -->|"updates users"| node_db_client
node_student_api -->|"checks roles"| node_access
node_student_api -->|"reads and writes"| node_db_client
node_student_api -->|"accepts files"| node_submission_upload
node_teacher_api -->|"checks roles"| node_access
node_teacher_api -->|"reads and writes"| node_db_client
node_teacher_api -.->|"accepts files"| node_material_upload
node_teacher_api -.->|"accepts files"| node_assign_upload
node_groups -->|"queries groups"| node_db_client
node_db_client -->|"loads connection"| node_config
node_db_client -.->|"queries"| node_database
node_submission_upload -->|"uses storage root"| node_config
node_submission_upload -->|"writes uploads"| node_disk
node_material_upload -->|"uses storage root"| node_config
node_material_upload -->|"writes uploads"| node_disk
node_assign_upload -->|"uses storage root"| node_config
node_assign_upload -->|"writes uploads"| node_disk
node_student_actor -.->|"uses portal"| node_student_ui
node_teacher_actor -.->|"uses portal"| node_teacher_ui
node_student_actor -.->|"signs in"| node_login_ui
node_student_actor -.->|"registers"| node_register_ui

click node_student_ui "https://github.com/a1ex1in/site/blob/main/frontend/student.js"
click node_teacher_ui "https://github.com/a1ex1in/site/blob/main/frontend/teacher.js"
click node_login_ui "https://github.com/a1ex1in/site/blob/main/frontend/login.js"
click node_register_ui "https://github.com/a1ex1in/site/blob/main/frontend/register.js"
click node_app "https://github.com/a1ex1in/site/blob/main/backend/app.js"
click node_auth "https://github.com/a1ex1in/site/blob/main/backend/routes/auth.js"
click node_access "https://github.com/a1ex1in/site/blob/main/backend/middleware/auth.js"
click node_groups "https://github.com/a1ex1in/site/blob/main/backend/routes/groups.js"
click node_student_api "https://github.com/a1ex1in/site/blob/main/backend/routes/student.js"
click node_teacher_api "https://github.com/a1ex1in/site/blob/main/backend/routes/teacher.js"
click node_approval "https://github.com/a1ex1in/site/blob/main/backend/routes/students.js"
click node_assign_upload "https://github.com/a1ex1in/site/blob/main/backend/middleware/assignmentUpload.js"
click node_material_upload "https://github.com/a1ex1in/site/blob/main/backend/middleware/materialUpload.js"
click node_submission_upload "https://github.com/a1ex1in/site/blob/main/backend/middleware/submissionUpload.js"
click node_config "https://github.com/a1ex1in/site/blob/main/backend/config.js"
click node_db_client "https://github.com/a1ex1in/site/blob/main/backend/db.js"
click node_database "https://github.com/a1ex1in/site/blob/main/database/schema.sql"
click node_server "https://github.com/a1ex1in/site/blob/main/backend/server.js"

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_student_ui,node_teacher_ui,node_login_ui,node_register_ui toneBlue
class node_app,node_auth,node_access,node_config,node_server toneAmber
class node_groups,node_student_api,node_teacher_api,node_approval toneMint
class node_assign_upload,node_material_upload,node_submission_upload,node_db_client,node_database,node_disk toneRose
class node_student_actor,node_teacher_actor toneIndigo
```

## Components

### Web interface

- [Student portal](https://github.com/a1ex1in/site/blob/main/frontend/student.js): `frontend/student.js`
- [Teacher portal](https://github.com/a1ex1in/site/blob/main/frontend/teacher.js): `frontend/teacher.js`
- [Login and registration](https://github.com/a1ex1in/site/blob/main/frontend/login.js): `frontend/login.js`
- [Registration form](https://github.com/a1ex1in/site/blob/main/frontend/register.js): `frontend/register.js`

### API and access

- [API routing and sessions](https://github.com/a1ex1in/site/blob/main/backend/app.js): `backend/app.js`
- [Authentication](https://github.com/a1ex1in/site/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Role access checks](https://github.com/a1ex1in/site/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Runtime configuration](https://github.com/a1ex1in/site/blob/main/backend/config.js): `backend/config.js`
- [HTTP server](https://github.com/a1ex1in/site/blob/main/backend/server.js): `backend/server.js`

### Learning workflows

- [Group directory](https://github.com/a1ex1in/site/blob/main/backend/routes/groups.js): `backend/routes/groups.js`
- [Student learning API](https://github.com/a1ex1in/site/blob/main/backend/routes/student.js): `backend/routes/student.js`
- [Teacher course API](https://github.com/a1ex1in/site/blob/main/backend/routes/teacher.js): `backend/routes/teacher.js`
- [Student approval](https://github.com/a1ex1in/site/blob/main/backend/routes/students.js): `backend/routes/students.js`

### Persistence and files

- [Assignment uploads](https://github.com/a1ex1in/site/blob/main/backend/middleware/assignmentUpload.js): `backend/middleware/assignmentUpload.js`
- [Material uploads](https://github.com/a1ex1in/site/blob/main/backend/middleware/materialUpload.js): `backend/middleware/materialUpload.js`
- [Submission uploads](https://github.com/a1ex1in/site/blob/main/backend/middleware/submissionUpload.js): `backend/middleware/submissionUpload.js`
- [PostgreSQL client](https://github.com/a1ex1in/site/blob/main/backend/db.js): `backend/db.js`
- [Portal records](https://github.com/a1ex1in/site/blob/main/database/schema.sql): `database/schema.sql`
- **Uploaded files**

### Other components

- **Student**
- **Teacher**

## Connections

- HTTP server → API routing and sessions: starts (evidence: `backend/server.js`)
- API routing and sessions → Authentication: mounts routes (evidence: `backend/app.js`)
- API routing and sessions → Group directory: mounts routes (evidence: `backend/app.js`)
- API routing and sessions → Student learning API: mounts routes (evidence: `backend/app.js`)
- API routing and sessions → Teacher course API: mounts routes (evidence: `backend/app.js`)
- API routing and sessions → Student approval: mounts routes (evidence: `backend/app.js`)
- API routing and sessions → PostgreSQL client: configures sessions (evidence: `backend/app.js`)
- API routing and sessions → Runtime configuration: reads settings (evidence: `backend/app.js`)
- Authentication → Role access checks: checks identity (evidence: `backend/routes/auth.js`)
- Authentication → PostgreSQL client: queries users (evidence: `backend/routes/auth.js`)
- Student approval → Role access checks: checks roles (evidence: `backend/routes/students.js`)
- Student approval → PostgreSQL client: updates users (evidence: `backend/routes/students.js`)
- Student learning API → Role access checks: checks roles (evidence: `backend/routes/student.js`)
- Student learning API → PostgreSQL client: reads and writes (evidence: `backend/routes/student.js`)
- Student learning API → Submission uploads: accepts files (evidence: `backend/routes/student.js`)
- Teacher course API → Role access checks: checks roles (evidence: `backend/routes/teacher.js`)
- Teacher course API → PostgreSQL client: reads and writes (evidence: `backend/routes/teacher.js`)
- Teacher course API → Material uploads: accepts files (evidence: `backend/routes/teacher.js`)
- Teacher course API → Assignment uploads: accepts files (evidence: `backend/routes/teacher.js`)
- Group directory → PostgreSQL client: queries groups (evidence: `backend/routes/groups.js`)
- PostgreSQL client → Runtime configuration: loads connection (evidence: `backend/db.js`)
- PostgreSQL client → Portal records: queries
- Submission uploads → Runtime configuration: uses storage root (evidence: `backend/middleware/submissionUpload.js`)
- Submission uploads → Uploaded files: writes uploads (evidence: `backend/middleware/submissionUpload.js`)
- Material uploads → Runtime configuration: uses storage root (evidence: `backend/middleware/materialUpload.js`)
- Material uploads → Uploaded files: writes uploads (evidence: `backend/middleware/materialUpload.js`)
- Assignment uploads → Runtime configuration: uses storage root (evidence: `backend/middleware/assignmentUpload.js`)
- Assignment uploads → Uploaded files: writes uploads (evidence: `backend/middleware/assignmentUpload.js`)
- Student → Student portal: uses portal
- Teacher → Teacher portal: uses portal
- Student → Login and registration: signs in
- Student → Registration form: registers
