@fiado/type-kit 3.278.0 → 3.280.0

package/src/retailCommission/enums/CommissionPlanStatusEnum.ts

@@ -0,0 +1,14 @@
+/**
+ * Estado de una versión del plan de comisiones.
+ *
+ * DRAFT - Borrador en edición. Ítem ÚNICO (`sk = DRAFT`): se pisa, no versiona.
+ * PUBLISHED - Snapshot sellado y vigente. Apuntado por el puntero `ACTIVE`.
+ * SUPERSEDED - Snapshot que fue vigente y ya no lo es. Inmutable: lo devengado con él ya se devengó.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export enum CommissionPlanStatusEnum {
+    DRAFT = 'DRAFT',
+    PUBLISHED = 'PUBLISHED',
+    SUPERSEDED = 'SUPERSEDED',
+}

package/src/retailCommission/enums/CommissionPriceReferenceEnum.ts

@@ -0,0 +1,18 @@
+/**
+ * Contra qué precio se evalúa la mecánica de una categoría.
+ *
+ * ⚠️ En el primer corte las tres resuelven contra el mismo número: la venta trae UN precio
+ * (`equipmentPriceCents`, con `amountCents` de respaldo). Se modela porque el plan de Jaime lo
+ * declara por categoría y borrarlo obligaría a migrar los snapshots cuando lleguen los tres precios.
+ *
+ * LIST - Precio de lista.
+ * FINAL - Precio final cobrado.
+ * PUBLIC - Precio público sugerido.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export enum CommissionPriceReferenceEnum {
+    LIST = 'LIST',
+    FINAL = 'FINAL',
+    PUBLIC = 'PUBLIC',
+}

package/src/retailCommission/enums/CommissionQuotaMeasureEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Qué se mide para evaluar la cuota.
+ *
+ * UNITS - Piezas vendidas en el periodo.
+ * SK_AMOUNT - Monto vendido, contando SOLO las ventas con financiera SUREKEEP.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export enum CommissionQuotaMeasureEnum {
+    UNITS = 'UNITS',
+    SK_AMOUNT = 'SK_AMOUNT',
+}

package/src/retailCommission/enums/CommissionQuotaModeEnum.ts

@@ -0,0 +1,13 @@
+/**
+ * Cómo se aplica la cuota al alcanzarse.
+ *
+ * Queda con un solo valor A PROPÓSITO: es un campo enumerable del dominio, no un flag. Guardarlo
+ * como booleano obligaría a migrar los snapshots el día que aparezca un modo prospectivo.
+ *
+ * RETROACTIVE - Aplica a TODO lo devengado en el periodo, no solo a lo que vino después.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export enum CommissionQuotaModeEnum {
+    RETROACTIVE = 'RETROACTIVE',
+}

package/src/retailCommission/enums/CommissionQuotaSubjectEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Sobre quién se acumula la cuota.
+ *
+ * SELLER - Por vendedor. Único implementado en el primer corte.
+ * STORE - Por tienda: la alcanza el equipo completo.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export enum CommissionQuotaSubjectEnum {
+    SELLER = 'SELLER',
+    STORE = 'STORE',
+}

package/src/retailCommission/enums/CommissionQuotaTypeEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Tipo de cuota. Cuota y acelerador quedaron unificados en un solo concepto (Jaime, 28-jul).
+ *
+ * BINARY - Un gate: alcanzarlo cambia de columna (`base` → `withQuota`) para las categorías que la referencian.
+ * TIERED - N niveles con multiplicador RETROACTIVO sobre el resultado. Es el «acelerador».
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export enum CommissionQuotaTypeEnum {
+    BINARY = 'BINARY',
+    TIERED = 'TIERED',
+}

package/src/retailCommission/index.ts

@@ -0,0 +1,23 @@
+// Enums
+export * from './enums/CommissionPlanStatusEnum';
+export * from './enums/CommissionMechanicTypeEnum';
+export * from './enums/CommissionPriceReferenceEnum';
+export * from './enums/CommissionQuotaTypeEnum';
+export * from './enums/CommissionQuotaMeasureEnum';
+export * from './enums/CommissionQuotaSubjectEnum';
+export * from './enums/CommissionPeriodTypeEnum';
+export * from './enums/CommissionQuotaModeEnum';
+export * from './enums/CommissionAccrualStatusEnum';
+export * from './enums/CommissionPayoutStatusEnum';
+export * from './enums/CommissionPayeeTypeEnum';
+export * from './enums/CommissionExceptionTypeEnum';
+export * from './enums/CommissionCalcStepEnum';
+
+// Entidades del dominio
+export * from './dtos/CommissionPlan';
+export * from './dtos/CommissionCalcTrace';
+export * from './dtos/CommissionAccrual';
+export * from './dtos/CommissionPayout';
+
+// Contratos HTTP — uno por endpoint
+export * from './dtos/CommissionApi';