# js-goodapakam/friday-desk-client architecture

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

- Interactive diagram: https://gitdiagram.com/js-goodapakam/friday-desk-client
- Repository: https://github.com/js-goodapakam/friday-desk-client

## Overview

Friday AI Desk Client is a React SPA for hotel operations. The user-facing workflow enters through the app shell, continues into onboarding or the operations dashboard, and branches into desk modules for reservations, guests, requests, rooms, calendar, finance, invoices, and reporting. Settings manage property, room, and staff records and expose communication-provider configuration; Friday AI is a separate product capability. Shared browser-persisted application data supports the operational modules. Some page implementations and routing details were not sampled, so links rely on the README and SOURCE INDEX where indicated.

Main entry points: [`src/App.jsx`](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/App.jsx) (App shell), [`src/core/data.js`](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/core/data.js) (Hotel data), [`src/pages/Settings.jsx`](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Settings.jsx) (Settings), [`src/pages/Reservations.jsx`](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Reservations.jsx) (Reservations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["App shell<br/>[App.jsx]"]
  node_onboarding["Onboarding<br/>[Onboarding.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_friday["Friday AI<br/>[Friday.jsx]"]
end

subgraph group_operations["Hotel operations"]
  node_reservations["Reservations<br/>[Reservations.jsx]"]
  node_guests["Guests<br/>[Guests.jsx]"]
  node_requests["Requests<br/>[Requests.jsx]"]
  node_rooms["Rooms<br/>[Rooms.jsx]"]
  node_calendar["Calendar<br/>[Calendar.jsx]"]
  node_finance["Finance<br/>[Finance.jsx]"]
  node_invoices["Invoices<br/>[Invoices.jsx]"]
  node_reports["Reports<br/>[Reports.jsx]"]
  node_help["Help<br/>[Help.jsx]"]
end

subgraph group_admin["Administration"]
  node_settings["Settings<br/>[Settings.jsx]"]
  node_property_editor["Property editor<br/>[PropertyEditor.jsx]"]
  node_room_editor["Room editor<br/>[RoomEditor.jsx]"]
  node_user_editor["Staff editor<br/>[UserEditor.jsx]"]
  node_telecmi["TeleCMI status<br/>[telecmi.js]"]
end

subgraph group_shared["Shared data"]
  node_data["Hotel data<br/>[data.js]"]
  node_storage[("Browser storage")]
end

node_user(("Hotel user"))

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_onboarding
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_friday
node_app -->|"routes to"| node_reservations
node_app -->|"routes to"| node_guests
node_app -->|"routes to"| node_requests
node_app -->|"routes to"| node_rooms
node_app -->|"routes to"| node_calendar
node_app -->|"routes to"| node_finance
node_app -->|"routes to"| node_invoices
node_app -->|"routes to"| node_reports
node_app -->|"routes to"| node_help
node_app -->|"routes to"| node_settings
node_app -->|"uses"| node_data
node_reservations -->|"uses"| node_data
node_guests -->|"reads and updates"| node_data
node_requests -->|"uses"| node_data
node_calendar -->|"uses"| node_data
node_finance -->|"uses"| node_data
node_invoices -->|"uses"| node_data
node_reports -->|"uses"| node_data
node_settings -->|"updates"| node_data
node_settings -->|"renders"| node_property_editor
node_settings -->|"renders"| node_room_editor
node_settings -->|"renders"| node_user_editor
node_settings -->|"reads status"| node_telecmi
node_data -->|"loads from"| node_storage

click node_app "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/App.jsx"
click node_onboarding "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/Onboarding.jsx"
click node_dashboard "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/Dashboard.jsx"
click node_friday "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/Friday.jsx"
click node_reservations "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Reservations.jsx"
click node_guests "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Guests.jsx"
click node_requests "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Requests.jsx"
click node_rooms "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Rooms.jsx"
click node_calendar "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Calendar.jsx"
click node_finance "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Finance.jsx"
click node_invoices "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Invoices.jsx"
click node_reports "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Reports.jsx"
click node_help "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Help.jsx"
click node_settings "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Settings.jsx"
click node_property_editor "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/components/settings/PropertyEditor.jsx"
click node_room_editor "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/components/settings/RoomEditor.jsx"
click node_user_editor "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/components/settings/UserEditor.jsx"
click node_telecmi "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/services/telecmi.js"
click node_data "https://github.com/js-goodapakam/friday-desk-client/blob/main/src/core/data.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_app,node_onboarding,node_dashboard,node_friday,node_user toneBlue
class node_reservations,node_guests,node_requests,node_rooms,node_calendar,node_finance,node_invoices,node_reports,node_help toneAmber
class node_settings,node_property_editor,node_room_editor,node_user_editor,node_telecmi toneMint
class node_data,node_storage toneRose
```

## Components

### Application shell

- [App shell](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/App.jsx): `src/App.jsx`
- [Onboarding](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/Onboarding.jsx): `src/Onboarding.jsx`
- [Dashboard](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/Dashboard.jsx): `src/Dashboard.jsx`
- [Friday AI](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/Friday.jsx): `src/Friday.jsx`

### Hotel operations

- [Reservations](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Reservations.jsx): `src/pages/Reservations.jsx`
- [Guests](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Guests.jsx): `src/pages/Guests.jsx`
- [Requests](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Requests.jsx): `src/pages/Requests.jsx`
- [Rooms](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Rooms.jsx): `src/pages/Rooms.jsx`
- [Calendar](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Calendar.jsx): `src/pages/Calendar.jsx`
- [Finance](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Finance.jsx): `src/pages/Finance.jsx`
- [Invoices](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Invoices.jsx): `src/pages/Invoices.jsx`
- [Reports](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Reports.jsx): `src/pages/Reports.jsx`
- [Help](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Help.jsx): `src/pages/Help.jsx`

### Administration

- [Settings](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/pages/Settings.jsx): `src/pages/Settings.jsx`
- [Property editor](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/components/settings/PropertyEditor.jsx): `src/components/settings/PropertyEditor.jsx`
- [Room editor](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/components/settings/RoomEditor.jsx): `src/components/settings/RoomEditor.jsx`
- [Staff editor](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/components/settings/UserEditor.jsx): `src/components/settings/UserEditor.jsx`
- [TeleCMI status](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/services/telecmi.js): `src/services/telecmi.js`

### Shared data

- [Hotel data](https://github.com/js-goodapakam/friday-desk-client/blob/main/src/core/data.js): `src/core/data.js`
- **Browser storage**

### Other components

- **Hotel user**

## Connections

- Hotel user → App shell: opens (evidence: `README.md`)
- App shell → Onboarding: routes to (evidence: `src/App.jsx`)
- App shell → Dashboard: routes to (evidence: `src/App.jsx`)
- App shell → Friday AI: routes to (evidence: `src/App.jsx`)
- App shell → Reservations: routes to (evidence: `src/App.jsx`)
- App shell → Guests: routes to (evidence: `src/App.jsx`)
- App shell → Requests: routes to (evidence: `src/App.jsx`)
- App shell → Rooms: routes to (evidence: `src/App.jsx`)
- App shell → Calendar: routes to (evidence: `src/App.jsx`)
- App shell → Finance: routes to (evidence: `src/App.jsx`)
- App shell → Invoices: routes to (evidence: `src/App.jsx`)
- App shell → Reports: routes to (evidence: `src/App.jsx`)
- App shell → Help: routes to (evidence: `src/App.jsx`)
- App shell → Settings: routes to (evidence: `src/App.jsx`)
- App shell → Hotel data: uses (evidence: `src/App.jsx`)
- Reservations → Hotel data: uses (evidence: `src/core/data.js`)
- Guests → Hotel data: reads and updates (evidence: `src/pages/Guests.jsx`)
- Requests → Hotel data: uses (evidence: `src/pages/Requests.jsx`)
- Calendar → Hotel data: uses (evidence: `src/pages/Calendar.jsx`)
- Finance → Hotel data: uses (evidence: `src/pages/Finance.jsx`)
- Invoices → Hotel data: uses (evidence: `src/pages/Invoices.jsx`)
- Reports → Hotel data: uses (evidence: `src/pages/Reports.jsx`)
- Settings → Hotel data: updates (evidence: `src/pages/Settings.jsx`)
- Settings → Property editor: renders (evidence: `src/pages/Settings.jsx`)
- Settings → Room editor: renders (evidence: `src/pages/Settings.jsx`)
- Settings → Staff editor: renders (evidence: `src/pages/Settings.jsx`)
- Settings → TeleCMI status: reads status (evidence: `src/pages/Settings.jsx`)
- Hotel data → Browser storage: loads from (evidence: `src/core/data.js`)
