Register all active platform services and base features in core DB so admin can manage them, add delivery/hospitality/sports-center backend phases, update apps catalog and production deploy tooling. Co-authored-by: Cursor <cursoragent@cursor.com>
50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
# Phase 12.7 — Connectors
|
|
|
|
| Field | Value |
|
|
| --- | --- |
|
|
| Status | Complete |
|
|
| Module | hospitality |
|
|
| Commercial Product | Torbat Food |
|
|
| Version | 0.12.7.0 |
|
|
| Database | `hospitality_db` |
|
|
| API Port | 8009 |
|
|
| ADR | ADR-001, ADR-003, ADR-006, ADR-017 |
|
|
| Prior phase | [12.6 Kitchen](hospitality-phase-12-6.md) |
|
|
|
|
## Goal
|
|
|
|
Add an outbound connector/dispatch shell for external integration platforms — delivery,
|
|
accounting, CRM, loyalty, communication, and website builder — registered and dispatched by
|
|
reference only. No real network calls (no httpx) and no cross-service imports; dispatch results
|
|
are simulated locally via no-op mock provider implementations of the existing platform Protocols.
|
|
|
|
## Scope (In)
|
|
|
|
- Aggregates: ConnectorRegistration, ConnectorDispatch
|
|
- `app/providers/mocks.py` — no-op async mocks implementing `AccountingProvider`, `CRMProvider`,
|
|
`LoyaltyProvider`, `CommunicationProvider`, `DeliveryProvider`, `WebsiteBuilderProvider`
|
|
- APIs under `/api/v1/connector-registrations|connector-dispatches`
|
|
- Dispatch service sets `status=sent` via mock provider when registration is `active`, else
|
|
`status=failed`
|
|
- Permissions + publish-only events
|
|
- Alembic `0008_phase_127_connectors`
|
|
- Capabilities `delivery_integration`, `accounting_integration`, `crm_integration`,
|
|
`loyalty_integration`, `communication_integration`, `website_integration`; version `0.12.7.0`
|
|
|
|
## Out of Scope
|
|
|
|
- Real connector SDKs / httpx calls to external platforms
|
|
- Analytics, AI Assistant
|
|
|
|
## Quality Gates
|
|
|
|
Passed (architecture, dependency, migration, tenant, API, permissions, docs). See handover.
|
|
|
|
## Related Documents
|
|
|
|
- [Hospitality Roadmap](hospitality-roadmap.md)
|
|
- [Phase Handover 12.7](phase-handover/phase-12-7.md)
|
|
- [ADR-017](architecture/adr/ADR-017.md)
|
|
- [Module Registry](module-registry.md#hospitality)
|
|
- [Service Snapshot](service-snapshots/hospitality.yaml)
|