@fiado/type-kit 3.395.0 → 3.397.0

package/_test_/unit/loanCredit/creditAuditSnapshots.test.ts

@@ -0,0 +1,75 @@
+import 'reflect-metadata';
+import {
+  AppliedStorePolicySnapshot,
+  CandidatePlanSnapshot,
+  EffectiveTermsSnapshot,
+  LoanCreditResponse,
+} from '../../../src/loanCredit/index';
+import { FoldableTermEnum, PromotionEffectKindEnum } from '../../../src/loanOfferings/index';
+
+describe('snapshots de auditoría del crédito', () => {
+  it('congela la política especial con los términos que ganó', () => {
+    const policy: AppliedStorePolicySnapshot = {
+      policyId: 'POL#1',
+      name: 'Freno de riesgo Norte',
+      appliedTerms: [FoldableTermEnum.MAX_FINANCED_AMOUNT_CENTS],
+    };
+    expect(policy.appliedTerms[0]).toBe('maxFinancedAmountCents');
+  });
+
+  it('congela el plan candidato con su id y su código', () => {
+    const candidate: CandidatePlanSnapshot = { planId: 'PLAN#1', code: 'SK-12' };
+    expect(candidate.planId).toBe('PLAN#1');
+  });
+
+  it('admite un tope de enganche nulo: el plan puede no acotarlo', () => {
+    const terms: EffectiveTermsSnapshot = {
+      minDownPaymentPct: 0.1,
+      maxDownPaymentPct: null,
+      maxFinancedAmountCents: 2_500_000,
+    };
+    expect(terms.maxDownPaymentPct).toBeNull();
+  });
+});
+
+describe('LoanCreditResponse', () => {
+  it('deja la auditoría opcional y nullable: los créditos viejos no la tienen', () => {
+    const legacy: Pick<
+      LoanCreditResponse,
+      | 'appliedPromotions'
+      | 'appliedStorePolicies'
+      | 'candidatePlans'
+      | 'planVersionAtOrigination'
+      | 'segmentIdsAtQuote'
+      | 'effectiveTerms'
+    > = {
+      appliedPromotions: null,
+      appliedStorePolicies: null,
+      candidatePlans: null,
+      planVersionAtOrigination: null,
+      segmentIdsAtQuote: null,
+      effectiveTerms: null,
+    };
+    expect(Object.values(legacy).every((value) => value === null)).toBe(true);
+  });
+
+  it('convive con la promoción primaria singular, que no cambia', () => {
+    const audited: Pick<LoanCreditResponse, 'appliedPromotion' | 'appliedPromotions'> = {
+      appliedPromotion: {
+        promotionId: 'PROMO#1',
+        name: 'Buen Fin',
+        version: 2,
+        appliedEffects: [PromotionEffectKindEnum.DOWN_PAYMENT_DELTA],
+      },
+      appliedPromotions: [
+        {
+          promotionId: 'PROMO#1',
+          name: 'Buen Fin',
+          version: 2,
+          appliedEffects: [PromotionEffectKindEnum.DOWN_PAYMENT_DELTA],
+        },
+      ],
+    };
+    expect(audited.appliedPromotions?.[0].name).toBe(audited.appliedPromotion?.name);
+  });
+});

package/_test_/unit/loanOfferings/simulationAudit.test.ts

@@ -0,0 +1,70 @@
+import 'reflect-metadata';
+import {
+  AppliedStorePolicyResponse,
+  CandidatePlanResponse,
+  FoldableTermEnum,
+  PromotionEffectKindEnum,
+  SimulationResultResponse,
+} from '../../../src/loanOfferings/index';
+
+/** Los valores del enum son las claves literales de los términos que el motor pliega. */
+describe('FoldableTermEnum', () => {
+  it('expone exactamente los tres términos plegables con su clave literal', () => {
+    expect(Object.values(FoldableTermEnum).sort()).toEqual(
+      ['maxFinancedAmountCents', 'minDownPaymentPct', 'tnaAnnual'],
+    );
+  });
+});
+
+describe('auditoría de la simulación', () => {
+  it('tipa el plan candidato con su id y su código', () => {
+    const candidate: CandidatePlanResponse = { planId: 'PLAN#1', code: 'SK-12' };
+    expect(candidate.code).toBe('SK-12');
+  });
+
+  it('tipa la política aplicada con los términos que ganó', () => {
+    const policy: AppliedStorePolicyResponse = {
+      policyId: 'POL#1',
+      name: 'Freno de riesgo Norte',
+      appliedTerms: [FoldableTermEnum.TNA_ANNUAL, FoldableTermEnum.MIN_DOWN_PAYMENT_PCT],
+    };
+    expect(policy.appliedTerms).toHaveLength(2);
+  });
+
+  it('deja los tres bloques de auditoría opcionales y conviviendo con la promoción primaria', () => {
+    const minimal: Pick<SimulationResultResponse, 'appliedPromotion'> = { appliedPromotion: null };
+    expect(minimal.appliedPromotion).toBeNull();
+
+    const audited: Pick<
+      SimulationResultResponse,
+      'appliedPromotion' | 'appliedPromotions' | 'candidatePlans' | 'appliedStorePolicies'
+    > = {
+      appliedPromotion: {
+        promotionId: 'PROMO#1',
+        name: 'Buen Fin',
+        version: 2,
+        appliedEffects: [PromotionEffectKindEnum.TNA_OVERRIDE],
+      },
+      appliedPromotions: [
+        {
+          promotionId: 'PROMO#1',
+          name: 'Buen Fin',
+          version: 2,
+          appliedEffects: [PromotionEffectKindEnum.TNA_OVERRIDE],
+        },
+        {
+          promotionId: 'PROMO#2',
+          name: 'Bono tarjeta',
+          version: 1,
+          appliedEffects: [PromotionEffectKindEnum.PCF_BONUS],
+        },
+      ],
+      candidatePlans: [{ planId: 'PLAN#1', code: 'SK-12' }],
+      appliedStorePolicies: [
+        { policyId: 'POL#1', name: 'Freno Norte', appliedTerms: [FoldableTermEnum.TNA_ANNUAL] },
+      ],
+    };
+    expect(audited.appliedPromotions).toHaveLength(2);
+    expect(audited.appliedPromotion?.promotionId).toBe(audited.appliedPromotions?.[0].promotionId);
+  });
+});

package/bin/loanCredit/dtos/AppliedStorePolicySnapshot.d.ts

@@ -0,0 +1,11 @@
+import { FoldableTermEnum } from '../../loanOfferings/enums/FoldableTermEnum';
+/**
+ * Política especial que ganó algún término de este crédito, congelada al cotizar. El catálogo de
+ * políticas es editable: sin esta copia, una edición posterior deja la cuota sin explicación.
+ */
+export interface AppliedStorePolicySnapshot {
+    policyId: string;
+    name: string;
+    /** Términos del plan que esta política ganó en el pliegue final. */
+    appliedTerms: FoldableTermEnum[];
+}

package/bin/loanCredit/dtos/AppliedStorePolicySnapshot.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCredit/dtos/CandidatePlanSnapshot.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `CreditPlan` que el motor consideró al cotizar este crédito, haya ganado algún término o no.
+ * Es lo que contesta por qué se cotizó con este plan y no con otro.
+ */
+export interface CandidatePlanSnapshot {
+    planId: string;
+    code: string;
+}

package/bin/loanCredit/dtos/CandidatePlanSnapshot.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCredit/dtos/EffectiveTermsSnapshot.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Cotas con las que se cotizó este crédito de verdad, ya pisadas por promociones y políticas.
+ * NO son las del plan: una promoción puede bajar el enganche mínimo o subir el techo de monto.
+ */
+export interface EffectiveTermsSnapshot {
+    /** Enganche mínimo exigible, en decimal sobre 1 (`0.10` = 10%). */
+    minDownPaymentPct: number;
+    /** Tope de enganche, o `null` si el plan no lo acota. */
+    maxDownPaymentPct: number | null;
+    /** Techo de capital financiable. */
+    maxFinancedAmountCents: number;
+}

package/bin/loanCredit/dtos/EffectiveTermsSnapshot.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCredit/dtos/responses/LoanCreditResponse.d.ts

@@ -1,6 +1,9 @@
 import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
 import { AppliedPromotionSnapshot } from '../AppliedPromotionSnapshot';
+import { AppliedStorePolicySnapshot } from '../AppliedStorePolicySnapshot';
+import { CandidatePlanSnapshot } from '../CandidatePlanSnapshot';
+import { EffectiveTermsSnapshot } from '../EffectiveTermsSnapshot';
 /**
  * Response de los endpoints de LoanCredit (loan-credit-business). Montos en cents; TNA decimal.
  */
@@ -31,6 +34,21 @@ export interface LoanCreditResponse {
     clientLevelAtOrigination?: ClientLevelEnum;
     /** Promoción con la que se cotizó, o `null` si ninguna alcanzaba a esta venta. */
     appliedPromotion?: AppliedPromotionSnapshot | null;
+    /**
+     * TODAS las promociones aplicadas: `appliedPromotion` es la primaria y esto es la auditoría
+     * completa. Los términos de arriba YA las incluyen, no son un extra a sumar.
+     */
+    appliedPromotions?: AppliedPromotionSnapshot[] | null;
+    /** Políticas especiales que ganaron algún término: qué frenó o aflojó la cuota. */
+    appliedStorePolicies?: AppliedStorePolicySnapshot[] | null;
+    /** Los planes que compitieron: contesta por qué este plan y no otro. */
+    candidatePlans?: CandidatePlanSnapshot[] | null;
+    /** Edición del plan al originar: contesta con qué reglas se cotizó, aunque después se edite. */
+    planVersionAtOrigination?: number | null;
+    /** Segmentos del cliente al cotizar: contesta por qué le alcanzó esa promoción. */
+    segmentIdsAtQuote?: string[] | null;
+    /** Cotas con las que se cotizó de verdad, ya pisadas por promociones y políticas. */
+    effectiveTerms?: EffectiveTermsSnapshot | null;
     activatedAt?: string;
     voluntaryCancelDeadline?: string;
     firstDueDate?: string;

package/bin/loanCredit/index.d.ts

@@ -9,6 +9,9 @@ export * from './dtos/LoanInstallment';
 export * from './dtos/LoanContract';
 export * from './dtos/ActivationChecklist';
 export * from './dtos/AppliedPromotionSnapshot';
+export * from './dtos/AppliedStorePolicySnapshot';
+export * from './dtos/CandidatePlanSnapshot';
+export * from './dtos/EffectiveTermsSnapshot';
 export * from './dtos/requests/UpsertLoanBorrowerRequest';
 export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';

package/bin/loanCredit/index.js

@@ -30,6 +30,9 @@ __exportStar(require("./dtos/LoanInstallment"), exports);
 __exportStar(require("./dtos/LoanContract"), exports);
 __exportStar(require("./dtos/ActivationChecklist"), exports);
 __exportStar(require("./dtos/AppliedPromotionSnapshot"), exports);
+__exportStar(require("./dtos/AppliedStorePolicySnapshot"), exports);
+__exportStar(require("./dtos/CandidatePlanSnapshot"), exports);
+__exportStar(require("./dtos/EffectiveTermsSnapshot"), exports);
 // Request DTOs
 __exportStar(require("./dtos/requests/UpsertLoanBorrowerRequest"), exports);
 __exportStar(require("./dtos/requests/OriginateLoanCreditRequest"), exports);

package/bin/loanOfferings/dtos/responses/SimulationResultResponse.d.ts

@@ -1,3 +1,4 @@
+import { FoldableTermEnum } from '../../enums/FoldableTermEnum';
 import { PromotionEffectKindEnum } from '../../enums/PromotionEffectKindEnum';
 import { PlanTermProvenance } from './StorePolicyResponse';
 /**
@@ -27,6 +28,24 @@ export interface AppliedPromotionResponse {
     /** Palancas del plan que la promoción pisó. */
     appliedEffects: PromotionEffectKindEnum[];
 }
+/**
+ * Una `CreditPlan` que el paso Base consideró para esta venta, haya ganado algún término o no.
+ * Es lo que contesta por qué ganó este plan y no otro.
+ */
+export interface CandidatePlanResponse {
+    planId: string;
+    code: string;
+}
+/**
+ * Política especial que ganó al menos un término de esta cotización. Las políticas en alcance que
+ * no ganaron nada no se reportan: no explican la cuota.
+ */
+export interface AppliedStorePolicyResponse {
+    policyId: string;
+    name: string;
+    /** Términos del plan que esta política ganó en el pliegue final. */
+    appliedTerms: FoldableTermEnum[];
+}
 /**
  * Cotas con las que se cotizó de verdad, ya pisadas por la promoción y las políticas. NO son las
  * del plan: una promoción puede bajar el enganche mínimo o subir el techo de monto.
@@ -84,4 +103,18 @@ export interface SimulationResultResponse {
      * Las cotas efectivas de ESTA cotización. Ausente si el lambda todavía no las emite.
      */
     effectiveTerms?: EffectiveTermsResponse;
+    /**
+     * Todas las `CreditPlan` candidatas del paso Base. Ausente si el lambda todavía no lo emite.
+     */
+    candidatePlans?: CandidatePlanResponse[];
+    /**
+     * TODAS las promociones aplicadas: `appliedPromotion` es la primaria y esto es la auditoría
+     * completa. Los montos de arriba YA las incluyen, no son un extra a sumar. Ausente si el
+     * lambda todavía no lo emite.
+     */
+    appliedPromotions?: AppliedPromotionResponse[];
+    /**
+     * Políticas especiales que ganaron algún término. Ausente si el lambda todavía no lo emite.
+     */
+    appliedStorePolicies?: AppliedStorePolicyResponse[];
 }

package/bin/loanOfferings/enums/FoldableTermEnum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Términos del plan que el motor de cotización pliega capa por capa (plan base, promociones,
+ * políticas especiales). El valor es la clave literal del término en el contrato.
+ * @enum {string}
+ */
+export declare enum FoldableTermEnum {
+    MIN_DOWN_PAYMENT_PCT = "minDownPaymentPct",
+    TNA_ANNUAL = "tnaAnnual",
+    MAX_FINANCED_AMOUNT_CENTS = "maxFinancedAmountCents"
+}

package/bin/loanOfferings/enums/FoldableTermEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FoldableTermEnum = void 0;
+/**
+ * Términos del plan que el motor de cotización pliega capa por capa (plan base, promociones,
+ * políticas especiales). El valor es la clave literal del término en el contrato.
+ * @enum {string}
+ */
+var FoldableTermEnum;
+(function (FoldableTermEnum) {
+    FoldableTermEnum["MIN_DOWN_PAYMENT_PCT"] = "minDownPaymentPct";
+    FoldableTermEnum["TNA_ANNUAL"] = "tnaAnnual";
+    FoldableTermEnum["MAX_FINANCED_AMOUNT_CENTS"] = "maxFinancedAmountCents";
+})(FoldableTermEnum || (exports.FoldableTermEnum = FoldableTermEnum = {}));

package/bin/loanOfferings/index.d.ts

@@ -6,6 +6,7 @@ export * from './enums/FinancierTypeEnum';
 export * from './enums/FinancierStatusEnum';
 export * from './enums/PromotionStatusEnum';
 export * from './enums/PromotionEffectKindEnum';
+export * from './enums/FoldableTermEnum';
 export * from './enums/PromotionBonusStatusEnum';
 export * from './enums/PromotionPhaseEnum';
 export * from './enums/PromotionLogEventEnum';

package/bin/loanOfferings/index.js

@@ -23,6 +23,7 @@ __exportStar(require("./enums/FinancierTypeEnum"), exports);
 __exportStar(require("./enums/FinancierStatusEnum"), exports);
 __exportStar(require("./enums/PromotionStatusEnum"), exports);
 __exportStar(require("./enums/PromotionEffectKindEnum"), exports);
+__exportStar(require("./enums/FoldableTermEnum"), exports);
 __exportStar(require("./enums/PromotionBonusStatusEnum"), exports);
 __exportStar(require("./enums/PromotionPhaseEnum"), exports);
 __exportStar(require("./enums/PromotionLogEventEnum"), exports);

package/bin/loanScoring/dtos/requests/EvaluateSciRequest.d.ts

@@ -8,6 +8,11 @@ import { SciInternalHistoryInput } from './SciInternalHistoryInput';
 export declare class EvaluateSciRequest {
     /** Acreditado a evaluar (`LoanBorrower`). La evaluación queda ligada a él en el historial. */
     borrowerId: string;
+    /**
+     * Cliente retail dueño del acreditado. Se guarda en el snapshot para que el listado del
+     * backoffice resuelva el nombre sin volver a preguntarle a loan-credit de quién es.
+     */
+    retailCustomerId?: string;
     /** CURP del solicitante (requerido por los proveedores de scoring). */
     curp: string;
     /** Celular del solicitante (requerido por Modelias). */

package/bin/loanScoring/dtos/requests/EvaluateSciRequest.js

@@ -27,6 +27,12 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], EvaluateSciRequest.prototype, "borrowerId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], EvaluateSciRequest.prototype, "retailCustomerId", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),

package/bin/loanScoring/dtos/responses/ListSciEvaluationsResponse.d.ts

@@ -0,0 +1,29 @@
+import { PaginatedResult } from '../../../retailOrg/dtos/PaginatedResult';
+import { SciEvaluationResponse } from './SciEvaluationResponse';
+/**
+ * Fila lista para pintar del listado de evaluaciones del tenant: la evaluación más el contexto
+ * del cliente ya resuelto por el motor. El front no cruza nada.
+ */
+export interface SciEvaluationListItem {
+    evaluation: SciEvaluationResponse;
+    /** Cliente retail dueño del acreditado. `null` en las evaluaciones anteriores al campo. */
+    retailCustomerId: string | null;
+    /** `null` cuando el nombre no se pudo resolver; el front pinta el id, nunca un vacío. */
+    customerName: string | null;
+    /**
+     * `null` mientras el lote del padrón no devuelva teléfono: hoy solo proyecta el nombre.
+     * Viaja igual para que el contrato de la fila no cambie cuando lo devuelva.
+     */
+    customerPhone: string | null;
+}
+/**
+ * Página del listado de evaluaciones del tenant, ordenada de la más nueva a la más vieja.
+ * Usa el sobre paginado canónico (`items` + `count` + `nextToken` ausente en la última página).
+ */
+export interface ListSciEvaluationsResponse extends PaginatedResult<SciEvaluationListItem> {
+    /**
+     * Filas con `retailCustomerId` cuyo nombre no se resolvió — porque el padrón no lo tiene o
+     * porque no contestó. La pantalla lo anuncia en vez de dejar huecos sin explicación.
+     */
+    unresolvedCustomerCount: number;
+}

package/bin/loanScoring/dtos/responses/ListSciEvaluationsResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanScoring/index.d.ts

@@ -9,3 +9,4 @@ export * from './dtos/requests/EvaluateSciRequest';
 export * from './dtos/requests/SciInternalHistoryInput';
 export * from './dtos/responses/EvaluateSciResponse';
 export * from './dtos/responses/SciEvaluationResponse';
+export * from './dtos/responses/ListSciEvaluationsResponse';

package/bin/loanScoring/index.js

@@ -29,3 +29,4 @@ __exportStar(require("./dtos/requests/SciInternalHistoryInput"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/EvaluateSciResponse"), exports);
 __exportStar(require("./dtos/responses/SciEvaluationResponse"), exports);
+__exportStar(require("./dtos/responses/ListSciEvaluationsResponse"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.395.0",
+  "version": "3.397.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/loanCredit/dtos/AppliedStorePolicySnapshot.ts

@@ -0,0 +1,12 @@
+import { FoldableTermEnum } from '../../loanOfferings/enums/FoldableTermEnum';
+
+/**
+ * Política especial que ganó algún término de este crédito, congelada al cotizar. El catálogo de
+ * políticas es editable: sin esta copia, una edición posterior deja la cuota sin explicación.
+ */
+export interface AppliedStorePolicySnapshot {
+    policyId: string;
+    name: string;
+    /** Términos del plan que esta política ganó en el pliegue final. */
+    appliedTerms: FoldableTermEnum[];
+}

package/src/loanCredit/dtos/CandidatePlanSnapshot.ts

@@ -0,0 +1,8 @@
+/**
+ * `CreditPlan` que el motor consideró al cotizar este crédito, haya ganado algún término o no.
+ * Es lo que contesta por qué se cotizó con este plan y no con otro.
+ */
+export interface CandidatePlanSnapshot {
+    planId: string;
+    code: string;
+}

package/src/loanCredit/dtos/EffectiveTermsSnapshot.ts

@@ -0,0 +1,12 @@
+/**
+ * Cotas con las que se cotizó este crédito de verdad, ya pisadas por promociones y políticas.
+ * NO son las del plan: una promoción puede bajar el enganche mínimo o subir el techo de monto.
+ */
+export interface EffectiveTermsSnapshot {
+    /** Enganche mínimo exigible, en decimal sobre 1 (`0.10` = 10%). */
+    minDownPaymentPct: number;
+    /** Tope de enganche, o `null` si el plan no lo acota. */
+    maxDownPaymentPct: number | null;
+    /** Techo de capital financiable. */
+    maxFinancedAmountCents: number;
+}

package/src/loanCredit/dtos/responses/LoanCreditResponse.ts

@@ -1,6 +1,9 @@
 import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
 import { AppliedPromotionSnapshot } from '../AppliedPromotionSnapshot';
+import { AppliedStorePolicySnapshot } from '../AppliedStorePolicySnapshot';
+import { CandidatePlanSnapshot } from '../CandidatePlanSnapshot';
+import { EffectiveTermsSnapshot } from '../EffectiveTermsSnapshot';
 
 /**
  * Response de los endpoints de LoanCredit (loan-credit-business). Montos en cents; TNA decimal.
@@ -32,6 +35,21 @@ export interface LoanCreditResponse {
     clientLevelAtOrigination?: ClientLevelEnum;
     /** Promoción con la que se cotizó, o `null` si ninguna alcanzaba a esta venta. */
     appliedPromotion?: AppliedPromotionSnapshot | null;
+    /**
+     * TODAS las promociones aplicadas: `appliedPromotion` es la primaria y esto es la auditoría
+     * completa. Los términos de arriba YA las incluyen, no son un extra a sumar.
+     */
+    appliedPromotions?: AppliedPromotionSnapshot[] | null;
+    /** Políticas especiales que ganaron algún término: qué frenó o aflojó la cuota. */
+    appliedStorePolicies?: AppliedStorePolicySnapshot[] | null;
+    /** Los planes que compitieron: contesta por qué este plan y no otro. */
+    candidatePlans?: CandidatePlanSnapshot[] | null;
+    /** Edición del plan al originar: contesta con qué reglas se cotizó, aunque después se edite. */
+    planVersionAtOrigination?: number | null;
+    /** Segmentos del cliente al cotizar: contesta por qué le alcanzó esa promoción. */
+    segmentIdsAtQuote?: string[] | null;
+    /** Cotas con las que se cotizó de verdad, ya pisadas por promociones y políticas. */
+    effectiveTerms?: EffectiveTermsSnapshot | null;
     activatedAt?: string;
     voluntaryCancelDeadline?: string;
     firstDueDate?: string;

package/src/loanCredit/index.ts

@@ -13,6 +13,9 @@ export * from './dtos/LoanInstallment';
 export * from './dtos/LoanContract';
 export * from './dtos/ActivationChecklist';
 export * from './dtos/AppliedPromotionSnapshot';
+export * from './dtos/AppliedStorePolicySnapshot';
+export * from './dtos/CandidatePlanSnapshot';
+export * from './dtos/EffectiveTermsSnapshot';
 
 // Request DTOs
 export * from './dtos/requests/UpsertLoanBorrowerRequest';

package/src/loanOfferings/dtos/responses/SimulationResultResponse.ts

@@ -1,3 +1,4 @@
+import { FoldableTermEnum } from '../../enums/FoldableTermEnum';
 import { PromotionEffectKindEnum } from '../../enums/PromotionEffectKindEnum';
 import { PlanTermProvenance } from './StorePolicyResponse';
 
@@ -30,6 +31,26 @@ export interface AppliedPromotionResponse {
     appliedEffects: PromotionEffectKindEnum[];
 }
 
+/**
+ * Una `CreditPlan` que el paso Base consideró para esta venta, haya ganado algún término o no.
+ * Es lo que contesta por qué ganó este plan y no otro.
+ */
+export interface CandidatePlanResponse {
+    planId: string;
+    code: string;
+}
+
+/**
+ * Política especial que ganó al menos un término de esta cotización. Las políticas en alcance que
+ * no ganaron nada no se reportan: no explican la cuota.
+ */
+export interface AppliedStorePolicyResponse {
+    policyId: string;
+    name: string;
+    /** Términos del plan que esta política ganó en el pliegue final. */
+    appliedTerms: FoldableTermEnum[];
+}
+
 /**
  * Cotas con las que se cotizó de verdad, ya pisadas por la promoción y las políticas. NO son las
  * del plan: una promoción puede bajar el enganche mínimo o subir el techo de monto.
@@ -88,4 +109,18 @@ export interface SimulationResultResponse {
      * Las cotas efectivas de ESTA cotización. Ausente si el lambda todavía no las emite.
      */
     effectiveTerms?: EffectiveTermsResponse;
+    /**
+     * Todas las `CreditPlan` candidatas del paso Base. Ausente si el lambda todavía no lo emite.
+     */
+    candidatePlans?: CandidatePlanResponse[];
+    /**
+     * TODAS las promociones aplicadas: `appliedPromotion` es la primaria y esto es la auditoría
+     * completa. Los montos de arriba YA las incluyen, no son un extra a sumar. Ausente si el
+     * lambda todavía no lo emite.
+     */
+    appliedPromotions?: AppliedPromotionResponse[];
+    /**
+     * Políticas especiales que ganaron algún término. Ausente si el lambda todavía no lo emite.
+     */
+    appliedStorePolicies?: AppliedStorePolicyResponse[];
 }

package/src/loanOfferings/enums/FoldableTermEnum.ts

@@ -0,0 +1,10 @@
+/**
+ * Términos del plan que el motor de cotización pliega capa por capa (plan base, promociones,
+ * políticas especiales). El valor es la clave literal del término en el contrato.
+ * @enum {string}
+ */
+export enum FoldableTermEnum {
+    MIN_DOWN_PAYMENT_PCT = 'minDownPaymentPct',
+    TNA_ANNUAL = 'tnaAnnual',
+    MAX_FINANCED_AMOUNT_CENTS = 'maxFinancedAmountCents',
+}

package/src/loanOfferings/index.ts

@@ -7,6 +7,7 @@ export * from './enums/FinancierTypeEnum';
 export * from './enums/FinancierStatusEnum';
 export * from './enums/PromotionStatusEnum';
 export * from './enums/PromotionEffectKindEnum';
+export * from './enums/FoldableTermEnum';
 export * from './enums/PromotionBonusStatusEnum';
 export * from './enums/PromotionPhaseEnum';
 export * from './enums/PromotionLogEventEnum';

package/src/loanScoring/dtos/requests/EvaluateSciRequest.ts

@@ -14,6 +14,15 @@ export class EvaluateSciRequest {
     @IsNotEmpty()
     borrowerId!: string;
 
+    /**
+     * Cliente retail dueño del acreditado. Se guarda en el snapshot para que el listado del
+     * backoffice resuelva el nombre sin volver a preguntarle a loan-credit de quién es.
+     */
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    retailCustomerId?: string;
+
     /** CURP del solicitante (requerido por los proveedores de scoring). */
     @IsString()
     @IsNotEmpty()

package/src/loanScoring/dtos/responses/ListSciEvaluationsResponse.ts

@@ -0,0 +1,31 @@
+import { PaginatedResult } from '../../../retailOrg/dtos/PaginatedResult';
+import { SciEvaluationResponse } from './SciEvaluationResponse';
+
+/**
+ * Fila lista para pintar del listado de evaluaciones del tenant: la evaluación más el contexto
+ * del cliente ya resuelto por el motor. El front no cruza nada.
+ */
+export interface SciEvaluationListItem {
+    evaluation: SciEvaluationResponse;
+    /** Cliente retail dueño del acreditado. `null` en las evaluaciones anteriores al campo. */
+    retailCustomerId: string | null;
+    /** `null` cuando el nombre no se pudo resolver; el front pinta el id, nunca un vacío. */
+    customerName: string | null;
+    /**
+     * `null` mientras el lote del padrón no devuelva teléfono: hoy solo proyecta el nombre.
+     * Viaja igual para que el contrato de la fila no cambie cuando lo devuelva.
+     */
+    customerPhone: string | null;
+}
+
+/**
+ * Página del listado de evaluaciones del tenant, ordenada de la más nueva a la más vieja.
+ * Usa el sobre paginado canónico (`items` + `count` + `nextToken` ausente en la última página).
+ */
+export interface ListSciEvaluationsResponse extends PaginatedResult<SciEvaluationListItem> {
+    /**
+     * Filas con `retailCustomerId` cuyo nombre no se resolvió — porque el padrón no lo tiene o
+     * porque no contestó. La pantalla lo anuncia en vez de dejar huecos sin explicación.
+     */
+    unresolvedCustomerCount: number;
+}

package/src/loanScoring/index.ts

@@ -16,3 +16,4 @@ export * from './dtos/requests/SciInternalHistoryInput';
 // Response DTOs
 export * from './dtos/responses/EvaluateSciResponse';
 export * from './dtos/responses/SciEvaluationResponse';
+export * from './dtos/responses/ListSciEvaluationsResponse';