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

package/dist/base/entities.d.ts

@@ -250,6 +250,7 @@ export interface DocumentParticipantEntity {
     id: string;
     role: DocumentParticipantRole;
     order: number;
+    stage: number;
     status: DocumentParticipantStatus;
     employeeId: string;
     fullName: string;

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 DocumentSignManyResponseEntity, 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 DocumentAgendaResponseEntity, type DocumentTrailExportEntity, type DocumentUpdateResponseEntity, type DocumentVerifyResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 /** Patrones NATS de `document`: `<servicio>.<recurso>.<acción>`. */
 export declare const DocumentPatterns: {
@@ -19,6 +19,8 @@ export declare const DocumentPatterns: {
     readonly verify: "gestorDocumental.document.verify";
     readonly getPublicFile: "gestorDocumental.document.getPublicFile";
     readonly getFilesFolder: "gestorDocumental.document.getFilesFolder";
+    readonly getAgenda: "gestorDocumental.document.getAgenda";
+    readonly exportTrail: "gestorDocumental.document.exportTrail";
 };
 /**
  * Funcionario que hace la operación y sus áreas (direcciones y departamentos a los que pertenece o que dirige). Lo
@@ -69,6 +71,8 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
     };
     attachments?: Pick<DocumentAttachmentEntity, 'name' | 'type' | 'fileId' | 'url'>[];
     visaEmployeeIds: string[];
+    visaStages?: number[] | null;
+    restartFlow?: boolean;
     signatureEmployeeIds: string[];
     signatureSheet?: boolean;
     recipients?: DocumentRecipientInput[];
@@ -87,6 +91,27 @@ export interface DocumentExternalRecipientInput {
  * Qué se envía y qué se responde en cada patrón. Generado desde los handlers y los DTO del microservicio.
  */
 export interface DocumentContract {
+    /** Plazos del funcionario entre `from` y `to` (hasta 62 días), y lo que tiene vencido sin atender. */
+    [DocumentPatterns.getAgenda]: {
+        payload: {
+            from: string;
+            to: string;
+            actor: DocumentActor;
+        };
+        response: DocumentAgendaResponseEntity;
+    };
+    /**
+     * Trazabilidad del documento en PDF: datos, flujo, hechos y huella de sus archivos. Con las mismas reglas de acceso
+     * del detalle. `generatedBy`: quién la descarga (va al pie).
+     */
+    [DocumentPatterns.exportTrail]: {
+        payload: Pick<DocumentEntity, 'id'> & {
+            actor?: DocumentActor;
+            viewAll?: boolean;
+            generatedBy: string;
+        };
+        response: DocumentTrailExportEntity;
+    };
     [DocumentPatterns.getAll]: {
         payload: {
             pagination?: {

package/dist/contracts/document.contract.js

@@ -19,4 +19,6 @@ exports.DocumentPatterns = {
     verify: 'gestorDocumental.document.verify',
     getPublicFile: 'gestorDocumental.document.getPublicFile',
     getFilesFolder: 'gestorDocumental.document.getFilesFolder',
+    getAgenda: 'gestorDocumental.document.getAgenda',
+    exportTrail: 'gestorDocumental.document.exportTrail',
 };

package/dist/contracts/index.d.ts

@@ -39,6 +39,8 @@ export declare const GestorDocumentalPatterns: {
         readonly verify: "gestorDocumental.document.verify";
         readonly getPublicFile: "gestorDocumental.document.getPublicFile";
         readonly getFilesFolder: "gestorDocumental.document.getFilesFolder";
+        readonly getAgenda: "gestorDocumental.document.getAgenda";
+        readonly exportTrail: "gestorDocumental.document.exportTrail";
     };
     readonly procedure: {
         readonly getAll: "gestorDocumental.procedure.getAll";

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

@@ -56,6 +56,7 @@ export interface SignatureBatchContract {
             directorateCodeReference?: number | null;
             departmentId?: string | null;
             visaEmployeeIds?: string[];
+            visaStages?: number[] | null;
             signatureEmployeeIds: string[];
             signatureSheet?: boolean;
             documents: {

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

@@ -10,6 +10,8 @@ export interface DocumentParticipantResponseEntity {
     id: DocumentParticipantEntity['id'];
     role: DocumentParticipantEntity['role'];
     order: DocumentParticipantEntity['order'];
+    /** Los visadores de una misma etapa visan a la vez. */
+    stage: DocumentParticipantEntity['stage'];
     status: DocumentParticipantEntity['status'];
     employeeId: DocumentParticipantEntity['employeeId'];
     fullName: DocumentParticipantEntity['fullName'];
@@ -100,6 +102,7 @@ export interface DocumentGetAllResponseEntity {
     /** Con búsqueda de texto completo: el fragmento donde aparece lo buscado, con lo encontrado entre ⟦ y ⟧. */
     snippet?: string | null;
     currentParticipant: Pick<DocumentParticipantResponseEntity, 'role' | 'employeeId' | 'fullName'> | null;
+    otherCurrentCount: number;
     distribution: {
         total: number;
         read: number;
@@ -307,3 +310,46 @@ export interface DocumentReassignResponseEntity {
     id: DocumentEntity['id'];
     ok: boolean;
 }
+/**
+ * Un plazo en la agenda de un funcionario: lo que recibió (como destinatario o por derivación) y debe atender, o un
+ * documento que envió y del que espera respuesta.
+ */
+export interface DocumentAgendaItemEntity {
+    kind: 'Received' | 'Sent';
+    /** La entrega (lo recibido) o el documento (lo enviado). */
+    id: string;
+    documentId: DocumentEntity['id'];
+    subject: DocumentEntity['subject'];
+    documentType: {
+        name: string;
+        abbreviation: string | null;
+    };
+    correlative: DocumentEntity['correlative'];
+    correlativeYear: DocumentEntity['correlativeYear'];
+    intakeNumber: DocumentEntity['intakeNumber'];
+    intakeYear: DocumentEntity['intakeYear'];
+    /** Plazo, en ISO 8601. */
+    dueAt: string;
+    /** Lo recibido: cuándo lo marcó como atendido (sin valor si sigue pendiente). */
+    closedAt: string | null;
+    /** Lo recibido: la providencia y quién lo derivó. */
+    instruction: DocumentDeliveryEntity['instruction'] | null;
+    sentByFullName: string | null;
+    /** Lo enviado: a cuántos les llegó y cuántos aún no lo atienden. */
+    recipients: {
+        total: number;
+        pending: number;
+    } | null;
+}
+export interface DocumentAgendaResponseEntity {
+    /** Plazos dentro del período pedido. */
+    items: DocumentAgendaItemEntity[];
+    /** Lo recibido con el plazo vencido y sin atender, de cualquier fecha (los 50 más antiguos). */
+    overdue: DocumentAgendaItemEntity[];
+}
+/** Trazabilidad de un documento en PDF, lista para descargar. */
+export interface DocumentTrailExportEntity {
+    fileName: string;
+    contentType: string;
+    contentBase64: string;
+}

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

@@ -65,6 +65,7 @@ export interface SignatureBatchGetByIdResponseEntity extends SignatureBatchGetAl
     /** Visadores y firmantes del lote, en orden (los del primer documento: todos parten con el mismo flujo). */
     flow: {
         role: DocumentParticipantRole;
+        stage: number;
         employeeId: string;
         fullName: string;
         position: string | null;

package/package.json

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

package/src/base/entities.ts

@@ -334,6 +334,7 @@ export interface DocumentParticipantEntity {
   id: string;
   role: DocumentParticipantRole;
   order: number;
+  stage: number;
   status: DocumentParticipantStatus;
   employeeId: string;
   fullName: string;

package/src/contracts/document.contract.ts

@@ -21,6 +21,8 @@ import {
   type DocumentReassignResponseEntity,
   type DocumentReviewResponseEntity,
   type DocumentSignManyResponseEntity,
+  type DocumentAgendaResponseEntity,
+  type DocumentTrailExportEntity,
   type DocumentUpdateResponseEntity,
   type DocumentVerifyResponseEntity,
 } from '../entities';
@@ -44,6 +46,8 @@ export const DocumentPatterns = {
   verify: 'gestorDocumental.document.verify',
   getPublicFile: 'gestorDocumental.document.getPublicFile',
   getFilesFolder: 'gestorDocumental.document.getFilesFolder',
+  getAgenda: 'gestorDocumental.document.getAgenda',
+  exportTrail: 'gestorDocumental.document.exportTrail',
 } as const;
 
 /**
@@ -95,6 +99,10 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
   attachments?: Pick<DocumentAttachmentEntity, 'name' | 'type' | 'fileId' | 'url'>[];
   // Funcionarios que visan y que firman, en el orden en que les toca. Primero visan todos y después firman.
   visaEmployeeIds: string[];
+  // Etapa de cada visador, en su orden ([1, 1, 2]: los dos primeros visan a la vez). Sin etapas, visan en cadena.
+  visaStages?: number[] | null;
+  // Al reenviar un documento rechazado, pedir de nuevo las visaciones ya hechas en vez de seguir donde quedó.
+  restartFlow?: boolean;
   signatureEmployeeIds: string[];
   // Firmas y visaciones en una hoja aparte al final, en vez de al pie de la última página.
   signatureSheet?: boolean;
@@ -120,6 +128,19 @@ export interface DocumentExternalRecipientInput {
  * Qué se envía y qué se responde en cada patrón. Generado desde los handlers y los DTO del microservicio.
  */
 export interface DocumentContract {
+  /** Plazos del funcionario entre `from` y `to` (hasta 62 días), y lo que tiene vencido sin atender. */
+  [DocumentPatterns.getAgenda]: {
+    payload: { from: string; to: string; actor: DocumentActor };
+    response: DocumentAgendaResponseEntity;
+  };
+  /**
+   * Trazabilidad del documento en PDF: datos, flujo, hechos y huella de sus archivos. Con las mismas reglas de acceso
+   * del detalle. `generatedBy`: quién la descarga (va al pie).
+   */
+  [DocumentPatterns.exportTrail]: {
+    payload: Pick<DocumentEntity, 'id'> & { actor?: DocumentActor; viewAll?: boolean; generatedBy: string };
+    response: DocumentTrailExportEntity;
+  };
   [DocumentPatterns.getAll]: {
     payload: {
       pagination?: { page?: number; limit?: number };

package/src/contracts/signatureBatch.contract.ts

@@ -57,6 +57,8 @@ export interface SignatureBatchContract {
       directorateCodeReference?: number | null;
       departmentId?: string | null;
       visaEmployeeIds?: string[];
+      // Etapa de cada visador: los de una misma etapa visan a la vez.
+      visaStages?: number[] | null;
       signatureEmployeeIds: string[];
       signatureSheet?: boolean;
       documents: { subject: string; file: { fileId: string; name: string } }[];

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

@@ -21,6 +21,8 @@ export interface DocumentParticipantResponseEntity {
   id: DocumentParticipantEntity['id'];
   role: DocumentParticipantEntity['role'];
   order: DocumentParticipantEntity['order'];
+  /** Los visadores de una misma etapa visan a la vez. */
+  stage: DocumentParticipantEntity['stage'];
   status: DocumentParticipantEntity['status'];
   employeeId: DocumentParticipantEntity['employeeId'];
   fullName: DocumentParticipantEntity['fullName'];
@@ -121,6 +123,8 @@ export interface DocumentGetAllResponseEntity {
   snippet?: string | null;
   // A quién le toca visar o firmar (null si el documento no está en tramitación).
   currentParticipant: Pick<DocumentParticipantResponseEntity, 'role' | 'employeeId' | 'fullName'> | null;
+  // Cuántos más tienen el turno a la vez (visación en paralelo).
+  otherCurrentCount: number;
   // A cuántos funcionarios llegó y cuántos ya lo abrieron (null si aún no se distribuye a nadie).
   distribution: { total: number; read: number } | null;
 }
@@ -351,3 +355,43 @@ export interface DocumentReassignResponseEntity {
   id: DocumentEntity['id'];
   ok: boolean;
 }
+
+/**
+ * Un plazo en la agenda de un funcionario: lo que recibió (como destinatario o por derivación) y debe atender, o un
+ * documento que envió y del que espera respuesta.
+ */
+export interface DocumentAgendaItemEntity {
+  kind: 'Received' | 'Sent';
+  /** La entrega (lo recibido) o el documento (lo enviado). */
+  id: string;
+  documentId: DocumentEntity['id'];
+  subject: DocumentEntity['subject'];
+  documentType: { name: string; abbreviation: string | null };
+  correlative: DocumentEntity['correlative'];
+  correlativeYear: DocumentEntity['correlativeYear'];
+  intakeNumber: DocumentEntity['intakeNumber'];
+  intakeYear: DocumentEntity['intakeYear'];
+  /** Plazo, en ISO 8601. */
+  dueAt: string;
+  /** Lo recibido: cuándo lo marcó como atendido (sin valor si sigue pendiente). */
+  closedAt: string | null;
+  /** Lo recibido: la providencia y quién lo derivó. */
+  instruction: DocumentDeliveryEntity['instruction'] | null;
+  sentByFullName: string | null;
+  /** Lo enviado: a cuántos les llegó y cuántos aún no lo atienden. */
+  recipients: { total: number; pending: number } | null;
+}
+
+export interface DocumentAgendaResponseEntity {
+  /** Plazos dentro del período pedido. */
+  items: DocumentAgendaItemEntity[];
+  /** Lo recibido con el plazo vencido y sin atender, de cualquier fecha (los 50 más antiguos). */
+  overdue: DocumentAgendaItemEntity[];
+}
+
+/** Trazabilidad de un documento en PDF, lista para descargar. */
+export interface DocumentTrailExportEntity {
+  fileName: string;
+  contentType: string;
+  contentBase64: string;
+}

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

@@ -60,7 +60,13 @@ export interface SignatureBatchGetByIdResponseEntity extends SignatureBatchGetAl
   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 }[];
+  flow: {
+    role: DocumentParticipantRole;
+    stage: number;
+    employeeId: string;
+    fullName: string;
+    position: string | null;
+  }[];
   documents: SignatureBatchDocumentEntity[];
 }