@muni-sanfer/types-gestor-documental 0.0.1-beta.6 → 0.0.1-beta.7

package/dist/base/entities.d.ts

@@ -169,11 +169,13 @@ export interface DocumentTypeEntity {
     nextCorrelative: number;
     correlativeYear?: number | null;
     resetsYearly: boolean;
+    numbered: boolean;
     directorateCodeReference?: number | null;
     enabled: boolean;
     documents?: DocumentEntity[];
     annulledNumbers?: DocumentAnnulledNumberEntity[];
     flowSteps?: DocumentTypeFlowStepEntity[];
+    signatureBatches?: SignatureBatchEntity[];
     deleted: boolean;
     createdAt: string;
     updatedAt: string;
@@ -201,6 +203,8 @@ export interface DocumentEntity {
     externalDate?: string | null;
     contentText?: string | null;
     textExtractedAt?: string | null;
+    batch?: SignatureBatchEntity | null;
+    batchId?: string | null;
     replyTo?: DocumentEntity | null;
     replyToDocumentId?: string | null;
     replies?: DocumentEntity[];
@@ -230,6 +234,18 @@ export interface DocumentEntity {
     createdAt: string;
     updatedAt: string;
 }
+export interface SignatureBatchEntity {
+    id: string;
+    name: string;
+    createdByEmployeeId: string;
+    createdByFullName: string;
+    documentType?: DocumentTypeEntity;
+    documentTypeId: string;
+    documents?: DocumentEntity[];
+    deleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
 export interface DocumentParticipantEntity {
     id: string;
     role: DocumentParticipantRole;

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

@@ -1,5 +1,5 @@
 import { type DocumentAccessLevel, type DocumentAttachmentEntity, type DocumentDeliveryEntity, type DocumentEntity, type DocumentInstruction, type DocumentParticipantEntity, type DocumentStatus } from '../base/entities';
-import { type DocumentAnnulResponseEntity, type DocumentCloseDeliveryResponseEntity, type DocumentCreateResponseEntity, type DocumentDeriveResponseEntity, type DocumentDiscardResponseEntity, type DocumentGetAllResponseEntity, type DocumentGetByIdResponseEntity, type DocumentGetSummaryResponseEntity, type DocumentInboxItemEntity, type DocumentPublicFileResponseEntity, type DocumentReassignResponseEntity, type DocumentReviewResponseEntity, type DocumentUpdateResponseEntity, type DocumentVerifyResponseEntity } from '../entities';
+import { type DocumentAnnulResponseEntity, type DocumentCloseDeliveryResponseEntity, type DocumentCreateResponseEntity, type DocumentDeriveResponseEntity, type DocumentDiscardResponseEntity, type DocumentGetAllResponseEntity, type DocumentGetByIdResponseEntity, type DocumentGetSummaryResponseEntity, type DocumentInboxItemEntity, type DocumentPublicFileResponseEntity, type DocumentReassignResponseEntity, type DocumentReviewResponseEntity, type DocumentSignManyResponseEntity, type DocumentUpdateResponseEntity, type DocumentVerifyResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 /** Patrones NATS de `document`: `<servicio>.<recurso>.<acción>`. */
 export declare const DocumentPatterns: {
@@ -10,6 +10,7 @@ export declare const DocumentPatterns: {
     readonly create: "gestorDocumental.document.create";
     readonly update: "gestorDocumental.document.update";
     readonly review: "gestorDocumental.document.review";
+    readonly signMany: "gestorDocumental.document.signMany";
     readonly reassign: "gestorDocumental.document.reassign";
     readonly discard: "gestorDocumental.document.discard";
     readonly annul: "gestorDocumental.document.annul";
@@ -161,6 +162,25 @@ export interface DocumentContract {
         };
         response: DocumentReviewResponseEntity;
     };
+    /**
+     * Firma con un solo OTP varios documentos que el funcionario tiene en su turno de firma (los de un lote, o los que
+     * marcó en su bandeja). Cada uno queda firmado aparte; los que no caben en la solicitud quedan en `remaining`.
+     */
+    [DocumentPatterns.signMany]: {
+        payload: {
+            ids: DocumentEntity['id'][];
+            observation?: string | null;
+            signer: {
+                rut: string;
+                fullName: string;
+                role: string;
+                areaName: string;
+            };
+            otp?: string;
+            actor: DocumentActor;
+        };
+        response: DocumentSignManyResponseEntity;
+    };
     /**
      * Pasa un turno pendiente (de visación o de firma) a otro funcionario, por ausencia o por error, y lo deja en la
      * trazabilidad con su motivo. Puede hacerlo quien redactó el documento; con `anyDocument`, quien lleva el registro.

package/dist/contracts/document.contract.js

@@ -10,6 +10,7 @@ exports.DocumentPatterns = {
     create: 'gestorDocumental.document.create',
     update: 'gestorDocumental.document.update',
     review: 'gestorDocumental.document.review',
+    signMany: 'gestorDocumental.document.signMany',
     reassign: 'gestorDocumental.document.reassign',
     discard: 'gestorDocumental.document.discard',
     annul: 'gestorDocumental.document.annul',

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

@@ -32,6 +32,7 @@ export interface DocumentTypeWritePayload {
     description?: string | null;
     nextCorrelative?: number;
     resetsYearly?: boolean;
+    numbered?: boolean;
     directorateCodeReference?: number | null;
     enabled?: boolean;
     flowSteps?: DocumentFlowStepInput[];

package/dist/contracts/index.d.ts

@@ -4,6 +4,7 @@ import { type DocumentTypeContract } from './documentType.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
 import { type RegisterBookContract } from './registerBook.contract';
+import { type SignatureBatchContract } from './signatureBatch.contract';
 export * from './contract';
 export * from './document.contract';
 export * from './documentType.contract';
@@ -11,6 +12,7 @@ export * from './procedure.contract';
 export * from './caseFile.contract';
 export * from './partsOffice.contract';
 export * from './registerBook.contract';
+export * from './signatureBatch.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -28,6 +30,7 @@ export declare const GestorDocumentalPatterns: {
         readonly create: "gestorDocumental.document.create";
         readonly update: "gestorDocumental.document.update";
         readonly review: "gestorDocumental.document.review";
+        readonly signMany: "gestorDocumental.document.signMany";
         readonly reassign: "gestorDocumental.document.reassign";
         readonly discard: "gestorDocumental.document.discard";
         readonly annul: "gestorDocumental.document.annul";
@@ -79,6 +82,14 @@ export declare const GestorDocumentalPatterns: {
         readonly get: "gestorDocumental.registerBook.get";
         readonly export: "gestorDocumental.registerBook.export";
     };
+    readonly signatureBatch: {
+        readonly getAll: "gestorDocumental.signatureBatch.getAll";
+        readonly getById: "gestorDocumental.signatureBatch.getById";
+        readonly create: "gestorDocumental.signatureBatch.create";
+        readonly visa: "gestorDocumental.signatureBatch.visa";
+        readonly sign: "gestorDocumental.signatureBatch.sign";
+        readonly reject: "gestorDocumental.signatureBatch.reject";
+    };
 };
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
-export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & CaseFileContract & PartsOfficeContract & RegisterBookContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract;

package/dist/contracts/index.js

@@ -21,6 +21,7 @@ const documentType_contract_1 = require("./documentType.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
 const registerBook_contract_1 = require("./registerBook.contract");
+const signatureBatch_contract_1 = require("./signatureBatch.contract");
 __exportStar(require("./contract"), exports);
 __exportStar(require("./document.contract"), exports);
 __exportStar(require("./documentType.contract"), exports);
@@ -28,6 +29,7 @@ __exportStar(require("./procedure.contract"), exports);
 __exportStar(require("./caseFile.contract"), exports);
 __exportStar(require("./partsOffice.contract"), exports);
 __exportStar(require("./registerBook.contract"), exports);
+__exportStar(require("./signatureBatch.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -36,4 +38,5 @@ exports.GestorDocumentalPatterns = {
     caseFile: caseFile_contract_1.CaseFilePatterns,
     partsOffice: partsOffice_contract_1.PartsOfficePatterns,
     registerBook: registerBook_contract_1.RegisterBookPatterns,
+    signatureBatch: signatureBatch_contract_1.SignatureBatchPatterns,
 };

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

@@ -0,0 +1,108 @@
+import { type DocumentAccessLevel } from '../base/entities';
+import { type SignatureBatchCreateResponseEntity, type SignatureBatchGetAllResponseEntity, type SignatureBatchGetByIdResponseEntity, type SignatureBatchRejectResponseEntity, type SignatureBatchSignResponseEntity, type SignatureBatchTab, type SignatureBatchVisaResponseEntity } from '../entities';
+import { type RpcPage } from './contract';
+import { type DocumentActor } from './document.contract';
+/** Patrones NATS de `signatureBatch` (lotes de firma): `<servicio>.<recurso>.<acción>`. */
+export declare const SignatureBatchPatterns: {
+    readonly getAll: "gestorDocumental.signatureBatch.getAll";
+    readonly getById: "gestorDocumental.signatureBatch.getById";
+    readonly create: "gestorDocumental.signatureBatch.create";
+    readonly visa: "gestorDocumental.signatureBatch.visa";
+    readonly sign: "gestorDocumental.signatureBatch.sign";
+    readonly reject: "gestorDocumental.signatureBatch.reject";
+};
+/** Datos de quien firma, para el sello de la firma (los resuelve el gateway desde la sesión). */
+export interface SignatureBatchSigner {
+    rut: string;
+    fullName: string;
+    role: string;
+    areaName: string;
+}
+export interface SignatureBatchContract {
+    [SignatureBatchPatterns.getAll]: {
+        payload: {
+            pagination?: {
+                page?: number;
+                limit?: number;
+            };
+            filters?: {
+                search?: string;
+                tab?: SignatureBatchTab;
+            };
+            actor: DocumentActor;
+        };
+        response: RpcPage<SignatureBatchGetAllResponseEntity[]>;
+    };
+    /** Lo ven su redactor y quienes visan o firman sus documentos; con `viewAll`, quien lleva el registro. */
+    [SignatureBatchPatterns.getById]: {
+        payload: {
+            id: string;
+            actor: DocumentActor;
+            viewAll?: boolean;
+        };
+        response: SignatureBatchGetByIdResponseEntity;
+    };
+    /**
+     * Crea el lote y lo envía a tramitación: un documento por cada PDF, todos del mismo tipo y con el mismo flujo.
+     * Cada documento recibe su código de verificación y, con su primera firma, su número (si el tipo lo lleva).
+     */
+    [SignatureBatchPatterns.create]: {
+        payload: {
+            name: string;
+            documentTypeId: string;
+            keywords: string[];
+            accessLevel?: DocumentAccessLevel;
+            hasSensitiveData?: boolean;
+            directorateCodeReference?: number | null;
+            departmentId?: string | null;
+            visaEmployeeIds?: string[];
+            signatureEmployeeIds: string[];
+            signatureSheet?: boolean;
+            documents: {
+                subject: string;
+                file: {
+                    fileId: string;
+                    name: string;
+                };
+            }[];
+            actor: DocumentActor;
+        };
+        response: SignatureBatchCreateResponseEntity;
+    };
+    /** Visa de una vez los documentos del lote que el funcionario tiene en su turno de visación. */
+    [SignatureBatchPatterns.visa]: {
+        payload: {
+            id: string;
+            observation?: string | null;
+            actor: DocumentActor;
+        };
+        response: SignatureBatchVisaResponseEntity;
+    };
+    /**
+     * Firma con un solo OTP los documentos del lote que el funcionario tiene en su turno de firma. FirmaGob admite 5 MB
+     * por solicitud: los que no caben quedan en `remaining`, para firmarlos con un OTP nuevo.
+     */
+    [SignatureBatchPatterns.sign]: {
+        payload: {
+            id: string;
+            observation?: string | null;
+            signer: SignatureBatchSigner;
+            otp?: string;
+            actor: DocumentActor;
+        };
+        response: SignatureBatchSignResponseEntity;
+    };
+    /**
+     * Devuelve a su redactor los documentos del lote que el funcionario tiene en su turno: todos, o los indicados en
+     * `documentIds`. Los demás siguen su curso.
+     */
+    [SignatureBatchPatterns.reject]: {
+        payload: {
+            id: string;
+            observation: string;
+            documentIds?: string[];
+            actor: DocumentActor;
+        };
+        response: SignatureBatchRejectResponseEntity;
+    };
+}

package/dist/contracts/signatureBatch.contract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignatureBatchPatterns = void 0;
+/** Patrones NATS de `signatureBatch` (lotes de firma): `<servicio>.<recurso>.<acción>`. */
+exports.SignatureBatchPatterns = {
+    getAll: 'gestorDocumental.signatureBatch.getAll',
+    getById: 'gestorDocumental.signatureBatch.getById',
+    create: 'gestorDocumental.signatureBatch.create',
+    visa: 'gestorDocumental.signatureBatch.visa',
+    sign: 'gestorDocumental.signatureBatch.sign',
+    reject: 'gestorDocumental.signatureBatch.reject',
+};

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

@@ -145,6 +145,11 @@ export interface DocumentGetByIdResponseEntity {
     recipients: DocumentRecipientResponseEntity[];
     deliveries: DocumentDeliveryResponseEntity[];
     replyTo: DocumentLinkEntity | null;
+    /** Lote de firma al que pertenece. */
+    batch: {
+        id: string;
+        name: string;
+    } | null;
     replies: DocumentLinkEntity[];
     /** Expedientes en que está incorporado y que quien consulta puede ver. */
     caseFiles: {
@@ -197,6 +202,11 @@ export interface DocumentGetByIdResponseEntity {
 export interface DocumentGetSummaryResponseEntity {
     toVisa: number;
     toSign: number;
+    /** Lotes de firma con documentos en su turno (los documentos de un lote no se cuentan en `toVisa` ni `toSign`). */
+    batches: {
+        toVisa: number;
+        toSign: number;
+    };
     created: {
         drafted: number;
         inProgress: number;
@@ -222,6 +232,27 @@ export interface DocumentReviewResponseEntity {
     ok: boolean;
     status: DocumentEntity['status'];
 }
+/** Resultado de un documento en una firma de varios documentos. */
+export interface DocumentSignManyResultEntity {
+    id: DocumentEntity['id'];
+    ok: boolean;
+    /** Estado en que quedó, si se firmó. */
+    status?: DocumentEntity['status'];
+    /** Por qué no se firmó. */
+    message?: string;
+}
+/**
+ * Firma de varios documentos con un solo OTP. FirmaGob admite 5 MB por solicitud: los que no cupieron quedan en
+ * `remaining`, en el turno del firmante, para firmarlos con un OTP nuevo.
+ */
+export interface DocumentSignManyResponseEntity {
+    results: DocumentSignManyResultEntity[];
+    signed: number;
+    failed: number;
+    remaining: DocumentEntity['id'][];
+    /** FirmaGob avisó que el OTP venció antes de firmar todos los documentos de la solicitud. */
+    otpExpired: boolean;
+}
 export interface DocumentDiscardResponseEntity {
     id: DocumentEntity['id'];
     ok: boolean;

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

@@ -19,6 +19,7 @@ export interface DocumentTypeGetAllResponseEntity {
     nextCorrelative: DocumentTypeEntity['nextCorrelative'];
     correlativeYear: DocumentTypeEntity['correlativeYear'];
     resetsYearly: DocumentTypeEntity['resetsYearly'];
+    numbered: DocumentTypeEntity['numbered'];
     directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
     enabled: DocumentTypeEntity['enabled'];
     flow: {

package/dist/entities/index.d.ts

@@ -4,3 +4,4 @@ export * from './procedure';
 export * from './caseFile';
 export * from './partsOffice';
 export * from './registerBook';
+export * from './signatureBatch';

package/dist/entities/index.js

@@ -20,3 +20,4 @@ __exportStar(require("./procedure"), exports);
 __exportStar(require("./caseFile"), exports);
 __exportStar(require("./partsOffice"), exports);
 __exportStar(require("./registerBook"), exports);
+__exportStar(require("./signatureBatch"), exports);

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

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

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

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

@@ -0,0 +1,106 @@
+import { type DocumentAccessLevel, type DocumentEntity, type DocumentParticipantRole, type DocumentStatus, type SignatureBatchEntity } from '../../base/entities';
+import { type DocumentSignManyResponseEntity, type DocumentSignManyResultEntity } from '../document';
+/**
+ * Estado de un lote, deducido del de sus documentos: en tramitación mientras alguno lo esté; devuelto si no queda
+ * ninguno en tramitación y alguno volvió a su redactor; finalizado si todos terminaron (o se anularon después).
+ */
+export type SignatureBatchStatus = 'InProgress' | 'Returned' | 'Finished';
+/** Lista de lotes: los que esperan al funcionario, los que redactó o todos en que participa. */
+export type SignatureBatchTab = 'pending' | 'created' | 'participated';
+/** Cuántos documentos del lote hay en cada situación. */
+export interface SignatureBatchCountsEntity {
+    total: number;
+    inProgress: number;
+    finished: number;
+    /** Devueltos a su redactor (rechazados), para corregirlos y reenviarlos. */
+    returned: number;
+    annulled: number;
+}
+export interface SignatureBatchGetAllResponseEntity {
+    id: string;
+    name: string;
+    documentType: {
+        id: string;
+        name: string;
+    };
+    createdByEmployeeId: string;
+    createdByFullName: string;
+    createdAt: SignatureBatchEntity['createdAt'];
+    status: SignatureBatchStatus;
+    counts: SignatureBatchCountsEntity;
+    /** Documentos del lote que esperan al funcionario que consulta, por rol. */
+    myPending: {
+        visa: number;
+        signature: number;
+    };
+}
+/** Un documento del lote, con su turno vigente. */
+export interface SignatureBatchDocumentEntity {
+    id: string;
+    subject: string;
+    status: DocumentStatus;
+    correlative: number | null;
+    correlativeYear: number | null;
+    numberedAt: DocumentEntity['numberedAt'];
+    verificationCode: string | null;
+    originalFileName: string;
+    currentTurn: {
+        employeeId: string;
+        fullName: string;
+        role: DocumentParticipantRole;
+    } | null;
+    /** Si el turno vigente es del funcionario que consulta, qué le toca hacer. */
+    myTurn: DocumentParticipantRole | null;
+}
+export interface SignatureBatchGetByIdResponseEntity extends SignatureBatchGetAllResponseEntity {
+    documentType: {
+        id: string;
+        name: string;
+        abbreviation: string | null;
+        numbered: boolean;
+    };
+    keywords: string[];
+    accessLevel: DocumentAccessLevel;
+    hasSensitiveData: boolean;
+    /** Visadores y firmantes del lote, en orden (los del primer documento: todos parten con el mismo flujo). */
+    flow: {
+        role: DocumentParticipantRole;
+        employeeId: string;
+        fullName: string;
+        position: string | null;
+    }[];
+    documents: SignatureBatchDocumentEntity[];
+}
+/** A quién le quedó el turno después de una operación sobre el lote: para avisarle una sola vez por lote. */
+export interface SignatureBatchTurnEntity {
+    employeeId: string;
+    fullName: string;
+    role: DocumentParticipantRole;
+    count: number;
+}
+/** Lo que el gateway necesita para avisar: el lote, su redactor, a quién le toca ahora y cuántos terminaron. */
+export interface SignatureBatchOutcomeEntity {
+    id: string;
+    name: string;
+    createdByEmployeeId: string;
+    nextTurns: SignatureBatchTurnEntity[];
+    /** Documentos que quedaron finalizados con esta operación. */
+    finished: number;
+}
+export interface SignatureBatchCreateResponseEntity extends SignatureBatchOutcomeEntity {
+    ok: boolean;
+    documentIds: string[];
+}
+export interface SignatureBatchVisaResponseEntity extends SignatureBatchOutcomeEntity {
+    ok: boolean;
+    visaed: number;
+    /** Los que no se pudieron visar, con el motivo. */
+    failures: DocumentSignManyResultEntity[];
+}
+export type SignatureBatchSignResponseEntity = SignatureBatchOutcomeEntity & DocumentSignManyResponseEntity;
+export interface SignatureBatchRejectResponseEntity extends SignatureBatchOutcomeEntity {
+    ok: boolean;
+    /** Documentos devueltos a su redactor. */
+    rejected: number;
+    observation: string;
+}

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

package/src/base/entities.ts

@@ -250,11 +250,13 @@ export interface DocumentTypeEntity {
   nextCorrelative: number;
   correlativeYear?: number | null;
   resetsYearly: boolean;
+  numbered: boolean;
   directorateCodeReference?: number | null;
   enabled: boolean;
   documents?: DocumentEntity[];
   annulledNumbers?: DocumentAnnulledNumberEntity[];
   flowSteps?: DocumentTypeFlowStepEntity[];
+  signatureBatches?: SignatureBatchEntity[];
   deleted: boolean;
   createdAt: string;
   updatedAt: string;
@@ -283,6 +285,8 @@ export interface DocumentEntity {
   externalDate?: string | null;
   contentText?: string | null;
   textExtractedAt?: string | null;
+  batch?: SignatureBatchEntity | null;
+  batchId?: string | null;
   replyTo?: DocumentEntity | null;
   replyToDocumentId?: string | null;
   replies?: DocumentEntity[];
@@ -313,6 +317,19 @@ export interface DocumentEntity {
   updatedAt: string;
 }
 
+export interface SignatureBatchEntity {
+  id: string;
+  name: string;
+  createdByEmployeeId: string;
+  createdByFullName: string;
+  documentType?: DocumentTypeEntity;
+  documentTypeId: string;
+  documents?: DocumentEntity[];
+  deleted: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
 export interface DocumentParticipantEntity {
   id: string;
   role: DocumentParticipantRole;

package/src/contracts/document.contract.ts

@@ -20,6 +20,7 @@ import {
   type DocumentPublicFileResponseEntity,
   type DocumentReassignResponseEntity,
   type DocumentReviewResponseEntity,
+  type DocumentSignManyResponseEntity,
   type DocumentUpdateResponseEntity,
   type DocumentVerifyResponseEntity,
 } from '../entities';
@@ -34,6 +35,7 @@ export const DocumentPatterns = {
   create: 'gestorDocumental.document.create',
   update: 'gestorDocumental.document.update',
   review: 'gestorDocumental.document.review',
+  signMany: 'gestorDocumental.document.signMany',
   reassign: 'gestorDocumental.document.reassign',
   discard: 'gestorDocumental.document.discard',
   annul: 'gestorDocumental.document.annul',
@@ -184,6 +186,21 @@ export interface DocumentContract {
     };
     response: DocumentReviewResponseEntity;
   };
+  /**
+   * Firma con un solo OTP varios documentos que el funcionario tiene en su turno de firma (los de un lote, o los que
+   * marcó en su bandeja). Cada uno queda firmado aparte; los que no caben en la solicitud quedan en `remaining`.
+   */
+  [DocumentPatterns.signMany]: {
+    payload: {
+      ids: DocumentEntity['id'][];
+      observation?: string | null;
+      // Datos de quien firma, para el sello de la firma (los resuelve el gateway desde la sesión).
+      signer: { rut: string; fullName: string; role: string; areaName: string };
+      otp?: string;
+      actor: DocumentActor;
+    };
+    response: DocumentSignManyResponseEntity;
+  };
   /**
    * Pasa un turno pendiente (de visación o de firma) a otro funcionario, por ausencia o por error, y lo deja en la
    * trazabilidad con su motivo. Puede hacerlo quien redactó el documento; con `anyDocument`, quien lleva el registro.

package/src/contracts/documentType.contract.ts

@@ -34,6 +34,8 @@ export interface DocumentTypeWritePayload {
   // Próximo número que se asignará: permite partir desde el correlativo que la municipalidad ya lleva.
   nextCorrelative?: number;
   resetsYearly?: boolean;
+  // Sus documentos llevan número (por omisión, sí).
+  numbered?: boolean;
   directorateCodeReference?: number | null;
   enabled?: boolean;
   // Flujo sugerido, en el orden en que les toca dentro de cada rol. Al editar, si no viene, el flujo no cambia.

package/src/contracts/index.ts

@@ -4,6 +4,7 @@ import { DocumentTypePatterns, type DocumentTypeContract } from './documentType.
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
 import { RegisterBookPatterns, type RegisterBookContract } from './registerBook.contract';
+import { SignatureBatchPatterns, type SignatureBatchContract } from './signatureBatch.contract';
 
 export * from './contract';
 export * from './document.contract';
@@ -12,6 +13,7 @@ export * from './procedure.contract';
 export * from './caseFile.contract';
 export * from './partsOffice.contract';
 export * from './registerBook.contract';
+export * from './signatureBatch.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -21,6 +23,7 @@ export const GestorDocumentalPatterns = {
   caseFile: CaseFilePatterns,
   partsOffice: PartsOfficePatterns,
   registerBook: RegisterBookPatterns,
+  signatureBatch: SignatureBatchPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -29,4 +32,5 @@ export type GestorDocumentalContract = DocumentTypeContract &
   ProcedureContract &
   CaseFileContract &
   PartsOfficeContract &
-  RegisterBookContract;
+  RegisterBookContract &
+  SignatureBatchContract;

package/src/contracts/signatureBatch.contract.ts

@@ -0,0 +1,94 @@
+import { type DocumentAccessLevel } from '../base/entities';
+import {
+  type SignatureBatchCreateResponseEntity,
+  type SignatureBatchGetAllResponseEntity,
+  type SignatureBatchGetByIdResponseEntity,
+  type SignatureBatchRejectResponseEntity,
+  type SignatureBatchSignResponseEntity,
+  type SignatureBatchTab,
+  type SignatureBatchVisaResponseEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+import { type DocumentActor } from './document.contract';
+
+/** Patrones NATS de `signatureBatch` (lotes de firma): `<servicio>.<recurso>.<acción>`. */
+export const SignatureBatchPatterns = {
+  getAll: 'gestorDocumental.signatureBatch.getAll',
+  getById: 'gestorDocumental.signatureBatch.getById',
+  create: 'gestorDocumental.signatureBatch.create',
+  visa: 'gestorDocumental.signatureBatch.visa',
+  sign: 'gestorDocumental.signatureBatch.sign',
+  reject: 'gestorDocumental.signatureBatch.reject',
+} as const;
+
+/** Datos de quien firma, para el sello de la firma (los resuelve el gateway desde la sesión). */
+export interface SignatureBatchSigner {
+  rut: string;
+  fullName: string;
+  role: string;
+  areaName: string;
+}
+
+export interface SignatureBatchContract {
+  [SignatureBatchPatterns.getAll]: {
+    payload: {
+      pagination?: { page?: number; limit?: number };
+      filters?: { search?: string; tab?: SignatureBatchTab };
+      actor: DocumentActor;
+    };
+    response: RpcPage<SignatureBatchGetAllResponseEntity[]>;
+  };
+  /** Lo ven su redactor y quienes visan o firman sus documentos; con `viewAll`, quien lleva el registro. */
+  [SignatureBatchPatterns.getById]: {
+    payload: { id: string; actor: DocumentActor; viewAll?: boolean };
+    response: SignatureBatchGetByIdResponseEntity;
+  };
+  /**
+   * Crea el lote y lo envía a tramitación: un documento por cada PDF, todos del mismo tipo y con el mismo flujo.
+   * Cada documento recibe su código de verificación y, con su primera firma, su número (si el tipo lo lleva).
+   */
+  [SignatureBatchPatterns.create]: {
+    payload: {
+      name: string;
+      documentTypeId: string;
+      keywords: string[];
+      accessLevel?: DocumentAccessLevel;
+      hasSensitiveData?: boolean;
+      directorateCodeReference?: number | null;
+      departmentId?: string | null;
+      visaEmployeeIds?: string[];
+      signatureEmployeeIds: string[];
+      signatureSheet?: boolean;
+      documents: { subject: string; file: { fileId: string; name: string } }[];
+      actor: DocumentActor;
+    };
+    response: SignatureBatchCreateResponseEntity;
+  };
+  /** Visa de una vez los documentos del lote que el funcionario tiene en su turno de visación. */
+  [SignatureBatchPatterns.visa]: {
+    payload: { id: string; observation?: string | null; actor: DocumentActor };
+    response: SignatureBatchVisaResponseEntity;
+  };
+  /**
+   * Firma con un solo OTP los documentos del lote que el funcionario tiene en su turno de firma. FirmaGob admite 5 MB
+   * por solicitud: los que no caben quedan en `remaining`, para firmarlos con un OTP nuevo.
+   */
+  [SignatureBatchPatterns.sign]: {
+    payload: {
+      id: string;
+      observation?: string | null;
+      signer: SignatureBatchSigner;
+      otp?: string;
+      actor: DocumentActor;
+    };
+    response: SignatureBatchSignResponseEntity;
+  };
+  /**
+   * Devuelve a su redactor los documentos del lote que el funcionario tiene en su turno: todos, o los indicados en
+   * `documentIds`. Los demás siguen su curso.
+   */
+  [SignatureBatchPatterns.reject]: {
+    payload: { id: string; observation: string; documentIds?: string[]; actor: DocumentActor };
+    response: SignatureBatchRejectResponseEntity;
+  };
+}

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

@@ -176,6 +176,8 @@ export interface DocumentGetByIdResponseEntity {
   deliveries: DocumentDeliveryResponseEntity[];
   // Documento al que este responde, y los que le responden (solo los ya finalizados, más los propios de quien consulta).
   replyTo: DocumentLinkEntity | null;
+  /** Lote de firma al que pertenece. */
+  batch: { id: string; name: string } | null;
   replies: DocumentLinkEntity[];
   /** Expedientes en que está incorporado y que quien consulta puede ver. */
   caseFiles: { id: string; code: string; title: string; status: 'Open' | 'Closed' }[];
@@ -230,6 +232,8 @@ export interface DocumentGetByIdResponseEntity {
 export interface DocumentGetSummaryResponseEntity {
   toVisa: number;
   toSign: number;
+  /** Lotes de firma con documentos en su turno (los documentos de un lote no se cuentan en `toVisa` ni `toSign`). */
+  batches: { toVisa: number; toSign: number };
   created: {
     drafted: number;
     inProgress: number;
@@ -260,6 +264,29 @@ export interface DocumentReviewResponseEntity {
   status: DocumentEntity['status'];
 }
 
+/** Resultado de un documento en una firma de varios documentos. */
+export interface DocumentSignManyResultEntity {
+  id: DocumentEntity['id'];
+  ok: boolean;
+  /** Estado en que quedó, si se firmó. */
+  status?: DocumentEntity['status'];
+  /** Por qué no se firmó. */
+  message?: string;
+}
+
+/**
+ * Firma de varios documentos con un solo OTP. FirmaGob admite 5 MB por solicitud: los que no cupieron quedan en
+ * `remaining`, en el turno del firmante, para firmarlos con un OTP nuevo.
+ */
+export interface DocumentSignManyResponseEntity {
+  results: DocumentSignManyResultEntity[];
+  signed: number;
+  failed: number;
+  remaining: DocumentEntity['id'][];
+  /** FirmaGob avisó que el OTP venció antes de firmar todos los documentos de la solicitud. */
+  otpExpired: boolean;
+}
+
 export interface DocumentDiscardResponseEntity {
   id: DocumentEntity['id'];
   ok: boolean;

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

@@ -22,6 +22,8 @@ export interface DocumentTypeGetAllResponseEntity {
   nextCorrelative: DocumentTypeEntity['nextCorrelative'];
   correlativeYear: DocumentTypeEntity['correlativeYear'];
   resetsYearly: DocumentTypeEntity['resetsYearly'];
+  // Sin numeración, sus documentos solo llevan fecha, código de verificación y QR.
+  numbered: DocumentTypeEntity['numbered'];
   directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
   enabled: DocumentTypeEntity['enabled'];
   // Cuántos visadores y firmantes tiene su flujo sugerido.

package/src/entities/index.ts

@@ -4,3 +4,4 @@ export * from './procedure';
 export * from './caseFile';
 export * from './partsOffice';
 export * from './registerBook';
+export * from './signatureBatch';

package/src/entities/signatureBatch/index.ts

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

package/src/entities/signatureBatch/signatureBatch.entity.ts

@@ -0,0 +1,104 @@
+import {
+  type DocumentAccessLevel,
+  type DocumentEntity,
+  type DocumentParticipantRole,
+  type DocumentStatus,
+  type SignatureBatchEntity,
+} from '../../base/entities';
+import { type DocumentSignManyResponseEntity, type DocumentSignManyResultEntity } from '../document';
+
+/**
+ * Estado de un lote, deducido del de sus documentos: en tramitación mientras alguno lo esté; devuelto si no queda
+ * ninguno en tramitación y alguno volvió a su redactor; finalizado si todos terminaron (o se anularon después).
+ */
+export type SignatureBatchStatus = 'InProgress' | 'Returned' | 'Finished';
+
+/** Lista de lotes: los que esperan al funcionario, los que redactó o todos en que participa. */
+export type SignatureBatchTab = 'pending' | 'created' | 'participated';
+
+/** Cuántos documentos del lote hay en cada situación. */
+export interface SignatureBatchCountsEntity {
+  total: number;
+  inProgress: number;
+  finished: number;
+  /** Devueltos a su redactor (rechazados), para corregirlos y reenviarlos. */
+  returned: number;
+  annulled: number;
+}
+
+export interface SignatureBatchGetAllResponseEntity {
+  id: string;
+  name: string;
+  documentType: { id: string; name: string };
+  createdByEmployeeId: string;
+  createdByFullName: string;
+  createdAt: SignatureBatchEntity['createdAt'];
+  status: SignatureBatchStatus;
+  counts: SignatureBatchCountsEntity;
+  /** Documentos del lote que esperan al funcionario que consulta, por rol. */
+  myPending: { visa: number; signature: number };
+}
+
+/** Un documento del lote, con su turno vigente. */
+export interface SignatureBatchDocumentEntity {
+  id: string;
+  subject: string;
+  status: DocumentStatus;
+  correlative: number | null;
+  correlativeYear: number | null;
+  numberedAt: DocumentEntity['numberedAt'];
+  verificationCode: string | null;
+  originalFileName: string;
+  currentTurn: { employeeId: string; fullName: string; role: DocumentParticipantRole } | null;
+  /** Si el turno vigente es del funcionario que consulta, qué le toca hacer. */
+  myTurn: DocumentParticipantRole | null;
+}
+
+export interface SignatureBatchGetByIdResponseEntity extends SignatureBatchGetAllResponseEntity {
+  documentType: { id: string; name: string; abbreviation: string | null; numbered: boolean };
+  keywords: string[];
+  accessLevel: DocumentAccessLevel;
+  hasSensitiveData: boolean;
+  /** Visadores y firmantes del lote, en orden (los del primer documento: todos parten con el mismo flujo). */
+  flow: { role: DocumentParticipantRole; employeeId: string; fullName: string; position: string | null }[];
+  documents: SignatureBatchDocumentEntity[];
+}
+
+/** A quién le quedó el turno después de una operación sobre el lote: para avisarle una sola vez por lote. */
+export interface SignatureBatchTurnEntity {
+  employeeId: string;
+  fullName: string;
+  role: DocumentParticipantRole;
+  count: number;
+}
+
+/** Lo que el gateway necesita para avisar: el lote, su redactor, a quién le toca ahora y cuántos terminaron. */
+export interface SignatureBatchOutcomeEntity {
+  id: string;
+  name: string;
+  createdByEmployeeId: string;
+  nextTurns: SignatureBatchTurnEntity[];
+  /** Documentos que quedaron finalizados con esta operación. */
+  finished: number;
+}
+
+export interface SignatureBatchCreateResponseEntity extends SignatureBatchOutcomeEntity {
+  ok: boolean;
+  documentIds: string[];
+}
+
+export interface SignatureBatchVisaResponseEntity extends SignatureBatchOutcomeEntity {
+  ok: boolean;
+  visaed: number;
+  /** Los que no se pudieron visar, con el motivo. */
+  failures: DocumentSignManyResultEntity[];
+}
+
+export type SignatureBatchSignResponseEntity = SignatureBatchOutcomeEntity & DocumentSignManyResponseEntity;
+
+export interface SignatureBatchRejectResponseEntity extends SignatureBatchOutcomeEntity {
+  ok: boolean;
+  /** Documentos devueltos a su redactor. */
+  rejected: number;
+  observation: string;
+}

package/tsconfig.json

@@ -9,7 +9,5 @@
     "skipLibCheck": true,
     "rootDir": "./src"
   },
-  "include": [
-    "src"
-  ]
+  "include": ["src"]
 }