# naomiabe2004-sudo/sia architecture

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

- Interactive diagram: https://gitdiagram.com/naomiabe2004-sudo/sia
- Repository: https://github.com/naomiabe2004-sudo/sia

## Overview

This is a marketplace application: its API supports account registration/login, product discovery and seller inventory, buyer orders, seller sales summaries, and admin user/statistics/audit operations. The available excerpts show the API routing and backend behavior, plus a separate legacy storefront with a browser cart. The README is empty, and the tree contains no model definitions or current frontend source excerpts, so those connections are not expanded beyond what the shown code supports.

Main entry points: [`server.js`](https://github.com/naomiabe2004-sudo/sia/blob/main/server.js) (API Server), [`routes/orders.js`](https://github.com/naomiabe2004-sudo/sia/blob/main/routes/orders.js) (Orders and Sales), [`routes/users.js`](https://github.com/naomiabe2004-sudo/sia/blob/main/routes/users.js) (User Administration), [`routes/products.js`](https://github.com/naomiabe2004-sudo/sia/blob/main/routes/products.js) (Product Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Marketplace API"]
  node_server["API Server<br/>[server.js]"]
  node_auth_routes["Account Access<br/>[auth.js]"]
  node_auth_guard["Token and Roles<br/>[auth.js]"]
  node_db_connect["DB Connection<br/>[db.js]"]
  node_login_page["Login Page<br/>[login.html]"]
end

subgraph group_commerce["Commerce Operations"]
  node_products["Product Catalog<br/>[products.js]"]
  node_orders["Orders and Sales<br/>[orders.js]"]
  node_seller_page["Seller Page<br/>[seller.html]"]
  node_sales_page["Sales Page<br/>[sales.html]"]
end

subgraph group_admin["Administration"]
  node_users["User Administration<br/>[users.js]"]
  node_audit_routes["Audit Records<br/>[audit.js]"]
  node_audit_writer["Audit Writer<br/>[audit.js]"]
  node_admin_page["Admin Page<br/>[admin.html]"]
end

subgraph group_legacy["Legacy Storefront"]
  node_store_page["Storefront<br/>[index.html]"]
  node_legacy_catalog["Legacy Catalog and Cart<br/>[script.js]"]
  node_legacy_products["Legacy Product Data<br/>[products.json]"]
  node_legacy_product_page["Product Detail Page<br/>[product.html]"]
  node_legacy_form_page["Product Form Page<br/>[product-from.html]"]
end

node_buyer(("Buyer"))
node_seller(("Seller"))
node_administrator(("Administrator"))
node_mongo[("MongoDB")]

node_server -->|"connects"| node_db_connect
node_db_connect -->|"opens connection"| node_mongo
node_server -->|"mounts routes"| node_auth_routes
node_server -->|"mounts routes"| node_products
node_server -->|"mounts routes"| node_orders
node_server -->|"mounts routes"| node_users
node_server -->|"mounts routes"| node_audit_routes
node_auth_routes -->|"reads and writes"| node_mongo
node_products -->|"checks access"| node_auth_guard
node_orders -->|"checks access"| node_auth_guard
node_users -->|"checks access"| node_auth_guard
node_audit_routes -->|"checks access"| node_auth_guard
node_products -->|"reads and writes"| node_mongo
node_orders -->|"reads and writes"| node_mongo
node_users -->|"reads and writes"| node_mongo
node_audit_routes -->|"reads records"| node_mongo
node_orders -->|"records actions"| node_audit_writer
node_users -->|"records actions"| node_audit_writer
node_audit_writer -->|"writes audit data"| node_mongo
node_buyer -.->|"registers or logs in"| node_auth_routes
node_seller -.->|"manages inventory"| node_products
node_buyer -.->|"places orders"| node_orders
node_administrator -.->|"manages accounts"| node_users
node_administrator -.->|"views activity"| node_audit_routes
node_seller_page -.->|"uses API"| node_products
node_sales_page -.->|"uses API"| node_orders
node_login_page -.->|"uses API"| node_auth_routes
node_admin_page -.->|"uses API"| node_users
node_store_page -.->|"runs storefront"| node_legacy_catalog
node_legacy_catalog -->|"loads products"| node_legacy_products
node_legacy_catalog -->|"navigates to"| node_legacy_product_page

click node_server "https://github.com/naomiabe2004-sudo/sia/blob/main/server.js"
click node_auth_routes "https://github.com/naomiabe2004-sudo/sia/blob/main/routes/auth.js"
click node_auth_guard "https://github.com/naomiabe2004-sudo/sia/blob/main/middleware/auth.js"
click node_db_connect "https://github.com/naomiabe2004-sudo/sia/blob/main/config/db.js"
click node_products "https://github.com/naomiabe2004-sudo/sia/blob/main/routes/products.js"
click node_orders "https://github.com/naomiabe2004-sudo/sia/blob/main/routes/orders.js"
click node_users "https://github.com/naomiabe2004-sudo/sia/blob/main/routes/users.js"
click node_audit_routes "https://github.com/naomiabe2004-sudo/sia/blob/main/routes/audit.js"
click node_audit_writer "https://github.com/naomiabe2004-sudo/sia/blob/main/utils/audit.js"
click node_admin_page "https://github.com/naomiabe2004-sudo/sia/blob/main/admin.html"
click node_seller_page "https://github.com/naomiabe2004-sudo/sia/blob/main/seller.html"
click node_sales_page "https://github.com/naomiabe2004-sudo/sia/blob/main/sales.html"
click node_login_page "https://github.com/naomiabe2004-sudo/sia/blob/main/login.html"
click node_store_page "https://github.com/naomiabe2004-sudo/sia/blob/main/old-shop/index.html"
click node_legacy_catalog "https://github.com/naomiabe2004-sudo/sia/blob/main/old-shop/script.js"
click node_legacy_products "https://github.com/naomiabe2004-sudo/sia/blob/main/old-shop/products.json"
click node_legacy_product_page "https://github.com/naomiabe2004-sudo/sia/blob/main/old-shop/product.html"
click node_legacy_form_page "https://github.com/naomiabe2004-sudo/sia/blob/main/old-shop/product-from.html"

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_auth_routes,node_auth_guard,node_db_connect,node_login_page toneBlue
class node_products,node_orders,node_seller_page,node_sales_page,node_mongo toneAmber
class node_users,node_audit_routes,node_audit_writer,node_admin_page toneMint
class node_store_page,node_legacy_catalog,node_legacy_products,node_legacy_product_page,node_legacy_form_page toneRose
class node_buyer,node_seller,node_administrator toneIndigo
```

## Components

### Marketplace API

- [API Server](https://github.com/naomiabe2004-sudo/sia/blob/main/server.js): `server.js`
- [Account Access](https://github.com/naomiabe2004-sudo/sia/blob/main/routes/auth.js): `routes/auth.js`
- [Token and Roles](https://github.com/naomiabe2004-sudo/sia/blob/main/middleware/auth.js): `middleware/auth.js`
- [DB Connection](https://github.com/naomiabe2004-sudo/sia/blob/main/config/db.js): `config/db.js`
- [Login Page](https://github.com/naomiabe2004-sudo/sia/blob/main/login.html): `login.html`

### Commerce Operations

- [Product Catalog](https://github.com/naomiabe2004-sudo/sia/blob/main/routes/products.js): `routes/products.js`
- [Orders and Sales](https://github.com/naomiabe2004-sudo/sia/blob/main/routes/orders.js): `routes/orders.js`
- [Seller Page](https://github.com/naomiabe2004-sudo/sia/blob/main/seller.html): `seller.html`
- [Sales Page](https://github.com/naomiabe2004-sudo/sia/blob/main/sales.html): `sales.html`

### Administration

- [User Administration](https://github.com/naomiabe2004-sudo/sia/blob/main/routes/users.js): `routes/users.js`
- [Audit Records](https://github.com/naomiabe2004-sudo/sia/blob/main/routes/audit.js): `routes/audit.js`
- [Audit Writer](https://github.com/naomiabe2004-sudo/sia/blob/main/utils/audit.js): `utils/audit.js`
- [Admin Page](https://github.com/naomiabe2004-sudo/sia/blob/main/admin.html): `admin.html`

### Legacy Storefront

- [Storefront](https://github.com/naomiabe2004-sudo/sia/blob/main/old-shop/index.html): `old-shop/index.html`
- [Legacy Catalog and Cart](https://github.com/naomiabe2004-sudo/sia/blob/main/old-shop/script.js): `old-shop/script.js`
- [Legacy Product Data](https://github.com/naomiabe2004-sudo/sia/blob/main/old-shop/products.json): `old-shop/products.json`
- [Product Detail Page](https://github.com/naomiabe2004-sudo/sia/blob/main/old-shop/product.html): `old-shop/product.html`
- [Product Form Page](https://github.com/naomiabe2004-sudo/sia/blob/main/old-shop/product-from.html): `old-shop/product-from.html`

### Other components

- **Buyer**
- **Seller**
- **Administrator**
- **MongoDB**

## Connections

- API Server → DB Connection: connects (evidence: `server.js`)
- DB Connection → MongoDB: opens connection (evidence: `config/db.js`)
- API Server → Account Access: mounts routes (evidence: `server.js`)
- API Server → Product Catalog: mounts routes (evidence: `server.js`)
- API Server → Orders and Sales: mounts routes (evidence: `server.js`)
- API Server → User Administration: mounts routes (evidence: `server.js`)
- API Server → Audit Records: mounts routes (evidence: `server.js`)
- Account Access → MongoDB: reads and writes (evidence: `routes/auth.js`)
- Product Catalog → Token and Roles: checks access (evidence: `routes/products.js`)
- Orders and Sales → Token and Roles: checks access (evidence: `routes/orders.js`)
- User Administration → Token and Roles: checks access (evidence: `routes/users.js`)
- Audit Records → Token and Roles: checks access (evidence: `routes/audit.js`)
- Product Catalog → MongoDB: reads and writes (evidence: `routes/products.js`)
- Orders and Sales → MongoDB: reads and writes (evidence: `routes/orders.js`)
- User Administration → MongoDB: reads and writes (evidence: `routes/users.js`)
- Audit Records → MongoDB: reads records (evidence: `routes/audit.js`)
- Orders and Sales → Audit Writer: records actions (evidence: `routes/orders.js`)
- User Administration → Audit Writer: records actions (evidence: `routes/users.js`)
- Audit Writer → MongoDB: writes audit data (evidence: `utils/audit.js`)
- Buyer → Account Access: registers or logs in
- Seller → Product Catalog: manages inventory
- Buyer → Orders and Sales: places orders
- Administrator → User Administration: manages accounts
- Administrator → Audit Records: views activity
- Seller Page → Product Catalog: uses API
- Sales Page → Orders and Sales: uses API
- Login Page → Account Access: uses API
- Admin Page → User Administration: uses API
- Storefront → Legacy Catalog and Cart: runs storefront
- Legacy Catalog and Cart → Legacy Product Data: loads products (evidence: `old-shop/script.js`)
- Legacy Catalog and Cart → Product Detail Page: navigates to (evidence: `old-shop/script.js`)
