# tzzii/tres-marias-web-system architecture

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

- Interactive diagram: https://gitdiagram.com/tzzii/tres-marias-web-system
- Repository: https://github.com/tzzii/tres-marias-web-system

## Overview

Tres Marias is a catering booking and operations product: customers browse packages, sign up, book and manage reservations, communicate, and pay; administrators manage those reservations and the wider business. The separately deployed portals share a service layer, while the README describes the API as the data backend for all major capabilities. Several API feature implementations are represented by their exact module directories because their source was not sampled; edges reflect only routes shown or README-documented connections.

Main entry points: [`apps/api/src/app.js`](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/api/src/app.js) (API routing), [`apps/admin/src/App.jsx`](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/admin/src/App.jsx) (Admin workspace), [`packages/shared/src/services/config.js`](https://github.com/tzzii/tres-marias-web-system/blob/main/packages/shared/src/services/config.js) (Shared service layer), [`apps/client/src/App.jsx`](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/client/src/App.jsx) (Public site and portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer portal"]
  node_clientapp["Public site and portal<br/>[App.jsx]"]
  node_booking["Booking workflow<br/>[BookEventPage.jsx]"]
end

subgraph group_admin["Admin dashboard"]
  node_adminapp["Admin workspace<br/>[App.jsx]"]
  node_reservationadmin["Reservation operations"]
  node_outsourceadmin["Outsourcing management<br/>[OutsourcePage.jsx]"]
  node_adminsession["Admin sessions<br/>[auth.js]"]
end

subgraph group_shared["Shared frontend"]
  node_authsession["Portal sessions<br/>[auth.js]"]
  node_sharedservices["Shared service layer<br/>[config.js]"]
  node_bookingrules["Reservation rules"]
  node_sharedstore[("Local data store<br/>[store.js]")]
  node_seeddata["Seed records<br/>[seed.js]"]
end

subgraph group_api["API services"]
  node_apiapp["API routing<br/>[app.js]"]
  node_authapi["Authentication"]
  node_catalogapi["Package catalogue"]
  node_calendarapi["Calendar availability"]
  node_reservationapi["Reservations"]
  node_paymentapi["Payments and refunds"]
  node_messageapi["Customer messaging"]
  node_otherapi["Business operations"]
  node_mysqldb[("MySQL database<br/>[db.js]")]
end

subgraph group_integrations["External services"]
  node_paymongo["PayMongo<br/>[index.js]"]
  node_delivery["Mail and SMS providers"]
  node_storage["Receipt storage<br/>[index.js]"]
end

node_guest(("Guest or customer"))
node_adminuser(("Administrator"))

node_guest -->|"browses and manages"| node_clientapp
node_clientapp -->|"routes booking to"| node_booking
node_clientapp -->|"uses session"| node_authsession
node_adminuser -->|"uses"| node_adminapp
node_adminapp -->|"routes reservation detail"| node_reservationadmin
node_adminapp -->|"routes operations"| node_outsourceadmin
node_adminapp -->|"guards routes with"| node_adminsession
node_clientapp -->|"uses data services"| node_sharedservices
node_adminapp -->|"uses data services"| node_sharedservices
node_booking -.->|"submits booking through"| node_sharedservices
node_sharedservices -->|"delegates reservation rules"| node_bookingrules
node_bookingrules -->|"reads and writes"| node_sharedstore
node_sharedstore -->|"loads seed records"| node_seeddata
node_sharedservices -->|"calls API when enabled"| node_apiapp
node_apiapp -->|"mounts routes"| node_authapi
node_apiapp -->|"mounts routes"| node_catalogapi
node_apiapp -->|"mounts routes"| node_calendarapi
node_apiapp -->|"mounts routes"| node_reservationapi
node_apiapp -->|"mounts routes"| node_paymentapi
node_apiapp -->|"mounts routes"| node_messageapi
node_apiapp -->|"mounts business routes"| node_otherapi
node_reservationapi -.->|"persists reservation data"| node_mysqldb
node_paymentapi -.->|"persists payment data"| node_mysqldb
node_paymentapi -.->|"creates QR payments"| node_paymongo
node_paymentapi -->|"stores receipt uploads"| node_storage
node_authapi -.->|"sends sign-in codes"| node_delivery

click node_clientapp "https://github.com/tzzii/tres-marias-web-system/blob/main/apps/client/src/App.jsx"
click node_booking "https://github.com/tzzii/tres-marias-web-system/blob/main/apps/client/src/pages/portal/BookEventPage.jsx"
click node_adminapp "https://github.com/tzzii/tres-marias-web-system/blob/main/apps/admin/src/App.jsx"
click node_reservationadmin "https://github.com/tzzii/tres-marias-web-system/blob/main/apps/admin/src/pages/ReservationDetailPage.jsx"
click node_outsourceadmin "https://github.com/tzzii/tres-marias-web-system/blob/main/apps/admin/src/pages/OutsourcePage.jsx"
click node_authsession "https://github.com/tzzii/tres-marias-web-system/blob/main/apps/client/src/auth.js"
click node_adminsession "https://github.com/tzzii/tres-marias-web-system/blob/main/apps/admin/src/auth.js"
click node_sharedservices "https://github.com/tzzii/tres-marias-web-system/blob/main/packages/shared/src/services/config.js"
click node_bookingrules "https://github.com/tzzii/tres-marias-web-system/blob/main/packages/shared/src/services/reservationService.js"
click node_sharedstore "https://github.com/tzzii/tres-marias-web-system/blob/main/packages/shared/src/services/store.js"
click node_seeddata "https://github.com/tzzii/tres-marias-web-system/blob/main/packages/shared/src/services/seed.js"
click node_apiapp "https://github.com/tzzii/tres-marias-web-system/blob/main/apps/api/src/app.js"
click node_authapi "https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules/auth"
click node_catalogapi "https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules/catalog"
click node_calendarapi "https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules/calendar"
click node_reservationapi "https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules/reservations"
click node_paymentapi "https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules/payments"
click node_messageapi "https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules/messages"
click node_otherapi "https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules"
click node_mysqldb "https://github.com/tzzii/tres-marias-web-system/blob/main/apps/api/src/db.js"
click node_paymongo "https://github.com/tzzii/tres-marias-web-system/blob/main/apps/api/src/integrations/paymongo/index.js"
click node_delivery "https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/integrations"
click node_storage "https://github.com/tzzii/tres-marias-web-system/blob/main/apps/api/src/integrations/storage/index.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_clientapp,node_booking toneBlue
class node_adminapp,node_reservationadmin,node_outsourceadmin,node_adminsession toneAmber
class node_authsession,node_sharedservices,node_bookingrules,node_sharedstore,node_seeddata toneMint
class node_apiapp,node_authapi,node_catalogapi,node_calendarapi,node_reservationapi,node_paymentapi,node_messageapi,node_otherapi,node_mysqldb toneRose
class node_paymongo,node_delivery,node_storage,node_guest,node_adminuser toneIndigo
```

## Components

### Customer portal

- [Public site and portal](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/client/src/App.jsx): `apps/client/src/App.jsx`
- [Booking workflow](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/client/src/pages/portal/BookEventPage.jsx): `apps/client/src/pages/portal/BookEventPage.jsx`

### Admin dashboard

- [Admin workspace](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/admin/src/App.jsx): `apps/admin/src/App.jsx`
- [Reservation operations](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/admin/src/pages/ReservationDetailPage.jsx): `apps/admin/src/pages/ReservationDetailPage.jsx`
- [Outsourcing management](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/admin/src/pages/OutsourcePage.jsx): `apps/admin/src/pages/OutsourcePage.jsx`
- [Admin sessions](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/admin/src/auth.js): `apps/admin/src/auth.js`

### Shared frontend

- [Portal sessions](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/client/src/auth.js): `apps/client/src/auth.js`
- [Shared service layer](https://github.com/tzzii/tres-marias-web-system/blob/main/packages/shared/src/services/config.js): `packages/shared/src/services/config.js`
- [Reservation rules](https://github.com/tzzii/tres-marias-web-system/blob/main/packages/shared/src/services/reservationService.js): `packages/shared/src/services/reservationService.js`
- [Local data store](https://github.com/tzzii/tres-marias-web-system/blob/main/packages/shared/src/services/store.js): `packages/shared/src/services/store.js`
- [Seed records](https://github.com/tzzii/tres-marias-web-system/blob/main/packages/shared/src/services/seed.js): `packages/shared/src/services/seed.js`

### API services

- [API routing](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/api/src/app.js): `apps/api/src/app.js`
- [Authentication](https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules/auth): `apps/api/src/modules/auth`
- [Package catalogue](https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules/catalog): `apps/api/src/modules/catalog`
- [Calendar availability](https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules/calendar): `apps/api/src/modules/calendar`
- [Reservations](https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules/reservations): `apps/api/src/modules/reservations`
- [Payments and refunds](https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules/payments): `apps/api/src/modules/payments`
- [Customer messaging](https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules/messages): `apps/api/src/modules/messages`
- [Business operations](https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/modules): `apps/api/src/modules`
- [MySQL database](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/api/src/db.js): `apps/api/src/db.js`

### External services

- [PayMongo](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/api/src/integrations/paymongo/index.js): `apps/api/src/integrations/paymongo/index.js`
- [Mail and SMS providers](https://github.com/tzzii/tres-marias-web-system/tree/main/apps/api/src/integrations): `apps/api/src/integrations`
- [Receipt storage](https://github.com/tzzii/tres-marias-web-system/blob/main/apps/api/src/integrations/storage/index.js): `apps/api/src/integrations/storage/index.js`

### Other components

- **Guest or customer**
- **Administrator**

## Connections

- Guest or customer → Public site and portal: browses and manages (evidence: `apps/client/src/App.jsx`)
- Public site and portal → Booking workflow: routes booking to (evidence: `apps/client/src/App.jsx`)
- Public site and portal → Portal sessions: uses session (evidence: `apps/client/src/main.jsx`)
- Administrator → Admin workspace: uses (evidence: `apps/admin/src/App.jsx`)
- Admin workspace → Reservation operations: routes reservation detail (evidence: `apps/admin/src/App.jsx`)
- Admin workspace → Outsourcing management: routes operations (evidence: `apps/admin/src/App.jsx`)
- Admin workspace → Admin sessions: guards routes with (evidence: `apps/admin/src/App.jsx`)
- Public site and portal → Shared service layer: uses data services
- Admin workspace → Shared service layer: uses data services
- Booking workflow → Shared service layer: submits booking through
- Shared service layer → Reservation rules: delegates reservation rules (evidence: `packages/shared/src/services/reservationService.js`)
- Reservation rules → Local data store: reads and writes (evidence: `packages/shared/src/services/reservationService.js`)
- Local data store → Seed records: loads seed records (evidence: `packages/shared/src/services/store.js`)
- Shared service layer → API routing: calls API when enabled
- API routing → Authentication: mounts routes (evidence: `apps/api/src/app.js`)
- API routing → Package catalogue: mounts routes (evidence: `apps/api/src/app.js`)
- API routing → Calendar availability: mounts routes (evidence: `apps/api/src/app.js`)
- API routing → Reservations: mounts routes (evidence: `apps/api/src/app.js`)
- API routing → Payments and refunds: mounts routes (evidence: `apps/api/src/app.js`)
- API routing → Customer messaging: mounts routes (evidence: `apps/api/src/app.js`)
- API routing → Business operations: mounts business routes (evidence: `apps/api/src/app.js`)
- Reservations → MySQL database: persists reservation data
- Payments and refunds → MySQL database: persists payment data
- Payments and refunds → PayMongo: creates QR payments
- Payments and refunds → Receipt storage: stores receipt uploads (evidence: `apps/api/src/modules/payments/payments.routes.js`)
- Authentication → Mail and SMS providers: sends sign-in codes
