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

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
@@ -89,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/entities/document/document.entity.d.ts

@@ -310,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/package.json

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

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;
 
 /**
@@ -124,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/entities/document/document.entity.ts

@@ -355,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;
+}