TorbatYar/docs/module-registry.md
Mortezakoohjani d579d0b142 feat(loyalty): add Loyalty Platform Frontend module
Add frontend/modules/loyalty with types, API client, design system, feature pages and thin App Router routes under app/loyalty/. BFF proxy at app/api/loyalty/. Include loyalty frontend docs.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-27 10:50:55 +03:30

55 KiB
Raw Blame History

Module Registry

Canonical inventory of modules. Template: module-template.md.
Architecture boundaries: module-boundaries.md.

Status legend: Active · Scaffolded (code placeholder) · Planned


core-platform

Field Value
Name Core Platform
Description Tenants, domains, plans, entitlements, registries, onboarding, audit, outbox
Owner Platform
Status Active
Dependencies Postgres, Redis, Celery
Internal Dependencies shared-lib
External Dependencies Payamak (OTP), Keycloak (JWT validate), SSL provision host
Database Ownership Sole owner
Database core_platform_db
API Prefix /api/v1
Permission Prefix core.* / platform admin deps
Events tenant.*, domain.*, subscription.*, feature_access.*
Event Producers Core services/workers
Event Consumers Future business services
Provider Dependencies Payamak, Let's Encrypt (via ops/SSL task)
AI Dependencies None
Documentation architecture/, reference/
Current Phase Phase 4 complete; white-label polish in progress
Version 0.4.x
Version Compatibility Identity ≥ phase 2
Migration Version Alembic head (incl. 0005_tenant_onboarding)
Tenant Aware Yes
Permission Tree platform_admin + membership roles
Future Plans Payment gateway, DNS verify, advanced permissions

identity-access

Field Value
Name Identity & Access
Description OIDC BFF, profiles, mobile OTP handoff, Keycloak sync
Owner Platform
Status Active
Dependencies Keycloak, Core OTP API
Internal Dependencies shared-lib
External Dependencies Keycloak, Core
Database Ownership Sole owner
Database identity_access_db
API Prefix /api/v1/auth, /api/v1/users, /api/v1/tenants/{id}/members
Permission Prefix Identity admin roles
Events user.registered, tenant_member.added, tenant_member.removed
Event Producers Identity service
Event Consumers Core (future sync)
Provider Dependencies Keycloak
AI Dependencies None
Documentation identity-architecture.md, service README
Current Phase Phase 2+ delivered
Version 0.2.x
Version Compatibility Core with JWT + mobile
Migration Version Identity Alembic head
Tenant Aware Partial (membership listing)
Permission Tree platform_admin for user/member admin APIs
Future Plans Richer sync with Core memberships

frontend

Field Value
Name Frontend
Description Next.js UI: SSO, onboarding, dashboard, tenant site
Owner Platform
Status Active
Dependencies Core API, Identity API, Keycloak
Internal Dependencies None (no backend imports)
External Dependencies Browser
Database Ownership None
Database
API Prefix Consumes /api/v1
Permission Prefix UI gated by roles from /me
Events N/A (consumer only via API)
Event Producers None
Event Consumers None
Provider Dependencies None directly
AI Dependencies None
Documentation frontend/README.md
Current Phase White-label runtime partial
Version Next 15.5.x
Version Compatibility Core/Identity current
Migration Version N/A
Tenant Aware Yes (host + context)
Permission Tree Mirrors Core roles in UI
Future Plans Module UIs per business phase

accounting

Field Value
Name Accounting
Description 4-level COA, double-entry, posting engine, GL, treasury, AR/AP, sales integration
Owner Platform
Status Active (Phases 5.15.11)
Dependencies Core entitlement
Internal Dependencies Posting Engine (owned here)
External Dependencies Tax/e-invoice providers (future)
Database Ownership Sole owner
Database accounting_db
API Prefix /api/v1 (service on port 8002)
Permission Prefix accounting.*, treasury.*, receivable.*, payable.*, sales_accounting.*
Events voucher.posted, ledger.updated, cash.received, settlement.completed, sales_invoice.posted
Event Producers Accounting
Event Consumers Reporting, compliance (planned)
Provider Dependencies Payment/tax (planned)
AI Dependencies Optional assistants only (Phase 5.12)
Documentation phases/Accounting, service README
Current Phase 5.11 complete; 5.12 (AI) next
Version 0.5.11.0
Version Compatibility Requires Core entitlement
Migration Version 0002_phases_57_511
Tenant Aware Yes (required)
Permission Tree accounting.*, treasury.*, receivable.*, payable.*, sales_accounting.*
Future Plans Phases 5.75.12 (purchase/inventory, assets, payroll, reporting, compliance, AI)

crm

Field Value
Name CRM
Description Sales CRM: leads, contacts, organizations, opportunities, pipelines, playbooks, forecasts, goals, targets, win/loss, activities, tasks, meetings, calls, timeline, comments, mentions, team collaboration, quotes, tags, addresses, custom fields, notes, attachments, audit
Owner Platform
Status Active (Phase 6.3 collaboration — CRM Core Platform complete)
Dependencies Core entitlement; File Storage + Product Service + Notification (reference/contracts only)
Internal Dependencies None — Sales CRM only
External Dependencies Platform providers via contracts only (Automation, Customer360, Notification, Analytics, AI, Communication, Helpdesk, FileStorage, ProductService)
Database Ownership Sole owner
Database crm_db
API Prefix /api/v1 (service on port 8003)
Permission Prefix crm.*, crm.opportunities.*, crm.pipelines.*, crm.playbooks.*, crm.forecasts.*, crm.goals.*, crm.targets.*, crm.activities.*, crm.tasks.*, crm.meetings.*, crm.calls.*, crm.timeline.*, crm.comments.*, crm.mentions.*, crm.team.*, crm.leads.*, crm.contacts.*, crm.organizations.*, crm.notes.*, crm.attachments.*, crm.customfields.*
Events crm.opportunity.*, crm.pipeline.changed, crm.stage.changed, crm.playbook.*, crm.forecast.updated, crm.activity.*, crm.task.completed, crm.meeting.finished, crm.call.logged, crm.timeline.updated, crm.comment.created, crm.mention.created, crm.lead.*, crm.contact.created, crm.organization.created, crm.note.created, crm.attachment.added, crm.quote.created
Event Producers CRM
Event Consumers Future platforms (not consumed in 6.3)
Provider Dependencies Contracts only — no implementations
AI Dependencies Optional via AIProvider contract only
Documentation crm-phase-6-0.md, crm-phase-6-1.md, crm-phase-6-2.md, crm-phase-6-3.md, phases/CRM, service README
Current Phase 6.3 complete (CRM Core Platform)
Version 0.6.3.0
Version Compatibility Requires Core entitlement
Migration Version 0004_phase_63_collaboration
Tenant Aware Yes (required)
Permission Tree crm.*
Future Plans Explicitly scoped Sales CRM slices only; no platform ownership

loyalty

Field Value
Name Enterprise Loyalty Platform
Description Shared loyalty: programs, members, tiers, point accounts, rewards, campaigns; reusable by all business modules
Owner Platform
Status Active (Phase 7.6 Wallet)
Dependencies Core entitlement (feature-key gate deferred platform-wide; JWT + tenant header enforced)
Internal Dependencies None — independent of CRM
External Dependencies Platform providers via contracts only (Notification, Analytics, Customer360, AI, ModuleIntegration, CRM, Communication, FileStorage)
Database Ownership Sole owner
Database loyalty_db
API Prefix /api/v1 (service on port 8004)
Permission Prefix loyalty.*, loyalty.programs.*, loyalty.tiers.*, loyalty.members.*, loyalty.point_accounts.*, loyalty.points.*, loyalty.rewards.*, loyalty.redemptions.*, loyalty.campaigns.*, loyalty.referral_programs.*, loyalty.referral_codes.*, loyalty.referrals.*, loyalty.wallets.*, loyalty.audit.*
Events loyalty.program.*, loyalty.tier.*, loyalty.member.*, loyalty.point_account.*, loyalty.points.*, loyalty.reward.*, loyalty.campaign.*, loyalty.referral.*, loyalty.wallet.*
Event Producers Loyalty (transactional outbox)
Event Consumers Future business modules / Customer360 (not consumed in 7.6)
Provider Dependencies Contracts only — no implementations
AI Dependencies Optional via AIProvider contract only
Documentation loyalty-phase-7-0.mdloyalty-phase-7-6.md, phase-handover/phase-7-6.md, service-snapshots/loyalty.yaml, phases/Loyalty
Current Phase 7.6 complete (Wallet); 7.7 next
Version 0.7.6.0
Version Compatibility Designed for Core entitlement; runtime feature-check deferred
Migration Version 0007_phase_76_wallet
Tenant Aware Yes (required)
Permission Tree loyalty.* (view/manage inheritance supported)
Future Plans Phases 7.77.10 (gift cards, analytics, partner APIs, final review)

communication

Field Value
Name Enterprise Communication Platform (Torbat Communication)
Description Independent shared messaging: providers, router, SMS, templates, dynamic contacts, queue, delivery tracking, OTP, webhooks, monitoring
Owner Platform
Status Production Ready (SMS MVP) — Phase 8.08.10 complete; feature-complete for current scope
Dependencies Core entitlement (optional gate); no other business modules required
Internal Dependencies None — independent of CRM / Loyalty / Restaurant
External Dependencies SMS providers (Payamak, mock); future email/push/social/voice adapters
Database Ownership Sole owner
Database communication_db
API Prefix /api/v1 (service on port 8005); /health, /capabilities
Permission Prefix communication.*
Events communication.message.*, communication.provider.*, communication.otp.*, communication.queue.*, communication.webhook.*, communication.template.*
Event Producers Communication
Event Consumers Any subscribed business module (via API/events only)
Provider Dependencies Payamak (SMS), Mock; stubs for smtp/fcm/whatsapp/telegram/rubika/voice
AI Dependencies None
Documentation communication-phase-8.md, communication-roadmap.md, phase-handover/phase-8.md, service-snapshots/communication.yaml, ADR-012, service README
Current Phase 8 complete (MVP)
Version 0.8.10.1
Version Compatibility Standalone; Core JWT optional via AUTH_REQUIRED
Migration Version 0001_initial, 0002_validation_hardening
Tenant Aware Yes (required)
Permission Tree communication.*
Future Plans See communication-roadmap.md — Email, Push, WhatsApp, Telegram, Rubika, Voice (not registered phases)

sports_center

Field Value
Name Sports Center Platform
Description Independent sports platform: foundation, membership catalog, and member management (profiles, assignment, cards/waivers/documents)
Owner Platform
Status Active (Phase 9.2 member management)
Dependencies Core entitlement; Accounting / CRM / Loyalty / Communication via API/Events when phases require them
Internal Dependencies Foundation + catalog + member modules owned by this service
External Dependencies Access-device vendors (adapters later); payment via Accounting (future)
Database Ownership Sole owner
Database sports_center_db
API Prefix /api/v1 (service on port 8006); /health, /capabilities
Permission Prefix sports_center.*
Events sports_center.member.*, membership.*, family_member.*, emergency_contact.*, medical_information.*, membership_card.*, digital_membership.*, waiver.*, member_document.*, catalog events, coach.*, facility.*, device.*, locker.*
Event Producers Sports Center
Event Consumers Accounting, CRM, Loyalty, Communication, Analytics (future consumers)
Provider Dependencies Connector interfaces only
AI Dependencies Optional via contracts only (Phase 9.9)
Documentation sports-center-phase-9-0.md, sports-center-phase-9-1.md, sports-center-phase-9-2.md, phase-handover/phase-9-2.md, sports-center-roadmap.md, phases/SportsCenter, ADR-014
Current Phase 9.2 complete (member management); next sports-center-9.3
Version 0.9.2.0
Version Compatibility Requires Core entitlement; integrations per Phase 9.8
Migration Version 0003_phase_92_member_management
Tenant Aware Yes (required)
Permission Tree sports_center.*
Future Plans Phases 9.39.10 per phase-manifest.yaml

Modules (owned by sports_center)

Module Key Name Status Phase
sports_center.sports_centers Sports Centers Active (shell) 9.0
sports_center.branches Branches Active (shell) 9.0
sports_center.sports Sports catalog Active (shell) 9.0
sports_center.membership_types Membership Types Active (catalog) 9.1
sports_center.memberships Memberships (assignment + status) Active 9.2
sports_center.sport_categories Sport Categories Active 9.1
sports_center.age_groups Age Groups Active 9.1
sports_center.pricing_models Pricing Models Active 9.1
sports_center.membership_packages Membership Packages Active 9.1
sports_center.membership_plans Membership Plans Active 9.1
sports_center.membership_rules Membership Rules Active 9.1
sports_center.renewal_policies Renewal Policies Active 9.1
sports_center.freezing_rules Freezing Rules Active 9.1
sports_center.expiration_policies Expiration Policies Active 9.1
sports_center.members Members Active 9.2
sports_center.family_members Family Members Active 9.2
sports_center.emergency_contacts Emergency Contacts Active 9.2
sports_center.medical Medical Information Active (shell) 9.2
sports_center.membership_cards Membership Cards Active 9.2
sports_center.digital_memberships Digital Memberships Active 9.2
sports_center.waivers Waivers Active 9.2
sports_center.member_documents Member Documents Active 9.2
sports_center.coaches Coaches / Staff Active 9.3
sports_center.staff_certificates Staff Certificates Active 9.3
sports_center.staff_skills Staff Skills Active 9.3
sports_center.staff_working_hours Staff Working Hours Active 9.3
sports_center.staff_availability Staff Availability Active 9.3
sports_center.staff_assignments Staff Assignments Active 9.3
sports_center.roles Sports Roles Active (shell) 9.0
sports_center.permissions Sports Permissions Active (shell) 9.0
sports_center.facilities Facilities Active (shell) 9.0
sports_center.courts Courts Active (shell) 9.0
sports_center.rooms Rooms Active (shell) 9.0
sports_center.locker_rooms Locker Rooms Active (shell) 9.0
sports_center.lockers Lockers Active (shell) 9.0
sports_center.devices Devices Active (shell) 9.0
sports_center.device_providers Device Providers Active (shell) 9.0
sports_center.attendance_gateways Attendance Gateways Active (shell) 9.0
sports_center.configuration Configuration Active (shell) 9.0
sports_center.events Sports Events Active (shell) 9.0
sports_center.settings Settings Active (shell) 9.0
sports_center.audit Audit Active 9.0
sports_center.attendance Attendance engine Active 9.5
sports_center.booking Booking Active 9.4
sports_center.equipment Equipment Active 9.4
sports_center.sessions Sports Sessions Active 9.4
sports_center.programs Training Programs Active 9.6
sports_center.workouts Workouts Active 9.6
sports_center.exercises Exercises Active 9.6
sports_center.training_goals Training Goals Active 9.6
sports_center.measurements Measurements Active 9.6
sports_center.competitions Competitions Active 9.7
sports_center.competition_teams Competition Teams Active 9.7
sports_center.competition_registrations Competition Registrations Active 9.7
sports_center.competition_matches Competition Matches Active 9.7
sports_center.competition_results Competition Results Active 9.7
sports_center.competition_rankings Competition Rankings Active 9.7
sports_center.competition_medals Competition Medals Active 9.7
sports_center.competition_judges Competition Judges Active 9.7
sports_center.competition_certificates Competition Certificates Active 9.7
sports_center.nutrition Nutrition Planned Later slice
sports_center.mobile Mobile Planned Cross-cutting
sports_center.reports Reports Planned 9.9
sports_center.analytics Analytics Planned 9.9
sports_center.integrations Integrations Planned 9.8
Module Responsibilities Non-responsibilities
Members Sports member profiles; links to platform user refs Platform Tenant Member; Loyalty Member
Membership Active membership instances; freeze/renewal/transfer Accounting invoices ownership
Membership Types Plans, packages, commercial definitions Core SaaS plans
Coaches Coach/trainer records and assignments Identity user admin
Attendance Check-in/out records Physical device firmware
Booking Reservations and conflict rules Payment capture ownership
Facilities Courts, rooms, zones Building IoT cloud
Equipment Equipment inventory for booking/tracking Procurement accounting
Programs Training programs Generic LMS / Academy ownership
Workouts Workout definitions / assignments Wearable vendor platforms
Competitions Competition definitions / results shells External federation systems
Events Sports calendar events Domain/integration event bus
Medical Clearance / note refs (privacy-aware) Hospital EHR systems
Nutrition Nutrition plan shells Dietitian marketplace
Locker Locker assignment status Smart-lock vendor cloud
Mobile Mobile API contracts / deep links Native app store publishing (ops)
Reports Operational reports Central BI warehouse ownership
Analytics Metrics export shells Product AI platform
Integrations Adapters to Accounting/CRM/Loyalty/Communication Foreign DB ownership

delivery

Field Value
Name Delivery & Fleet Platform (Torbat Driver)
Description Independent logistics platform (Torbat Driver): foundation orgs/hubs/config/providers/routing-engine shells; drivers active; fleet/dispatch in later phases
Owner Platform
Status Active (Phase 10.1 drivers)
Dependencies Core entitlement; Accounting / CRM / Loyalty / Communication / verticals via API/Events when phases require them
Internal Dependencies Modules owned by this service only
External Dependencies Routing engines and fleet providers (adapters); notifications via Communication; Storage file refs for driver docs
Database Ownership Sole owner
Database delivery_db
API Prefix /api/v1 (service on port 8007); /health, /capabilities, /metrics
Permission Prefix delivery.*
Events delivery.organization.*, delivery.hub.*, delivery.external_provider.*, delivery.routing_engine.*, delivery.configuration.*, delivery.setting.*, delivery.driver.* (+ planned fleet/dispatch/...)
Event Producers Delivery
Event Consumers Accounting, Communication, CRM, Loyalty, Restaurant, Marketplace, Clinic, Sports Center, Analytics (future)
Provider Dependencies External routing/fleet provider interfaces (planned); Storage refs for documents
AI Dependencies Optional via contracts only (Phase 10.10)
Documentation delivery-phase-10-1.md, phase-handover/phase-10-1.md, delivery-phase-10-0.md, delivery-roadmap.md, phases/Delivery, ADR-015
Current Phase 10.1 complete (drivers); next delivery-10.2
Version 0.10.1.0
Version Compatibility Requires Core entitlement; integrations per later phases
Migration Version 0002_phase_101_drivers
Tenant Aware Yes (required)
Permission Tree delivery.*
Future Plans Phases 10.010.10 per phase-manifest.yaml
Commercial Product Torbat Driver

Modules (owned by delivery)

Module Key Name Status Phase
delivery.organizations Delivery Organizations Active (shell) 10.0
delivery.hubs Delivery Hubs Active (shell) 10.0
delivery.roles Delivery Roles Active (shell) 10.0
delivery.permissions_catalog Delivery Permissions Catalog Active (shell) 10.0
delivery.routing_engines Routing Engine Registrations Active (shell) 10.0
delivery.settings Settings Active (shell) 10.0
delivery.drivers Driver Management Active 10.1
delivery.fleet Fleet Management Planned 10.2
delivery.vehicle_types Vehicle Types Planned 10.2
delivery.vehicles Vehicles Planned 10.2
delivery.availability Availability Planned 10.3
delivery.shifts Shift Management Planned 10.3
delivery.working_zones Working Zones Planned 10.3
delivery.pricing Pricing Planned 10.4
delivery.capabilities Capabilities Planned 10.4
delivery.bundles Capability Bundles Planned 10.4
delivery.dispatch Dispatch Engine Planned 10.5
delivery.routing Routing Planned 10.6
delivery.optimization Optimization Planned 10.6
delivery.tracking Tracking Planned 10.7
delivery.proof_of_delivery Proof Of Delivery Planned 10.7
delivery.customer_tracking Customer Tracking Planned 10.7 / 10.9
delivery.settlement Settlement Planned 10.8
delivery.merchant_connector Merchant Connector Planned 10.9
delivery.notifications Notifications (Communication client) Planned 10.9
delivery.driver_app_apis Driver App APIs Planned 10.9
delivery.dispatcher_panel_apis Dispatcher Panel APIs Planned 10.9
delivery.fleet_analytics Fleet Analytics Planned 10.10
delivery.ai_hooks AI Ready Hooks Planned 10.10
delivery.external_providers External Providers Ready Active (shell) 10.0
delivery.audit Audit Active 10.0
delivery.configuration Configuration Active (shell) 10.0
Module Responsibilities Non-responsibilities
Drivers Courier/driver profiles and status Identity user admin; Platform Member
Fleet / Vehicles Fleet units and vehicle catalog Procurement accounting
Dispatch Job assignment engine Owning vertical order aggregates
Routing Route plans and multi stop Owning map vendor credentials outside adapters
Tracking / POD Journey + proof refs Communication message delivery status
Settlement Settlement intents JournalEntry / Posting Engine
Merchant Connector Job intake contracts Restaurant menu / Marketplace catalog
Notifications Call Communication APIs SMS/email provider ownership

experience

Field Value
Name Enterprise Experience Platform (Torbat Pages)
Description Independent experience platform: sites, pages-as-resources, versioned components, themes, layouts, templates, localization, forms/surveys/appointments, SEO/PWA, bundles, widgets for all verticals
Owner Platform
Status Active (Phase 11.10 complete — Experience track closed)
Dependencies Core entitlement; Storage / CRM / Loyalty / Communication / Hospitality / Marketplace / Sports / Delivery / AI / Automation via API/Events when phases require them
Internal Dependencies Modules owned by this service only
External Dependencies File Storage for media refs; notifications via Communication
Database Ownership Sole owner
Database experience_db
API Prefix /api/v1 (port 8008); /health, /capabilities, /metrics
Permission Prefix experience.*
Events experience.workspace.*, experience.locale_profile.*, experience.external_provider.*, experience.render_engine.*, experience.configuration.*, experience.setting.*, experience.site.*, experience.page.*, experience.site_domain.*, experience.component.*, experience.component_version.*, experience.page_component.*, experience.theme.*, experience.layout.*, experience.site_theme.*, experience.page_layout.*, experience.template.*, experience.template_version.*, experience.site_locale.*, experience.localization.*, experience.media_ref.*, experience.form.*, experience.form_submission.*, experience.survey.*, experience.survey_response.*, experience.appointment_page.*, experience.appointment_booking_ref.* (+ planned seo/…)
Event Producers Experience
Event Consumers Hospitality, Marketplace, Sports Center, CRM, Loyalty, Communication, Accounting, Clinic, Hotel, Tourism, Analytics (future)
Provider Dependencies Optional theme/component marketplace adapters (planned)
AI Dependencies Optional via contracts only (Phase 11.10)
Documentation experience-roadmap.md, phases/Experience, experience-phase-11-10.md, phase-handover/phase-11-10.md, experience-phase-11-10-audit.md, ADR-016
Current Phase 11.10 complete — track closed
Version 0.11.10.0
Version Compatibility Requires Core entitlement; integrations per later phases
Migration Version 0011_phase_1110_analytics_ai_hooks
Tenant Aware Yes (required)
Permission Tree experience.*
Future Plans Phases 11.011.10 per phase-manifest.yaml
Commercial Product Torbat Pages

Modules (owned by experience)

Module Key Name Status Phase
experience.workspaces Workspaces Complete 11.0
experience.locale_profiles Locale Profiles Complete 11.0
experience.external_providers External Providers Complete 11.0
experience.render_engines Render Engines Complete 11.0
experience.audit Audit Complete 11.0
experience.configuration Configuration Complete 11.0
experience.sites Sites Complete 11.1
experience.pages Page Resources Complete 11.1
experience.page_types Page Types Complete 11.1
experience.domains Site Domains Complete 11.1
experience.components Components Complete 11.2
experience.component_versions Component Versions Complete 11.2
experience.page_component_placements Page Component Placements Complete 11.2
experience.themes Themes & Theme Versions Complete 11.3
experience.layouts Layouts & Layout Versions Complete 11.3
experience.site_theme_bindings Site Theme Bindings Complete 11.3
experience.page_layout_bindings Page Layout Bindings Complete 11.3
experience.templates Templates & Template Versions Complete 11.4
experience.template_instantiations Template Instantiation Complete 11.4
experience.locales Localization Complete 11.5
experience.media_refs Media References Complete 11.5
experience.forms Forms Complete 11.6
experience.surveys Surveys Complete 11.6
experience.appointments Appointment Pages Complete 11.6
experience.publishing Publishing Complete 11.7
experience.seo SEO Complete 11.7
experience.pwa PWA Readiness Complete 11.7
experience.bundles Capability Bundles Complete 11.8
experience.feature_toggles Feature Toggles Complete 11.8
experience.widgets Widgets Complete 11.9
experience.consumer_connectors Consumer Connectors Complete 11.9
experience.notify Notify Client Complete 11.9
experience.analytics Analytics Complete 11.10
experience.ai_hooks AI Content Hooks Complete 11.10
Module Responsibilities Non-responsibilities
Sites / Pages Site and page resources + lifecycle Vertical menu/product source of truth
Components Versioned building blocks Binary asset storage
Themes / Layouts Replaceable themes; dynamic layouts Core white-label tenant brand ownership
Templates Starter packs and instantiation Frontend builder UI
Forms / Surveys Form/survey definitions + submission shells Communication provider ownership
Publishing / SEO / PWA Publish workflow + SEO/PWA shells Nginx/DNS/SSL edge ownership
Bundles / Toggles Commercial packs + feature flags Core plan/subscription engine
Widgets / Connectors Embed + vertical integration contracts Owning CRM/Hospitality aggregates
Analytics / AI Shells + optional AI contracts Mandatory AI for publish

restaurant

Field Value
Name Restaurant / Cafe (historical)
Description Superseded by Hospitality Platform — see hospitality
Owner Platform
Status Superseded
Documentation phases/Restaurant, hospitality
Current Phase hospitality-12.0
Version 0.12.0.0
Notes Pointer only; runtime is hospitality

hospitality

Field Value
Name Hospitality Platform
Description Independent F&B platform (Torbat Food): venues, digital menu catalog, tables, QR menu & QR ordering shells, table service & reservations, bundle licensing, feature toggles; future POS/kitchen/connectors
Owner Platform
Status Active (Phase 12.8 Analytics)
Dependencies Core entitlement; Accounting / CRM / Loyalty / Communication / Delivery / Experience via API/Events when phases require them
Internal Dependencies None — independent of CRM / Loyalty / Delivery / Experience DBs
External Dependencies Payment provider (future); Storage refs for media
Database Ownership Sole owner
Database hospitality_db
API Prefix /api/v1 (service on port 8009); /health, /capabilities
Permission Prefix hospitality.*
Events hospitality.venue.*, hospitality.menu.*, hospitality.allergen.*, hospitality.modifier_*, hospitality.availability_window.*, hospitality.menu_media_ref.*, hospitality.menu_localization.*, hospitality.qr_code.*, hospitality.qr_menu_session.*, hospitality.qr_ordering_session.*, hospitality.cart.*, hospitality.cart_line.*, hospitality.reservation.*, hospitality.table_assignment.*, hospitality.service_request.*, hospitality.waitlist_entry.*, hospitality.pos_register.*, hospitality.pos_shift.*, hospitality.pos_ticket.*, hospitality.pos_ticket_line.*, hospitality.pos_payment.*, hospitality.pos_discount.*, hospitality.pos_tax_line.*, hospitality.pos_floor_plan.*, hospitality.pos_station.*, hospitality.kitchen_station.*, hospitality.kitchen_ticket.*, hospitality.kitchen_ticket_item.*, hospitality.connector_registration.*, hospitality.connector_dispatch.*, hospitality.analytics_report_definition.*, hospitality.analytics_snapshot.*, hospitality.tenant_bundle.*, hospitality.feature_toggle.*, …
Event Producers Hospitality
Event Consumers Accounting, CRM, Loyalty, Communication, Delivery, Experience (subscribed)
Provider Dependencies Contracts only through 12.8 (mock implementations for local dispatch simulation)
AI Dependencies Optional
Documentation hospitality-phase-12-8.md, hospitality-phase-12-7.md, hospitality-phase-12-6.md, hospitality-phase-12-5.md, hospitality-phase-12-4.md, hospitality-phase-12-3.md, hospitality-phase-12-2.md, hospitality-phase-12-1.md, hospitality-phase-12-0.md, hospitality-roadmap.md, ADR-017, service README
Current Phase 12.8 complete
Version 0.12.8.0
Version Compatibility Standalone; Core JWT optional via AUTH_REQUIRED
Migration Version 0009_phase_128_analytics
Tenant Aware Yes (required)
Permission Tree hospitality.*
Commercial Product Torbat Food
Future Plans AI Assistant (12.9), Enterprise Validation (12.10)

healthcare

Field Value
Name Healthcare Platform (Torbat Health)
Description Independent healthcare platform: clinics, doctors, patients, appointment engine, doctor panel, clinic management, patient portal, medical records, pharmacy network, Delivery integration
Owner Platform
Status Planned (HC-Reg documentation complete; implementation not started)
Dependencies Core entitlement; Identity / Communication / CRM / Loyalty / Accounting / Delivery / File Storage via API/Events when phases require them
Internal Dependencies Modules owned by this service only
External Dependencies Delivery platform (Phase 13.7); Storage refs for documents/imaging
Database Ownership Sole owner (planned)
Database healthcare_db
API Prefix /api/v1 (service on port 8010 reserved); /health, /capabilities, /metrics
Permission Prefix healthcare.*
Events healthcare.clinic.*, healthcare.doctor.*, healthcare.patient.*, healthcare.appointment.*, healthcare.visit_session.*, healthcare.medical_record.*, healthcare.prescription_order.*, healthcare.delivery_job_intent.* (+ planned)
Event Producers Healthcare (planned)
Event Consumers Communication, Delivery, CRM, Loyalty, Accounting, Experience (future)
Provider Dependencies Contracts only — Communication, Delivery, Storage, CRM, Accounting, AI
AI Dependencies Optional via contracts only (future)
Documentation healthcare-roadmap.md, phases/Healthcare
Current Phase HC-Reg complete; next healthcare-13-0
Version 0.0.0 (planned foundation 0.13.0.0)
Version Compatibility Requires Core entitlement
Migration Version None (planned 0001_initial at 13.0)
Tenant Aware Yes (required)
Permission Tree healthcare.*
Future Plans Phases 13.013.7 per healthcare-roadmap.md
Commercial Product Torbat Health

Modules (owned by healthcare — planned)

Module Key Name Status Phase
healthcare.clinics Clinics Planned 13.0
healthcare.branches Branches Planned 13.0
healthcare.departments Departments Planned 13.0
healthcare.doctors Doctors Planned 13.0
healthcare.patients Patients Planned 13.0
healthcare.roles Healthcare Roles Planned 13.0
healthcare.permissions_catalog Permissions Catalog Planned 13.0
healthcare.configuration Configuration Planned 13.0
healthcare.settings Settings Planned 13.0
healthcare.external_providers External Providers Planned 13.0
healthcare.audit Audit Planned 13.0
healthcare.schedules Schedules Planned 13.1
healthcare.availability Availability Planned 13.1
healthcare.appointment_types Appointment Types Planned 13.1
healthcare.appointments Appointment Engine Planned 13.1
healthcare.waiting_list Waiting List Planned 13.1
healthcare.doctor_panel Doctor Panel Planned 13.2
healthcare.visit_sessions Visit Sessions Planned 13.2
healthcare.visit_notes Visit Notes Planned 13.2
healthcare.clinic_services Clinic Services Catalog Planned 13.3
healthcare.staff_assignments Staff Assignments Planned 13.3
healthcare.clinic_policies Clinic Policies Planned 13.3
healthcare.patient_portal Patient Portal Planned 13.4
healthcare.patient_documents Patient Documents Planned 13.4
healthcare.medical_records Medical Records Planned 13.5
healthcare.encounters Encounters Planned 13.5
healthcare.clinical_lists Conditions / Allergies / Medications Planned 13.5
healthcare.pharmacies Pharmacy Network Planned 13.6
healthcare.prescriptions Prescriptions Planned 13.6
healthcare.prescription_orders Prescription Orders Planned 13.6
healthcare.delivery_integration Delivery Integration Planned 13.7
healthcare.delivery_job_intents Delivery Job Intents Planned 13.7
Module Responsibilities Non-responsibilities
Clinics / Branches Healthcare org structure Core tenant/workspace admin
Doctors / Patients Clinical actor profiles (refs to Identity) Identity user admin
Appointments Scheduling and lifecycle Communication provider ownership
Doctor Panel Visit queue and session shells Full EHR legal archive
Clinic Management Services catalog, staff, policies Accounting postings
Patient Portal Patient self-service APIs Frontend UI ownership
Medical Records Encounters and clinical lists National HIE / FHIR mandate
Pharmacy Network Prescription routing and fulfillment status Drug inventory accounting
Delivery Integration Job intents to Delivery platform Drivers, fleet, dispatch, routing

beauty_business

Field Value
Name Beauty Business Platform (Torbat Beauty)
Description Independent beauty & wellness platform: salons, barbershops, beauty clinics, laser centers, skin-care centers, hair-treatment centers, spa & wellness; booking, salon management, service catalog, customers, packages, staff commission, marketing/Loyalty integration
Owner Platform
Status Planned (BB-Reg documentation complete; implementation not started)
Dependencies Core entitlement; Identity / Communication / CRM / Loyalty / Accounting / Delivery / Experience via API/Events when phases require them
Internal Dependencies Modules owned by this service only
External Dependencies Storage refs for media/documents; Loyalty and Communication via client contracts
Database Ownership Sole owner (planned)
Database beauty_business_db
API Prefix /api/v1 (service on port 8011 reserved); /health, /capabilities, /metrics
Permission Prefix beauty_business.*
Events beauty_business.organization.*, beauty_business.branch.*, beauty_business.appointment.*, beauty_business.service.*, beauty_business.customer.*, beauty_business.package.*, beauty_business.membership.*, beauty_business.staff.*, beauty_business.commission.*, beauty_business.marketing.* (+ planned)
Event Producers Beauty Business (planned)
Event Consumers Communication, Loyalty, CRM, Accounting, Experience, Delivery (future)
Provider Dependencies Contracts only — Communication, Loyalty, CRM, Accounting, Experience, Delivery, Storage, AI
AI Dependencies Optional via contracts only (future)
Documentation beauty-business-roadmap.md, phases/BeautyBusiness
Current Phase BB-Reg complete; next beauty-business-14-0
Version 0.0.0 (planned foundation 0.14.0.0)
Version Compatibility Requires Core entitlement
Migration Version None (planned 0001_initial at 14.0)
Tenant Aware Yes (required)
Permission Tree beauty_business.*
Future Plans Phases 14.014.7 per beauty-business-roadmap.md; post-14.7 retail POS, analytics, mobile
Commercial Product Torbat Beauty

Independence from Healthcare: Beauty Business and Healthcare are sibling modules. Separate documentation, phases, frontend (/beauty vs /healthcare), dashboards, permissions, navigation, and branding. Shared Core platforms only via API/events.

Modules (owned by beauty_business — planned)

Module Key Name Status Phase
beauty_business.organizations Beauty Organizations Planned 14.0
beauty_business.branches Branches Planned 14.0
beauty_business.roles Beauty Roles Planned 14.0
beauty_business.permissions_catalog Permissions Catalog Planned 14.0
beauty_business.configuration Configuration Planned 14.0
beauty_business.settings Settings Planned 14.0
beauty_business.external_providers External Providers Planned 14.0
beauty_business.audit Audit Planned 14.0
beauty_business.schedules Staff Schedules Planned 14.1
beauty_business.appointments Booking Engine Planned 14.1
beauty_business.waiting_list Waiting List Planned 14.1
beauty_business.rooms Treatment Rooms Planned 14.2
beauty_business.stations Stations Planned 14.2
beauty_business.branch_policies Branch Policies Planned 14.2
beauty_business.service_categories Service Categories Planned 14.3
beauty_business.services Beauty Services Planned 14.3
beauty_business.service_variants Service Variants Planned 14.3
beauty_business.customers Customer Management Planned 14.4
beauty_business.customer_preferences Customer Preferences Planned 14.4
beauty_business.visit_history Visit History Planned 14.4
beauty_business.packages Packages Planned 14.5
beauty_business.memberships Memberships Planned 14.5
beauty_business.staff Staff Profiles Planned 14.6
beauty_business.commissions Commissions Planned 14.6
beauty_business.marketing Marketing Hooks Planned 14.7
beauty_business.loyalty_integration Loyalty Integration Planned 14.7
beauty_business.communication_integration Communication Integration Planned 14.7
Module Responsibilities Non-responsibilities
Organizations / Branches Beauty business org structure Core tenant/workspace admin
Booking Appointments and waiting list Communication reminder delivery
Salon Management Rooms, stations, branch policies Healthcare clinical facilities
Service Catalog Beauty services and variants CRM product catalog; clinical service codes
Customers Beauty customer context (CRM refs) CRM Contact ownership; Healthcare patients
Packages / Memberships Prepaid sessions and plans Loyalty ledger; Accounting subscriptions
Staff / Commission Stylists, rules, accrual shells Identity admin; Accounting payroll engine
Marketing / Loyalty Integration refs and dispatch Loyalty PointEngine; Communication providers

ecommerce

Field Value
Name Ecommerce
Description Store builder, catalog, cart, orders, shipments
Owner TBD
Status Scaffolded
Dependencies Core, file_storage (future)
Internal Dependencies
External Dependencies Payment, shipping (future)
Database Ownership Sole owner
Database ecommerce_db
API Prefix /api/v1
Permission Prefix ecommerce.*
Events order.*, product.* (planned)
Event Producers Ecommerce
Event Consumers Accounting, notification
Provider Dependencies Payment, S3
AI Dependencies Optional
Documentation service README
Current Phase Not started
Version 0.0.0
Version Compatibility Core
Migration Version None
Tenant Aware Yes
Permission Tree ecommerce.*
Future Plans Marketplace handoff

marketplace

Field Value
Name Marketplace
Description Multi-vendor market capabilities
Owner TBD
Status Planned
Dependencies ecommerce, identity, accounting
Internal Dependencies ecommerce
External Dependencies Payment
Database Ownership TBD (likely dedicated DB)
Database TBD
API Prefix TBD
Permission Prefix marketplace.*
Events TBD
Event Producers TBD
Event Consumers TBD
Provider Dependencies Payment
AI Dependencies Optional
Documentation phases/Marketplace
Current Phase Future
Version 0.0.0
Version Compatibility TBD
Migration Version None
Tenant Aware Yes
Permission Tree marketplace.*
Future Plans After ecommerce foundation

website_builder

Field Value
Name Website Builder
Description Historical scaffold for sites/pages/blocks — prefer Enterprise Experience Platform (experience / Torbat Pages) for new work (ADR-016)
Owner TBD
Status Scaffolded (deferred; prefer experience)
Dependencies file_storage
Internal Dependencies
External Dependencies S3
Database Ownership Sole owner (historical scaffold)
Database website_builder_db
API Prefix /api/v1
Permission Prefix website_builder.*
Events TBD
Event Producers Website Builder
Event Consumers
Provider Dependencies S3
AI Dependencies Optional copy assist
Documentation service README; ADR-016
Current Phase Not started — prefer Experience Phases 11.0+
Version 0.0.0
Version Compatibility Core
Migration Version None
Tenant Aware Yes
Permission Tree website_builder.*
Future Plans Do not expand; migrate capability intent to experience

live_chat

Field Value
Name Live Chat
Description Embeddable widget, conversations, agent routing
Owner TBD
Status Scaffolded
Dependencies Core, optional CRM/AI
Internal Dependencies
External Dependencies
Database Ownership Sole owner
Database live_chat_db
API Prefix /api/v1
Permission Prefix live_chat.*
Events conversation.* (planned)
Event Producers Live Chat
Event Consumers CRM, AI
Provider Dependencies
AI Dependencies Optional handoff
Documentation service README
Current Phase Not started
Version 0.0.0
Version Compatibility Core
Migration Version None
Tenant Aware Yes
Permission Tree live_chat.*
Future Plans Widget on tenant sites

ai_assistant

Field Value
Name AI Assistant
Description Intelligent chat, KB, handoff to humans
Owner TBD
Status Scaffolded
Dependencies Core entitlement, model provider
Internal Dependencies Independent — must not own money/compliance
External Dependencies AI model provider
Database Ownership Sole owner
Database ai_assistant_db
API Prefix /api/v1
Permission Prefix ai_assistant.*
Events assistant.* (planned)
Event Producers AI Assistant
Event Consumers Live Chat, CRM
Provider Dependencies AI model provider
AI Dependencies Self
Documentation ai-architecture.md, phases/AI
Current Phase Not started
Version 0.0.0
Version Compatibility Core
Migration Version None
Tenant Aware Yes
Permission Tree ai_assistant.*
Future Plans Provider-agnostic adapters

smart_messenger

Field Value
Name Smart Messenger
Description Social channels, unified inbox, automations
Owner TBD
Status Scaffolded
Dependencies Core
Internal Dependencies Optional CRM
External Dependencies Social network APIs
Database Ownership Sole owner
Database smart_messenger_db
API Prefix /api/v1
Permission Prefix smart_messenger.*
Events TBD
Event Producers Smart Messenger
Event Consumers CRM
Provider Dependencies Channel providers
AI Dependencies Optional
Documentation service README
Current Phase Not started
Version 0.0.0
Version Compatibility Core
Migration Version None
Tenant Aware Yes
Permission Tree smart_messenger.*
Future Plans Channel provider registry entries

sms_panel

Field Value
Name SMS Panel
Description Campaign SMS, templates, queues, multi-provider
Owner TBD
Status Scaffolded
Dependencies Core
Internal Dependencies
External Dependencies SMS providers
Database Ownership Sole owner
Database sms_panel_db
API Prefix /api/v1
Permission Prefix sms_panel.*
Events TBD
Event Producers SMS Panel
Event Consumers
Provider Dependencies Payamak and others
AI Dependencies None
Documentation service README
Current Phase Not started
Version 0.0.0
Version Compatibility Core
Migration Version None
Tenant Aware Yes
Permission Tree sms_panel.*
Future Plans Separate from Core OTP path

Field Value
Name Link Shortener
Description Short links, custom domains, click analytics
Owner TBD
Status Scaffolded
Dependencies Core
Internal Dependencies
External Dependencies
Database Ownership Sole owner
Database link_shortener_db
API Prefix /api/v1
Permission Prefix link_shortener.*
Events TBD
Event Producers Link Shortener
Event Consumers Campaign analytics
Provider Dependencies
AI Dependencies None
Documentation service README
Current Phase Not started
Version 0.0.0
Version Compatibility Core
Migration Version None
Tenant Aware Yes
Permission Tree link_shortener.*
Future Plans Custom domain SSL via edge

notification

Field Value
Name Notification
Description Email, SMS, push, webhook, in-app fanout
Owner TBD
Status Scaffolded
Dependencies Core
Internal Dependencies
External Dependencies Email/SMS/push providers
Database Ownership Sole owner
Database notification_db
API Prefix /api/v1
Permission Prefix notification.*
Events Consumes many domain events
Event Producers Notification (delivery logs)
Event Consumers Notification
Provider Dependencies SMS/email providers
AI Dependencies None
Documentation service README
Current Phase Not started
Version 0.0.0
Version Compatibility Core
Migration Version None
Tenant Aware Yes
Permission Tree notification.*
Future Plans Central delivery for all modules

file_storage

Field Value
Name File Storage
Description Tenant-aware uploads, assets, S3 gateway
Owner TBD
Status Scaffolded
Dependencies S3-compatible provider
Internal Dependencies
External Dependencies S3
Database Ownership Sole owner
Database file_storage_db
API Prefix /api/v1
Permission Prefix file_storage.*
Events TBD
Event Producers File Storage
Event Consumers website_builder, ecommerce
Provider Dependencies S3-compatible
AI Dependencies None
Documentation service README
Current Phase Not started
Version 0.0.0
Version Compatibility Core
Migration Version None
Tenant Aware Yes
Permission Tree file_storage.*
Future Plans Signed URL pattern

automation (platform capability)

Field Value
Name Automation
Description Cross-module workflow automation
Owner TBD
Status Planned
Dependencies Event bus maturity
Internal Dependencies Multiple modules
External Dependencies
Database Ownership TBD
Database TBD
API Prefix TBD
Permission Prefix automation.*
Events Trigger/action events
Event Producers Automation engine
Event Consumers Modules
Provider Dependencies
AI Dependencies Optional
Documentation phases/Automation
Current Phase Future
Version 0.0.0
Version Compatibility Requires real message bus
Migration Version None
Tenant Aware Yes
Permission Tree automation.*
Future Plans After event bus