# masonprice813/s26-cpsc4910-team19 architecture

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

- Interactive diagram: https://gitdiagram.com/masonprice813/s26-cpsc4910-team19
- Repository: https://github.com/masonprice813/s26-cpsc4910-team19

## Overview

This is a role-based points and rewards portal for drivers, sponsors, and administrators. Drivers browse and redeem catalog products, then review point history and orders; sponsors manage drivers, applications, points, catalog settings, and reports; administrators manage users and inspect reports and audit logs. The browser modules call a large Express API, which queries MySQL and uses a separate bulk-file parser. The README gives no product details, so capabilities here are inferred from the source filenames and excerpts; most server routes and several UI modules were not sampled.

Main entry points: [`server.js`](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/server.js) (Express API), [`Website/catalog.js`](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/catalog.js) (Rewards catalog), [`Website/profile.js`](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/profile.js) (Driver profile), [`Website/transaction-history.js`](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/transaction-history.js) (Order history)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experiences"]
  node_catalog["Rewards catalog<br/>[catalog.js]"]
  node_product["Product details<br/>[product.js]"]
  node_profile["Driver profile<br/>[profile.js]"]
  node_history["Order history"]
  node_notifications["Notifications<br/>[notifications.js]"]
  node_application["Applications<br/>[application.js]"]
  node_sponsor["Sponsor dashboard<br/>[sponsor-page.js]"]
  node_sponsorapps["Sponsor applications"]
  node_sponsorcreate["Sponsor setup<br/>[sponsor-create.js]"]
  node_adminusers["Admin user management<br/>[admin-users.js]"]
  node_adminreports["Admin reports<br/>[admin-reports.js]"]
  node_audit["Audit logs<br/>[audit-logs.js]"]
  node_login["Authentication UI<br/>[login.js]"]
end

subgraph group_api["Application services"]
  node_api["Express API<br/>[server.js]"]
end

subgraph group_data["Persistence and imports"]
  node_bulk["Bulk import parser<br/>[bulkParser.js]"]
  node_mysql[("MySQL database")]
end

node_users(("Portal users"))

node_users -->|"browse and redeem"| node_catalog
node_users -->|"manage profile"| node_profile
node_users -->|"review orders"| node_history
node_users -->|"manage alerts"| node_notifications
node_users -->|"submit application"| node_application
node_users -->|"manage program"| node_sponsor
node_users -->|"manage users"| node_adminusers
node_users -->|"view reports"| node_adminreports
node_users -->|"review audit logs"| node_audit
node_users -.->|"sign in"| node_login
node_catalog -->|"request catalog and checkout"| node_api
node_product -.->|"request product data"| node_api
node_profile -->|"read and update profile"| node_api
node_history -->|"request order history"| node_api
node_notifications -->|"manage notifications"| node_api
node_application -->|"submit and configure"| node_api
node_sponsor -->|"manage sponsor data"| node_api
node_sponsorapps -.->|"manage applications"| node_api
node_sponsorcreate -.->|"configure sponsor"| node_api
node_adminusers -->|"manage users and bugs"| node_api
node_adminreports -->|"request analytics"| node_api
node_audit -->|"request audit data"| node_api
node_api -->|"query and update"| node_mysql
node_api -->|"uses parser"| node_bulk

click node_catalog "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/catalog.js"
click node_product "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/product.js"
click node_profile "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/profile.js"
click node_history "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/transaction-history.js"
click node_notifications "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/notifications.js"
click node_application "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/application.js"
click node_sponsor "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/sponsor-page.js"
click node_sponsorapps "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/sponsor-applications.js"
click node_sponsorcreate "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/sponsor-create.js"
click node_adminusers "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/admin-users.js"
click node_adminreports "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/admin-reports.js"
click node_audit "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/audit-logs.js"
click node_login "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/login.js"
click node_api "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/server.js"
click node_bulk "https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/bulkParser.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_catalog,node_product,node_profile,node_history,node_notifications,node_application,node_sponsor,node_sponsorapps,node_sponsorcreate,node_adminusers,node_adminreports,node_audit,node_login,node_users toneBlue
class node_api toneAmber
class node_bulk,node_mysql toneMint
```

## Components

### Web experiences

- [Rewards catalog](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/catalog.js): `Website/catalog.js`
- [Product details](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/product.js): `Website/product.js`
- [Driver profile](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/profile.js): `Website/profile.js`
- [Order history](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/transaction-history.js): `Website/transaction-history.js`
- [Notifications](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/notifications.js): `Website/notifications.js`
- [Applications](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/application.js): `Website/application.js`
- [Sponsor dashboard](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/sponsor-page.js): `Website/sponsor-page.js`
- [Sponsor applications](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/sponsor-applications.js): `Website/sponsor-applications.js`
- [Sponsor setup](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/sponsor-create.js): `Website/sponsor-create.js`
- [Admin user management](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/admin-users.js): `Website/admin-users.js`
- [Admin reports](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/admin-reports.js): `Website/admin-reports.js`
- [Audit logs](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/audit-logs.js): `Website/audit-logs.js`
- [Authentication UI](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/login.js): `Website/login.js`

### Application services

- [Express API](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/server.js): `server.js`

### Persistence and imports

- [Bulk import parser](https://github.com/masonprice813/s26-cpsc4910-team19/blob/main/Website/bulkParser.js): `Website/bulkParser.js`
- **MySQL database**

### Other components

- **Portal users**

## Connections

- Portal users → Rewards catalog: browse and redeem (evidence: `Website/catalog.js`)
- Portal users → Driver profile: manage profile (evidence: `Website/profile.js`)
- Portal users → Order history: review orders (evidence: `Website/transaction-history.js`)
- Portal users → Notifications: manage alerts (evidence: `Website/notifications.js`)
- Portal users → Applications: submit application (evidence: `Website/application.js`)
- Portal users → Sponsor dashboard: manage program (evidence: `Website/sponsor-page.js`)
- Portal users → Admin user management: manage users (evidence: `Website/admin-users.js`)
- Portal users → Admin reports: view reports (evidence: `Website/admin-reports.js`)
- Portal users → Audit logs: review audit logs (evidence: `Website/audit-logs.js`)
- Portal users → Authentication UI: sign in
- Rewards catalog → Express API: request catalog and checkout (evidence: `Website/catalog.js`)
- Product details → Express API: request product data
- Driver profile → Express API: read and update profile (evidence: `Website/profile.js`)
- Order history → Express API: request order history (evidence: `Website/transaction-history.js`)
- Notifications → Express API: manage notifications (evidence: `Website/notifications.js`)
- Applications → Express API: submit and configure (evidence: `Website/application.js`)
- Sponsor dashboard → Express API: manage sponsor data (evidence: `Website/sponsor-page.js`)
- Sponsor applications → Express API: manage applications
- Sponsor setup → Express API: configure sponsor
- Admin user management → Express API: manage users and bugs (evidence: `Website/admin-users.js`)
- Admin reports → Express API: request analytics (evidence: `Website/admin-reports.js`)
- Audit logs → Express API: request audit data (evidence: `Website/audit-logs.js`)
- Express API → MySQL database: query and update (evidence: `server.js`)
- Express API → Bulk import parser: uses parser (evidence: `server.js`)
