@muni-sanfer/types-gestor-documental 0.0.1-beta.10 → 0.0.1-beta.12

package/dist/base/entities.d.ts

@@ -143,12 +143,13 @@ export declare const CaseFileActorType: {
     PrivateInstitution: "PrivateInstitution";
     Official: "Official";
 };
-export type CaseFileTrackingAction = 'Created' | 'Updated' | 'EntryAdded' | 'EntryVoided' | 'ParticipantAdded' | 'ParticipantRemoved' | 'Closed' | 'Exported';
+export type CaseFileTrackingAction = 'Created' | 'Updated' | 'EntryAdded' | 'EntryVoided' | 'EntryMoved' | 'ParticipantAdded' | 'ParticipantRemoved' | 'Closed' | 'Exported';
 export declare const CaseFileTrackingAction: {
     Created: "Created";
     Updated: "Updated";
     EntryAdded: "EntryAdded";
     EntryVoided: "EntryVoided";
+    EntryMoved: "EntryMoved";
     ParticipantAdded: "ParticipantAdded";
     ParticipantRemoved: "ParticipantRemoved";
     Closed: "Closed";
@@ -206,6 +207,7 @@ export interface DocumentEntity {
     externalFolio?: string | null;
     externalSender?: string | null;
     externalDate?: string | null;
+    composition?: JsonValue | null;
     contentText?: string | null;
     textExtractedAt?: string | null;
     batch?: SignatureBatchEntity | null;
@@ -284,6 +286,7 @@ export interface DocumentTrackingEntity {
     id: string;
     action: DocumentTrackingAction;
     observation?: string | null;
+    sha256?: string | null;
     employeeId?: string | null;
     employeeFullName?: string | null;
     document?: DocumentEntity;
@@ -344,6 +347,7 @@ export interface DocumentTypeFlowStepEntity {
     directorateCodeReference?: number | null;
     name: string;
     position?: string | null;
+    withPrevious: boolean;
     documentType?: DocumentTypeEntity;
     documentTypeId: string;
     createdAt: string;
@@ -424,6 +428,7 @@ export interface CaseFileEntryEntity {
     kind: CaseFileEntryKind;
     actuationType: CaseFileActuationType;
     title: string;
+    folder?: string | null;
     document?: DocumentEntity | null;
     documentId?: string | null;
     fileId?: string | null;

package/dist/base/entities.js

@@ -132,6 +132,7 @@ exports.CaseFileTrackingAction = {
     Updated: 'Updated',
     EntryAdded: 'EntryAdded',
     EntryVoided: 'EntryVoided',
+    EntryMoved: 'EntryMoved',
     ParticipantAdded: 'ParticipantAdded',
     ParticipantRemoved: 'ParticipantRemoved',
     Closed: 'Closed',

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

@@ -11,6 +11,7 @@ export declare const CaseFilePatterns: {
     readonly addEntry: "gestorDocumental.caseFile.addEntry";
     readonly addBatch: "gestorDocumental.caseFile.addBatch";
     readonly voidEntry: "gestorDocumental.caseFile.voidEntry";
+    readonly moveEntry: "gestorDocumental.caseFile.moveEntry";
     readonly share: "gestorDocumental.caseFile.share";
     readonly unshare: "gestorDocumental.caseFile.unshare";
     readonly close: "gestorDocumental.caseFile.close";
@@ -110,10 +111,20 @@ export interface CaseFileContract {
     [CaseFilePatterns.addEntry]: {
         payload: Pick<CaseFileEntity, 'id'> & {
             entry: CaseFileEntryInput;
+            folder?: string | null;
         } & CaseFileActorPayload;
         response: CaseFileAddEntryResponseEntity;
     };
     /** Deja una actuación sin efecto, con su motivo. No se elimina del índice. */
+    /** Pasa una actuación a otra subcarpeta del índice (`null`: a la raíz). El orden de incorporación no cambia. */
+    [CaseFilePatterns.moveEntry]: {
+        payload: {
+            id: string;
+            entryId: string;
+            folder: string | null;
+        } & CaseFileActorPayload;
+        response: CaseFileUpdateResponseEntity;
+    };
     [CaseFilePatterns.voidEntry]: {
         payload: Pick<CaseFileEntity, 'id'> & {
             entryId: string;

package/dist/contracts/caseFile.contract.js

@@ -10,6 +10,7 @@ exports.CaseFilePatterns = {
     addEntry: 'gestorDocumental.caseFile.addEntry',
     addBatch: 'gestorDocumental.caseFile.addBatch',
     voidEntry: 'gestorDocumental.caseFile.voidEntry',
+    moveEntry: 'gestorDocumental.caseFile.moveEntry',
     share: 'gestorDocumental.caseFile.share',
     unshare: 'gestorDocumental.caseFile.unshare',
     close: 'gestorDocumental.caseFile.close',

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 DocumentAgendaResponseEntity, type DocumentTrailExportEntity, 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 DocumentComposeResponseEntity, type DocumentComposition, 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: {
@@ -21,6 +21,7 @@ export declare const DocumentPatterns: {
     readonly getFilesFolder: "gestorDocumental.document.getFilesFolder";
     readonly getAgenda: "gestorDocumental.document.getAgenda";
     readonly exportTrail: "gestorDocumental.document.exportTrail";
+    readonly compose: "gestorDocumental.document.compose";
 };
 /**
  * Funcionario que hace la operación y sus áreas (direcciones y departamentos a los que pertenece o que dirige). Lo
@@ -73,6 +74,7 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
     visaEmployeeIds: string[];
     visaStages?: number[] | null;
     restartFlow?: boolean;
+    composition?: DocumentComposition | null;
     signatureEmployeeIds: string[];
     signatureSheet?: boolean;
     recipients?: DocumentRecipientInput[];
@@ -91,6 +93,26 @@ 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 {
+    /**
+     * Arma el PDF de un documento redactado con una plantilla oficial: membrete, estructura y espacio libre para el
+     * número, las visaciones, las firmas y el QR. Con `preview` lo entrega para verlo; si no, lo sube y entrega su
+     * `fileId` para guardarlo como el PDF del documento.
+     */
+    [DocumentPatterns.compose]: {
+        payload: {
+            documentTypeId: string;
+            subject: string;
+            composition: DocumentComposition;
+            visaCount: number;
+            signatureCount: number;
+            signatureSheet?: boolean;
+            /** Unidad que emite, para el membrete. */
+            issuingUnitName?: string | null;
+            preview?: boolean;
+            actor: DocumentActor;
+        };
+        response: DocumentComposeResponseEntity;
+    };
     /** Plazos del funcionario entre `from` y `to` (hasta 62 días), y lo que tiene vencido sin atender. */
     [DocumentPatterns.getAgenda]: {
         payload: {

package/dist/contracts/document.contract.js

@@ -21,4 +21,5 @@ exports.DocumentPatterns = {
     getFilesFolder: 'gestorDocumental.document.getFilesFolder',
     getAgenda: 'gestorDocumental.document.getAgenda',
     exportTrail: 'gestorDocumental.document.exportTrail',
+    compose: 'gestorDocumental.document.compose',
 };

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

@@ -14,7 +14,7 @@ export declare const DocumentTypePatterns: {
  * momento de redactar (su jefatura o, con subrogancia activa, el subrogante). El nombre de la dirección lo resuelve
  * el gateway; el navegador solo indica cuál es.
  */
-export type DocumentFlowStepInput = {
+export type DocumentFlowStepInput = ({
     role: DocumentParticipantRole;
     type: 'Employee';
     employeeId: string;
@@ -23,6 +23,8 @@ export type DocumentFlowStepInput = {
     type: 'DirectorateHead';
     directorateCodeReference: number;
     name: string;
+}) & {
+    withPrevious?: boolean;
 };
 /** Datos de un tipo documental al crearlo o editarlo. */
 export interface DocumentTypeWritePayload {
@@ -51,6 +53,7 @@ export interface DocumentTypeContract {
                 search?: string;
                 enabled?: boolean;
                 category?: DocumentCategory;
+                usableByDirectorates?: number[];
             };
         };
         response: RpcPage<DocumentTypeGetAllResponseEntity[]>;

package/dist/contracts/index.d.ts

@@ -43,6 +43,7 @@ export declare const GestorDocumentalPatterns: {
         readonly getFilesFolder: "gestorDocumental.document.getFilesFolder";
         readonly getAgenda: "gestorDocumental.document.getAgenda";
         readonly exportTrail: "gestorDocumental.document.exportTrail";
+        readonly compose: "gestorDocumental.document.compose";
     };
     readonly procedure: {
         readonly getAll: "gestorDocumental.procedure.getAll";
@@ -59,6 +60,7 @@ export declare const GestorDocumentalPatterns: {
         readonly addEntry: "gestorDocumental.caseFile.addEntry";
         readonly addBatch: "gestorDocumental.caseFile.addBatch";
         readonly voidEntry: "gestorDocumental.caseFile.voidEntry";
+        readonly moveEntry: "gestorDocumental.caseFile.moveEntry";
         readonly share: "gestorDocumental.caseFile.share";
         readonly unshare: "gestorDocumental.caseFile.unshare";
         readonly close: "gestorDocumental.caseFile.close";

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

@@ -33,6 +33,8 @@ export interface CaseFileEntryDocumentEntity {
 export interface CaseFileEntryResponseEntity {
     id: CaseFileEntryEntity['id'];
     sequence: CaseFileEntryEntity['sequence'];
+    /** Subcarpeta del índice (sin valor: en la raíz). */
+    folder: CaseFileEntryEntity['folder'];
     kind: CaseFileEntryEntity['kind'];
     actuationType: CaseFileEntryEntity['actuationType'];
     title: CaseFileEntryEntity['title'];

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

@@ -153,6 +153,8 @@ export interface DocumentGetByIdResponseEntity {
         id: string;
         name: string;
     } | null;
+    /** Contenido redactado en el sistema con una plantilla, para volver a editarlo (sin valor si se subió un PDF). */
+    composition: DocumentComposition | null;
     replies: DocumentLinkEntity[];
     /** Expedientes en que está incorporado y que quien consulta puede ver. */
     caseFiles: {
@@ -184,6 +186,7 @@ export interface DocumentGetByIdResponseEntity {
         id: DocumentTrackingEntity['id'];
         action: DocumentTrackingEntity['action'];
         observation: DocumentTrackingEntity['observation'];
+        sha256: DocumentTrackingEntity['sha256'];
         employeeId: DocumentTrackingEntity['employeeId'];
         employeeFullName: DocumentTrackingEntity['employeeFullName'];
         createdAt: DocumentTrackingEntity['createdAt'];
@@ -353,3 +356,48 @@ export interface DocumentTrailExportEntity {
     contentType: string;
     contentBase64: string;
 }
+/** Plantilla oficial con que se redacta un documento en el sistema. */
+export type DocumentTemplateKind = 'Decree' | 'Office' | 'Memorandum' | 'General';
+/**
+ * Contenido de un documento redactado en el sistema. Cada plantilla tiene su estructura; los párrafos son texto
+ * (un salto de línea dentro de un párrafo se respeta). La materia es el asunto del documento.
+ */
+export type DocumentComposition = {
+    template: 'Decree';
+    /** VISTOS: las normas y antecedentes. */
+    vistos: string[];
+    /** CONSIDERANDO: cada fundamento, numerado. */
+    considerando: string[];
+    /** DECRETO: cada punto resolutivo, numerado. */
+    resolutive: string[];
+    /** Fórmula de cierre: «Anótese, comuníquese y archívese». */
+    closing: string;
+    distribution: string[];
+} | {
+    template: 'Office';
+    /** ANT.: antecedentes (otro oficio, una solicitud). */
+    antecedents?: string | null;
+    from: string;
+    to: string;
+    body: string[];
+    closing: string;
+    distribution: string[];
+} | {
+    template: 'Memorandum';
+    from: string;
+    to: string;
+    body: string[];
+    closing?: string | null;
+    distribution: string[];
+} | {
+    template: 'General';
+    title: string;
+    body: string[];
+    closing?: string | null;
+};
+/** PDF armado con una plantilla: para la vista previa (`contentBase64`) o ya subido (`fileId`). */
+export interface DocumentComposeResponseEntity {
+    fileName: string;
+    fileId?: string;
+    contentBase64?: string;
+}

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

@@ -9,6 +9,7 @@ export interface DocumentTypeFlowStepResponseEntity {
     directorateCodeReference: DocumentTypeFlowStepEntity['directorateCodeReference'];
     name: DocumentTypeFlowStepEntity['name'];
     position: DocumentTypeFlowStepEntity['position'];
+    withPrevious: DocumentTypeFlowStepEntity['withPrevious'];
 }
 export interface DocumentTypeGetAllResponseEntity {
     id: DocumentTypeEntity['id'];

package/package.json

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

package/src/base/entities.ts

@@ -217,6 +217,7 @@ export type CaseFileTrackingAction =
   | 'Updated'
   | 'EntryAdded'
   | 'EntryVoided'
+  | 'EntryMoved'
   | 'ParticipantAdded'
   | 'ParticipantRemoved'
   | 'Closed'
@@ -227,6 +228,7 @@ export const CaseFileTrackingAction = {
   Updated: 'Updated',
   EntryAdded: 'EntryAdded',
   EntryVoided: 'EntryVoided',
+  EntryMoved: 'EntryMoved',
   ParticipantAdded: 'ParticipantAdded',
   ParticipantRemoved: 'ParticipantRemoved',
   Closed: 'Closed',
@@ -290,6 +292,7 @@ export interface DocumentEntity {
   externalFolio?: string | null;
   externalSender?: string | null;
   externalDate?: string | null;
+  composition?: JsonValue | null;
   contentText?: string | null;
   textExtractedAt?: string | null;
   batch?: SignatureBatchEntity | null;
@@ -372,6 +375,7 @@ export interface DocumentTrackingEntity {
   id: string;
   action: DocumentTrackingAction;
   observation?: string | null;
+  sha256?: string | null;
   employeeId?: string | null;
   employeeFullName?: string | null;
   document?: DocumentEntity;
@@ -436,6 +440,7 @@ export interface DocumentTypeFlowStepEntity {
   directorateCodeReference?: number | null;
   name: string;
   position?: string | null;
+  withPrevious: boolean;
   documentType?: DocumentTypeEntity;
   documentTypeId: string;
   createdAt: string;
@@ -522,6 +527,7 @@ export interface CaseFileEntryEntity {
   kind: CaseFileEntryKind;
   actuationType: CaseFileActuationType;
   title: string;
+  folder?: string | null;
   document?: DocumentEntity | null;
   documentId?: string | null;
   fileId?: string | null;

package/src/contracts/caseFile.contract.ts

@@ -28,6 +28,7 @@ export const CaseFilePatterns = {
   addEntry: 'gestorDocumental.caseFile.addEntry',
   addBatch: 'gestorDocumental.caseFile.addBatch',
   voidEntry: 'gestorDocumental.caseFile.voidEntry',
+  moveEntry: 'gestorDocumental.caseFile.moveEntry',
   share: 'gestorDocumental.caseFile.share',
   unshare: 'gestorDocumental.caseFile.unshare',
   close: 'gestorDocumental.caseFile.close',
@@ -108,10 +109,16 @@ export interface CaseFileContract {
     response: CaseFileAddBatchResponseEntity;
   };
   [CaseFilePatterns.addEntry]: {
-    payload: Pick<CaseFileEntity, 'id'> & { entry: CaseFileEntryInput } & CaseFileActorPayload;
+    // `folder`: subcarpeta del índice en que queda (sin valor: en la raíz)
+    payload: Pick<CaseFileEntity, 'id'> & { entry: CaseFileEntryInput; folder?: string | null } & CaseFileActorPayload;
     response: CaseFileAddEntryResponseEntity;
   };
   /** Deja una actuación sin efecto, con su motivo. No se elimina del índice. */
+  /** Pasa una actuación a otra subcarpeta del índice (`null`: a la raíz). El orden de incorporación no cambia. */
+  [CaseFilePatterns.moveEntry]: {
+    payload: { id: string; entryId: string; folder: string | null } & CaseFileActorPayload;
+    response: CaseFileUpdateResponseEntity;
+  };
   [CaseFilePatterns.voidEntry]: {
     payload: Pick<CaseFileEntity, 'id'> & { entryId: string; reason: string; actor: DocumentActor };
     response: CaseFileUpdateResponseEntity;

package/src/contracts/document.contract.ts

@@ -22,6 +22,8 @@ import {
   type DocumentReviewResponseEntity,
   type DocumentSignManyResponseEntity,
   type DocumentAgendaResponseEntity,
+  type DocumentComposeResponseEntity,
+  type DocumentComposition,
   type DocumentTrailExportEntity,
   type DocumentUpdateResponseEntity,
   type DocumentVerifyResponseEntity,
@@ -48,6 +50,7 @@ export const DocumentPatterns = {
   getFilesFolder: 'gestorDocumental.document.getFilesFolder',
   getAgenda: 'gestorDocumental.document.getAgenda',
   exportTrail: 'gestorDocumental.document.exportTrail',
+  compose: 'gestorDocumental.document.compose',
 } as const;
 
 /**
@@ -103,6 +106,8 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
   visaStages?: number[] | null;
   // Al reenviar un documento rechazado, pedir de nuevo las visaciones ya hechas en vez de seguir donde quedó.
   restartFlow?: boolean;
+  // Contenido redactado con una plantilla (el PDF ya armado va en `file`): se guarda para volver a editarlo.
+  composition?: DocumentComposition | null;
   signatureEmployeeIds: string[];
   // Firmas y visaciones en una hoja aparte al final, en vez de al pie de la última página.
   signatureSheet?: boolean;
@@ -128,6 +133,26 @@ 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 {
+  /**
+   * Arma el PDF de un documento redactado con una plantilla oficial: membrete, estructura y espacio libre para el
+   * número, las visaciones, las firmas y el QR. Con `preview` lo entrega para verlo; si no, lo sube y entrega su
+   * `fileId` para guardarlo como el PDF del documento.
+   */
+  [DocumentPatterns.compose]: {
+    payload: {
+      documentTypeId: string;
+      subject: string;
+      composition: DocumentComposition;
+      visaCount: number;
+      signatureCount: number;
+      signatureSheet?: boolean;
+      /** Unidad que emite, para el membrete. */
+      issuingUnitName?: string | null;
+      preview?: boolean;
+      actor: DocumentActor;
+    };
+    response: DocumentComposeResponseEntity;
+  };
   /** 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 };

package/src/contracts/documentType.contract.ts

@@ -21,9 +21,13 @@ export const DocumentTypePatterns = {
  * momento de redactar (su jefatura o, con subrogancia activa, el subrogante). El nombre de la dirección lo resuelve
  * el gateway; el navegador solo indica cuál es.
  */
-export type DocumentFlowStepInput =
+export type DocumentFlowStepInput = (
   | { role: DocumentParticipantRole; type: 'Employee'; employeeId: string }
-  | { role: DocumentParticipantRole; type: 'DirectorateHead'; directorateCodeReference: number; name: string };
+  | { role: DocumentParticipantRole; type: 'DirectorateHead'; directorateCodeReference: number; name: string }
+) & {
+  // Visa a la vez con el paso anterior (visación en paralelo). Solo en visaciones.
+  withPrevious?: boolean;
+};
 
 /** Datos de un tipo documental al crearlo o editarlo. */
 export interface DocumentTypeWritePayload {
@@ -50,7 +54,13 @@ export interface DocumentTypeContract {
     // sin `page` y `limit` responde todos los tipos en una sola página
     payload: {
       pagination?: { page?: number; limit?: number };
-      filters?: { search?: string; enabled?: boolean; category?: DocumentCategory };
+      filters?: {
+        search?: string;
+        enabled?: boolean;
+        category?: DocumentCategory;
+        // Solo los que puede usar quien redacta: los de toda la municipalidad y los de estas direcciones.
+        usableByDirectorates?: number[];
+      };
     };
     response: RpcPage<DocumentTypeGetAllResponseEntity[]>;
   };

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

@@ -47,6 +47,8 @@ export interface CaseFileEntryDocumentEntity {
 export interface CaseFileEntryResponseEntity {
   id: CaseFileEntryEntity['id'];
   sequence: CaseFileEntryEntity['sequence'];
+  /** Subcarpeta del índice (sin valor: en la raíz). */
+  folder: CaseFileEntryEntity['folder'];
   kind: CaseFileEntryEntity['kind'];
   actuationType: CaseFileEntryEntity['actuationType'];
   title: CaseFileEntryEntity['title'];

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

@@ -182,6 +182,8 @@ export interface DocumentGetByIdResponseEntity {
   replyTo: DocumentLinkEntity | null;
   /** Lote de firma al que pertenece. */
   batch: { id: string; name: string } | null;
+  /** Contenido redactado en el sistema con una plantilla, para volver a editarlo (sin valor si se subió un PDF). */
+  composition: DocumentComposition | null;
   replies: DocumentLinkEntity[];
   /** Expedientes en que está incorporado y que quien consulta puede ver. */
   caseFiles: { id: string; code: string; title: string; status: 'Open' | 'Closed' }[];
@@ -208,6 +210,8 @@ export interface DocumentGetByIdResponseEntity {
     id: DocumentTrackingEntity['id'];
     action: DocumentTrackingEntity['action'];
     observation: DocumentTrackingEntity['observation'];
+    // Huella SHA-256 del PDF en ese hecho (firma, despacho o ingreso por DocDigital).
+    sha256: DocumentTrackingEntity['sha256'];
     employeeId: DocumentTrackingEntity['employeeId'];
     employeeFullName: DocumentTrackingEntity['employeeFullName'];
     createdAt: DocumentTrackingEntity['createdAt'];
@@ -395,3 +399,50 @@ export interface DocumentTrailExportEntity {
   contentType: string;
   contentBase64: string;
 }
+
+/** Plantilla oficial con que se redacta un documento en el sistema. */
+export type DocumentTemplateKind = 'Decree' | 'Office' | 'Memorandum' | 'General';
+
+/**
+ * Contenido de un documento redactado en el sistema. Cada plantilla tiene su estructura; los párrafos son texto
+ * (un salto de línea dentro de un párrafo se respeta). La materia es el asunto del documento.
+ */
+export type DocumentComposition =
+  | {
+      template: 'Decree';
+      /** VISTOS: las normas y antecedentes. */
+      vistos: string[];
+      /** CONSIDERANDO: cada fundamento, numerado. */
+      considerando: string[];
+      /** DECRETO: cada punto resolutivo, numerado. */
+      resolutive: string[];
+      /** Fórmula de cierre: «Anótese, comuníquese y archívese». */
+      closing: string;
+      distribution: string[];
+    }
+  | {
+      template: 'Office';
+      /** ANT.: antecedentes (otro oficio, una solicitud). */
+      antecedents?: string | null;
+      from: string;
+      to: string;
+      body: string[];
+      closing: string;
+      distribution: string[];
+    }
+  | {
+      template: 'Memorandum';
+      from: string;
+      to: string;
+      body: string[];
+      closing?: string | null;
+      distribution: string[];
+    }
+  | { template: 'General'; title: string; body: string[]; closing?: string | null };
+
+/** PDF armado con una plantilla: para la vista previa (`contentBase64`) o ya subido (`fileId`). */
+export interface DocumentComposeResponseEntity {
+  fileName: string;
+  fileId?: string;
+  contentBase64?: string;
+}

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

@@ -11,6 +11,8 @@ export interface DocumentTypeFlowStepResponseEntity {
   // Nombre del funcionario o de la dirección, como estaba al definir el flujo.
   name: DocumentTypeFlowStepEntity['name'];
   position: DocumentTypeFlowStepEntity['position'];
+  // Visa a la vez con el paso anterior (visación en paralelo).
+  withPrevious: DocumentTypeFlowStepEntity['withPrevious'];
 }
 
 export interface DocumentTypeGetAllResponseEntity {