@muni-sanfer/types-gestor-documental 0.0.1-beta.38 → 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: {
@@ -407,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;
@@ -491,6 +504,7 @@ export interface DocumentEntity {
     dataRightsResponses?: DataRightsRequestEntity[];
     versions?: DocumentVersionEntity[];
     comments?: DocumentCommentEntity[];
+    draftReviews?: DocumentDraftReviewEntity[];
     accessRequestDeliveries?: AccessRequestDocumentEntity[];
     dispatch?: DocumentDispatchEntity | null;
     docDigitalInbound?: DocDigitalInboundEntity | null;
@@ -902,6 +916,23 @@ export interface DocumentTemplateEntity {
     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;

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',

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/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

@@ -68,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";

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

@@ -1,6 +1,6 @@
 {
   "name": "@muni-sanfer/types-gestor-documental",
-  "version": "0.0.1-beta.38",
+  "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 = {
@@ -600,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;
@@ -685,6 +704,7 @@ export interface DocumentEntity {
   dataRightsResponses?: DataRightsRequestEntity[];
   versions?: DocumentVersionEntity[];
   comments?: DocumentCommentEntity[];
+  draftReviews?: DocumentDraftReviewEntity[];
   accessRequestDeliveries?: AccessRequestDocumentEntity[];
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
@@ -1123,6 +1143,24 @@ export interface DocumentTemplateEntity {
   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;

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/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/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/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.