# imaginewecreatethis-byte/wb-t-c-progress-monitoring-system architecture

> Architecture diagram of the GitHub repository imaginewecreatethis-byte/wb-t-c-progress-monitoring-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system
- Repository: https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system

## Overview

WB-T&C is a role-based capstone/thesis progress portal. Students register, submit requirements, and track progress; teachers and admins review submissions, manage accounts, and share course-scoped galleries, while admins can issue clearances. The browser UI is primarily orchestrated by src/script.js, with db.js handling Supabase access and separate document-analysis and viewing modules. README capabilities supplement the sampled code; some UI-to-module wiring is not visible in the excerpts, so those links are omitted or marked unverified.

Main entry points: [`src/script.js`](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js) (Portal workflows), [`db.js`](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/db.js) (Data access), [`pages/userpage.html`](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/pages/userpage.html) (Student portal), [`pages/adminpage.html`](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/pages/adminpage.html) (Teacher console)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Portal workflows"]
  node_workflow["Portal workflows<br/>[script.js]"]
  node_authentication["Sign-in and registration<br/>[db.js]"]
  node_submissions["Requirement submissions<br/>[db.js]"]
  node_gallery["Course gallery<br/>[script.js]"]
  node_clearance["Clearance release<br/>[script.js]"]
  node_account_admin["Account administration<br/>[script.js]"]
  node_notifications["Notifications<br/>[script.js]"]
end

subgraph group_review["Review and documents"]
  node_progress["Progress analysis<br/>[analyzer.js]"]
  node_review_tools["Review actions<br/>[script.js]"]
  node_file_viewer["File viewer<br/>[viewer.js]"]
end

subgraph group_data["Data services"]
  node_database_access["Data access<br/>[db.js]"]
  node_supabase[("Supabase")]
  node_file_storage[("Submission storage")]
  node_sql["Database policies"]
end

subgraph group_roles["Role interfaces"]
  node_student_ui["Student portal<br/>[userpage.html]"]
  node_teacher_ui["Teacher console<br/>[adminpage.html]"]
  node_admin_ui["Admin console"]
  node_icons["Icon helpers<br/>[icons.js]"]
end

node_student(("Student"))
node_teacher(("Teacher"))
node_admin(("Admin"))

node_student -->|"uses"| node_student_ui
node_teacher -->|"uses"| node_teacher_ui
node_admin -->|"uses"| node_admin_ui
node_student_ui -.->|"opens"| node_workflow
node_teacher_ui -.->|"opens"| node_workflow
node_admin_ui -.->|"opens"| node_workflow
node_workflow -->|"authenticates"| node_authentication
node_workflow -.->|"manages"| node_submissions
node_workflow -.->|"checks documents"| node_progress
node_workflow -->|"handles reviews"| node_review_tools
node_workflow -->|"filters gallery"| node_gallery
node_workflow -->|"releases clearance"| node_clearance
node_workflow -->|"manages accounts"| node_account_admin
node_workflow -->|"shows notices"| node_notifications
node_workflow -->|"renders icons"| node_icons
node_authentication -->|"uses"| node_database_access
node_submissions -->|"uses"| node_database_access
node_database_access -->|"creates client"| node_supabase
node_database_access -->|"reads and writes"| node_file_storage
node_file_viewer -->|"loads ZIP helper"| node_progress
node_sql -.->|"configures schema"| node_supabase

click node_student_ui "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/pages/userpage.html"
click node_teacher_ui "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/pages/adminpage.html"
click node_admin_ui "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/pages/superadminpage.html"
click node_workflow "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js"
click node_authentication "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/db.js"
click node_submissions "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/db.js"
click node_progress "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/analyzer.js"
click node_review_tools "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js"
click node_file_viewer "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/viewer.js"
click node_gallery "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js"
click node_clearance "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js"
click node_account_admin "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js"
click node_notifications "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js"
click node_database_access "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/db.js"
click node_sql "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/tree/main/supabase"
click node_icons "https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/assets/icons.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_workflow,node_authentication,node_submissions,node_gallery,node_clearance,node_account_admin,node_notifications toneBlue
class node_progress,node_review_tools,node_file_viewer toneAmber
class node_database_access,node_supabase,node_file_storage,node_sql toneMint
class node_student_ui,node_teacher_ui,node_admin_ui,node_icons toneRose
class node_student,node_teacher,node_admin toneIndigo
```

## Components

### Portal workflows

- [Portal workflows](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js): `src/script.js`
- [Sign-in and registration](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/db.js): `db.js`
- [Requirement submissions](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/db.js): `db.js`
- [Course gallery](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js): `src/script.js`
- [Clearance release](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js): `src/script.js`
- [Account administration](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js): `src/script.js`
- [Notifications](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js): `src/script.js`

### Review and documents

- [Progress analysis](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/analyzer.js): `src/analyzer.js`
- [Review actions](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/script.js): `src/script.js`
- [File viewer](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/src/viewer.js): `src/viewer.js`

### Data services

- [Data access](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/db.js): `db.js`
- **Supabase**
- **Submission storage**
- [Database policies](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/tree/main/supabase): `supabase`

### Role interfaces

- [Student portal](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/pages/userpage.html): `pages/userpage.html`
- [Teacher console](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/pages/adminpage.html): `pages/adminpage.html`
- [Admin console](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/pages/superadminpage.html): `pages/superadminpage.html`
- [Icon helpers](https://github.com/imaginewecreatethis-byte/wb-t-c-progress-monitoring-system/blob/main/assets/icons.js): `assets/icons.js`

### Other components

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

## Connections

- Student → Student portal: uses (evidence: `README.md`)
- Teacher → Teacher console: uses (evidence: `README.md`)
- Admin → Admin console: uses (evidence: `README.md`)
- Student portal → Portal workflows: opens
- Teacher console → Portal workflows: opens
- Admin console → Portal workflows: opens
- Portal workflows → Sign-in and registration: authenticates (evidence: `src/script.js`)
- Portal workflows → Requirement submissions: manages
- Portal workflows → Progress analysis: checks documents
- Portal workflows → Review actions: handles reviews (evidence: `src/script.js`)
- Portal workflows → Course gallery: filters gallery (evidence: `src/script.js`)
- Portal workflows → Clearance release: releases clearance (evidence: `src/script.js`)
- Portal workflows → Account administration: manages accounts (evidence: `src/script.js`)
- Portal workflows → Notifications: shows notices (evidence: `src/script.js`)
- Portal workflows → Icon helpers: renders icons (evidence: `src/script.js`)
- Sign-in and registration → Data access: uses (evidence: `db.js`)
- Requirement submissions → Data access: uses (evidence: `db.js`)
- Data access → Supabase: creates client (evidence: `db.js`)
- Data access → Submission storage: reads and writes (evidence: `db.js`)
- File viewer → Progress analysis: loads ZIP helper (evidence: `src/viewer.js`)
- Database policies → Supabase: configures schema
