# guilhermesousarosendo/barbershop_appoinment_book architecture

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

- Interactive diagram: https://gitdiagram.com/guilhermesousarosendo/barbershop_appoinment_book
- Repository: https://github.com/guilhermesousarosendo/barbershop_appoinment_book

## Overview

BarberTime is a browser-based barbershop appointment prototype. A customer registers or logs in, checks barber availability, books a service, and can initiate simulated Pix payment; barbers manage schedules and appointments. The sampled code shows the registration flow and server-side booking, schedule, and payment routes. Several frontend pages and persistence helpers are not present in the excerpts, so those links are left unverified rather than inferred as direct calls.

Main entry points: [`db.json`](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/db.json) (JSON data store), [`public`](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/tree/main/public) (Browser pages), [`server.js`](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js) (Appointment routes), [`public/js/app.js`](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/public/js/app.js) (Session and navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Browser client"]
  node_browser["Browser pages"]
  node_session["Session and navigation<br/>[app.js]"]
  node_api_client["API client<br/>[app.js]"]
end

subgraph group_booking["Booking domain"]
  node_account_routes["Account routes<br/>[server.js]"]
  node_service_routes["Service listing<br/>[server.js]"]
  node_availability["Availability and agenda<br/>[server.js]"]
  node_appointment_routes["Appointment routes<br/>[server.js]"]
  node_slot_builder["Slot calculation<br/>[server.js]"]
end

subgraph group_operations["Barber operations"]
  node_barber_accounts["Barber user management<br/>[server.js]"]
  node_schedule_routes["Schedule management<br/>[server.js]"]
end

subgraph group_payment["Payment"]
  node_pix_routes["Pix payment flow<br/>[server.js]"]
  node_qr_generator["QR generation<br/>[server.js]"]
end

subgraph group_persistence["Persistence"]
  node_json_store[("JSON data store<br/>[db.json]")]
end

node_customer(("Customer"))
node_barber(("Barber"))
node_qrcode_package["QRCode package"]

node_customer -->|"uses"| node_browser
node_barber -.->|"uses"| node_browser
node_browser -.->|"loads"| node_session
node_session -->|"submits registration"| node_api_client
node_api_client -->|"posts registration"| node_account_routes
node_service_routes -.->|"reads services"| node_json_store
node_availability -->|"builds slots"| node_slot_builder
node_appointment_routes -.->|"checks availability"| node_slot_builder
node_appointment_routes -.->|"reads and writes"| node_json_store
node_barber_accounts -.->|"reads and writes"| node_json_store
node_schedule_routes -.->|"reads and writes"| node_json_store
node_pix_routes -->|"generates QR"| node_qr_generator
node_qr_generator -->|"creates data URL"| node_qrcode_package
node_pix_routes -.->|"reads and writes"| node_json_store

click node_browser "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/tree/main/public"
click node_session "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/public/js/app.js"
click node_api_client "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/public/js/app.js"
click node_account_routes "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js"
click node_service_routes "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js"
click node_availability "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js"
click node_appointment_routes "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js"
click node_slot_builder "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js"
click node_barber_accounts "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js"
click node_schedule_routes "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js"
click node_pix_routes "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js"
click node_qr_generator "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js"
click node_json_store "https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/db.json"

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_browser,node_session,node_api_client toneBlue
class node_account_routes,node_service_routes,node_availability,node_appointment_routes,node_slot_builder toneAmber
class node_barber_accounts,node_schedule_routes toneMint
class node_pix_routes,node_qr_generator toneRose
class node_json_store,node_customer,node_barber,node_qrcode_package toneIndigo
```

## Components

### Browser client

- [Browser pages](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/tree/main/public): `public`
- [Session and navigation](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/public/js/app.js): `public/js/app.js`
- [API client](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/public/js/app.js): `public/js/app.js`

### Booking domain

- [Account routes](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js): `server.js`
- [Service listing](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js): `server.js`
- [Availability and agenda](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js): `server.js`
- [Appointment routes](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js): `server.js`
- [Slot calculation](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js): `server.js`

### Barber operations

- [Barber user management](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js): `server.js`
- [Schedule management](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js): `server.js`

### Payment

- [Pix payment flow](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js): `server.js`
- [QR generation](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/server.js): `server.js`

### Persistence

- [JSON data store](https://github.com/guilhermesousarosendo/barbershop_appoinment_book/blob/main/db.json): `db.json`

### Other components

- **Customer**
- **Barber**
- **QRCode package**

## Connections

- Customer → Browser pages: uses (evidence: `README.md`)
- Barber → Browser pages: uses
- Browser pages → Session and navigation: loads
- Session and navigation → API client: submits registration (evidence: `public/js/app.js`)
- API client → Account routes: posts registration (evidence: `public/js/app.js`)
- Service listing → JSON data store: reads services
- Availability and agenda → Slot calculation: builds slots (evidence: `server.js`)
- Appointment routes → Slot calculation: checks availability (evidence: `server.js`)
- Appointment routes → JSON data store: reads and writes
- Barber user management → JSON data store: reads and writes
- Schedule management → JSON data store: reads and writes
- Pix payment flow → QR generation: generates QR (evidence: `server.js`)
- QR generation → QRCode package: creates data URL (evidence: `server.js`)
- Pix payment flow → JSON data store: reads and writes
