# cc-jpg2077/sky888-commercial-spaces architecture

> Architecture diagram of the GitHub repository cc-jpg2077/sky888-commercial-spaces, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cc-jpg2077/sky888-commercial-spaces
- Repository: https://github.com/cc-jpg2077/sky888-commercial-spaces

## Overview

SKY888 is a tenant-request website and small property-management system. Visitors browse commercial spaces and site details, then submit a request and receive a reference number. Administrators log in to review and decide requests, manage spaces and photos, and update contact settings. The Express app serves the browser interfaces and API; route handlers use SQLite, with authentication and validation support. The route files are sampled only in part, so some feature links below rely on the README’s documented capabilities rather than inspected handler details.

Main entry points: [`public/admin/admin.js`](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/public/admin/admin.js) (Admin interface), [`src/db.js`](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/db.js) (SQLite data), [`public/js/site.js`](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/public/js/site.js) (Public site), [`src/routes/public.js`](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/public.js) (Public API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public experience"]
  node_public_ui["Public site<br/>[site.js]"]
  node_hero["Scroll hero<br/>[scroll-hero.js]"]
  node_request_flow["Request submission<br/>[public.js]"]
end

subgraph group_admin["Administration"]
  node_admin_ui["Admin interface<br/>[admin.js]"]
  node_dashboard["Request dashboard<br/>[admin.js]"]
  node_decisions["Request decisions<br/>[admin.js]"]
  node_space_mgmt["Space management<br/>[admin.js]"]
  node_site_settings["Site settings<br/>[admin.js]"]
end

subgraph group_server["Application server"]
  node_public_api["Public API<br/>[public.js]"]
  node_login["Admin authentication<br/>[admin.js]"]
  node_auth["Sessions and passwords<br/>[auth.js]"]
  node_util["Validation and limits<br/>[util.js]"]
  node_app["Express app<br/>[app.js]"]
end

subgraph group_data["Persistence"]
  node_database[("SQLite data<br/>[db.js]")]
end

node_visitor(("Visitor"))
node_manager(("Administrator"))

node_visitor -->|"browses and submits"| node_public_ui
node_public_ui -->|"loads site data"| node_public_api
node_public_ui -->|"posts request"| node_request_flow
node_hero -->|"expands page"| node_public_ui
node_request_flow -->|"stores request"| node_database
node_public_api -->|"reads spaces and settings"| node_database
node_manager -->|"manages property"| node_admin_ui
node_admin_ui -->|"authenticates"| node_login
node_admin_ui -->|"searches requests"| node_dashboard
node_admin_ui -->|"accepts or declines"| node_decisions
node_admin_ui -->|"manages spaces"| node_space_mgmt
node_admin_ui -->|"edits details"| node_site_settings
node_login -->|"uses sessions"| node_auth
node_login -->|"reads and updates admins"| node_database
node_dashboard -->|"reads requests"| node_database
node_decisions -->|"records decisions"| node_database
node_space_mgmt -->|"manages spaces and photos"| node_database
node_site_settings -->|"reads and writes settings"| node_database
node_public_api -->|"validates submissions"| node_util
node_app -->|"mounts routes"| node_public_api
node_app -->|"mounts admin routes"| node_login
node_app -->|"serves static files"| node_admin_ui

click node_public_ui "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/public/js/site.js"
click node_hero "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/public/js/scroll-hero.js"
click node_public_api "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/public.js"
click node_request_flow "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/public.js"
click node_admin_ui "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/public/admin/admin.js"
click node_login "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/admin.js"
click node_auth "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/auth.js"
click node_dashboard "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/admin.js"
click node_decisions "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/admin.js"
click node_space_mgmt "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/admin.js"
click node_site_settings "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/admin.js"
click node_util "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/util.js"
click node_app "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/app.js"
click node_database "https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/db.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_public_ui,node_hero,node_request_flow toneBlue
class node_admin_ui,node_dashboard,node_decisions,node_space_mgmt,node_site_settings toneAmber
class node_public_api,node_login,node_auth,node_util,node_app toneMint
class node_database toneRose
class node_visitor,node_manager toneIndigo
```

## Components

### Public experience

- [Public site](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/public/js/site.js): `public/js/site.js`
- [Scroll hero](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/public/js/scroll-hero.js): `public/js/scroll-hero.js`
- [Request submission](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/public.js): `src/routes/public.js`

### Administration

- [Admin interface](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/public/admin/admin.js): `public/admin/admin.js`
- [Request dashboard](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/admin.js): `src/routes/admin.js`
- [Request decisions](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/admin.js): `src/routes/admin.js`
- [Space management](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/admin.js): `src/routes/admin.js`
- [Site settings](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/admin.js): `src/routes/admin.js`

### Application server

- [Public API](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/public.js): `src/routes/public.js`
- [Admin authentication](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/routes/admin.js): `src/routes/admin.js`
- [Sessions and passwords](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/auth.js): `src/auth.js`
- [Validation and limits](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/util.js): `src/util.js`
- [Express app](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/app.js): `src/app.js`

### Persistence

- [SQLite data](https://github.com/cc-jpg2077/sky888-commercial-spaces/blob/main/src/db.js): `src/db.js`

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → Public site: browses and submits (evidence: `README.md`)
- Public site → Public API: loads site data (evidence: `README.md`)
- Public site → Request submission: posts request (evidence: `public/js/site.js`)
- Scroll hero → Public site: expands page (evidence: `public/js/scroll-hero.js`)
- Request submission → SQLite data: stores request (evidence: `src/routes/public.js`)
- Public API → SQLite data: reads spaces and settings (evidence: `src/routes/public.js`)
- Administrator → Admin interface: manages property (evidence: `README.md`)
- Admin interface → Admin authentication: authenticates (evidence: `README.md`)
- Admin interface → Request dashboard: searches requests (evidence: `README.md`)
- Admin interface → Request decisions: accepts or declines (evidence: `README.md`)
- Admin interface → Space management: manages spaces (evidence: `README.md`)
- Admin interface → Site settings: edits details (evidence: `README.md`)
- Admin authentication → Sessions and passwords: uses sessions (evidence: `src/routes/admin.js`)
- Admin authentication → SQLite data: reads and updates admins (evidence: `src/routes/admin.js`)
- Request dashboard → SQLite data: reads requests (evidence: `src/routes/admin.js`)
- Request decisions → SQLite data: records decisions (evidence: `README.md`)
- Space management → SQLite data: manages spaces and photos (evidence: `src/routes/admin.js`)
- Site settings → SQLite data: reads and writes settings (evidence: `src/routes/admin.js`)
- Public API → Validation and limits: validates submissions (evidence: `src/routes/public.js`)
- Express app → Public API: mounts routes (evidence: `src/app.js`)
- Express app → Admin authentication: mounts admin routes (evidence: `src/app.js`)
- Express app → Admin interface: serves static files (evidence: `src/app.js`)
