> ## Documentation Index
> Fetch the complete documentation index at: https://internal.softcrum.com/llms.txt
> Use this file to discover all available pages before exploring further.

# R1 · Loyalty

> El módulo comercial que abre la suite: programas, libro de puntos, motor de reglas, recompensas, cupones, referidos y niveles. Es el más especificado y el único con specs en revisión.

Schema `loyalty`. Es el módulo con el que se vende Engage y el que tiene el modelo de datos más
grande de la suite: 37 tablas.

|               |                                                     |
| ------------- | --------------------------------------------------- |
| Feature specs | 14 · [ver módulo](/modules/loyalty/overview)        |
| Tablas        | 37 · [modelo de datos](/modules/loyalty/data-model) |
| APIs          | [ver listado](/modules/loyalty/api)                 |
| Depende de    | Customer Core                                       |
| Estado        | **15 documentos en `review`** — es el más avanzado  |

## Alcance

**Se construye primero:**

| Spec                                                                         | Qué entrega                                                  |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------ |
| [FS-LOY-0001](/modules/loyalty/features/fs-loy-0001-programs-and-currencies) | Programas y monedas de puntos, multi-programa desde el día 1 |
| [FS-LOY-0002](/modules/loyalty/features/fs-loy-0002-points-ledger)           | El libro de puntos append-only y los lotes FIFO              |
| [FS-LOY-0003](/modules/loyalty/features/fs-loy-0003-balance-projection)      | La proyección de saldo y la reconciliación de drift          |
| [FS-LOY-0004](/modules/loyalty/features/fs-loy-0004-rules-engine)            | El motor de reglas: condiciones, efectos y presupuestos      |
| [FS-LOY-0005](/modules/loyalty/features/fs-loy-0005-rewards-catalog)         | El catálogo de recompensas                                   |
| [FS-LOY-0006](/modules/loyalty/features/fs-loy-0006-redemptions)             | Canjes padre/hijo con idempotencia obligatoria               |
| [FS-LOY-0009](/modules/loyalty/features/fs-loy-0009-referrals)               | Referidos con recompensa doble y marcas de fraude            |
| [FS-LOY-0011](/modules/loyalty/features/fs-loy-0011-expiring-points)         | Escaneo de vencimientos y avisos a 30 y 7 días               |

**Completa la propuesta:**

| Spec                                                                | Qué entrega                                             |
| ------------------------------------------------------------------- | ------------------------------------------------------- |
| [FS-LOY-0007](/modules/loyalty/features/fs-loy-0007-coupons)        | Cupones: generación masiva y códigos genéricos          |
| [FS-LOY-0008](/modules/loyalty/features/fs-loy-0008-stacking-rules) | Combinabilidad de beneficios y conjuntos no combinables |
| [FS-LOY-0010](/modules/loyalty/features/fs-loy-0010-tiers)          | Niveles, ventana de calificación y período de gracia    |
| [FS-LOY-0014](/modules/loyalty/features/fs-loy-0014-wallet-passes)  | Wallet passes de Apple y Google                         |

**Depende de decisiones abiertas:**

| Spec                                                                | Qué entrega                                         |
| ------------------------------------------------------------------- | --------------------------------------------------- |
| [FS-LOY-0012](/modules/loyalty/features/fs-loy-0012-gamification)   | Insignias y desafíos                                |
| [FS-LOY-0013](/modules/loyalty/features/fs-loy-0013-apply-discount) | Aplicación de descuentos y sesiones de calificación |

## Lo que hace tangible esta entrega

Doña María compra, acumula puntos en el mostrador, los canjea por una recompensa y recibe el aviso
antes de que venzan. Ese circuito completo es la demo, y es lo que el design partner tiene que poder
ejercitar en noviembre.

## Riesgos propios

* **El libro de puntos es el camino del dinero.** Una columna de saldo mutable está prohibida en
  todo el módulo, y los invariantes de FS-LOY-0002 no se pueden revisar barato después.
* **El canje corre en un mostrador**: p95 bajo 300 ms con `Idempotency-Key` obligatoria. Un reintento
  de red que cobra dos veces es un incidente con el cliente final.
* **15 documentos esperan visto bueno.** Es el módulo más cerca de poder construirse y el que más
  descubierto queda si la aprobación se demora.