Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Documentación interna. Borradores en revisión — nada acá es un compromiso público, y la sección Legal no ha sido revisada por un abogado.
Los lotes de puntos con su vencimiento. El consumo es FIFO por fecha de expiración, que es la única política que se le explica a un cliente en una frase.
points_remaining es la garantía dura de que nunca hay un lote negativo,
y por lo tanto nunca un saldo negativo.
| Nombre | Definición | Por qué existe |
|---|---|---|
idx_point_lot_fifo | (program_id, contact_id, point_currency_id, expires_at) | El índice exacto que pide FS-LOY-0002: seleccionar el lote más antiguo primero es la operación de cada canje |
idx_point_lot_expiring | (tenant_id, expires_at) WHERE points_remaining > 0 | El escaneo de vencimientos y los avisos a 30 y 7 días |
ck_point_lot_remaining | CHECK (points_remaining BETWEEN 0 AND points_total) | Nunca un lote negativo, nunca un saldo negativo. Garantía de la base, no de la aplicación |
tenant_id. No particionada.
Consumir más que el total disponible falla antes de escribir nada. Un canje que deja el saldo en
negativo no es un bug a corregir después: no puede ocurrir.
| Fecha | Cambio | Por qué | Decidido en | Autor |
|---|---|---|---|---|
| 2026-08-17 | Tabla creada con consumo FIFO por expires_at | Es la única política de consumo que se explica en una frase a quien reclama | FS-LOY-0002 · ADR-011 | daniel + claude-opus-5 |
| 2026-08-17 | Al revertir un canje, los puntos restaurados mantienen su vencimiento original | Reiniciarlo convertiría el rollback en una forma de extender vencimientos, y alguien lo iba a descubrir | OQ-LOY-09 | daniel + claude-opus-5 |
| 2026-08-18 | Renombrada de loyalty.point_lots a loyalty.point_lot | Nombre en singular | ADR-024 | daniel + claude-opus-5 |