How josuemerlos/ceiba works
Ceiba is a multi-tenant service-business platform whose first product is Ceiba Citas. Its main user journeys are staff managing appointment catalogs and schedules in the panel, and customers discovering a business and booking through the public app; Rails packs provide API and domain behavior. The graph preserves the documented identity, tenancy, customer, access, and branding capabilities. Several backend and booking subsystems are represented by tree-supported paths, but their internal calls were not sampled, so those links are marked unverified or omitted.
Main entry points: application.rb Rails API runtime · appointments_controller.rb Appointment API · appointment.rb Appointment records · app.tsx Staff panel
Components 22
User applications
- Staff panel
frontend/apps/panel/src/app/app.tsx - Service catalog UI
frontend/apps/panel/src/modules/appointments/routes/services-page.tsx - Public booking app
frontend/apps/booking/src/App.tsx
Appointments domain
- Appointment API
backend/packs/modules/appointments/app/controllers/api/v1/appointments/appointments_controller.rb - Availability endpoints
backend/packs/modules/appointments/app/controllers/api/public/v1/appointments/availability_controller.rb - Booking lifecycle
backend/packs/modules/appointments/app/public/appointments - Availability engine
backend/packs/modules/appointments/app/services/appointments/availability - Service catalog
backend/packs/modules/appointments/app/services/appointments/catalog - Staff scheduling
backend/packs/modules/appointments/app/services/appointments/staff - Appointment records
backend/packs/modules/appointments/app/models/appointments/appointment.rb
Platform services
- Identity and sessions
backend/packs/platform/identity/app/controllers/api/v1/identity/sessions_controller.rb - Branch access
backend/packs/platform/access/app/controllers/api/v1/access/branches_controller.rb - Customer accounts
backend/packs/platform/customers/app/controllers/api/v1/customers/customers_controller.rb - Module activation
backend/packs/platform/modules/app/controllers/api/v1/modules/me_controller.rb - Tenant branding
backend/packs/platform/tenancy/app/controllers/api/public/v1/tenancy/brandings_controller.rb - Branding media
backend/packs/platform/tenancy/app/controllers/tenancy/storage/representations_controller.rb
API foundation
- Typed API client
frontend/packages/api-client/src/client.ts - API query hooks
frontend/packages/api-client/src/query.tsx - Rails API runtime
backend/config/application.rb
Other components
- PostgreSQL
- Booking customer
- Business staff
Connections 21
- Staff panel → Service catalog UI: renders routes
frontend/apps/panel/src/app/app.tsx - Service catalog UI → API query hooks: uses queries
- API query hooks → Typed API client: calls client
frontend/packages/api-client/src/query.tsx - Typed API client → Rails API runtime: sends API requests
frontend/packages/api-client/src/client.ts - Booking customer → Public booking app: opens booking
- Public booking app → Tenant branding: loads branding
- Business staff → Staff panel: uses panel
- Rails API runtime → Appointment API: routes requests
- Rails API runtime → Availability endpoints: routes requests
- Appointment API → Booking lifecycle: manages lifecycle
- Availability endpoints → Availability engine: calculates slots
- Appointment API → Appointment records: reads and writes
- Booking lifecycle → Appointment records: creates appointments
- Appointment API → Service catalog: manages services
- Appointment API → Staff scheduling: manages schedules
- Rails API runtime → Identity and sessions: routes requests
- Rails API runtime → Branch access: routes requests
- Rails API runtime → Customer accounts: routes requests
- Rails API runtime → Module activation: routes requests
- Tenant branding → Branding media: uses attachments
- Appointment records → PostgreSQL: persists records