How tzzii/tres-marias-web-system works
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: app.js API routing · src/App.jsx Admin workspace · config.js Shared service layer · src/App.jsx Public site and portal
Components 25
Customer portal
- Public site and portal
apps/client/src/App.jsx - Booking workflow
apps/client/src/pages/portal/BookEventPage.jsx
Admin dashboard
- Admin workspace
apps/admin/src/App.jsx - Reservation operations
apps/admin/src/pages/ReservationDetailPage.jsx - Outsourcing management
apps/admin/src/pages/OutsourcePage.jsx - Admin sessions
apps/admin/src/auth.js
Shared frontend
- Portal sessions
apps/client/src/auth.js - Shared service layer
packages/shared/src/services/config.js - Reservation rules
packages/shared/src/services/reservationService.js - Local data store
packages/shared/src/services/store.js - Seed records
packages/shared/src/services/seed.js
API services
- API routing
apps/api/src/app.js - Authentication
apps/api/src/modules/auth - Package catalogue
apps/api/src/modules/catalog - Calendar availability
apps/api/src/modules/calendar - Reservations
apps/api/src/modules/reservations - Payments and refunds
apps/api/src/modules/payments - Customer messaging
apps/api/src/modules/messages - Business operations
apps/api/src/modules - MySQL database
apps/api/src/db.js
External services
- PayMongo
apps/api/src/integrations/paymongo/index.js - Mail and SMS providers
apps/api/src/integrations - Receipt storage
apps/api/src/integrations/storage/index.js
Other components
- Guest or customer
- Administrator
Connections 26
- Guest or customer → Public site and portal: browses and manages
apps/client/src/App.jsx - Public site and portal → Booking workflow: routes booking to
apps/client/src/App.jsx - Public site and portal → Portal sessions: uses session
apps/client/src/main.jsx - Administrator → Admin workspace: uses
apps/admin/src/App.jsx - Admin workspace → Reservation operations: routes reservation detail
apps/admin/src/App.jsx - Admin workspace → Outsourcing management: routes operations
apps/admin/src/App.jsx - Admin workspace → Admin sessions: guards routes with
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
packages/shared/src/services/reservationService.js - Reservation rules → Local data store: reads and writes
packages/shared/src/services/reservationService.js - Local data store → Seed records: loads seed records
packages/shared/src/services/store.js - Shared service layer → API routing: calls API when enabled
- API routing → Authentication: mounts routes
apps/api/src/app.js - API routing → Package catalogue: mounts routes
apps/api/src/app.js - API routing → Calendar availability: mounts routes
apps/api/src/app.js - API routing → Reservations: mounts routes
apps/api/src/app.js - API routing → Payments and refunds: mounts routes
apps/api/src/app.js - API routing → Customer messaging: mounts routes
apps/api/src/app.js - API routing → Business operations: mounts business routes
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
apps/api/src/modules/payments/payments.routes.js - Authentication → Mail and SMS providers: sends sign-in codes