# Loyalty Phases

Enterprise Loyalty Platform — independent shared service (`loyalty-service`, `loyalty_db`).

Not part of CRM. Consumed by Restaurant, Marketplace, Ecommerce, Academy, Booking, Healthcare, Salon, Gym, and future modules via API + Events only.

## Status

| Phase | Title | Status |
| --- | --- | --- |
| 7.0 | Foundation | Complete (validated) — [loyalty-phase-7-0.md](../../loyalty-phase-7-0.md) · [audit](../../loyalty-phase-7-0-audit.md) |
| 7.1 | Membership Engine | Complete — [loyalty-phase-7-1.md](../../loyalty-phase-7-1.md) · [handover](../../phase-handover/phase-7-1.md) |
| 7.2 | Points Engine (immutable ledger) | Complete — [loyalty-phase-7-2.md](../../loyalty-phase-7-2.md) · [handover](../../phase-handover/phase-7-2.md) |
| 7.3 | Rewards Engine | Complete — [loyalty-phase-7-3.md](../../loyalty-phase-7-3.md) · [handover](../../phase-handover/phase-7-3.md) |
| 7.4 | Campaign Engine | Complete — [loyalty-phase-7-4.md](../../loyalty-phase-7-4.md) · [handover](../../phase-handover/phase-7-4.md) |
| 7.5 | Referral Engine | Complete — [loyalty-phase-7-5.md](../../loyalty-phase-7-5.md) · [handover](../../phase-handover/phase-7-5.md) |
| 7.6 | Wallet | Complete — [loyalty-phase-7-6.md](../../loyalty-phase-7-6.md) · [handover](../../phase-handover/phase-7-6.md) |
| 7.7 | Gift Card Platform | Planned |
| 7.8 | Analytics | Planned |
| 7.9 | Public / Partner / Webhook APIs | Planned |
| 7.10 | Final Review | Planned |

## Architecture

- ADR-011 — Independent Enterprise Loyalty Platform Service
- ADR-001 — Database-per-service
- ADR-003 — Row-level tenancy
- ADR-006 — Event envelope / outbox-ready publish

## Related Documents

- [Module Registry](../../module-registry.md#loyalty)
- [Progress](../../progress.md)
- [Roadmap](../../roadmap.md)
- [Service README](../../../backend/services/loyalty/README.md)
