loyalty.program - Softcrum Suite

Forma A — dominio con alcance de tenant. Un tenant tiene al menos un programa desde el momento en que se provisiona, y exactamente uno marcado por defecto. Multi-programa es capacidad de primera clase desde F1 (ADR-021).

Clave primaria

Atributos específicos

Claves foráneas

Atributos base

Restricciones e índices

Nombre	Definición	Por qué existe
`uq_program_tenant_name`	`UNIQUE (tenant_id, name)`	Dos programas del mismo tenant no pueden llamarse igual. Incluye `tenant_id` porque la unicidad global está prohibida (`standards/data.md` §2b)
`uq_program_tenant_default`	`UNIQUE (tenant_id) WHERE is_default`	Índice único parcial: exactamente un programa por defecto por tenant, garantizado por la base
`idx_program_tenant_active`	`(tenant_id, is_active)`	Listar los programas activos de un tenant es la consulta de cada pantalla de la consola
`ck_program_return_window`	`CHECK (return_window_days >= 0)`	Una ventana negativa dejaría acumulaciones en `pending` para siempre

RLS y particionamiento

RLS activa, política de tenant escrita en la misma migración que crea la tabla (R7). No particionada: la tabla es pequeña y regular (standards/data.md §4).

Referencias entrantes

Toda tabla de loyalty lleva program_id NOT NULL desde la primera migración. Las que lo referencian directamente: point_currency · ledger_transaction · point_lot · contact_balance · rule_campaign · rule · reward · coupon_campaign · redemption · stacking_rule · referral_code · tier_definition · badge · challenge

Registro de cambios

Fecha	Cambio	Por qué	Decidido en	Autor
2026-08-17	Tabla creada	Contenedor de todo el módulo; nada de `loyalty` se puede construir antes	FS-LOY-0001	daniel + claude-opus-5
2026-08-17	`name` pasa a ser editable por el tenant y único por tenant	ADR-021 revirtió DEC-H2: multi-programa es capacidad de primera clase en F1, así que el nombre deja de ser interno	ADR-021	daniel + claude-opus-5
2026-08-17	Se agrega `return_window_days`	La ventana de devolución es política del programa, no de cada regla de acumulación	OQ-LOY-01	daniel + claude-opus-5
2026-08-17	Se agrega `redemption_reversal_days`, default 90	Sin límite, un canje antiguo se revierte contra un catálogo que ya no existe	OQ-LOY-10	daniel + claude-opus-5
2026-08-18	Renombrada de `loyalty.programs` a `loyalty.program`	Nombre en singular; la tabla es el prefijo de sus FK	ADR-024	daniel + claude-opus-5

​Clave primaria

​Atributos específicos

​Claves foráneas

​Atributos base

​Restricciones e índices

​RLS y particionamiento

​Referencias entrantes

​Registro de cambios