@fiado/type-kit 3.195.0 → 3.198.0

package/src/loanCredit/dtos/LoanInstallment.ts

@@ -0,0 +1,75 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, IsString, Matches, Min } from 'class-validator';
+import { regexIso8601 } from '../../helpers/constans/regex';
+import { LoanInstallmentStatusEnum } from '../enums/LoanInstallmentStatusEnum';
+
+/**
+ * LoanInstallment — cuota semanal del crédito (modelo-datos §5b). Montos en cents; el IVA (16%)
+ * aplica SOLO sobre el interés de la cuota (M2 §3.3). `dueDate` (YYYY-MM-DD) queda ausente hasta la
+ * activación: las fechas se fijan a partir del primer viernes después de `activatedAt` (05_MOTOR §7).
+ */
+export class LoanInstallment {
+    @Expose()
+    @IsString()
+    creditId!: string;
+
+    /** Número de cuota 1-based. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    installmentNumber!: number;
+
+    @Expose()
+    @IsEnum(LoanInstallmentStatusEnum)
+    status!: LoanInstallmentStatusEnum;
+
+    /** Vencimiento YYYY-MM-DD (viernes; festivo → lunes siguiente). Ausente hasta activar. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    dueDate?: string;
+
+    @Expose()
+    @IsInt()
+    capitalCents!: number;
+
+    @Expose()
+    @IsInt()
+    interestCents!: number;
+
+    /** IVA 16% sobre el interés de la cuota. */
+    @Expose()
+    @IsInt()
+    ivaCents!: number;
+
+    /** capital + interés + IVA. */
+    @Expose()
+    @IsInt()
+    totalCents!: number;
+
+    /** Saldo insoluto de capital tras aplicar la cuota. */
+    @Expose()
+    @IsInt()
+    outstandingBalanceCents!: number;
+
+    @Expose()
+    @IsOptional()
+    @Matches(regexIso8601)
+    paidAt?: string;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+
+    @Expose()
+    @Matches(regexIso8601)
+    createdAt!: string;
+
+    @Expose()
+    @Matches(regexIso8601)
+    updatedAt!: string;
+}

package/src/loanCredit/dtos/requests/ChangeLoanCreditStatusRequest.ts

@@ -0,0 +1,22 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsString, MaxLength } from 'class-validator';
+import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
+
+/**
+ * Body de PUT /credits/:creditId/status (loan-credit-business). Cambio MANUAL de estado (05_MOTOR
+ * §8.2 — solo admin). Transiciones válidas: PENDING_ACTIVATION→CANCELLED (siempre),
+ * ACTIVE→CANCELLED (solo dentro de la ventana de 7 días), ACTIVE→WRITTEN_OFF,
+ * IN_ARREARS→WRITTEN_OFF. Cualquier otra → 400 INVALID_TRANSITION.
+ */
+export class ChangeLoanCreditStatusRequest {
+    @Expose()
+    @IsEnum(LoanCreditStatusEnum)
+    newStatus!: LoanCreditStatusEnum;
+
+    /** Razón del cambio (obligatoria — va al audit trail). */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(500)
+    reason!: string;
+}

package/src/loanCredit/dtos/requests/OriginateLoanCreditRequest.ts

@@ -0,0 +1,73 @@
+import { Expose } from 'class-transformer';
+import {
+    IsEnum,
+    IsInt,
+    IsNotEmpty,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Max,
+    Min,
+} from 'class-validator';
+import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+
+/**
+ * Body de POST /credits (loan-credit-business). Origina el crédito en `PENDING_ACTIVATION` y genera
+ * su plan de cuotas (amortización francesa + IVA 16% — M2 §3 / 05_MOTOR §4).
+ *
+ * Los términos financieros (`planId`, `termWeeks`, `tnaAnnual`) vienen de la cotización hecha con
+ * loan-offerings; el motor recalcula la tabla internamente (la cotización es informativa, el plan
+ * de cuotas del crédito lo genera y persiste este lambda).
+ */
+export class OriginateLoanCreditRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    borrowerId!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    planId!: string;
+
+    @Expose()
+    @IsInt()
+    @Min(1)
+    @Max(104)
+    termWeeks!: number;
+
+    @Expose()
+    @IsInt()
+    @Min(1)
+    equipmentPriceCents!: number;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    downPaymentCents!: number;
+
+    /** TNA decimal (`2.30` = 230%). */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    @Max(10)
+    tnaAnnual!: number;
+
+    /** SCI del cliente al originar (snapshot). */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    sciAtOrigination?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ClientLevelEnum)
+    clientLevelAtOrigination?: ClientLevelEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    imei?: string;
+}

package/src/loanCredit/dtos/requests/UpdateActivationChecklistRequest.ts

@@ -0,0 +1,29 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsOptional } from 'class-validator';
+
+/**
+ * Body de PUT /credits/:creditId/checklist (loan-credit-business). Marca condiciones de activación
+ * cumplidas. Solo se mandan las que cambian; en F3 las marcarán los flujos de firma de contrato
+ * (`downPayment` + `contractSigned`) y de enrolamiento MDM (`imeiEnrolled` + `lockVerified`).
+ */
+export class UpdateActivationChecklistRequest {
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    downPayment?: boolean;
+
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    contractSigned?: boolean;
+
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    imeiEnrolled?: boolean;
+
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    lockVerified?: boolean;
+}

package/src/loanCredit/dtos/requests/UpsertLoanBorrowerRequest.ts

@@ -0,0 +1,48 @@
+import { Expose, Type } from 'class-transformer';
+import {
+    IsEnum,
+    IsInt,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    Max,
+    Min,
+    ValidateNested,
+} from 'class-validator';
+import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { LoanBeneficiary } from '../LoanBeneficiary';
+
+/**
+ * Body de POST /borrowers y POST /private/borrowers (loan-credit-business).
+ * Upsert idempotente por `retailCustomerId`: si el borrower ya existe se actualizan los campos
+ * presentes; si no, se crea (mismo contrato que el consumidor de `CustomerKycVerifiedV1`).
+ */
+export class UpsertLoanBorrowerRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    retailCustomerId!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    sciScore?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ClientLevelEnum)
+    clientLevel?: ClientLevelEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    bureauScore?: number;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => LoanBeneficiary)
+    beneficiary?: LoanBeneficiary;
+}

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

@@ -0,0 +1,22 @@
+import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+
+/**
+ * Response de los endpoints de LoanBorrower (loan-credit-business). Interface plain (las salidas
+ * solo se tipan, no se validan en runtime).
+ */
+export interface LoanBorrowerResponse {
+    borrowerId: string;
+    retailCustomerId: string;
+    sciScore?: number;
+    clientLevel?: ClientLevelEnum;
+    bureauScore?: number;
+    beneficiary?: {
+        fullName: string;
+        relationship?: string;
+        phone?: string;
+    };
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

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

@@ -0,0 +1,39 @@
+import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
+
+/**
+ * Response de los endpoints de LoanCredit (loan-credit-business). Montos en cents; TNA decimal.
+ */
+export interface LoanCreditResponse {
+    creditId: string;
+    borrowerId: string;
+    status: LoanCreditStatusEnum;
+    planId: string;
+    termWeeks: number;
+    equipmentPriceCents: number;
+    downPaymentCents: number;
+    financedCapitalCents: number;
+    tnaAnnual: number;
+    weeklyPaymentCents: number;
+    weeklyPaymentWithIvaCents: number;
+    totalInterestCents: number;
+    totalIvaCents: number;
+    totalToPayCents: number;
+    imei?: string;
+    activationChecklist: {
+        downPayment: boolean;
+        contractSigned: boolean;
+        imeiEnrolled: boolean;
+        lockVerified: boolean;
+    };
+    sciAtOrigination?: number;
+    clientLevelAtOrigination?: ClientLevelEnum;
+    activatedAt?: string;
+    voluntaryCancelDeadline?: string;
+    firstDueDate?: string;
+    lastDueDate?: string;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

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

@@ -0,0 +1,18 @@
+import { LoanInstallmentStatusEnum } from '../../enums/LoanInstallmentStatusEnum';
+
+/**
+ * Response de una cuota del plan de pagos (loan-credit-business). Montos en cents; el IVA (16%)
+ * aplica solo sobre el interés de la cuota.
+ */
+export interface LoanInstallmentResponse {
+    creditId: string;
+    installmentNumber: number;
+    status: LoanInstallmentStatusEnum;
+    dueDate?: string;
+    capitalCents: number;
+    interestCents: number;
+    ivaCents: number;
+    totalCents: number;
+    outstandingBalanceCents: number;
+    paidAt?: string;
+}

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

@@ -0,0 +1,11 @@
+import { LoanCreditResponse } from './LoanCreditResponse';
+import { LoanInstallmentResponse } from './LoanInstallmentResponse';
+
+/**
+ * Response de POST /credits (loan-credit-business): el crédito recién originado en
+ * `PENDING_ACTIVATION` + su plan de cuotas completo (las fechas se fijan al activar).
+ */
+export interface OriginateLoanCreditResponse {
+    credit: LoanCreditResponse;
+    installments: LoanInstallmentResponse[];
+}

package/src/loanCredit/enums/ClientLevelEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Nivel del cliente según su SCI (M7/05_MOTOR §3.2): 21-60 Bronce · 61-80 Plata · 81-100 Oro.
+ * Distinto de `CreditPlanLevelEnum` de loanOfferings (que además tiene `ALL` para planes):
+ * un CLIENTE nunca es `ALL`.
+ * @enum {string}
+ */
+export enum ClientLevelEnum {
+    BRONZE = 'BRONZE',
+    SILVER = 'SILVER',
+    GOLD = 'GOLD',
+}

package/src/loanCredit/enums/LoanCreditStatusEnum.ts

@@ -0,0 +1,21 @@
+/**
+ * Estado del crédito SOFOM SureKeep (M2 §10 — ciclo de vida).
+ *
+ * `PENDING_ACTIVATION` (pendiente_activacion) → condiciones en proceso, reanudable, caduca a 30 días.
+ * `ACTIVE` (activo) → vigente, al corriente.
+ * `IN_ARREARS` (en_mora) → cuotas vencidas, dispositivo bloqueado.
+ * `SETTLED` (liquidado) → saldo pagado; historial positivo. Final.
+ * `CANCELLED` (cancelado) → cancelación voluntaria (ventana 7 días); enganche devuelto. Final.
+ * `DISCARDED` (descartado) → nunca se activó (caducó a 30 días). Sin efecto. Final.
+ * `WRITTEN_OFF` (baja_contable) → 180 días sin pago. Se desbloquea si paga. Final.
+ * @enum {string}
+ */
+export enum LoanCreditStatusEnum {
+    PENDING_ACTIVATION = 'PENDING_ACTIVATION',
+    ACTIVE = 'ACTIVE',
+    IN_ARREARS = 'IN_ARREARS',
+    SETTLED = 'SETTLED',
+    CANCELLED = 'CANCELLED',
+    DISCARDED = 'DISCARDED',
+    WRITTEN_OFF = 'WRITTEN_OFF',
+}

package/src/loanCredit/enums/LoanInstallmentStatusEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Estado de una cuota semanal del crédito (M2 §6.1 / 05_MOTOR §5).
+ * `RESTRUCTURED` (reestructurado) = la cuota dejó de aplicar por reestructura o cancelación.
+ * @enum {string}
+ */
+export enum LoanInstallmentStatusEnum {
+    PENDING = 'PENDING',
+    PAID = 'PAID',
+    OVERDUE = 'OVERDUE',
+    RESTRUCTURED = 'RESTRUCTURED',
+}

package/src/loanCredit/index.ts

@@ -0,0 +1,23 @@
+// Enums
+export * from './enums/LoanCreditStatusEnum';
+export * from './enums/LoanInstallmentStatusEnum';
+export * from './enums/ClientLevelEnum';
+
+// Entity DTOs
+export * from './dtos/LoanBorrower';
+export * from './dtos/LoanBeneficiary';
+export * from './dtos/LoanCredit';
+export * from './dtos/LoanInstallment';
+export * from './dtos/ActivationChecklist';
+
+// Request DTOs
+export * from './dtos/requests/UpsertLoanBorrowerRequest';
+export * from './dtos/requests/OriginateLoanCreditRequest';
+export * from './dtos/requests/UpdateActivationChecklistRequest';
+export * from './dtos/requests/ChangeLoanCreditStatusRequest';
+
+// Response DTOs
+export * from './dtos/responses/LoanBorrowerResponse';
+export * from './dtos/responses/LoanCreditResponse';
+export * from './dtos/responses/LoanInstallmentResponse';
+export * from './dtos/responses/OriginateLoanCreditResponse';

package/src/loanScoring/dtos/SciBreakdown.ts

@@ -0,0 +1,33 @@
+import { SciLayer2SourceEnum } from '../enums/SciLayer2SourceEnum';
+
+/** Capa 1 — gate anti-fraude (M7 §2). Binario: pasa o no pasa (KYC/Metamap, lo declara el caller). */
+export interface SciLayer1Breakdown {
+    passed: boolean;
+}
+
+/** Capa 2 — buró (M7 §3). Sub-scores normalizados 0-100 por variable cuando la fuente es FICO. */
+export interface SciLayer2Breakdown {
+    /** Score de la capa, 0-100. */
+    score: number;
+    source: SciLayer2SourceEnum;
+    /** Sub-scores 0-100 por variable (fico, worstDelinquency, openCredits, historyAge, inquiries). */
+    components?: Record<string, number>;
+}
+
+/** Capa 3 — historial interno SureKeep (M7 §4). */
+export interface SciLayer3Breakdown {
+    /** Score de la capa, 0-100. */
+    score: number;
+    /** Sub-scores 0-100 por variable (onTime, avgDelay, episodes, restructures, completed, writeOff). */
+    components?: Record<string, number>;
+}
+
+/**
+ * Desglose por capas del SCI (M7) que se snapshotea en `LoanSciEvaluation_GT`.
+ * Con proveedor Modelias solo viaja `layer1` (la decisión llega completa, sin SCI local).
+ */
+export interface SciBreakdown {
+    layer1: SciLayer1Breakdown;
+    layer2?: SciLayer2Breakdown;
+    layer3?: SciLayer3Breakdown;
+}

package/src/loanScoring/dtos/ScoringDecision.ts

@@ -0,0 +1,30 @@
+import { ClientLevelEnum } from '../enums/ClientLevelEnum';
+import { ScoringDecisionEnum } from '../enums/ScoringDecisionEnum';
+import { ScoringProviderEnum } from '../enums/ScoringProviderEnum';
+import { SciBreakdown } from './SciBreakdown';
+import { ScoringOffer } from './ScoringOffer';
+
+/**
+ * Contrato AGNÓSTICO de salida del scoring (diagramas F2 §credito · patrón spec 12): todos los
+ * proveedores (Modelias decisión-directa, Círculo insumos+SCI M7, futuros) normalizan a esta forma.
+ * El consumidor (wizard paso 05, motor de crédito) NO sabe qué proveedor la produjo; el proveedor
+ * usado queda snapshoteado en la evaluación (`LoanSciEvaluation_GT`).
+ */
+export interface ScoringDecision {
+    provider: ScoringProviderEnum;
+    /** Score en la escala canónica SCI 0-100 (C2 resuelta: la escala es 0-100). */
+    sciTotal: number;
+    level: ClientLevelEnum;
+    decision: ScoringDecisionEnum;
+    /** Oferta pre-aprobada si el proveedor la entrega (Modelias); null en el camino Círculo+SCI. */
+    offer: ScoringOffer | null;
+    /**
+     * Thin-file (M7 §3 / INT4): el proveedor CONFIRMÓ que la persona no tiene historial en buró.
+     * Es un dato de negocio válido (capa 2 neutra o FIS) — NUNCA se confunde con un error del
+     * connector (ese camino lanza DomainError; antipatrón API_ADAPTER_SWALLOW).
+     */
+    thinFile: boolean;
+    breakdown: SciBreakdown;
+    /** Marcas/flags del proveedor (`marcas` de Modelias). Vacío si no aplica. */
+    flags: string[];
+}

package/src/loanScoring/dtos/ScoringOffer.ts

@@ -0,0 +1,18 @@
+/**
+ * Oferta pre-aprobada que acompaña una decisión de scoring (cuando el proveedor la entrega —
+ * Modelias la devuelve completa; el camino Círculo+SCI no produce oferta, el plan lo resuelve
+ * loan-offerings por nivel).
+ *
+ * ⚠️ Los valores numéricos se transportan TAL CUAL los entrega el proveedor (el contrato Modelias
+ * no confirma unidades de `linea_credito`/`enganche` — ver TD del módulo modelias). NO asumir cents.
+ */
+export interface ScoringOffer {
+    /** Línea de crédito aprobada (unidad según proveedor). */
+    creditLine: number | null;
+    /** Enganche requerido (unidad/base según proveedor). */
+    downPayment: number | null;
+    /** Plazos ofrecidos, en semanas. */
+    termsWeeks: number[];
+    /** Tasas por plazo (clave = plazo, valor = tasa decimal). */
+    rates: Record<string, number>;
+}

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

@@ -0,0 +1,43 @@
+import { Type } from 'class-transformer';
+import { IsBoolean, IsEmail, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { SciInternalHistoryInput } from './SciInternalHistoryInput';
+
+/**
+ * Body de `POST /private/scoring/evaluations` de loan-scoring-business (wizard paso 05 / motor de
+ * crédito, vía api-invoker). El proveedor NO se elige acá: lo resuelve el `ScoringProviderRouter`
+ * por configuración del tenant (spec 12). El tenant viaja por query `?tenantId=` (convención de
+ * los privados Fiado), no en este body.
+ */
+export class EvaluateSciRequest {
+    /** Acreditado a evaluar (`LoanBorrower`). La evaluación queda ligada a él en el historial. */
+    @IsString()
+    @IsNotEmpty()
+    borrowerId!: string;
+
+    /** CURP del solicitante (requerido por los proveedores de scoring). */
+    @IsString()
+    @IsNotEmpty()
+    curp!: string;
+
+    /** Celular del solicitante (requerido por Modelias). */
+    @IsString()
+    @IsNotEmpty()
+    cellphone!: string;
+
+    @IsOptional()
+    @IsEmail()
+    email?: string;
+
+    /**
+     * Resultado del gate anti-fraude (M7 §2 — KYC/Metamap, se ejecuta UNA vez en el paso 01/02
+     * del wizard). El caller lo declara: `false` → decisión REJECTED sin consultar proveedor.
+     */
+    @IsBoolean()
+    antiFraudPassed!: boolean;
+
+    /** Historial interno del acreditado (capa 3). Ausente = cliente nuevo (capa 2 pesa 100%). */
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => SciInternalHistoryInput)
+    internalHistory?: SciInternalHistoryInput;
+}

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

@@ -0,0 +1,38 @@
+import { IsBoolean, IsInt, IsNumber, Max, Min } from 'class-validator';
+
+/**
+ * Resumen del historial interno SureKeep del acreditado (M7 §4 — capa 3 del SCI). Lo aporta el
+ * caller (loan-credit-business es el dueño de cuotas/moras); ausente = cliente sin historial
+ * interno (la capa 2 pesa 100% — M7 §5).
+ */
+export class SciInternalHistoryInput {
+    /** % de cuotas pagadas a tiempo, 0-100 (peso 30%). */
+    @IsNumber()
+    @Min(0)
+    @Max(100)
+    pctOnTimeInstallments!: number;
+
+    /** Días promedio de atraso (peso 20%). */
+    @IsNumber()
+    @Min(0)
+    avgDelinquencyDays!: number;
+
+    /** Episodios de mora (peso 20%). */
+    @IsInt()
+    @Min(0)
+    delinquencyEpisodes!: number;
+
+    /** Reestructuras (peso 15%; máx 1 por crédito — M2). */
+    @IsInt()
+    @Min(0)
+    restructures!: number;
+
+    /** Créditos completados sin mora (peso 10%). */
+    @IsInt()
+    @Min(0)
+    completedCredits!: number;
+
+    /** Baja contable previa (peso 5% — penaliza fuerte). */
+    @IsBoolean()
+    previousWriteOff!: boolean;
+}

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

@@ -0,0 +1,25 @@
+import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { ScoringDecisionEnum } from '../../enums/ScoringDecisionEnum';
+import { ScoringProviderEnum } from '../../enums/ScoringProviderEnum';
+import { SciBreakdown } from '../SciBreakdown';
+import { ScoringOffer } from '../ScoringOffer';
+
+/**
+ * Response de `POST /private/scoring/evaluations`: la `ScoringDecision` normalizada + la identidad
+ * del snapshot persistido en `LoanSciEvaluation_GT` (el motor de crédito guarda `evaluationId`
+ * como `sciAtOrigination`).
+ */
+export interface EvaluateSciResponse {
+    evaluationId: string;
+    borrowerId: string;
+    provider: ScoringProviderEnum;
+    /** Escala canónica SCI 0-100. */
+    sciTotal: number;
+    level: ClientLevelEnum;
+    decision: ScoringDecisionEnum;
+    offer: ScoringOffer | null;
+    thinFile: boolean;
+    breakdown: SciBreakdown;
+    flags: string[];
+    createdAt: string;
+}

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

@@ -0,0 +1,29 @@
+import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
+import { ScoringDecisionEnum } from '../../enums/ScoringDecisionEnum';
+import { ScoringProviderEnum } from '../../enums/ScoringProviderEnum';
+import { SciBreakdown } from '../SciBreakdown';
+import { ScoringOffer } from '../ScoringOffer';
+
+/**
+ * Detalle de una evaluación SCI snapshoteada en `LoanSciEvaluation_GT` (lecturas: detalle e
+ * historial por acreditado del backoffice, y GET privado del motor de crédito). Incluye la
+ * metadata de auditoría del snapshot.
+ */
+export interface SciEvaluationResponse {
+    evaluationId: string;
+    borrowerId: string;
+    provider: ScoringProviderEnum;
+    /** Escala canónica SCI 0-100. */
+    sciTotal: number;
+    level: ClientLevelEnum;
+    decision: ScoringDecisionEnum;
+    offer: ScoringOffer | null;
+    thinFile: boolean;
+    breakdown: SciBreakdown;
+    flags: string[];
+    version: number;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/src/loanScoring/enums/ClientLevelEnum.ts

@@ -0,0 +1,13 @@
+/**
+ * Nivel del cliente derivado del SCI (M7 §5: 0-20 no elegible · 21-60 bronce · 61-80 plata ·
+ * 81-100 oro). Valores en inglés alineados con `CreditPlanLevelEnum` de loanOfferings
+ * (BRONZE/SILVER/GOLD) — el plan de crédito se resuelve cruzando este nivel con el catálogo.
+ * `NOT_ELIGIBLE` no existe en el catálogo de planes: significa "no se ofrece crédito".
+ * @enum {string}
+ */
+export enum ClientLevelEnum {
+    NOT_ELIGIBLE = 'NOT_ELIGIBLE',
+    BRONZE = 'BRONZE',
+    SILVER = 'SILVER',
+    GOLD = 'GOLD',
+}

package/src/loanScoring/enums/SciLayer2SourceEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Fuente de la capa 2 (buró) del SCI — M7 §3 + INT4 v2.0 (thin-file):
+ * `FICO` = historial pleno en Círculo · `FIS` = thin-file con Financial Inclusion Score
+ * (INT4 v2.0 supersede el "50 neutro" de M7 §3) · `NEUTRAL` = sin dato de buró (SCI base 50).
+ * @enum {string}
+ */
+export enum SciLayer2SourceEnum {
+    FICO = 'FICO',
+    FIS = 'FIS',
+    NEUTRAL = 'NEUTRAL',
+}