@muni-sanfer/types-gestor-documental 0.0.1-beta.15 → 0.0.1-beta.16

package/dist/base/entities.d.ts

@@ -166,6 +166,11 @@ export declare const CaseFileAccessAction: {
     FileDownloaded: "FileDownloaded";
     Exported: "Exported";
 };
+export type ScanSessionStatus = 'Open' | 'Ready';
+export declare const ScanSessionStatus: {
+    Open: "Open";
+    Ready: "Ready";
+};
 export type WorkFolderItemKind = 'Document' | 'File';
 export declare const WorkFolderItemKind: {
     Document: "Document";
@@ -182,6 +187,8 @@ export interface DocumentTypeEntity {
     resetsYearly: boolean;
     numbered: boolean;
     directorateCodeReference?: number | null;
+    archivalSeries?: ArchivalSeriesEntity | null;
+    archivalSeriesId?: string | null;
     issuingEntity?: IssuingEntityEntity | null;
     issuingEntityId?: string | null;
     sharesNumberingWith?: DocumentTypeEntity | null;
@@ -202,6 +209,7 @@ export interface DocumentEntity {
     keywords: string[];
     accessLevel: DocumentAccessLevel;
     hasSensitiveData: boolean;
+    restrictionEndsAt?: string | null;
     status: DocumentStatus;
     correlative?: number | null;
     correlativeYear?: number | null;
@@ -390,6 +398,9 @@ export interface CaseFileEntity {
     status: CaseFileStatus;
     accessLevel: DocumentAccessLevel;
     hasSensitiveData: boolean;
+    restrictionEndsAt?: string | null;
+    archivalSeries?: ArchivalSeriesEntity | null;
+    archivalSeriesId?: string | null;
     incorporationMechanism: CaseFileIncorporationMechanism;
     schemaVersion: string;
     procedure?: ProcedureEntity;
@@ -533,6 +544,18 @@ export interface DocumentEmailCopyEntity {
     documentId: string;
     createdAt: string;
 }
+export interface ScanSessionEntity {
+    id: string;
+    tokenHash: string;
+    status: ScanSessionStatus;
+    employeeId: string;
+    pages: JsonValue;
+    fileId?: string | null;
+    fileName?: string | null;
+    expiresAt: string;
+    finishedAt?: string | null;
+    createdAt: string;
+}
 export interface DocumentExternalRecipientEntity {
     id: string;
     entityId: number;
@@ -598,6 +621,19 @@ export interface DocDigitalInboundEntity {
     createdAt: string;
     updatedAt: string;
 }
+export interface ArchivalSeriesEntity {
+    id: string;
+    code: string;
+    name: string;
+    section?: string | null;
+    description?: string | null;
+    enabled: boolean;
+    documentTypes?: DocumentTypeEntity[];
+    caseFiles?: CaseFileEntity[];
+    deleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
 export interface IssuingEntityEntity {
     id: string;
     name: string;

package/dist/base/entities.js

@@ -1,7 +1,7 @@
 "use strict";
 // This file was auto-generated by prisma-generator-typescript-interfaces
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkFolderItemKind = exports.CaseFileAccessAction = exports.CaseFileTrackingAction = exports.CaseFileActorType = exports.CaseFileActorRelation = exports.CaseFileEntryKind = exports.CaseFileActuationType = exports.CaseFileIncorporationMechanism = exports.CaseFileStatus = exports.DocumentInstruction = exports.DocumentDeliveryOrigin = exports.DocumentRecipientType = exports.DocumentAttachmentType = exports.DocumentFlowStepType = exports.DocDigitalInboundStatus = exports.DocumentDispatchStatus = exports.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
+exports.WorkFolderItemKind = exports.ScanSessionStatus = exports.CaseFileAccessAction = exports.CaseFileTrackingAction = exports.CaseFileActorType = exports.CaseFileActorRelation = exports.CaseFileEntryKind = exports.CaseFileActuationType = exports.CaseFileIncorporationMechanism = exports.CaseFileStatus = exports.DocumentInstruction = exports.DocumentDeliveryOrigin = exports.DocumentRecipientType = exports.DocumentAttachmentType = exports.DocumentFlowStepType = exports.DocDigitalInboundStatus = exports.DocumentDispatchStatus = exports.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
 exports.DocumentCategory = {
     Decree: 'Decree',
     Communication: 'Communication',
@@ -148,6 +148,10 @@ exports.CaseFileAccessAction = {
     FileDownloaded: 'FileDownloaded',
     Exported: 'Exported',
 };
+exports.ScanSessionStatus = {
+    Open: 'Open',
+    Ready: 'Ready',
+};
 exports.WorkFolderItemKind = {
     Document: 'Document',
     File: 'File',

package/dist/contracts/archivalSeries.contract.d.ts

@@ -0,0 +1,50 @@
+import { type ArchivalSeriesEntity } from '../base/entities';
+import { type ArchivalSeriesCreateResponseEntity, type ArchivalSeriesGetAllResponseEntity, type ArchivalSeriesGetByIdResponseEntity, type ArchivalSeriesUpdateResponseEntity } from '../entities';
+import { type RpcPage } from './contract';
+/** Patrones NATS de `archivalSeries` (series del Cuadro de Clasificación): `<servicio>.<recurso>.<acción>`. */
+export declare const ArchivalSeriesPatterns: {
+    readonly getAll: "gestorDocumental.archivalSeries.getAll";
+    readonly getById: "gestorDocumental.archivalSeries.getById";
+    readonly create: "gestorDocumental.archivalSeries.create";
+    readonly update: "gestorDocumental.archivalSeries.update";
+    readonly setEnabled: "gestorDocumental.archivalSeries.setEnabled";
+};
+/** Datos de una serie documental al crearla o editarla. */
+export interface ArchivalSeriesWritePayload {
+    code: string;
+    name: string;
+    section?: string | null;
+    description?: string | null;
+    enabled?: boolean;
+}
+export interface ArchivalSeriesContract {
+    [ArchivalSeriesPatterns.getAll]: {
+        payload: {
+            pagination?: {
+                page?: number;
+                limit?: number;
+            };
+            filters?: {
+                search?: string;
+                enabled?: boolean;
+            };
+        };
+        response: RpcPage<ArchivalSeriesGetAllResponseEntity[]>;
+    };
+    [ArchivalSeriesPatterns.getById]: {
+        payload: Pick<ArchivalSeriesEntity, 'id'>;
+        response: ArchivalSeriesGetByIdResponseEntity;
+    };
+    [ArchivalSeriesPatterns.create]: {
+        payload: ArchivalSeriesWritePayload;
+        response: ArchivalSeriesCreateResponseEntity;
+    };
+    [ArchivalSeriesPatterns.update]: {
+        payload: ArchivalSeriesWritePayload & Pick<ArchivalSeriesEntity, 'id'>;
+        response: ArchivalSeriesUpdateResponseEntity;
+    };
+    [ArchivalSeriesPatterns.setEnabled]: {
+        payload: Pick<ArchivalSeriesEntity, 'id' | 'enabled'>;
+        response: ArchivalSeriesUpdateResponseEntity;
+    };
+}

package/dist/contracts/archivalSeries.contract.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArchivalSeriesPatterns = void 0;
+/** Patrones NATS de `archivalSeries` (series del Cuadro de Clasificación): `<servicio>.<recurso>.<acción>`. */
+exports.ArchivalSeriesPatterns = {
+    getAll: 'gestorDocumental.archivalSeries.getAll',
+    getById: 'gestorDocumental.archivalSeries.getById',
+    create: 'gestorDocumental.archivalSeries.create',
+    update: 'gestorDocumental.archivalSeries.update',
+    setEnabled: 'gestorDocumental.archivalSeries.setEnabled',
+};

package/dist/contracts/caseFile.contract.d.ts

@@ -51,6 +51,10 @@ export interface CaseFileWritePayload {
     procedureId: string;
     accessLevel: DocumentAccessLevel;
     hasSensitiveData: boolean;
+    /** MGDEE8_2: fin de la restricción de acceso (ISO 8601), si no es público. */
+    restrictionEndsAt?: string | null;
+    /** MGDEE1_2: serie del Cuadro de Clasificación. */
+    archivalSeriesId?: string | null;
     actors?: CaseFileActorInput[];
 }
 /** Actuación que se incorpora al índice: un documento del gestor, un archivo subido u otro expediente. */

package/dist/contracts/document.contract.d.ts

@@ -84,6 +84,7 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
     responseDueAt?: string | null;
     replyToDocumentId?: string | null;
     externalRecipients?: DocumentExternalRecipientInput[];
+    restrictionEndsAt?: string | null;
     emailCopies?: DocumentEmailCopyInput[];
     action?: 'Submit';
     actor: DocumentActor;

package/dist/contracts/documentType.contract.d.ts

@@ -36,6 +36,7 @@ export interface DocumentTypeWritePayload {
     resetsYearly?: boolean;
     numbered?: boolean;
     directorateCodeReference?: number | null;
+    archivalSeriesId?: string | null;
     issuingEntityId?: string | null;
     sharesNumberingWithId?: string | null;
     enabled?: boolean;

package/dist/contracts/index.d.ts

@@ -2,6 +2,8 @@ import { type CaseFileContract } from './caseFile.contract';
 import { type DocumentContract } from './document.contract';
 import { type DocumentTypeContract } from './documentType.contract';
 import { type IssuingEntityContract } from './issuingEntity.contract';
+import { type ArchivalSeriesContract } from './archivalSeries.contract';
+import { type ScanContract } from './scan.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
 import { type RegisterBookContract } from './registerBook.contract';
@@ -17,6 +19,8 @@ export * from './partsOffice.contract';
 export * from './registerBook.contract';
 export * from './signatureBatch.contract';
 export * from './workFolder.contract';
+export * from './scan.contract';
+export * from './archivalSeries.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -128,6 +132,21 @@ export declare const GestorDocumentalPatterns: {
         readonly remove: "gestorDocumental.workFolder.remove";
         readonly convert: "gestorDocumental.workFolder.convert";
     };
+    readonly scan: {
+        readonly create: "gestorDocumental.scan.create";
+        readonly getById: "gestorDocumental.scan.getById";
+        readonly getFile: "gestorDocumental.scan.getFile";
+        readonly getByToken: "gestorDocumental.scan.getByToken";
+        readonly addPage: "gestorDocumental.scan.addPage";
+        readonly finish: "gestorDocumental.scan.finish";
+    };
+    readonly archivalSeries: {
+        readonly getAll: "gestorDocumental.archivalSeries.getAll";
+        readonly getById: "gestorDocumental.archivalSeries.getById";
+        readonly create: "gestorDocumental.archivalSeries.create";
+        readonly update: "gestorDocumental.archivalSeries.update";
+        readonly setEnabled: "gestorDocumental.archivalSeries.setEnabled";
+    };
 };
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
-export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract;

package/dist/contracts/index.js

@@ -19,6 +19,8 @@ const caseFile_contract_1 = require("./caseFile.contract");
 const document_contract_1 = require("./document.contract");
 const documentType_contract_1 = require("./documentType.contract");
 const issuingEntity_contract_1 = require("./issuingEntity.contract");
+const archivalSeries_contract_1 = require("./archivalSeries.contract");
+const scan_contract_1 = require("./scan.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
 const registerBook_contract_1 = require("./registerBook.contract");
@@ -34,6 +36,8 @@ __exportStar(require("./partsOffice.contract"), exports);
 __exportStar(require("./registerBook.contract"), exports);
 __exportStar(require("./signatureBatch.contract"), exports);
 __exportStar(require("./workFolder.contract"), exports);
+__exportStar(require("./scan.contract"), exports);
+__exportStar(require("./archivalSeries.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -45,4 +49,6 @@ exports.GestorDocumentalPatterns = {
     registerBook: registerBook_contract_1.RegisterBookPatterns,
     signatureBatch: signatureBatch_contract_1.SignatureBatchPatterns,
     workFolder: workFolder_contract_1.WorkFolderPatterns,
+    scan: scan_contract_1.ScanPatterns,
+    archivalSeries: archivalSeries_contract_1.ArchivalSeriesPatterns,
 };

package/dist/contracts/scan.contract.d.ts

@@ -0,0 +1,63 @@
+import { type ScanSessionCreateResponseEntity, type ScanSessionFileResponseEntity, type ScanSessionPublicEntity, type ScanSessionResponseEntity } from '../entities';
+import { type DocumentActor } from './document.contract';
+/** Patrones NATS de `scan`: escanear con el celular. */
+export declare const ScanPatterns: {
+    readonly create: "gestorDocumental.scan.create";
+    readonly getById: "gestorDocumental.scan.getById";
+    readonly getFile: "gestorDocumental.scan.getFile";
+    readonly getByToken: "gestorDocumental.scan.getByToken";
+    readonly addPage: "gestorDocumental.scan.addPage";
+    readonly finish: "gestorDocumental.scan.finish";
+};
+export interface ScanContract {
+    /**
+     * Abre una sesión de escaneo para el funcionario. `url` es la dirección pública del celular (sin el token): con ella
+     * se arma el QR que se muestra en el escritorio.
+     */
+    [ScanPatterns.create]: {
+        payload: {
+            url: string;
+            actor: DocumentActor;
+        };
+        response: ScanSessionCreateResponseEntity;
+    };
+    /** Estado de la sesión, para quien la abrió: el escritorio la consulta hasta que el PDF esté listo. */
+    [ScanPatterns.getById]: {
+        payload: {
+            id: string;
+            actor: DocumentActor;
+        };
+        response: ScanSessionResponseEntity;
+    };
+    [ScanPatterns.getFile]: {
+        payload: {
+            id: string;
+            actor: DocumentActor;
+        };
+        response: ScanSessionFileResponseEntity;
+    };
+    /** Sin sesión, desde el celular, con el token del QR. */
+    [ScanPatterns.getByToken]: {
+        payload: {
+            token: string;
+        };
+        response: ScanSessionPublicEntity;
+    };
+    /** Agrega una foto ya subida al gestor de archivos (la sube el gateway). */
+    [ScanPatterns.addPage]: {
+        payload: {
+            token: string;
+            fileId: string;
+            contentType: string;
+            size: number;
+        };
+        response: ScanSessionPublicEntity;
+    };
+    /** Junta las fotos en un PDF y cierra la sesión. */
+    [ScanPatterns.finish]: {
+        payload: {
+            token: string;
+        };
+        response: ScanSessionPublicEntity;
+    };
+}

package/dist/contracts/scan.contract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScanPatterns = void 0;
+/** Patrones NATS de `scan`: escanear con el celular. */
+exports.ScanPatterns = {
+    create: 'gestorDocumental.scan.create',
+    getById: 'gestorDocumental.scan.getById',
+    getFile: 'gestorDocumental.scan.getFile',
+    getByToken: 'gestorDocumental.scan.getByToken',
+    addPage: 'gestorDocumental.scan.addPage',
+    finish: 'gestorDocumental.scan.finish',
+};

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

@@ -0,0 +1,27 @@
+import { ArchivalSeriesEntity } from '../../base/entities';
+export interface ArchivalSeriesGetAllResponseEntity {
+    id: ArchivalSeriesEntity['id'];
+    code: ArchivalSeriesEntity['code'];
+    name: ArchivalSeriesEntity['name'];
+    section: ArchivalSeriesEntity['section'];
+    description: ArchivalSeriesEntity['description'];
+    enabled: ArchivalSeriesEntity['enabled'];
+    /** Cuántos tipos documentales y expedientes la usan. */
+    documentTypes: number;
+    caseFiles: number;
+}
+export type ArchivalSeriesGetByIdResponseEntity = ArchivalSeriesGetAllResponseEntity;
+/** Cómo se cita una serie donde se usa: código y nombre. */
+export interface ArchivalSeriesSummaryEntity {
+    id: string;
+    code: string;
+    name: string;
+}
+export interface ArchivalSeriesCreateResponseEntity {
+    id: ArchivalSeriesEntity['id'];
+    ok: boolean;
+}
+export interface ArchivalSeriesUpdateResponseEntity {
+    id: ArchivalSeriesEntity['id'];
+    ok: boolean;
+}

package/dist/entities/archivalSeries/archivalSeries.entity.js

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

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

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

package/dist/entities/archivalSeries/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("./archivalSeries.entity"), exports);

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

@@ -120,6 +120,14 @@ export interface CaseFileGetByIdResponseEntity extends CaseFileGetAllResponseEnt
     closingNote: CaseFileEntity['closingNote'];
     /** Expediente híbrido: tiene documentos en papel que no se pudieron digitalizar. */
     isHybrid: boolean;
+    /** MGDEE1_2: serie del Cuadro de Clasificación. */
+    archivalSeries: {
+        id: string;
+        code: string;
+        name: string;
+    } | null;
+    /** MGDEE8_2: fin de la restricción de acceso. */
+    restrictionEndsAt: string | null;
     index: CaseFileEntryResponseEntity[];
     sharedWith: CaseFileParticipantResponseEntity[];
     actors: CaseFileActorResponseEntity[];

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

@@ -115,6 +115,12 @@ export interface DocumentInboxItemEntity extends DocumentDeliveryResponseEntity
 export interface DocumentGetByIdResponseEntity {
     id: DocumentEntity['id'];
     issuerName: string;
+    archivalSeries: {
+        id: string;
+        code: string;
+        name: string;
+    } | null;
+    restrictionEndsAt: string | null;
     subject: DocumentEntity['subject'];
     keywords: DocumentEntity['keywords'];
     accessLevel: DocumentEntity['accessLevel'];

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

@@ -22,6 +22,11 @@ export interface DocumentTypeGetAllResponseEntity {
     resetsYearly: DocumentTypeEntity['resetsYearly'];
     numbered: DocumentTypeEntity['numbered'];
     directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
+    archivalSeries: {
+        id: string;
+        code: string;
+        name: string;
+    } | null;
     issuingEntity: {
         id: string;
         name: string;

package/dist/entities/index.d.ts

@@ -7,3 +7,5 @@ export * from './partsOffice';
 export * from './registerBook';
 export * from './signatureBatch';
 export * from './workFolder';
+export * from './scan';
+export * from './archivalSeries';

package/dist/entities/index.js

@@ -23,3 +23,5 @@ __exportStar(require("./partsOffice"), exports);
 __exportStar(require("./registerBook"), exports);
 __exportStar(require("./signatureBatch"), exports);
 __exportStar(require("./workFolder"), exports);
+__exportStar(require("./scan"), exports);
+__exportStar(require("./archivalSeries"), exports);

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

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

package/dist/entities/scan/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("./scan.entity"), exports);

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

@@ -0,0 +1,29 @@
+/** Sesión recién abierta: el token y el QR viajan solo aquí. */
+export interface ScanSessionCreateResponseEntity {
+    id: string;
+    token: string;
+    /** Dirección que abre el celular, con el token. */
+    url: string;
+    /** El QR de esa dirección, como imagen PNG en data URL. */
+    qrDataUrl: string;
+    expiresAt: string;
+}
+/** Estado de la sesión, como lo ve en el escritorio quien la abrió. */
+export interface ScanSessionResponseEntity {
+    id: string;
+    status: 'Open' | 'Ready';
+    pageCount: number;
+    expiresAt: string;
+    fileName: string | null;
+}
+export interface ScanSessionFileResponseEntity {
+    fileId: string;
+    fileName: string;
+}
+/** La sesión como la ve el celular. */
+export interface ScanSessionPublicEntity {
+    status: 'Open' | 'Ready';
+    pageCount: number;
+    maxPages: number;
+    expiresAt: string;
+}

package/dist/entities/scan/scan.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.15",
+  "version": "0.0.1-beta.16",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/base/entities.ts

@@ -252,6 +252,13 @@ export const CaseFileAccessAction = {
   Exported: 'Exported',
 } satisfies Record<string, CaseFileAccessAction>;
 
+export type ScanSessionStatus = 'Open' | 'Ready';
+
+export const ScanSessionStatus = {
+  Open: 'Open',
+  Ready: 'Ready',
+} satisfies Record<string, ScanSessionStatus>;
+
 export type WorkFolderItemKind = 'Document' | 'File';
 
 export const WorkFolderItemKind = {
@@ -270,6 +277,8 @@ export interface DocumentTypeEntity {
   resetsYearly: boolean;
   numbered: boolean;
   directorateCodeReference?: number | null;
+  archivalSeries?: ArchivalSeriesEntity | null;
+  archivalSeriesId?: string | null;
   issuingEntity?: IssuingEntityEntity | null;
   issuingEntityId?: string | null;
   sharesNumberingWith?: DocumentTypeEntity | null;
@@ -291,6 +300,7 @@ export interface DocumentEntity {
   keywords: string[];
   accessLevel: DocumentAccessLevel;
   hasSensitiveData: boolean;
+  restrictionEndsAt?: string | null;
   status: DocumentStatus;
   correlative?: number | null;
   correlativeYear?: number | null;
@@ -490,6 +500,9 @@ export interface CaseFileEntity {
   status: CaseFileStatus;
   accessLevel: DocumentAccessLevel;
   hasSensitiveData: boolean;
+  restrictionEndsAt?: string | null;
+  archivalSeries?: ArchivalSeriesEntity | null;
+  archivalSeriesId?: string | null;
   incorporationMechanism: CaseFileIncorporationMechanism;
   schemaVersion: string;
   procedure?: ProcedureEntity;
@@ -642,6 +655,19 @@ export interface DocumentEmailCopyEntity {
   createdAt: string;
 }
 
+export interface ScanSessionEntity {
+  id: string;
+  tokenHash: string;
+  status: ScanSessionStatus;
+  employeeId: string;
+  pages: JsonValue;
+  fileId?: string | null;
+  fileName?: string | null;
+  expiresAt: string;
+  finishedAt?: string | null;
+  createdAt: string;
+}
+
 export interface DocumentExternalRecipientEntity {
   id: string;
   entityId: number;
@@ -710,6 +736,20 @@ export interface DocDigitalInboundEntity {
   updatedAt: string;
 }
 
+export interface ArchivalSeriesEntity {
+  id: string;
+  code: string;
+  name: string;
+  section?: string | null;
+  description?: string | null;
+  enabled: boolean;
+  documentTypes?: DocumentTypeEntity[];
+  caseFiles?: CaseFileEntity[];
+  deleted: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
 export interface IssuingEntityEntity {
   id: string;
   name: string;

package/src/contracts/archivalSeries.contract.ts

@@ -0,0 +1,53 @@
+import { type ArchivalSeriesEntity } from '../base/entities';
+import {
+  type ArchivalSeriesCreateResponseEntity,
+  type ArchivalSeriesGetAllResponseEntity,
+  type ArchivalSeriesGetByIdResponseEntity,
+  type ArchivalSeriesUpdateResponseEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+
+/** Patrones NATS de `archivalSeries` (series del Cuadro de Clasificación): `<servicio>.<recurso>.<acción>`. */
+export const ArchivalSeriesPatterns = {
+  getAll: 'gestorDocumental.archivalSeries.getAll',
+  getById: 'gestorDocumental.archivalSeries.getById',
+  create: 'gestorDocumental.archivalSeries.create',
+  update: 'gestorDocumental.archivalSeries.update',
+  setEnabled: 'gestorDocumental.archivalSeries.setEnabled',
+} as const;
+
+/** Datos de una serie documental al crearla o editarla. */
+export interface ArchivalSeriesWritePayload {
+  code: string;
+  name: string;
+  section?: string | null;
+  description?: string | null;
+  enabled?: boolean;
+}
+
+export interface ArchivalSeriesContract {
+  [ArchivalSeriesPatterns.getAll]: {
+    // sin `page` y `limit` responde todas en una sola página
+    payload: {
+      pagination?: { page?: number; limit?: number };
+      filters?: { search?: string; enabled?: boolean };
+    };
+    response: RpcPage<ArchivalSeriesGetAllResponseEntity[]>;
+  };
+  [ArchivalSeriesPatterns.getById]: {
+    payload: Pick<ArchivalSeriesEntity, 'id'>;
+    response: ArchivalSeriesGetByIdResponseEntity;
+  };
+  [ArchivalSeriesPatterns.create]: {
+    payload: ArchivalSeriesWritePayload;
+    response: ArchivalSeriesCreateResponseEntity;
+  };
+  [ArchivalSeriesPatterns.update]: {
+    payload: ArchivalSeriesWritePayload & Pick<ArchivalSeriesEntity, 'id'>;
+    response: ArchivalSeriesUpdateResponseEntity;
+  };
+  [ArchivalSeriesPatterns.setEnabled]: {
+    payload: Pick<ArchivalSeriesEntity, 'id' | 'enabled'>;
+    response: ArchivalSeriesUpdateResponseEntity;
+  };
+}

package/src/contracts/caseFile.contract.ts

@@ -74,6 +74,10 @@ export interface CaseFileWritePayload {
   procedureId: string;
   accessLevel: DocumentAccessLevel;
   hasSensitiveData: boolean;
+  /** MGDEE8_2: fin de la restricción de acceso (ISO 8601), si no es público. */
+  restrictionEndsAt?: string | null;
+  /** MGDEE1_2: serie del Cuadro de Clasificación. */
+  archivalSeriesId?: string | null;
   actors?: CaseFileActorInput[];
 }
 

package/src/contracts/document.contract.ts

@@ -124,6 +124,8 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
   replyToDocumentId?: string | null;
   // Instituciones (y usuarios) de DocDigital a quienes va: al terminar la firma pasa a Oficina de Partes.
   externalRecipients?: DocumentExternalRecipientInput[];
+  // Fin de la restricción de acceso (ISO 8601), si no es público.
+  restrictionEndsAt?: string | null;
   // Copia por correo a quienes están fuera del Estado: sale al finalizar o, si también va por DocDigital, al despacharlo.
   emailCopies?: DocumentEmailCopyInput[];
   action?: 'Submit';

package/src/contracts/documentType.contract.ts

@@ -41,6 +41,8 @@ export interface DocumentTypeWritePayload {
   // Sus documentos llevan número (por omisión, sí).
   numbered?: boolean;
   directorateCodeReference?: number | null;
+  // Serie documental del Cuadro de Clasificación (sin valor: sin clasificar).
+  archivalSeriesId?: string | null;
   // Entidad emisora (sin valor: la municipalidad).
   issuingEntityId?: string | null;
   // Tipo cuyo correlativo comparte (sin valor: el suyo propio).

package/src/contracts/index.ts

@@ -2,6 +2,8 @@ import { CaseFilePatterns, type CaseFileContract } from './caseFile.contract';
 import { DocumentPatterns, type DocumentContract } from './document.contract';
 import { DocumentTypePatterns, type DocumentTypeContract } from './documentType.contract';
 import { IssuingEntityPatterns, type IssuingEntityContract } from './issuingEntity.contract';
+import { ArchivalSeriesPatterns, type ArchivalSeriesContract } from './archivalSeries.contract';
+import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
 import { RegisterBookPatterns, type RegisterBookContract } from './registerBook.contract';
@@ -18,6 +20,8 @@ export * from './partsOffice.contract';
 export * from './registerBook.contract';
 export * from './signatureBatch.contract';
 export * from './workFolder.contract';
+export * from './scan.contract';
+export * from './archivalSeries.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -30,6 +34,8 @@ export const GestorDocumentalPatterns = {
   registerBook: RegisterBookPatterns,
   signatureBatch: SignatureBatchPatterns,
   workFolder: WorkFolderPatterns,
+  scan: ScanPatterns,
+  archivalSeries: ArchivalSeriesPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -41,4 +47,6 @@ export type GestorDocumentalContract = DocumentTypeContract &
   PartsOfficeContract &
   RegisterBookContract &
   SignatureBatchContract &
-  WorkFolderContract;
+  WorkFolderContract &
+  ScanContract &
+  ArchivalSeriesContract;

package/src/contracts/scan.contract.ts

@@ -0,0 +1,52 @@
+import {
+  type ScanSessionCreateResponseEntity,
+  type ScanSessionFileResponseEntity,
+  type ScanSessionPublicEntity,
+  type ScanSessionResponseEntity,
+} from '../entities';
+import { type DocumentActor } from './document.contract';
+
+/** Patrones NATS de `scan`: escanear con el celular. */
+export const ScanPatterns = {
+  create: 'gestorDocumental.scan.create',
+  getById: 'gestorDocumental.scan.getById',
+  getFile: 'gestorDocumental.scan.getFile',
+  getByToken: 'gestorDocumental.scan.getByToken',
+  addPage: 'gestorDocumental.scan.addPage',
+  finish: 'gestorDocumental.scan.finish',
+} as const;
+
+export interface ScanContract {
+  /**
+   * Abre una sesión de escaneo para el funcionario. `url` es la dirección pública del celular (sin el token): con ella
+   * se arma el QR que se muestra en el escritorio.
+   */
+  [ScanPatterns.create]: {
+    payload: { url: string; actor: DocumentActor };
+    response: ScanSessionCreateResponseEntity;
+  };
+  /** Estado de la sesión, para quien la abrió: el escritorio la consulta hasta que el PDF esté listo. */
+  [ScanPatterns.getById]: {
+    payload: { id: string; actor: DocumentActor };
+    response: ScanSessionResponseEntity;
+  };
+  [ScanPatterns.getFile]: {
+    payload: { id: string; actor: DocumentActor };
+    response: ScanSessionFileResponseEntity;
+  };
+  /** Sin sesión, desde el celular, con el token del QR. */
+  [ScanPatterns.getByToken]: {
+    payload: { token: string };
+    response: ScanSessionPublicEntity;
+  };
+  /** Agrega una foto ya subida al gestor de archivos (la sube el gateway). */
+  [ScanPatterns.addPage]: {
+    payload: { token: string; fileId: string; contentType: string; size: number };
+    response: ScanSessionPublicEntity;
+  };
+  /** Junta las fotos en un PDF y cierra la sesión. */
+  [ScanPatterns.finish]: {
+    payload: { token: string };
+    response: ScanSessionPublicEntity;
+  };
+}

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

@@ -0,0 +1,32 @@
+import { ArchivalSeriesEntity } from '../../base/entities';
+
+export interface ArchivalSeriesGetAllResponseEntity {
+  id: ArchivalSeriesEntity['id'];
+  code: ArchivalSeriesEntity['code'];
+  name: ArchivalSeriesEntity['name'];
+  section: ArchivalSeriesEntity['section'];
+  description: ArchivalSeriesEntity['description'];
+  enabled: ArchivalSeriesEntity['enabled'];
+  /** Cuántos tipos documentales y expedientes la usan. */
+  documentTypes: number;
+  caseFiles: number;
+}
+
+export type ArchivalSeriesGetByIdResponseEntity = ArchivalSeriesGetAllResponseEntity;
+
+/** Cómo se cita una serie donde se usa: código y nombre. */
+export interface ArchivalSeriesSummaryEntity {
+  id: string;
+  code: string;
+  name: string;
+}
+
+export interface ArchivalSeriesCreateResponseEntity {
+  id: ArchivalSeriesEntity['id'];
+  ok: boolean;
+}
+
+export interface ArchivalSeriesUpdateResponseEntity {
+  id: ArchivalSeriesEntity['id'];
+  ok: boolean;
+}

package/src/entities/archivalSeries/index.ts

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

package/src/entities/caseFile/caseFile.entity.ts

@@ -140,6 +140,10 @@ export interface CaseFileGetByIdResponseEntity extends CaseFileGetAllResponseEnt
   closingNote: CaseFileEntity['closingNote'];
   /** Expediente híbrido: tiene documentos en papel que no se pudieron digitalizar. */
   isHybrid: boolean;
+  /** MGDEE1_2: serie del Cuadro de Clasificación. */
+  archivalSeries: { id: string; code: string; name: string } | null;
+  /** MGDEE8_2: fin de la restricción de acceso. */
+  restrictionEndsAt: string | null;
   index: CaseFileEntryResponseEntity[];
   sharedWith: CaseFileParticipantResponseEntity[];
   actors: CaseFileActorResponseEntity[];

package/src/entities/document/document.entity.ts

@@ -138,6 +138,10 @@ export interface DocumentGetByIdResponseEntity {
   id: DocumentEntity['id'];
   // Quién lo emite: la entidad emisora del tipo (Educación, Salud, Juzgado) o la municipalidad.
   issuerName: string;
+  // Serie documental del Cuadro de Clasificación (la de su tipo documental; MGDDE1_2).
+  archivalSeries: { id: string; code: string; name: string } | null;
+  // Fin de la restricción de acceso: desde entonces se consulta como público si no tiene datos sensibles.
+  restrictionEndsAt: string | null;
   subject: DocumentEntity['subject'];
   keywords: DocumentEntity['keywords'];
   accessLevel: DocumentEntity['accessLevel'];

package/src/entities/documentType/documentType.entity.ts

@@ -27,6 +27,8 @@ export interface DocumentTypeGetAllResponseEntity {
   // Sin numeración, sus documentos solo llevan fecha, código de verificación y QR.
   numbered: DocumentTypeEntity['numbered'];
   directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
+  // Serie documental del Cuadro de Clasificación a la que van sus documentos (MGDDE1_2).
+  archivalSeries: { id: string; code: string; name: string } | null;
   // Entidad que emite sus documentos (Educación, Salud, Juzgado). `null`: la municipalidad.
   issuingEntity: { id: string; name: string; shortName: string | null } | null;
   // Tipo cuyo correlativo comparte: sus números salen de esa serie (y `nextCorrelative`, `correlativeYear` y

package/src/entities/index.ts

@@ -7,3 +7,5 @@ export * from './partsOffice';
 export * from './registerBook';
 export * from './signatureBatch';
 export * from './workFolder';
+export * from './scan';
+export * from './archivalSeries';

package/src/entities/scan/index.ts

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

package/src/entities/scan/scan.entity.ts

@@ -0,0 +1,32 @@
+/** Sesión recién abierta: el token y el QR viajan solo aquí. */
+export interface ScanSessionCreateResponseEntity {
+  id: string;
+  token: string;
+  /** Dirección que abre el celular, con el token. */
+  url: string;
+  /** El QR de esa dirección, como imagen PNG en data URL. */
+  qrDataUrl: string;
+  expiresAt: string;
+}
+
+/** Estado de la sesión, como lo ve en el escritorio quien la abrió. */
+export interface ScanSessionResponseEntity {
+  id: string;
+  status: 'Open' | 'Ready';
+  pageCount: number;
+  expiresAt: string;
+  fileName: string | null;
+}
+
+export interface ScanSessionFileResponseEntity {
+  fileId: string;
+  fileName: string;
+}
+
+/** La sesión como la ve el celular. */
+export interface ScanSessionPublicEntity {
+  status: 'Open' | 'Ready';
+  pageCount: number;
+  maxPages: number;
+  expiresAt: string;
+}