@muni-sanfer/types-gestor-documental 0.0.1-beta.23 → 0.0.1-beta.25

package/dist/entities/index.d.ts

@@ -15,3 +15,5 @@ export * from './indicators';
 export * from './audit';
 export * from './signatureCheck';
 export * from './repositoryExport';
+export * from './retention';
+export * from './accessRequest';

package/dist/entities/index.js

@@ -31,3 +31,5 @@ __exportStar(require("./indicators"), exports);
 __exportStar(require("./audit"), exports);
 __exportStar(require("./signatureCheck"), exports);
 __exportStar(require("./repositoryExport"), exports);
+__exportStar(require("./retention"), exports);
+__exportStar(require("./accessRequest"), exports);

package/dist/entities/retention/index.d.ts

@@ -0,0 +1 @@
+export * from './retention.entity';

package/dist/entities/retention/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./retention.entity"), exports);

package/dist/entities/retention/retention.entity.d.ts

@@ -0,0 +1,49 @@
+import { type DispositionKind, type FinalDisposition } from '../../base/entities';
+/** Una serie con su Tabla de Retención y cuánto venció. */
+export interface RetentionSeriesEntity {
+    seriesId: string;
+    code: string;
+    name: string;
+    section: string | null;
+    managementYears: number;
+    centralYears: number;
+    finalDisposition: FinalDisposition;
+    retentionNote: string | null;
+    /** Documentos firmados y expedientes cerrados cuyo plazo terminó y aún no tienen acta. */
+    documentsDue: number;
+    caseFilesDue: number;
+    /** Actas ya emitidas de la serie. */
+    dispositions: number;
+}
+export interface RetentionSummaryEntity {
+    series: RetentionSeriesEntity[];
+    /** Series habilitadas sin plazos: sus documentos no vencen. */
+    seriesWithoutRetention: number;
+}
+/** Un documento o expediente cuyo plazo de retención terminó. */
+export interface RetentionDueItemEntity {
+    kind: 'Document' | 'CaseFile';
+    id: string;
+    /** Folio del documento o IUIe del expediente. */
+    reference: string;
+    title: string;
+    /** Desde cuándo se cuenta: la última firma del documento o el cierre del expediente. */
+    baseDate: string;
+    dueAt: string;
+}
+export interface DispositionRecordResponseEntity {
+    id: string;
+    kind: DispositionKind;
+    number: number;
+    year: number;
+    /** «Acta de transferencia N° 1/2026». */
+    label: string;
+    seriesId: string;
+    seriesCode: string;
+    seriesName: string;
+    observation: string | null;
+    documents: number;
+    caseFiles: number;
+    createdByFullName: string;
+    createdAt: string;
+}

package/dist/entities/retention/retention.entity.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muni-sanfer/types-gestor-documental",
-  "version": "0.0.1-beta.23",
+  "version": "0.0.1-beta.25",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/base/entities.ts

@@ -65,7 +65,8 @@ export type DocumentTrackingAction =
   | 'DispatchReturned'
   | 'Received'
   | 'EmailCopySent'
-  | 'EmailCopyOpened';
+  | 'EmailCopyOpened'
+  | 'DispositionRecorded';
 
 export const DocumentTrackingAction = {
   Created: 'Created',
@@ -87,6 +88,7 @@ export const DocumentTrackingAction = {
   Received: 'Received',
   EmailCopySent: 'EmailCopySent',
   EmailCopyOpened: 'EmailCopyOpened',
+  DispositionRecorded: 'DispositionRecorded',
 } satisfies Record<string, DocumentTrackingAction>;
 
 export type DocumentOrigin = 'Internal' | 'DocDigital';
@@ -228,7 +230,8 @@ export type CaseFileTrackingAction =
   | 'Closed'
   | 'Exported'
   | 'ShareLinkCreated'
-  | 'ShareLinkRevoked';
+  | 'ShareLinkRevoked'
+  | 'DispositionRecorded';
 
 export const CaseFileTrackingAction = {
   Created: 'Created',
@@ -242,6 +245,7 @@ export const CaseFileTrackingAction = {
   Exported: 'Exported',
   ShareLinkCreated: 'ShareLinkCreated',
   ShareLinkRevoked: 'ShareLinkRevoked',
+  DispositionRecorded: 'DispositionRecorded',
 } satisfies Record<string, CaseFileTrackingAction>;
 
 export type CaseFileAccessAction = 'Viewed' | 'FileDownloaded' | 'Exported';
@@ -344,6 +348,76 @@ export const AuditAction = {
   Exported: 'Exported',
 } satisfies Record<string, AuditAction>;
 
+export type FinalDisposition = 'Permanent' | 'Eliminate' | 'Select';
+
+export const FinalDisposition = {
+  Permanent: 'Permanent',
+  Eliminate: 'Eliminate',
+  Select: 'Select',
+} satisfies Record<string, FinalDisposition>;
+
+export type DispositionKind = 'Transfer' | 'Elimination';
+
+export const DispositionKind = {
+  Transfer: 'Transfer',
+  Elimination: 'Elimination',
+} satisfies Record<string, DispositionKind>;
+
+export type AccessRequestChannel = 'Portal' | 'Email' | 'InPerson' | 'Letter';
+
+export const AccessRequestChannel = {
+  Portal: 'Portal',
+  Email: 'Email',
+  InPerson: 'InPerson',
+  Letter: 'Letter',
+} satisfies Record<string, AccessRequestChannel>;
+
+export type AccessRequestStatus = 'Received' | 'InCorrection' | 'InProgress' | 'Resolved';
+
+export const AccessRequestStatus = {
+  Received: 'Received',
+  InCorrection: 'InCorrection',
+  InProgress: 'InProgress',
+  Resolved: 'Resolved',
+} satisfies Record<string, AccessRequestStatus>;
+
+export type AccessRequestResolution =
+  'Delivered' | 'PartiallyDelivered' | 'Denied' | 'Derived' | 'NonExistent' | 'Withdrawn';
+
+export const AccessRequestResolution = {
+  Delivered: 'Delivered',
+  PartiallyDelivered: 'PartiallyDelivered',
+  Denied: 'Denied',
+  Derived: 'Derived',
+  NonExistent: 'NonExistent',
+  Withdrawn: 'Withdrawn',
+} satisfies Record<string, AccessRequestResolution>;
+
+export type AccessRequestEventAction =
+  | 'Received'
+  | 'Updated'
+  | 'CorrectionRequested'
+  | 'Corrected'
+  | 'Assigned'
+  | 'ThirdPartyNotified'
+  | 'OppositionRegistered'
+  | 'Extended'
+  | 'Resolved'
+  | 'AppealRegistered';
+
+export const AccessRequestEventAction = {
+  Received: 'Received',
+  Updated: 'Updated',
+  CorrectionRequested: 'CorrectionRequested',
+  Corrected: 'Corrected',
+  Assigned: 'Assigned',
+  ThirdPartyNotified: 'ThirdPartyNotified',
+  OppositionRegistered: 'OppositionRegistered',
+  Extended: 'Extended',
+  Resolved: 'Resolved',
+  AppealRegistered: 'AppealRegistered',
+} satisfies Record<string, AccessRequestEventAction>;
+
 export interface DocumentTypeEntity {
   id: string;
   name: string;
@@ -425,6 +499,10 @@ export interface DocumentEntity {
   externalRecipients?: DocumentExternalRecipientEntity[];
   emailCopies?: DocumentEmailCopyEntity[];
   accesses?: DocumentAccessEntity[];
+  disposition?: DispositionRecordEntity | null;
+  dispositionId?: string | null;
+  accessRequestResponses?: AccessRequestEntity[];
+  accessRequestDeliveries?: AccessRequestDocumentEntity[];
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
   deleted: boolean;
@@ -592,6 +670,8 @@ export interface CaseFileEntity {
   responsibleFullName: string;
   responsiblePosition?: string | null;
   closedAt?: string | null;
+  disposition?: DispositionRecordEntity | null;
+  dispositionId?: string | null;
   closedByEmployeeId?: string | null;
   closedByFullName?: string | null;
   closingNote?: string | null;
@@ -844,9 +924,14 @@ export interface ArchivalSeriesEntity {
   name: string;
   section?: string | null;
   description?: string | null;
+  managementYears?: number | null;
+  centralYears?: number | null;
+  finalDisposition?: FinalDisposition | null;
+  retentionNote?: string | null;
   enabled: boolean;
   documentTypes?: DocumentTypeEntity[];
   caseFiles?: CaseFileEntity[];
+  dispositions?: DispositionRecordEntity[];
   deleted: boolean;
   createdAt: string;
   updatedAt: string;
@@ -971,4 +1056,78 @@ export interface AuditLogEntity {
   createdAt: string;
 }
 
+export interface DispositionRecordEntity {
+  id: string;
+  kind: DispositionKind;
+  number: number;
+  year: number;
+  observation?: string | null;
+  series?: ArchivalSeriesEntity;
+  seriesId: string;
+  documents?: DocumentEntity[];
+  caseFiles?: CaseFileEntity[];
+  createdByEmployeeId: string;
+  createdByFullName: string;
+  createdAt: string;
+}
+
+export interface AccessRequestEntity {
+  id: string;
+  number: number;
+  year: number;
+  externalFolio?: string | null;
+  channel: AccessRequestChannel;
+  receivedAt: string;
+  requesterName: string;
+  requesterEmail?: string | null;
+  requesterAddress?: string | null;
+  requestText: string;
+  deliveryFormat?: string | null;
+  status: AccessRequestStatus;
+  correctionRequestedAt?: string | null;
+  correctionDueAt?: string | null;
+  correctedAt?: string | null;
+  dueAt: string;
+  extendedAt?: string | null;
+  extensionNote?: string | null;
+  assigneeEmployeeId?: string | null;
+  assigneeFullName?: string | null;
+  thirdPartyNotifiedAt?: string | null;
+  oppositionDueAt?: string | null;
+  thirdPartyOpposed?: boolean | null;
+  resolution?: AccessRequestResolution | null;
+  resolvedAt?: string | null;
+  denialGrounds: string[];
+  derivedTo?: string | null;
+  resolutionNote?: string | null;
+  responseDocument?: DocumentEntity | null;
+  responseDocumentId?: string | null;
+  appealedAt?: string | null;
+  appealNote?: string | null;
+  createdByEmployeeId: string;
+  createdByFullName: string;
+  documents?: AccessRequestDocumentEntity[];
+  events?: AccessRequestEventEntity[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface AccessRequestDocumentEntity {
+  accessRequest?: AccessRequestEntity;
+  accessRequestId: string;
+  document?: DocumentEntity;
+  documentId: string;
+}
+
+export interface AccessRequestEventEntity {
+  id: string;
+  action: AccessRequestEventAction;
+  note?: string | null;
+  employeeId?: string | null;
+  employeeFullName: string;
+  accessRequest?: AccessRequestEntity;
+  accessRequestId: string;
+  createdAt: string;
+}
+
 type JsonValue = string | number | boolean | { [key in string]?: JsonValue } | Array<JsonValue> | null;

package/src/contracts/accessRequest.contract.ts

@@ -0,0 +1,81 @@
+import { type AccessRequestChannel, type AccessRequestResolution } from '../base/entities';
+import {
+  type AccessRequestDetailEntity,
+  type AccessRequestListItemEntity,
+  type AccessRequestSummaryEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+
+/** Patrones NATS de `accessRequest`: solicitudes de acceso a la información pública (Ley 20.285). */
+export const AccessRequestPatterns = {
+  getAll: 'gestorDocumental.accessRequest.getAll',
+  getById: 'gestorDocumental.accessRequest.getById',
+  getSummary: 'gestorDocumental.accessRequest.getSummary',
+  create: 'gestorDocumental.accessRequest.create',
+  update: 'gestorDocumental.accessRequest.update',
+  act: 'gestorDocumental.accessRequest.act',
+} as const;
+
+export interface AccessRequestWritePayload {
+  externalFolio?: string | null;
+  channel: AccessRequestChannel;
+  /** Fecha y hora de ingreso (ISO): desde ahí corren los 20 días hábiles. */
+  receivedAt: string;
+  requesterName: string;
+  requesterEmail?: string | null;
+  requesterAddress?: string | null;
+  requestText: string;
+  deliveryFormat?: string | null;
+}
+
+/** Lo que se hace con una solicitud, un paso a la vez. */
+export type AccessRequestAction =
+  | { type: 'requestCorrection'; note: string }
+  | { type: 'registerCorrection'; correctedAt?: string | null; note?: string | null }
+  | { type: 'assign'; employeeId: string; fullName: string; note?: string | null }
+  | { type: 'notifyThirdParty'; note: string }
+  | { type: 'registerOpposition'; opposed: boolean; note?: string | null }
+  | { type: 'extend'; note: string }
+  | {
+      type: 'resolve';
+      resolution: AccessRequestResolution;
+      grounds?: string[];
+      derivedTo?: string | null;
+      note?: string | null;
+      responseDocumentId?: string | null;
+      documentIds?: string[];
+    }
+  | { type: 'registerAppeal'; appealedAt?: string | null; note: string };
+
+export interface AccessRequestActor {
+  employeeId: string;
+  fullName: string;
+}
+
+export interface AccessRequestContract {
+  [AccessRequestPatterns.getAll]: {
+    payload: {
+      status?: 'open' | 'resolved' | 'all';
+      year?: number | null;
+      search?: string;
+      page?: number;
+      limit?: number;
+    };
+    response: RpcPage<AccessRequestListItemEntity[]>;
+  };
+  [AccessRequestPatterns.getById]: { payload: { id: string }; response: AccessRequestDetailEntity };
+  [AccessRequestPatterns.getSummary]: { payload: { year: number }; response: AccessRequestSummaryEntity };
+  [AccessRequestPatterns.create]: {
+    payload: AccessRequestWritePayload & { actor: AccessRequestActor };
+    response: AccessRequestDetailEntity;
+  };
+  /** Corrige los datos mientras no está resuelta. */
+  [AccessRequestPatterns.update]: {
+    payload: AccessRequestWritePayload & { id: string; actor: AccessRequestActor };
+    response: AccessRequestDetailEntity;
+  };
+  [AccessRequestPatterns.act]: {
+    payload: { id: string; action: AccessRequestAction; actor: AccessRequestActor };
+    response: AccessRequestDetailEntity;
+  };
+}

package/src/contracts/archivalSeries.contract.ts

@@ -1,3 +1,4 @@
+import { type FinalDisposition } from '../base/entities';
 import { type ArchivalSeriesEntity } from '../base/entities';
 import {
   type ArchivalSeriesCreateResponseEntity,
@@ -23,6 +24,11 @@ export interface ArchivalSeriesWritePayload {
   section?: string | null;
   description?: string | null;
   enabled?: boolean;
+  /** Tabla de Retención Documental: los tres juntos o ninguno. */
+  managementYears?: number | null;
+  centralYears?: number | null;
+  finalDisposition?: FinalDisposition | null;
+  retentionNote?: string | null;
 }
 
 export interface ArchivalSeriesContract {

package/src/contracts/index.ts

@@ -9,6 +9,8 @@ import { IndicatorsPatterns, type IndicatorsContract } from './indicators.contra
 import { AuditPatterns, type AuditContract } from './audit.contract';
 import { SignatureCheckPatterns, type SignatureCheckContract } from './signatureCheck.contract';
 import { RepositoryExportPatterns, type RepositoryExportContract } from './repositoryExport.contract';
+import { RetentionPatterns, type RetentionContract } from './retention.contract';
+import { AccessRequestPatterns, type AccessRequestContract } from './accessRequest.contract';
 import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
@@ -34,6 +36,8 @@ export * from './indicators.contract';
 export * from './audit.contract';
 export * from './signatureCheck.contract';
 export * from './repositoryExport.contract';
+export * from './retention.contract';
+export * from './accessRequest.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -54,6 +58,8 @@ export const GestorDocumentalPatterns = {
   audit: AuditPatterns,
   signatureCheck: SignatureCheckPatterns,
   repositoryExport: RepositoryExportPatterns,
+  retention: RetentionPatterns,
+  accessRequest: AccessRequestPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -73,4 +79,6 @@ export type GestorDocumentalContract = DocumentTypeContract &
   IndicatorsContract &
   AuditContract &
   SignatureCheckContract &
-  RepositoryExportContract;
+  RepositoryExportContract &
+  RetentionContract &
+  AccessRequestContract;

package/src/contracts/repositoryExport.contract.ts

@@ -22,6 +22,8 @@ export interface RepositoryExportQuery {
   from?: string | null;
   to?: string | null;
   scope?: RepositoryExportScope;
+  /** Solo lo incluido en un acta de transferencia: el paquete para el Archivo Nacional. */
+  dispositionId?: string | null;
 }
 
 export interface RepositoryExportContract {

package/src/contracts/retention.contract.ts

@@ -0,0 +1,44 @@
+import { type DispositionKind } from '../base/entities';
+import {
+  type DispositionRecordResponseEntity,
+  type IndicatorsFileEntity,
+  type RetentionDueItemEntity,
+  type RetentionSummaryEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+
+/** Patrones NATS de `retention`: plazos de retención por serie y actas de transferencia o eliminación. */
+export const RetentionPatterns = {
+  getSummary: 'gestorDocumental.retention.getSummary',
+  getDueItems: 'gestorDocumental.retention.getDueItems',
+  createRecord: 'gestorDocumental.retention.createRecord',
+  getRecords: 'gestorDocumental.retention.getRecords',
+  getRecordPdf: 'gestorDocumental.retention.getRecordPdf',
+} as const;
+
+export interface RetentionContract {
+  [RetentionPatterns.getSummary]: { payload: Record<string, never>; response: RetentionSummaryEntity };
+  /** Lo vencido de una serie, de lo más antiguo a lo más reciente. */
+  [RetentionPatterns.getDueItems]: {
+    payload: { seriesId: string; page?: number; limit?: number };
+    response: RpcPage<RetentionDueItemEntity[]>;
+  };
+  /**
+   * Emite el acta con lo elegido (todo debe estar vencido y sin acta). Según la serie: conservación permanente →
+   * transferencia; eliminación → eliminación; selección → cualquiera de las dos.
+   */
+  [RetentionPatterns.createRecord]: {
+    payload: {
+      kind: DispositionKind;
+      seriesId: string;
+      documentIds: string[];
+      caseFileIds: string[];
+      observation?: string | null;
+      actor: { employeeId: string; fullName: string };
+    };
+    response: DispositionRecordResponseEntity;
+  };
+  [RetentionPatterns.getRecords]: { payload: { year: number }; response: DispositionRecordResponseEntity[] };
+  /** El acta en PDF, con lo que incluye, para firmarla y archivarla. */
+  [RetentionPatterns.getRecordPdf]: { payload: { id: string; generatedBy: string }; response: IndicatorsFileEntity };
+}

package/src/entities/accessRequest/accessRequest.entity.ts

@@ -0,0 +1,78 @@
+import {
+  type AccessRequestChannel,
+  type AccessRequestEventAction,
+  type AccessRequestResolution,
+  type AccessRequestStatus,
+} from '../../base/entities';
+
+/** Semáforo del plazo de respuesta: a tiempo, por vencer (2 días hábiles o menos) o vencido. */
+export type AccessRequestDueStatus = 'OnTime' | 'DueSoon' | 'Overdue';
+
+export interface AccessRequestListItemEntity {
+  id: string;
+  /** «N° 15/2026». */
+  label: string;
+  externalFolio: string | null;
+  channel: AccessRequestChannel;
+  requesterName: string;
+  requestText: string;
+  receivedAt: string;
+  dueAt: string;
+  status: AccessRequestStatus;
+  resolution: AccessRequestResolution | null;
+  assigneeFullName: string | null;
+  /** Solo mientras está abierta. */
+  dueStatus: AccessRequestDueStatus | null;
+  businessDaysLeft: number | null;
+  /** Ya resuelta: si se respondió dentro del plazo. */
+  resolvedOnTime: boolean | null;
+}
+
+export interface AccessRequestDocumentLinkEntity {
+  id: string;
+  folio: string | null;
+  subject: string;
+}
+
+export interface AccessRequestDetailEntity extends AccessRequestListItemEntity {
+  year: number;
+  number: number;
+  requesterEmail: string | null;
+  requesterAddress: string | null;
+  deliveryFormat: string | null;
+  correctionRequestedAt: string | null;
+  correctionDueAt: string | null;
+  correctedAt: string | null;
+  extendedAt: string | null;
+  extensionNote: string | null;
+  assigneeEmployeeId: string | null;
+  thirdPartyNotifiedAt: string | null;
+  oppositionDueAt: string | null;
+  thirdPartyOpposed: boolean | null;
+  resolvedAt: string | null;
+  denialGrounds: string[];
+  derivedTo: string | null;
+  resolutionNote: string | null;
+  responseDocument: AccessRequestDocumentLinkEntity | null;
+  documents: AccessRequestDocumentLinkEntity[];
+  appealedAt: string | null;
+  appealNote: string | null;
+  createdByFullName: string;
+  /** Se puede prorrogar: abierta, sin prórroga y antes de vencer. */
+  canExtend: boolean;
+  events: { action: AccessRequestEventAction; note: string | null; employeeFullName: string; createdAt: string }[];
+}
+
+export interface AccessRequestSummaryEntity {
+  year: number;
+  total: number;
+  open: number;
+  overdue: number;
+  dueSoon: number;
+  resolved: Record<AccessRequestResolution, number>;
+  /** Respondidas dentro del plazo sobre las respondidas, en %. */
+  onTimeRate: number | null;
+  /** Días hábiles promedio entre el ingreso (o la subsanación) y la respuesta. */
+  averageBusinessDays: number | null;
+  appealed: number;
+}

package/src/entities/accessRequest/index.ts

@@ -0,0 +1 @@
+export * from './accessRequest.entity';

package/src/entities/archivalSeries/archivalSeries.entity.ts

@@ -7,6 +7,11 @@ export interface ArchivalSeriesGetAllResponseEntity {
   section: ArchivalSeriesEntity['section'];
   description: ArchivalSeriesEntity['description'];
   enabled: ArchivalSeriesEntity['enabled'];
+  /** Tabla de Retención Documental: años en archivo de gestión y central, y qué se hace después. */
+  managementYears: ArchivalSeriesEntity['managementYears'];
+  centralYears: ArchivalSeriesEntity['centralYears'];
+  finalDisposition: ArchivalSeriesEntity['finalDisposition'];
+  retentionNote: ArchivalSeriesEntity['retentionNote'];
   /** Cuántos tipos documentales y expedientes la usan. */
   documentTypes: number;
   caseFiles: number;

package/src/entities/index.ts

@@ -15,3 +15,5 @@ export * from './indicators';
 export * from './audit';
 export * from './signatureCheck';
 export * from './repositoryExport';
+export * from './retention';
+export * from './accessRequest';

package/src/entities/retention/index.ts

@@ -0,0 +1 @@
+export * from './retention.entity';

package/src/entities/retention/retention.entity.ts

@@ -0,0 +1,53 @@
+import { type DispositionKind, type FinalDisposition } from '../../base/entities';
+
+/** Una serie con su Tabla de Retención y cuánto venció. */
+export interface RetentionSeriesEntity {
+  seriesId: string;
+  code: string;
+  name: string;
+  section: string | null;
+  managementYears: number;
+  centralYears: number;
+  finalDisposition: FinalDisposition;
+  retentionNote: string | null;
+  /** Documentos firmados y expedientes cerrados cuyo plazo terminó y aún no tienen acta. */
+  documentsDue: number;
+  caseFilesDue: number;
+  /** Actas ya emitidas de la serie. */
+  dispositions: number;
+}
+
+export interface RetentionSummaryEntity {
+  series: RetentionSeriesEntity[];
+  /** Series habilitadas sin plazos: sus documentos no vencen. */
+  seriesWithoutRetention: number;
+}
+
+/** Un documento o expediente cuyo plazo de retención terminó. */
+export interface RetentionDueItemEntity {
+  kind: 'Document' | 'CaseFile';
+  id: string;
+  /** Folio del documento o IUIe del expediente. */
+  reference: string;
+  title: string;
+  /** Desde cuándo se cuenta: la última firma del documento o el cierre del expediente. */
+  baseDate: string;
+  dueAt: string;
+}
+
+export interface DispositionRecordResponseEntity {
+  id: string;
+  kind: DispositionKind;
+  number: number;
+  year: number;
+  /** «Acta de transferencia N° 1/2026». */
+  label: string;
+  seriesId: string;
+  seriesCode: string;
+  seriesName: string;
+  observation: string | null;
+  documents: number;
+  caseFiles: number;
+  createdByFullName: string;
+  createdAt: string;
+}