# gabriellecruzz/salon-manager architecture

> Architecture diagram of the GitHub repository gabriellecruzz/salon-manager, 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/gabriellecruzz/salon-manager
- Repository: https://github.com/gabriellecruzz/salon-manager

## Overview

Beauty Studio System is a browser-based studio management app for scheduling, client records, and financial reporting. The main workflow is entering an appointment, managing its status and payment in the agenda, then using completed appointments for financial summaries. Client records are also managed in a separate browser-local workflow; a small Express backend exposes account and client routes, but the shown frontend does not connect to it. The README names these capabilities, while unsampled pages and scripts limit confirmation of their wiring.

Main entry points: [`backend/server.js`](https://github.com/gabriellecruzz/salon-manager/blob/main/backend/server.js) (Express API), [`js/dashboard.js`](https://github.com/gabriellecruzz/salon-manager/blob/main/js/dashboard.js) (Appointment Entry), [`js/schedule.js`](https://github.com/gabriellecruzz/salon-manager/blob/main/js/schedule.js) (Agenda and Payments), [`js/clients.js`](https://github.com/gabriellecruzz/salon-manager/blob/main/js/clients.js) (Client Records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_appointments["Appointments"]
  node_dashboard["Appointment Entry<br/>[dashboard.js]"]
  node_schedule["Agenda and Payments<br/>[schedule.js]"]
  node_schedule_api["Schedule Routes<br/>[schedule.js]"]
  node_local_appointments[("Browser Appointment Data<br/>[schedule.js]")]
end

subgraph group_clients["Client Management"]
  node_client_ui["Client Records<br/>[clients.js]"]
  node_client_api["Client Routes<br/>[clients.js]"]
  node_client_store[("Browser Client Data<br/>[clients.js]")]
  node_client_memory[("In-Memory Clients<br/>[clients.js]")]
end

subgraph group_finance["Financial Reporting"]
  node_reports["Report Calculations<br/>[financial-data.js]"]
  node_finance_ui["Finance Dashboard<br/>[finance.js]"]
end

subgraph group_platform["App and API"]
  node_app_menu["Navigation Menu<br/>[menu.js]"]
  node_menu_markup["Menu Markup<br/>[menu.html]"]
  node_api_server["Express API<br/>[server.js]"]
  node_user_routes["Account Registration<br/>[users.js]"]
  node_account_store[("In-Memory Accounts<br/>[users.js]")]
end

node_studio_user(("Studio Staff"))

node_studio_user -->|"enters appointments"| node_dashboard
node_dashboard -->|"adds agenda entry"| node_schedule
node_schedule -->|"reads and writes"| node_local_appointments
node_studio_user -->|"manages clients"| node_client_ui
node_client_ui -->|"reads and writes"| node_client_store
node_studio_user -->|"reviews finances"| node_finance_ui
node_finance_ui -->|"requests summaries"| node_reports
node_reports -->|"reads appointments"| node_local_appointments
node_app_menu -->|"fetches markup"| node_menu_markup
node_api_server -->|"registers routes"| node_user_routes
node_api_server -->|"registers routes"| node_client_api
node_user_routes -->|"stores accounts"| node_account_store
node_client_api -->|"reads and updates"| node_client_memory

click node_dashboard "https://github.com/gabriellecruzz/salon-manager/blob/main/js/dashboard.js"
click node_schedule "https://github.com/gabriellecruzz/salon-manager/blob/main/js/schedule.js"
click node_schedule_api "https://github.com/gabriellecruzz/salon-manager/blob/main/backend/routes/schedule.js"
click node_client_ui "https://github.com/gabriellecruzz/salon-manager/blob/main/js/clients.js"
click node_client_api "https://github.com/gabriellecruzz/salon-manager/blob/main/backend/routes/clients.js"
click node_client_store "https://github.com/gabriellecruzz/salon-manager/blob/main/js/clients.js"
click node_reports "https://github.com/gabriellecruzz/salon-manager/blob/main/js/financial-data.js"
click node_finance_ui "https://github.com/gabriellecruzz/salon-manager/blob/main/js/finance.js"
click node_local_appointments "https://github.com/gabriellecruzz/salon-manager/blob/main/js/schedule.js"
click node_app_menu "https://github.com/gabriellecruzz/salon-manager/blob/main/js/menu.js"
click node_menu_markup "https://github.com/gabriellecruzz/salon-manager/blob/main/components/menu.html"
click node_api_server "https://github.com/gabriellecruzz/salon-manager/blob/main/backend/server.js"
click node_user_routes "https://github.com/gabriellecruzz/salon-manager/blob/main/backend/routes/users.js"
click node_account_store "https://github.com/gabriellecruzz/salon-manager/blob/main/backend/routes/users.js"
click node_client_memory "https://github.com/gabriellecruzz/salon-manager/blob/main/backend/routes/clients.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_dashboard,node_schedule,node_schedule_api,node_local_appointments toneBlue
class node_client_ui,node_client_api,node_client_store,node_client_memory toneAmber
class node_reports,node_finance_ui toneMint
class node_app_menu,node_menu_markup,node_api_server,node_user_routes,node_account_store toneRose
class node_studio_user toneIndigo
```

## Components

### Appointments

- [Appointment Entry](https://github.com/gabriellecruzz/salon-manager/blob/main/js/dashboard.js): `js/dashboard.js`
- [Agenda and Payments](https://github.com/gabriellecruzz/salon-manager/blob/main/js/schedule.js): `js/schedule.js`
- [Schedule Routes](https://github.com/gabriellecruzz/salon-manager/blob/main/backend/routes/schedule.js): `backend/routes/schedule.js`
- [Browser Appointment Data](https://github.com/gabriellecruzz/salon-manager/blob/main/js/schedule.js): `js/schedule.js`

### Client Management

- [Client Records](https://github.com/gabriellecruzz/salon-manager/blob/main/js/clients.js): `js/clients.js`
- [Client Routes](https://github.com/gabriellecruzz/salon-manager/blob/main/backend/routes/clients.js): `backend/routes/clients.js`
- [Browser Client Data](https://github.com/gabriellecruzz/salon-manager/blob/main/js/clients.js): `js/clients.js`
- [In-Memory Clients](https://github.com/gabriellecruzz/salon-manager/blob/main/backend/routes/clients.js): `backend/routes/clients.js`

### Financial Reporting

- [Report Calculations](https://github.com/gabriellecruzz/salon-manager/blob/main/js/financial-data.js): `js/financial-data.js`
- [Finance Dashboard](https://github.com/gabriellecruzz/salon-manager/blob/main/js/finance.js): `js/finance.js`

### App and API

- [Navigation Menu](https://github.com/gabriellecruzz/salon-manager/blob/main/js/menu.js): `js/menu.js`
- [Menu Markup](https://github.com/gabriellecruzz/salon-manager/blob/main/components/menu.html): `components/menu.html`
- [Express API](https://github.com/gabriellecruzz/salon-manager/blob/main/backend/server.js): `backend/server.js`
- [Account Registration](https://github.com/gabriellecruzz/salon-manager/blob/main/backend/routes/users.js): `backend/routes/users.js`
- [In-Memory Accounts](https://github.com/gabriellecruzz/salon-manager/blob/main/backend/routes/users.js): `backend/routes/users.js`

### Other components

- **Studio Staff**

## Connections

- Studio Staff → Appointment Entry: enters appointments (evidence: `js/dashboard.js`)
- Appointment Entry → Agenda and Payments: adds agenda entry (evidence: `js/dashboard.js`)
- Agenda and Payments → Browser Appointment Data: reads and writes (evidence: `js/schedule.js`)
- Studio Staff → Client Records: manages clients (evidence: `js/clients.js`)
- Client Records → Browser Client Data: reads and writes (evidence: `js/clients.js`)
- Studio Staff → Finance Dashboard: reviews finances (evidence: `js/finance.js`)
- Finance Dashboard → Report Calculations: requests summaries (evidence: `js/finance.js`)
- Report Calculations → Browser Appointment Data: reads appointments (evidence: `js/financial-data.js`)
- Navigation Menu → Menu Markup: fetches markup (evidence: `js/menu.js`)
- Express API → Account Registration: registers routes (evidence: `backend/server.js`)
- Express API → Client Routes: registers routes (evidence: `backend/server.js`)
- Account Registration → In-Memory Accounts: stores accounts (evidence: `backend/routes/users.js`)
- Client Routes → In-Memory Clients: reads and updates (evidence: `backend/routes/clients.js`)
