@muni-sanfer/types-gestor-documental 0.0.1-beta.37 → 0.0.1-beta.39

package/dist/base/entities.d.ts

@@ -33,7 +33,7 @@ export declare const DocumentParticipantStatus: {
     Resolved: "Resolved";
     Rejected: "Rejected";
 };
-export type DocumentTrackingAction = 'Created' | 'Updated' | 'Submitted' | 'Visaed' | 'Signed' | 'Rejected' | 'Finished' | 'Discarded' | 'Numbered' | 'NumberAnnulled' | 'Annulled' | 'Delivered' | 'Derived' | 'Reassigned' | 'Dispatched' | 'DispatchReturned' | 'DispatchedByContingency' | 'Received' | 'EmailCopySent' | 'EmailCopyOpened' | 'DispositionRecorded' | 'TransparencyRedacted' | 'TransparencyPublished' | 'TransparencyExcluded' | 'TransparencyWithdrawn';
+export type DocumentTrackingAction = 'Created' | 'Updated' | 'Submitted' | 'Visaed' | 'Signed' | 'Rejected' | 'Finished' | 'Discarded' | 'Numbered' | 'NumberAnnulled' | 'Annulled' | 'Delivered' | 'Derived' | 'Reassigned' | 'Dispatched' | 'DispatchReturned' | 'DispatchedByContingency' | 'Received' | 'EmailCopySent' | 'EmailCopyOpened' | 'DispositionRecorded' | 'TransparencyRedacted' | 'TransparencyPublished' | 'TransparencyExcluded' | 'TransparencyWithdrawn' | 'DraftReviewRequested' | 'DraftReviewApproved' | 'DraftReviewRejected' | 'DraftReviewCancelled';
 export declare const DocumentTrackingAction: {
     Created: "Created";
     Updated: "Updated";
@@ -60,6 +60,17 @@ export declare const DocumentTrackingAction: {
     TransparencyPublished: "TransparencyPublished";
     TransparencyExcluded: "TransparencyExcluded";
     TransparencyWithdrawn: "TransparencyWithdrawn";
+    DraftReviewRequested: "DraftReviewRequested";
+    DraftReviewApproved: "DraftReviewApproved";
+    DraftReviewRejected: "DraftReviewRejected";
+    DraftReviewCancelled: "DraftReviewCancelled";
+};
+export type DraftReviewStatus = 'Pending' | 'Approved' | 'Rejected' | 'Cancelled';
+export declare const DraftReviewStatus: {
+    Pending: "Pending";
+    Approved: "Approved";
+    Rejected: "Rejected";
+    Cancelled: "Cancelled";
 };
 export type DocumentOrigin = 'Internal' | 'DocDigital' | 'Manual';
 export declare const DocumentOrigin: {
@@ -220,7 +231,7 @@ export declare const DocumentAccessAction: {
     FileDownloaded: "FileDownloaded";
     TrailExported: "TrailExported";
 };
-export type AuditEntity = 'DocumentType' | 'IssuingEntity' | 'ArchivalSeries' | 'TextSnippet' | 'Holiday' | 'Procedure' | 'QualityMetric' | 'ServiceOutage' | 'Repository' | 'DataTreatment';
+export type AuditEntity = 'DocumentType' | 'IssuingEntity' | 'ArchivalSeries' | 'TextSnippet' | 'Holiday' | 'Procedure' | 'QualityMetric' | 'ServiceOutage' | 'Repository' | 'DataTreatment' | 'DocumentTemplate';
 export declare const AuditEntity: {
     DocumentType: "DocumentType";
     IssuingEntity: "IssuingEntity";
@@ -232,6 +243,7 @@ export declare const AuditEntity: {
     ServiceOutage: "ServiceOutage";
     Repository: "Repository";
     DataTreatment: "DataTreatment";
+    DocumentTemplate: "DocumentTemplate";
 };
 export type AuditAction = 'Created' | 'Updated' | 'Enabled' | 'Disabled' | 'Removed' | 'Exported';
 export declare const AuditAction: {
@@ -406,6 +418,8 @@ export interface DocumentTypeEntity {
     activeTransparency: boolean;
     transparencySection?: string | null;
     directorateCodeReference?: number | null;
+    draftReviewDirectorateCode?: number | null;
+    draftReviewDirectorateName?: string | null;
     archivalSeries?: ArchivalSeriesEntity | null;
     archivalSeriesId?: string | null;
     issuingEntity?: IssuingEntityEntity | null;
@@ -490,6 +504,7 @@ export interface DocumentEntity {
     dataRightsResponses?: DataRightsRequestEntity[];
     versions?: DocumentVersionEntity[];
     comments?: DocumentCommentEntity[];
+    draftReviews?: DocumentDraftReviewEntity[];
     accessRequestDeliveries?: AccessRequestDocumentEntity[];
     dispatch?: DocumentDispatchEntity | null;
     docDigitalInbound?: DocDigitalInboundEntity | null;
@@ -887,6 +902,46 @@ export interface TextSnippetEntity {
     createdAt: string;
     updatedAt: string;
 }
+export interface DocumentTemplateEntity {
+    id: string;
+    name: string;
+    description?: string | null;
+    documentTypeIds: string[];
+    content: JsonValue;
+    version: number;
+    enabled: boolean;
+    updatedByFullName?: string | null;
+    versions?: DocumentTemplateVersionEntity[];
+    deleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DocumentDraftReviewEntity {
+    id: string;
+    documentId: string;
+    document?: DocumentEntity;
+    round: number;
+    versionNumber: number;
+    directorateCodeReference: number;
+    directorateName: string;
+    reviewerEmployeeId: string;
+    reviewerFullName: string;
+    requestedByEmployeeId: string;
+    requestedByFullName: string;
+    requestedAt: string;
+    status: DraftReviewStatus;
+    observation?: string | null;
+    resolvedAt?: string | null;
+}
+export interface DocumentTemplateVersionEntity {
+    id: string;
+    templateId: string;
+    template?: DocumentTemplateEntity;
+    version: number;
+    content: JsonValue;
+    createdByFullName?: string | null;
+    createdAt: string;
+}
 export interface ArchivalSeriesEntity {
     id: string;
     code: string;

package/dist/base/entities.js

@@ -1,8 +1,8 @@
 "use strict";
 // This file was auto-generated by prisma-generator-typescript-interfaces
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DeskFileTarget = exports.DeskFileSource = exports.DataBreachNoticeMeans = exports.DataBreachEventAction = exports.DataBreachStatus = exports.DataBreachKind = exports.DataRightsEventAction = exports.DataRightsResolution = exports.DataRightsRequestStatus = exports.DataRightsChannel = exports.DataRight = exports.DataLegalBasis = exports.TransparencyStatus = exports.AccessRequestEventAction = exports.AccessRequestResolution = exports.AccessRequestStatus = exports.AccessRequestChannel = exports.DispositionKind = exports.FinalDisposition = exports.AuditAction = exports.AuditEntity = exports.DocumentAccessAction = exports.QualityMetricKey = exports.ServiceOutageKind = exports.WorkFolderItemKind = exports.TextSnippetSection = 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.CommunicationMeans = exports.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
-exports.MailAuthentication = exports.MailIntakeStatus = void 0;
+exports.DeskFileSource = exports.DataBreachNoticeMeans = exports.DataBreachEventAction = exports.DataBreachStatus = exports.DataBreachKind = exports.DataRightsEventAction = exports.DataRightsResolution = exports.DataRightsRequestStatus = exports.DataRightsChannel = exports.DataRight = exports.DataLegalBasis = exports.TransparencyStatus = exports.AccessRequestEventAction = exports.AccessRequestResolution = exports.AccessRequestStatus = exports.AccessRequestChannel = exports.DispositionKind = exports.FinalDisposition = exports.AuditAction = exports.AuditEntity = exports.DocumentAccessAction = exports.QualityMetricKey = exports.ServiceOutageKind = exports.WorkFolderItemKind = exports.TextSnippetSection = 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.CommunicationMeans = exports.DocumentOrigin = exports.DraftReviewStatus = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
+exports.MailAuthentication = exports.MailIntakeStatus = exports.DeskFileTarget = void 0;
 exports.DocumentCategory = {
     Decree: 'Decree',
     Communication: 'Communication',
@@ -59,6 +59,16 @@ exports.DocumentTrackingAction = {
     TransparencyPublished: 'TransparencyPublished',
     TransparencyExcluded: 'TransparencyExcluded',
     TransparencyWithdrawn: 'TransparencyWithdrawn',
+    DraftReviewRequested: 'DraftReviewRequested',
+    DraftReviewApproved: 'DraftReviewApproved',
+    DraftReviewRejected: 'DraftReviewRejected',
+    DraftReviewCancelled: 'DraftReviewCancelled',
+};
+exports.DraftReviewStatus = {
+    Pending: 'Pending',
+    Approved: 'Approved',
+    Rejected: 'Rejected',
+    Cancelled: 'Cancelled',
 };
 exports.DocumentOrigin = {
     Internal: 'Internal',
@@ -207,6 +217,7 @@ exports.AuditEntity = {
     ServiceOutage: 'ServiceOutage',
     Repository: 'Repository',
     DataTreatment: 'DataTreatment',
+    DocumentTemplate: 'DocumentTemplate',
 };
 exports.AuditAction = {
     Created: 'Created',

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

@@ -1,5 +1,5 @@
 import { type DocumentAccessAction, 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 DocumentEmailCopyIssuedEntity, type DocumentEmailCopyViewEntity, type DocumentReminderEntity, 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, type DocumentCommentResponseEntity, type DocumentCommentsResponseEntity, type DocumentVersionResponseEntity } from '../entities';
+import { type DocumentAnnulResponseEntity, type DocumentCloseDeliveryResponseEntity, type DocumentCreateResponseEntity, type DocumentDeriveResponseEntity, type DocumentDiscardResponseEntity, type DocumentEmailCopyIssuedEntity, type DocumentEmailCopyViewEntity, type DocumentReminderEntity, 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, type DocumentCommentResponseEntity, type DocumentCommentsResponseEntity, type DocumentVersionResponseEntity, type DocumentDraftReviewResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 /** Patrones NATS de `document`: `<servicio>.<recurso>.<acción>`. */
 export declare const DocumentPatterns: {
@@ -12,6 +12,8 @@ export declare const DocumentPatterns: {
     readonly review: "gestorDocumental.document.review";
     readonly signMany: "gestorDocumental.document.signMany";
     readonly reassign: "gestorDocumental.document.reassign";
+    readonly requestDraftReview: "gestorDocumental.document.requestDraftReview";
+    readonly resolveDraftReview: "gestorDocumental.document.resolveDraftReview";
     readonly discard: "gestorDocumental.document.discard";
     readonly annul: "gestorDocumental.document.annul";
     readonly derive: "gestorDocumental.document.derive";
@@ -42,7 +44,7 @@ export interface DocumentActor {
     departmentIds: string[];
 }
 /** Bandeja desde la que se lista. Todas son del funcionario (`actor`), salvo `all`. */
-export type DocumentBucket = 'created' | 'sent' | 'toVisa' | 'toSign' | 'participated' | 'all';
+export type DocumentBucket = 'created' | 'sent' | 'toVisa' | 'toSign' | 'participated' | 'toReview' | 'all';
 /**
  * Destinatario de un documento o de una derivación: una persona o un área completa. El gateway resuelve el nombre del
  * área y quiénes la integran hoy; el navegador solo indica cuál es.
@@ -256,6 +258,26 @@ export interface DocumentContract {
      * 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.
      */
+    /** El redactor pide la revisión del borrador; el gateway resuelve quién dirige hoy la dirección revisora. */
+    [DocumentPatterns.requestDraftReview]: {
+        payload: Pick<DocumentEntity, 'id'> & {
+            reviewer: {
+                employeeId: string;
+                fullName: string;
+            };
+            actor: DocumentActor;
+        };
+        response: DocumentDraftReviewResponseEntity;
+    };
+    /** La jefatura revisora aprueba o devuelve (con observaciones); el redactor puede retirar la solicitud. */
+    [DocumentPatterns.resolveDraftReview]: {
+        payload: Pick<DocumentEntity, 'id'> & {
+            decision: 'Approve' | 'Reject' | 'Cancel';
+            observation?: string | null;
+            actor: DocumentActor;
+        };
+        response: DocumentDraftReviewResponseEntity;
+    };
     [DocumentPatterns.reassign]: {
         payload: Pick<DocumentEntity, 'id'> & {
             participantId: DocumentParticipantEntity['id'];

package/dist/contracts/document.contract.js

@@ -12,6 +12,8 @@ exports.DocumentPatterns = {
     review: 'gestorDocumental.document.review',
     signMany: 'gestorDocumental.document.signMany',
     reassign: 'gestorDocumental.document.reassign',
+    requestDraftReview: 'gestorDocumental.document.requestDraftReview',
+    resolveDraftReview: 'gestorDocumental.document.resolveDraftReview',
     discard: 'gestorDocumental.document.discard',
     annul: 'gestorDocumental.document.annul',
     derive: 'gestorDocumental.document.derive',

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

@@ -0,0 +1,58 @@
+import { type DocumentTemplateEntity } from '../base/entities';
+import { type DocumentTemplateAvailableResponseEntity, type DocumentTemplateContent, type DocumentTemplateCreateResponseEntity, type DocumentTemplateGetAllResponseEntity, type DocumentTemplateGetByIdResponseEntity, type DocumentTemplateUpdateResponseEntity } from '../entities';
+import { type RpcPage } from './contract';
+/** Patrones NATS de `documentTemplate` (plantillas propias del editor): `<servicio>.<recurso>.<acción>`. */
+export declare const DocumentTemplatePatterns: {
+    readonly getAll: "gestorDocumental.documentTemplate.getAll";
+    readonly getById: "gestorDocumental.documentTemplate.getById";
+    readonly create: "gestorDocumental.documentTemplate.create";
+    readonly update: "gestorDocumental.documentTemplate.update";
+    readonly setEnabled: "gestorDocumental.documentTemplate.setEnabled";
+    readonly getAvailable: "gestorDocumental.documentTemplate.getAvailable";
+};
+/** Datos de una plantilla propia al crearla o editarla. */
+export interface DocumentTemplateWritePayload {
+    name: string;
+    description?: string | null;
+    documentTypeIds?: string[];
+    content: DocumentTemplateContent;
+    enabled?: boolean;
+}
+export interface DocumentTemplateContract {
+    [DocumentTemplatePatterns.getAll]: {
+        payload: {
+            pagination?: {
+                page?: number;
+                limit?: number;
+            };
+            filters?: {
+                search?: string;
+                enabled?: boolean;
+            };
+        };
+        response: RpcPage<DocumentTemplateGetAllResponseEntity[]>;
+    };
+    [DocumentTemplatePatterns.getById]: {
+        payload: Pick<DocumentTemplateEntity, 'id'>;
+        response: DocumentTemplateGetByIdResponseEntity;
+    };
+    [DocumentTemplatePatterns.create]: {
+        payload: DocumentTemplateWritePayload;
+        response: DocumentTemplateCreateResponseEntity;
+    };
+    [DocumentTemplatePatterns.update]: {
+        payload: DocumentTemplateWritePayload & Pick<DocumentTemplateEntity, 'id'>;
+        response: DocumentTemplateUpdateResponseEntity;
+    };
+    [DocumentTemplatePatterns.setEnabled]: {
+        payload: Pick<DocumentTemplateEntity, 'id' | 'enabled'>;
+        response: DocumentTemplateUpdateResponseEntity;
+    };
+    /** Las habilitadas que se ofrecen al redactar un documento del tipo (las de todos los tipos y las suyas). */
+    [DocumentTemplatePatterns.getAvailable]: {
+        payload: {
+            documentTypeId: string;
+        };
+        response: DocumentTemplateAvailableResponseEntity[];
+    };
+}

package/dist/contracts/documentTemplate.contract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentTemplatePatterns = void 0;
+/** Patrones NATS de `documentTemplate` (plantillas propias del editor): `<servicio>.<recurso>.<acción>`. */
+exports.DocumentTemplatePatterns = {
+    getAll: 'gestorDocumental.documentTemplate.getAll',
+    getById: 'gestorDocumental.documentTemplate.getById',
+    create: 'gestorDocumental.documentTemplate.create',
+    update: 'gestorDocumental.documentTemplate.update',
+    setEnabled: 'gestorDocumental.documentTemplate.setEnabled',
+    getAvailable: 'gestorDocumental.documentTemplate.getAvailable',
+};

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

@@ -39,6 +39,8 @@ export interface DocumentTypeWritePayload {
     activeTransparency?: boolean;
     transparencySection?: string | null;
     directorateCodeReference?: number | null;
+    draftReviewDirectorateCode?: number | null;
+    draftReviewDirectorateName?: string | null;
     archivalSeriesId?: string | null;
     issuingEntityId?: string | null;
     sharesNumberingWithId?: string | null;

package/dist/contracts/index.d.ts

@@ -4,6 +4,7 @@ import { type DocumentTypeContract } from './documentType.contract';
 import { type IssuingEntityContract } from './issuingEntity.contract';
 import { type ArchivalSeriesContract } from './archivalSeries.contract';
 import { type TextSnippetContract } from './textSnippet.contract';
+import { type DocumentTemplateContract } from './documentTemplate.contract';
 import { type HolidayContract } from './holiday.contract';
 import { type IndicatorsContract } from './indicators.contract';
 import { type AuditContract } from './audit.contract';
@@ -35,6 +36,7 @@ export * from './workFolder.contract';
 export * from './scan.contract';
 export * from './archivalSeries.contract';
 export * from './textSnippet.contract';
+export * from './documentTemplate.contract';
 export * from './holiday.contract';
 export * from './indicators.contract';
 export * from './audit.contract';
@@ -66,6 +68,8 @@ export declare const GestorDocumentalPatterns: {
         readonly review: "gestorDocumental.document.review";
         readonly signMany: "gestorDocumental.document.signMany";
         readonly reassign: "gestorDocumental.document.reassign";
+        readonly requestDraftReview: "gestorDocumental.document.requestDraftReview";
+        readonly resolveDraftReview: "gestorDocumental.document.resolveDraftReview";
         readonly discard: "gestorDocumental.document.discard";
         readonly annul: "gestorDocumental.document.annul";
         readonly derive: "gestorDocumental.document.derive";
@@ -192,6 +196,14 @@ export declare const GestorDocumentalPatterns: {
         readonly update: "gestorDocumental.textSnippet.update";
         readonly setEnabled: "gestorDocumental.textSnippet.setEnabled";
     };
+    readonly documentTemplate: {
+        readonly getAll: "gestorDocumental.documentTemplate.getAll";
+        readonly getById: "gestorDocumental.documentTemplate.getById";
+        readonly create: "gestorDocumental.documentTemplate.create";
+        readonly update: "gestorDocumental.documentTemplate.update";
+        readonly setEnabled: "gestorDocumental.documentTemplate.setEnabled";
+        readonly getAvailable: "gestorDocumental.documentTemplate.getAvailable";
+    };
     readonly holiday: {
         readonly getAll: "gestorDocumental.holiday.getAll";
         readonly create: "gestorDocumental.holiday.create";
@@ -288,4 +300,4 @@ export declare const GestorDocumentalPatterns: {
     };
 };
 /** 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 & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract & AccessRequestContract & TransparencyContract & DataProtectionContract & DeskContract & MailIntakeContract & PushContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & DocumentTemplateContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract & AccessRequestContract & TransparencyContract & DataProtectionContract & DeskContract & MailIntakeContract & PushContract;

package/dist/contracts/index.js

@@ -21,6 +21,7 @@ const documentType_contract_1 = require("./documentType.contract");
 const issuingEntity_contract_1 = require("./issuingEntity.contract");
 const archivalSeries_contract_1 = require("./archivalSeries.contract");
 const textSnippet_contract_1 = require("./textSnippet.contract");
+const documentTemplate_contract_1 = require("./documentTemplate.contract");
 const holiday_contract_1 = require("./holiday.contract");
 const indicators_contract_1 = require("./indicators.contract");
 const audit_contract_1 = require("./audit.contract");
@@ -52,6 +53,7 @@ __exportStar(require("./workFolder.contract"), exports);
 __exportStar(require("./scan.contract"), exports);
 __exportStar(require("./archivalSeries.contract"), exports);
 __exportStar(require("./textSnippet.contract"), exports);
+__exportStar(require("./documentTemplate.contract"), exports);
 __exportStar(require("./holiday.contract"), exports);
 __exportStar(require("./indicators.contract"), exports);
 __exportStar(require("./audit.contract"), exports);
@@ -78,6 +80,7 @@ exports.GestorDocumentalPatterns = {
     scan: scan_contract_1.ScanPatterns,
     archivalSeries: archivalSeries_contract_1.ArchivalSeriesPatterns,
     textSnippet: textSnippet_contract_1.TextSnippetPatterns,
+    documentTemplate: documentTemplate_contract_1.DocumentTemplatePatterns,
     holiday: holiday_contract_1.HolidayPatterns,
     indicators: indicators_contract_1.IndicatorsPatterns,
     audit: audit_contract_1.AuditPatterns,

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

@@ -181,6 +181,11 @@ export interface DocumentGetByIdResponseEntity {
     } | null;
     /** Contenido redactado en el sistema con una plantilla, para volver a editarlo (sin valor si se subió un PDF). */
     composition: DocumentComposition | null;
+    /**
+     * Revisión del borrador antes de enviarlo a tramitación, si su tipo la exige: qué dirección revisa, las rondas (la
+     * más reciente primero) y si la versión vigente ya está aprobada. `null` si el tipo no la exige.
+     */
+    draftReview: DocumentDraftReviewInfoEntity | null;
     replies: DocumentLinkEntity[];
     /** Expedientes en que está incorporado y que quien consulta puede ver. */
     caseFiles: {
@@ -227,6 +232,8 @@ export interface DocumentGetByIdResponseEntity {
         canReassign: boolean;
         /** Quien consulta redactó el documento (o lo ingresó, si llegó por DocDigital). */
         isAuthor: boolean;
+        /** Le toca aprobar o devolver el borrador: es la jefatura de la revisión pendiente. */
+        canResolveDraftReview: boolean;
         inbox: DocumentDeliveryResponseEntity[];
     };
     signatureRequiresOtp: boolean;
@@ -235,6 +242,8 @@ export interface DocumentGetByIdResponseEntity {
 export interface DocumentGetSummaryResponseEntity {
     toVisa: number;
     toSign: number;
+    /** Borradores que esperan su revisión (como jefatura de la dirección que los revisa). */
+    toReview: number;
     /** Lotes de firma con documentos en su turno (los documentos de un lote no se cuentan en `toVisa` ni `toSign`). */
     batches: {
         toVisa: number;
@@ -600,7 +609,8 @@ export interface DocumentCommentResponseEntity {
     text: string;
     authorEmployeeId: string;
     authorFullName: string;
-    authorRole: 'Author' | 'Visa' | 'Signature';
+    /** `Review`: la jefatura que revisa el borrador antes de enviarlo a tramitación. */
+    authorRole: 'Author' | 'Visa' | 'Signature' | 'Review';
     createdAt: string;
     resolvedAt: string | null;
     resolvedByFullName: string | null;
@@ -614,3 +624,40 @@ export interface DocumentCommentsResponseEntity {
     canComment: boolean;
     currentVersion: number;
 }
+/** Una ronda de revisión del borrador. */
+export interface DocumentDraftReviewRoundEntity {
+    id: string;
+    round: number;
+    /** Versión del borrador que se revisó. */
+    versionNumber: number;
+    directorateName: string;
+    reviewerEmployeeId: string;
+    reviewerFullName: string;
+    requestedByFullName: string;
+    requestedAt: string;
+    status: 'Pending' | 'Approved' | 'Rejected' | 'Cancelled';
+    observation: string | null;
+    resolvedAt: string | null;
+}
+/** La revisión del borrador que exige el tipo documental. */
+export interface DocumentDraftReviewInfoEntity {
+    directorateCodeReference: number;
+    directorateName: string;
+    rounds: DocumentDraftReviewRoundEntity[];
+    /** La versión vigente del borrador está aprobada: se puede enviar a tramitación. */
+    approved: boolean;
+    /** Hay una ronda esperando respuesta: el borrador no se edita mientras tanto. */
+    pending: boolean;
+}
+/** Resultado de pedir, resolver o retirar una revisión del borrador. */
+export interface DocumentDraftReviewResponseEntity {
+    id: string;
+    ok: boolean;
+    round: number;
+    status: DocumentDraftReviewRoundEntity['status'];
+    /** A quién avisar: la jefatura revisora (al pedirla) o el redactor (al resolverla). */
+    notify: {
+        employeeId: string;
+        fullName: string;
+    } | null;
+}

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

@@ -0,0 +1,51 @@
+import { type DocumentTemplateEntity } from '../../base/entities';
+import { type RichBlock, type RichField } from '../document/document.entity';
+/**
+ * Contenido de una plantilla propia: los bloques del editor (con sus partes fijas) y los campos que completa quien
+ * redacta (en la plantilla, sin valor).
+ */
+export interface DocumentTemplateContent {
+    blocks: RichBlock[];
+    fields: RichField[];
+}
+/** Plantilla propia en el listado de quien las administra. */
+export interface DocumentTemplateGetAllResponseEntity {
+    id: DocumentTemplateEntity['id'];
+    name: DocumentTemplateEntity['name'];
+    description: string | null;
+    /** Tipos documentales donde se ofrece; vacío, en todos. */
+    documentTypeIds: DocumentTemplateEntity['documentTypeIds'];
+    documentTypeNames: string[];
+    version: DocumentTemplateEntity['version'];
+    enabled: DocumentTemplateEntity['enabled'];
+    updatedAt: DocumentTemplateEntity['updatedAt'];
+    updatedByFullName: string | null;
+}
+/** Una versión del contenido de una plantilla. */
+export interface DocumentTemplateVersionResponseEntity {
+    version: number;
+    createdAt: string;
+    createdByFullName: string | null;
+}
+export interface DocumentTemplateGetByIdResponseEntity extends DocumentTemplateGetAllResponseEntity {
+    content: DocumentTemplateContent;
+    versions: DocumentTemplateVersionResponseEntity[];
+}
+/** Plantilla que se ofrece al redactar un documento de un tipo: con su contenido, lista para usar. */
+export interface DocumentTemplateAvailableResponseEntity {
+    id: DocumentTemplateEntity['id'];
+    name: DocumentTemplateEntity['name'];
+    description: string | null;
+    version: DocumentTemplateEntity['version'];
+    content: DocumentTemplateContent;
+}
+export interface DocumentTemplateCreateResponseEntity {
+    id: DocumentTemplateEntity['id'];
+    ok: boolean;
+}
+export interface DocumentTemplateUpdateResponseEntity {
+    id: DocumentTemplateEntity['id'];
+    ok: boolean;
+    /** Versión vigente: sube solo si cambió el contenido. */
+    version: number;
+}

package/dist/entities/documentTemplate/documentTemplate.entity.js

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

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

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

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

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

@@ -25,6 +25,8 @@ export interface DocumentTypeGetAllResponseEntity {
     activeTransparency: DocumentTypeEntity['activeTransparency'];
     transparencySection: DocumentTypeEntity['transparencySection'];
     directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
+    draftReviewDirectorateCode: DocumentTypeEntity['draftReviewDirectorateCode'];
+    draftReviewDirectorateName: DocumentTypeEntity['draftReviewDirectorateName'];
     archivalSeries: {
         id: string;
         code: string;

package/dist/entities/index.d.ts

@@ -22,3 +22,4 @@ export * from './dataProtection';
 export * from './desk';
 export * from './mailIntake';
 export * from './push';
+export * from './documentTemplate';

package/dist/entities/index.js

@@ -38,3 +38,4 @@ __exportStar(require("./dataProtection"), exports);
 __exportStar(require("./desk"), exports);
 __exportStar(require("./mailIntake"), exports);
 __exportStar(require("./push"), exports);
+__exportStar(require("./documentTemplate"), exports);

package/package.json

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

package/src/base/entities.ts

@@ -71,7 +71,11 @@ export type DocumentTrackingAction =
   | 'TransparencyRedacted'
   | 'TransparencyPublished'
   | 'TransparencyExcluded'
-  | 'TransparencyWithdrawn';
+  | 'TransparencyWithdrawn'
+  | 'DraftReviewRequested'
+  | 'DraftReviewApproved'
+  | 'DraftReviewRejected'
+  | 'DraftReviewCancelled';
 
 export const DocumentTrackingAction = {
   Created: 'Created',
@@ -99,8 +103,21 @@ export const DocumentTrackingAction = {
   TransparencyPublished: 'TransparencyPublished',
   TransparencyExcluded: 'TransparencyExcluded',
   TransparencyWithdrawn: 'TransparencyWithdrawn',
+  DraftReviewRequested: 'DraftReviewRequested',
+  DraftReviewApproved: 'DraftReviewApproved',
+  DraftReviewRejected: 'DraftReviewRejected',
+  DraftReviewCancelled: 'DraftReviewCancelled',
 } satisfies Record<string, DocumentTrackingAction>;
 
+export type DraftReviewStatus = 'Pending' | 'Approved' | 'Rejected' | 'Cancelled';
+
+export const DraftReviewStatus = {
+  Pending: 'Pending',
+  Approved: 'Approved',
+  Rejected: 'Rejected',
+  Cancelled: 'Cancelled',
+} satisfies Record<string, DraftReviewStatus>;
+
 export type DocumentOrigin = 'Internal' | 'DocDigital' | 'Manual';
 
 export const DocumentOrigin = {
@@ -344,7 +361,8 @@ export type AuditEntity =
   | 'QualityMetric'
   | 'ServiceOutage'
   | 'Repository'
-  | 'DataTreatment';
+  | 'DataTreatment'
+  | 'DocumentTemplate';
 
 export const AuditEntity = {
   DocumentType: 'DocumentType',
@@ -357,6 +375,7 @@ export const AuditEntity = {
   ServiceOutage: 'ServiceOutage',
   Repository: 'Repository',
   DataTreatment: 'DataTreatment',
+  DocumentTemplate: 'DocumentTemplate',
 } satisfies Record<string, AuditEntity>;
 
 export type AuditAction = 'Created' | 'Updated' | 'Enabled' | 'Disabled' | 'Removed' | 'Exported';
@@ -598,6 +617,8 @@ export interface DocumentTypeEntity {
   activeTransparency: boolean;
   transparencySection?: string | null;
   directorateCodeReference?: number | null;
+  draftReviewDirectorateCode?: number | null;
+  draftReviewDirectorateName?: string | null;
   archivalSeries?: ArchivalSeriesEntity | null;
   archivalSeriesId?: string | null;
   issuingEntity?: IssuingEntityEntity | null;
@@ -683,6 +704,7 @@ export interface DocumentEntity {
   dataRightsResponses?: DataRightsRequestEntity[];
   versions?: DocumentVersionEntity[];
   comments?: DocumentCommentEntity[];
+  draftReviews?: DocumentDraftReviewEntity[];
   accessRequestDeliveries?: AccessRequestDocumentEntity[];
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
@@ -1106,6 +1128,49 @@ export interface TextSnippetEntity {
   updatedAt: string;
 }
 
+export interface DocumentTemplateEntity {
+  id: string;
+  name: string;
+  description?: string | null;
+  documentTypeIds: string[];
+  content: JsonValue;
+  version: number;
+  enabled: boolean;
+  updatedByFullName?: string | null;
+  versions?: DocumentTemplateVersionEntity[];
+  deleted: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface DocumentDraftReviewEntity {
+  id: string;
+  documentId: string;
+  document?: DocumentEntity;
+  round: number;
+  versionNumber: number;
+  directorateCodeReference: number;
+  directorateName: string;
+  reviewerEmployeeId: string;
+  reviewerFullName: string;
+  requestedByEmployeeId: string;
+  requestedByFullName: string;
+  requestedAt: string;
+  status: DraftReviewStatus;
+  observation?: string | null;
+  resolvedAt?: string | null;
+}
+
+export interface DocumentTemplateVersionEntity {
+  id: string;
+  templateId: string;
+  template?: DocumentTemplateEntity;
+  version: number;
+  content: JsonValue;
+  createdByFullName?: string | null;
+  createdAt: string;
+}
+
 export interface ArchivalSeriesEntity {
   id: string;
   code: string;

package/src/contracts/document.contract.ts

@@ -34,6 +34,7 @@ import {
   type DocumentCommentResponseEntity,
   type DocumentCommentsResponseEntity,
   type DocumentVersionResponseEntity,
+  type DocumentDraftReviewResponseEntity,
 } from '../entities';
 import { type RpcPage } from './contract';
 
@@ -48,6 +49,8 @@ export const DocumentPatterns = {
   review: 'gestorDocumental.document.review',
   signMany: 'gestorDocumental.document.signMany',
   reassign: 'gestorDocumental.document.reassign',
+  requestDraftReview: 'gestorDocumental.document.requestDraftReview',
+  resolveDraftReview: 'gestorDocumental.document.resolveDraftReview',
   discard: 'gestorDocumental.document.discard',
   annul: 'gestorDocumental.document.annul',
   derive: 'gestorDocumental.document.derive',
@@ -86,6 +89,7 @@ export type DocumentBucket =
   | 'toVisa' // le toca visarlos
   | 'toSign' // le toca firmarlos
   | 'participated' // ya los visó, firmó o rechazó
+  | 'toReview' // borradores que le toca revisar como jefatura de la dirección revisora
   | 'all'; // todos los que están en tramitación o finalizados (historial)
 
 /**
@@ -286,6 +290,23 @@ export interface DocumentContract {
    * 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.
    */
+  /** El redactor pide la revisión del borrador; el gateway resuelve quién dirige hoy la dirección revisora. */
+  [DocumentPatterns.requestDraftReview]: {
+    payload: Pick<DocumentEntity, 'id'> & {
+      reviewer: { employeeId: string; fullName: string };
+      actor: DocumentActor;
+    };
+    response: DocumentDraftReviewResponseEntity;
+  };
+  /** La jefatura revisora aprueba o devuelve (con observaciones); el redactor puede retirar la solicitud. */
+  [DocumentPatterns.resolveDraftReview]: {
+    payload: Pick<DocumentEntity, 'id'> & {
+      decision: 'Approve' | 'Reject' | 'Cancel';
+      observation?: string | null;
+      actor: DocumentActor;
+    };
+    response: DocumentDraftReviewResponseEntity;
+  };
   [DocumentPatterns.reassign]: {
     payload: Pick<DocumentEntity, 'id'> & {
       participantId: DocumentParticipantEntity['id'];

package/src/contracts/documentTemplate.contract.ts

@@ -0,0 +1,61 @@
+import { type DocumentTemplateEntity } from '../base/entities';
+import {
+  type DocumentTemplateAvailableResponseEntity,
+  type DocumentTemplateContent,
+  type DocumentTemplateCreateResponseEntity,
+  type DocumentTemplateGetAllResponseEntity,
+  type DocumentTemplateGetByIdResponseEntity,
+  type DocumentTemplateUpdateResponseEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+
+/** Patrones NATS de `documentTemplate` (plantillas propias del editor): `<servicio>.<recurso>.<acción>`. */
+export const DocumentTemplatePatterns = {
+  getAll: 'gestorDocumental.documentTemplate.getAll',
+  getById: 'gestorDocumental.documentTemplate.getById',
+  create: 'gestorDocumental.documentTemplate.create',
+  update: 'gestorDocumental.documentTemplate.update',
+  setEnabled: 'gestorDocumental.documentTemplate.setEnabled',
+  getAvailable: 'gestorDocumental.documentTemplate.getAvailable',
+} as const;
+
+/** Datos de una plantilla propia al crearla o editarla. */
+export interface DocumentTemplateWritePayload {
+  name: string;
+  description?: string | null;
+  documentTypeIds?: string[];
+  content: DocumentTemplateContent;
+  enabled?: boolean;
+}
+
+export interface DocumentTemplateContract {
+  [DocumentTemplatePatterns.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<DocumentTemplateGetAllResponseEntity[]>;
+  };
+  [DocumentTemplatePatterns.getById]: {
+    payload: Pick<DocumentTemplateEntity, 'id'>;
+    response: DocumentTemplateGetByIdResponseEntity;
+  };
+  [DocumentTemplatePatterns.create]: {
+    payload: DocumentTemplateWritePayload;
+    response: DocumentTemplateCreateResponseEntity;
+  };
+  [DocumentTemplatePatterns.update]: {
+    payload: DocumentTemplateWritePayload & Pick<DocumentTemplateEntity, 'id'>;
+    response: DocumentTemplateUpdateResponseEntity;
+  };
+  [DocumentTemplatePatterns.setEnabled]: {
+    payload: Pick<DocumentTemplateEntity, 'id' | 'enabled'>;
+    response: DocumentTemplateUpdateResponseEntity;
+  };
+  /** Las habilitadas que se ofrecen al redactar un documento del tipo (las de todos los tipos y las suyas). */
+  [DocumentTemplatePatterns.getAvailable]: {
+    payload: { documentTypeId: string };
+    response: DocumentTemplateAvailableResponseEntity[];
+  };
+}

package/src/contracts/documentType.contract.ts

@@ -44,6 +44,10 @@ export interface DocumentTypeWritePayload {
   activeTransparency?: boolean;
   transparencySection?: string | null;
   directorateCodeReference?: number | null;
+  // Dirección cuya jefatura revisa los borradores antes de enviarlos (sin valor: sin revisión). El nombre lo pone el
+  // gateway desde caschile-ms.
+  draftReviewDirectorateCode?: number | null;
+  draftReviewDirectorateName?: string | null;
   // Serie documental del Cuadro de Clasificación (sin valor: sin clasificar).
   archivalSeriesId?: string | null;
   // Entidad emisora (sin valor: la municipalidad).

package/src/contracts/index.ts

@@ -4,6 +4,7 @@ import { DocumentTypePatterns, type DocumentTypeContract } from './documentType.
 import { IssuingEntityPatterns, type IssuingEntityContract } from './issuingEntity.contract';
 import { ArchivalSeriesPatterns, type ArchivalSeriesContract } from './archivalSeries.contract';
 import { TextSnippetPatterns, type TextSnippetContract } from './textSnippet.contract';
+import { DocumentTemplatePatterns, type DocumentTemplateContract } from './documentTemplate.contract';
 import { HolidayPatterns, type HolidayContract } from './holiday.contract';
 import { IndicatorsPatterns, type IndicatorsContract } from './indicators.contract';
 import { AuditPatterns, type AuditContract } from './audit.contract';
@@ -36,6 +37,7 @@ export * from './workFolder.contract';
 export * from './scan.contract';
 export * from './archivalSeries.contract';
 export * from './textSnippet.contract';
+export * from './documentTemplate.contract';
 export * from './holiday.contract';
 export * from './indicators.contract';
 export * from './audit.contract';
@@ -63,6 +65,7 @@ export const GestorDocumentalPatterns = {
   scan: ScanPatterns,
   archivalSeries: ArchivalSeriesPatterns,
   textSnippet: TextSnippetPatterns,
+  documentTemplate: DocumentTemplatePatterns,
   holiday: HolidayPatterns,
   indicators: IndicatorsPatterns,
   audit: AuditPatterns,
@@ -90,6 +93,7 @@ export type GestorDocumentalContract = DocumentTypeContract &
   ScanContract &
   ArchivalSeriesContract &
   TextSnippetContract &
+  DocumentTemplateContract &
   HolidayContract &
   IndicatorsContract &
   AuditContract &

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

@@ -212,6 +212,11 @@ export interface DocumentGetByIdResponseEntity {
   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;
+  /**
+   * Revisión del borrador antes de enviarlo a tramitación, si su tipo la exige: qué dirección revisa, las rondas (la
+   * más reciente primero) y si la versión vigente ya está aprobada. `null` si el tipo no la exige.
+   */
+  draftReview: DocumentDraftReviewInfoEntity | null;
   replies: DocumentLinkEntity[];
   /** Expedientes en que está incorporado y que quien consulta puede ver. */
   caseFiles: { id: string; code: string; title: string; status: 'Open' | 'Closed' }[];
@@ -259,6 +264,8 @@ export interface DocumentGetByIdResponseEntity {
     canReassign: boolean;
     /** Quien consulta redactó el documento (o lo ingresó, si llegó por DocDigital). */
     isAuthor: boolean;
+    /** Le toca aprobar o devolver el borrador: es la jefatura de la revisión pendiente. */
+    canResolveDraftReview: boolean;
     // Sus propias entregas de este documento (puede tener más de una si además se lo derivaron).
     inbox: DocumentDeliveryResponseEntity[];
   };
@@ -270,6 +277,8 @@ export interface DocumentGetByIdResponseEntity {
 export interface DocumentGetSummaryResponseEntity {
   toVisa: number;
   toSign: number;
+  /** Borradores que esperan su revisión (como jefatura de la dirección que los revisa). */
+  toReview: 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: {
@@ -625,7 +634,8 @@ export interface DocumentCommentResponseEntity {
   text: string;
   authorEmployeeId: string;
   authorFullName: string;
-  authorRole: 'Author' | 'Visa' | 'Signature';
+  /** `Review`: la jefatura que revisa el borrador antes de enviarlo a tramitación. */
+  authorRole: 'Author' | 'Visa' | 'Signature' | 'Review';
   createdAt: string;
   resolvedAt: string | null;
   resolvedByFullName: string | null;
@@ -640,3 +650,40 @@ export interface DocumentCommentsResponseEntity {
   canComment: boolean;
   currentVersion: number;
 }
+
+/** Una ronda de revisión del borrador. */
+export interface DocumentDraftReviewRoundEntity {
+  id: string;
+  round: number;
+  /** Versión del borrador que se revisó. */
+  versionNumber: number;
+  directorateName: string;
+  reviewerEmployeeId: string;
+  reviewerFullName: string;
+  requestedByFullName: string;
+  requestedAt: string;
+  status: 'Pending' | 'Approved' | 'Rejected' | 'Cancelled';
+  observation: string | null;
+  resolvedAt: string | null;
+}
+
+/** La revisión del borrador que exige el tipo documental. */
+export interface DocumentDraftReviewInfoEntity {
+  directorateCodeReference: number;
+  directorateName: string;
+  rounds: DocumentDraftReviewRoundEntity[];
+  /** La versión vigente del borrador está aprobada: se puede enviar a tramitación. */
+  approved: boolean;
+  /** Hay una ronda esperando respuesta: el borrador no se edita mientras tanto. */
+  pending: boolean;
+}
+
+/** Resultado de pedir, resolver o retirar una revisión del borrador. */
+export interface DocumentDraftReviewResponseEntity {
+  id: string;
+  ok: boolean;
+  round: number;
+  status: DocumentDraftReviewRoundEntity['status'];
+  /** A quién avisar: la jefatura revisora (al pedirla) o el redactor (al resolverla). */
+  notify: { employeeId: string; fullName: string } | null;
+}

package/src/entities/documentTemplate/documentTemplate.entity.ts

@@ -0,0 +1,58 @@
+import { type DocumentTemplateEntity } from '../../base/entities';
+import { type RichBlock, type RichField } from '../document/document.entity';
+
+/**
+ * Contenido de una plantilla propia: los bloques del editor (con sus partes fijas) y los campos que completa quien
+ * redacta (en la plantilla, sin valor).
+ */
+export interface DocumentTemplateContent {
+  blocks: RichBlock[];
+  fields: RichField[];
+}
+
+/** Plantilla propia en el listado de quien las administra. */
+export interface DocumentTemplateGetAllResponseEntity {
+  id: DocumentTemplateEntity['id'];
+  name: DocumentTemplateEntity['name'];
+  description: string | null;
+  /** Tipos documentales donde se ofrece; vacío, en todos. */
+  documentTypeIds: DocumentTemplateEntity['documentTypeIds'];
+  documentTypeNames: string[];
+  version: DocumentTemplateEntity['version'];
+  enabled: DocumentTemplateEntity['enabled'];
+  updatedAt: DocumentTemplateEntity['updatedAt'];
+  updatedByFullName: string | null;
+}
+
+/** Una versión del contenido de una plantilla. */
+export interface DocumentTemplateVersionResponseEntity {
+  version: number;
+  createdAt: string;
+  createdByFullName: string | null;
+}
+
+export interface DocumentTemplateGetByIdResponseEntity extends DocumentTemplateGetAllResponseEntity {
+  content: DocumentTemplateContent;
+  versions: DocumentTemplateVersionResponseEntity[];
+}
+
+/** Plantilla que se ofrece al redactar un documento de un tipo: con su contenido, lista para usar. */
+export interface DocumentTemplateAvailableResponseEntity {
+  id: DocumentTemplateEntity['id'];
+  name: DocumentTemplateEntity['name'];
+  description: string | null;
+  version: DocumentTemplateEntity['version'];
+  content: DocumentTemplateContent;
+}
+
+export interface DocumentTemplateCreateResponseEntity {
+  id: DocumentTemplateEntity['id'];
+  ok: boolean;
+}
+
+export interface DocumentTemplateUpdateResponseEntity {
+  id: DocumentTemplateEntity['id'];
+  ok: boolean;
+  /** Versión vigente: sube solo si cambió el contenido. */
+  version: number;
+}

package/src/entities/documentTemplate/index.ts

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

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

@@ -30,6 +30,9 @@ export interface DocumentTypeGetAllResponseEntity {
   activeTransparency: DocumentTypeEntity['activeTransparency'];
   transparencySection: DocumentTypeEntity['transparencySection'];
   directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
+  // Dirección cuya jefatura revisa los borradores antes de enviarlos a tramitación (sin valor: no hay revisión).
+  draftReviewDirectorateCode: DocumentTypeEntity['draftReviewDirectorateCode'];
+  draftReviewDirectorateName: DocumentTypeEntity['draftReviewDirectorateName'];
   // 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.

package/src/entities/index.ts

@@ -22,3 +22,4 @@ export * from './dataProtection';
 export * from './desk';
 export * from './mailIntake';
 export * from './push';
+export * from './documentTemplate';