# 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)
