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

package/dist/base/entities.d.ts

@@ -405,6 +405,22 @@ export declare const MailAuthentication: {
     Fail: "Fail";
     Unknown: "Unknown";
 };
+export type DraftingRequestStatus = 'Pending' | 'Taken' | 'Declined' | 'Cancelled';
+export declare const DraftingRequestStatus: {
+    Pending: "Pending";
+    Taken: "Taken";
+    Declined: "Declined";
+    Cancelled: "Cancelled";
+};
+export type DraftingRequestEventAction = 'Created' | 'Taken' | 'Released' | 'Declined' | 'Cancelled' | 'DocumentLinked';
+export declare const DraftingRequestEventAction: {
+    Created: "Created";
+    Taken: "Taken";
+    Released: "Released";
+    Declined: "Declined";
+    Cancelled: "Cancelled";
+    DocumentLinked: "DocumentLinked";
+};
 export interface DocumentTypeEntity {
     id: string;
     name: string;
@@ -429,6 +445,7 @@ export interface DocumentTypeEntity {
     numberingMembers?: DocumentTypeEntity[];
     enabled: boolean;
     documents?: DocumentEntity[];
+    draftingRequests?: DraftingRequestEntity[];
     annulledNumbers?: DocumentAnnulledNumberEntity[];
     flowSteps?: DocumentTypeFlowStepEntity[];
     signatureBatches?: SignatureBatchEntity[];
@@ -505,6 +522,7 @@ export interface DocumentEntity {
     versions?: DocumentVersionEntity[];
     comments?: DocumentCommentEntity[];
     draftReviews?: DocumentDraftReviewEntity[];
+    draftingRequest?: DraftingRequestEntity | null;
     accessRequestDeliveries?: AccessRequestDocumentEntity[];
     dispatch?: DocumentDispatchEntity | null;
     docDigitalInbound?: DocDigitalInboundEntity | null;
@@ -1348,6 +1366,57 @@ export interface DocumentCommentEntity {
     resolutionNote?: string | null;
     createdAt: string;
 }
+export interface DraftingRequestEntity {
+    id: string;
+    number: number;
+    year: number;
+    subject: string;
+    details: string;
+    documentTypeId?: string | null;
+    documentType?: DocumentTypeEntity | null;
+    dueAt?: string | null;
+    requesterEmployeeId: string;
+    requesterFullName: string;
+    requesterAreaName?: string | null;
+    targetDirectorateCode: number;
+    targetDirectorateName: string;
+    status: DraftingRequestStatus;
+    takenByEmployeeId?: string | null;
+    takenByFullName?: string | null;
+    takenAt?: string | null;
+    closedAt?: string | null;
+    closingNote?: string | null;
+    documentId?: string | null;
+    document?: DocumentEntity | null;
+    recipients?: DraftingRequestRecipientEntity[];
+    attachments?: DraftingRequestAttachmentEntity[];
+    events?: DraftingRequestEventEntity[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DraftingRequestRecipientEntity {
+    id: string;
+    requestId: string;
+    request?: DraftingRequestEntity;
+    employeeId: string;
+}
+export interface DraftingRequestAttachmentEntity {
+    id: string;
+    requestId: string;
+    request?: DraftingRequestEntity;
+    fileId: string;
+    name: string;
+}
+export interface DraftingRequestEventEntity {
+    id: string;
+    requestId: string;
+    request?: DraftingRequestEntity;
+    action: DraftingRequestEventAction;
+    note?: string | null;
+    employeeId: string;
+    employeeFullName: string;
+    createdAt: string;
+}
 type JsonValue = string | number | boolean | {
     [key in string]?: JsonValue;
 } | Array<JsonValue> | null;

package/dist/base/entities.js

@@ -2,7 +2,7 @@
 // This file was auto-generated by prisma-generator-typescript-interfaces
 Object.defineProperty(exports, "__esModule", { value: true });
 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.DraftingRequestEventAction = exports.DraftingRequestStatus = exports.MailAuthentication = exports.MailIntakeStatus = exports.DeskFileTarget = void 0;
 exports.DocumentCategory = {
     Decree: 'Decree',
     Communication: 'Communication',
@@ -357,3 +357,17 @@ exports.MailAuthentication = {
     Fail: 'Fail',
     Unknown: 'Unknown',
 };
+exports.DraftingRequestStatus = {
+    Pending: 'Pending',
+    Taken: 'Taken',
+    Declined: 'Declined',
+    Cancelled: 'Cancelled',
+};
+exports.DraftingRequestEventAction = {
+    Created: 'Created',
+    Taken: 'Taken',
+    Released: 'Released',
+    Declined: 'Declined',
+    Cancelled: 'Cancelled',
+    DocumentLinked: 'DocumentLinked',
+};

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

@@ -75,6 +75,8 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
     keywords: string[];
     /** Qué cambió, si el guardado crea una versión nueva (otro PDF, otro texto u otro asunto). */
     versionNote?: string | null;
+    /** Al crearlo: solicitud de redacción que atiende (la tomó quien redacta). */
+    draftingRequestId?: string | null;
     accessLevel?: DocumentAccessLevel;
     hasSensitiveData?: boolean;
     directorateCodeReference?: number | null;

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

@@ -0,0 +1,94 @@
+import { type DraftingRequestDetailEntity, type DraftingRequestListItemEntity } from '../entities';
+import { type RpcPage } from './contract';
+/** Patrones NATS de `draftingRequest`: solicitudes de redacción entre áreas. */
+export declare const DraftingRequestPatterns: {
+    readonly getAll: "gestorDocumental.draftingRequest.getAll";
+    readonly getById: "gestorDocumental.draftingRequest.getById";
+    readonly create: "gestorDocumental.draftingRequest.create";
+    readonly act: "gestorDocumental.draftingRequest.act";
+    readonly getAttachmentFile: "gestorDocumental.draftingRequest.getAttachmentFile";
+};
+/** Quien consulta o actúa: el funcionario de la sesión, con su nombre. */
+export interface DraftingRequestActor {
+    employeeId: string;
+    fullName: string;
+}
+/**
+ * Bandeja: las que le llegaron a su dirección, las que tomó o las que pidió. `state`: abiertas (sin tomar, tomadas o
+ * en redacción), cerradas (atendidas, devueltas o retiradas) o todas.
+ */
+export type DraftingRequestBox = 'received' | 'taken' | 'sent';
+export interface DraftingRequestCreatePayload {
+    subject: string;
+    details: string;
+    documentTypeId?: string | null;
+    dueAt?: string | null;
+    attachments?: {
+        fileId: string;
+        name: string;
+    }[];
+    /** Dirección a la que se pide, con el nombre que le pone el gateway. */
+    targetDirectorateCode: number;
+    targetDirectorateName: string;
+    /** Quienes la integran hoy, resueltos por el gateway (sin quien la pide). */
+    recipientEmployeeIds: string[];
+    requesterAreaName?: string | null;
+    actor: DraftingRequestActor;
+}
+/** Lo que se hace con una solicitud, un paso a la vez. */
+export type DraftingRequestAction = {
+    type: 'take';
+} | {
+    type: 'release';
+    note?: string | null;
+} | {
+    type: 'decline';
+    note: string;
+} | {
+    type: 'cancel';
+    note?: string | null;
+};
+export interface DraftingRequestContract {
+    [DraftingRequestPatterns.getAll]: {
+        payload: {
+            box: DraftingRequestBox;
+            state?: 'open' | 'closed' | 'all';
+            search?: string;
+            page?: number;
+            limit?: number;
+            actor: Pick<DraftingRequestActor, 'employeeId'>;
+        };
+        response: RpcPage<DraftingRequestListItemEntity[]>;
+    };
+    [DraftingRequestPatterns.getById]: {
+        payload: {
+            id: string;
+            actor: Pick<DraftingRequestActor, 'employeeId'>;
+        };
+        response: DraftingRequestDetailEntity;
+    };
+    [DraftingRequestPatterns.create]: {
+        payload: DraftingRequestCreatePayload;
+        response: DraftingRequestDetailEntity;
+    };
+    [DraftingRequestPatterns.act]: {
+        payload: {
+            id: string;
+            action: DraftingRequestAction;
+            actor: DraftingRequestActor;
+        };
+        response: DraftingRequestDetailEntity;
+    };
+    /** Archivo adjunto, con las mismas reglas de acceso del detalle. */
+    [DraftingRequestPatterns.getAttachmentFile]: {
+        payload: {
+            id: string;
+            attachmentId: string;
+            actor: Pick<DraftingRequestActor, 'employeeId'>;
+        };
+        response: {
+            fileId: string;
+            fileName: string;
+        };
+    };
+}

package/dist/contracts/draftingRequest.contract.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DraftingRequestPatterns = void 0;
+/** Patrones NATS de `draftingRequest`: solicitudes de redacción entre áreas. */
+exports.DraftingRequestPatterns = {
+    getAll: 'gestorDocumental.draftingRequest.getAll',
+    getById: 'gestorDocumental.draftingRequest.getById',
+    create: 'gestorDocumental.draftingRequest.create',
+    act: 'gestorDocumental.draftingRequest.act',
+    getAttachmentFile: 'gestorDocumental.draftingRequest.getAttachmentFile',
+};

package/dist/contracts/index.d.ts

@@ -23,6 +23,7 @@ import { type ProcedureContract } from './procedure.contract';
 import { type RegisterBookContract } from './registerBook.contract';
 import { type SignatureBatchContract } from './signatureBatch.contract';
 import { type WorkFolderContract } from './workFolder.contract';
+import { type DraftingRequestContract } from './draftingRequest.contract';
 export * from './contract';
 export * from './document.contract';
 export * from './documentType.contract';
@@ -49,6 +50,7 @@ export * from './dataProtection.contract';
 export * from './desk.contract';
 export * from './mailIntake.contract';
 export * from './push.contract';
+export * from './draftingRequest.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -298,6 +300,13 @@ export declare const GestorDocumentalPatterns: {
         readonly test: "gestorDocumental.push.test";
         readonly send: "gestorDocumental.push.send";
     };
+    readonly draftingRequest: {
+        readonly getAll: "gestorDocumental.draftingRequest.getAll";
+        readonly getById: "gestorDocumental.draftingRequest.getById";
+        readonly create: "gestorDocumental.draftingRequest.create";
+        readonly act: "gestorDocumental.draftingRequest.act";
+        readonly getAttachmentFile: "gestorDocumental.draftingRequest.getAttachmentFile";
+    };
 };
 /** 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 & DocumentTemplateContract & 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 & DraftingRequestContract;

package/dist/contracts/index.js

@@ -40,6 +40,7 @@ const procedure_contract_1 = require("./procedure.contract");
 const registerBook_contract_1 = require("./registerBook.contract");
 const signatureBatch_contract_1 = require("./signatureBatch.contract");
 const workFolder_contract_1 = require("./workFolder.contract");
+const draftingRequest_contract_1 = require("./draftingRequest.contract");
 __exportStar(require("./contract"), exports);
 __exportStar(require("./document.contract"), exports);
 __exportStar(require("./documentType.contract"), exports);
@@ -66,6 +67,7 @@ __exportStar(require("./dataProtection.contract"), exports);
 __exportStar(require("./desk.contract"), exports);
 __exportStar(require("./mailIntake.contract"), exports);
 __exportStar(require("./push.contract"), exports);
+__exportStar(require("./draftingRequest.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -93,4 +95,5 @@ exports.GestorDocumentalPatterns = {
     desk: desk_contract_1.DeskPatterns,
     mailIntake: mailIntake_contract_1.MailIntakePatterns,
     push: push_contract_1.PushPatterns,
+    draftingRequest: draftingRequest_contract_1.DraftingRequestPatterns,
 };

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

@@ -1,4 +1,5 @@
 import { type CommunicationMeans, DocumentAnnulledNumberEntity, DocumentAttachmentEntity, DocumentDeliveryEntity, DocumentEntity, DocumentParticipantEntity, DocumentRecipientEntity, type DocumentStatus, DocumentTrackingEntity, DocumentTypeEntity } from '../../base/entities';
+import { type DocumentDraftingRequestEntity } from '../draftingRequest/draftingRequest.entity';
 /** Tipo documental de un documento, con lo necesario para citarlo. */
 export interface DocumentTypeSummaryEntity {
     id: DocumentTypeEntity['id'];
@@ -186,6 +187,8 @@ export interface DocumentGetByIdResponseEntity {
      * más reciente primero) y si la versión vigente ya está aprobada. `null` si el tipo no la exige.
      */
     draftReview: DocumentDraftReviewInfoEntity | null;
+    /** Solicitud de redacción que atiende, si se redactó a pedido de otra área. */
+    draftingRequest: DocumentDraftingRequestEntity | null;
     replies: DocumentLinkEntity[];
     /** Expedientes en que está incorporado y que quien consulta puede ver. */
     caseFiles: {
@@ -244,6 +247,11 @@ export interface DocumentGetSummaryResponseEntity {
     toSign: number;
     /** Borradores que esperan su revisión (como jefatura de la dirección que los revisa). */
     toReview: number;
+    /** Solicitudes de redacción: sin tomar dirigidas a su dirección, y tomadas por él aún sin atender. */
+    draftingRequests: {
+        pending: number;
+        taken: number;
+    };
     /** Lotes de firma con documentos en su turno (los documentos de un lote no se cuentan en `toVisa` ni `toSign`). */
     batches: {
         toVisa: number;

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

@@ -0,0 +1,76 @@
+import { type DocumentStatus, type DraftingRequestEventAction, type DraftingRequestStatus } from '../../base/entities';
+/**
+ * Cómo va la solicitud, para mostrarla: sin tomar, tomada (aún sin documento), en redacción (con documento en curso),
+ * atendida (su documento quedó finalizado), devuelta o retirada.
+ */
+export type DraftingRequestState = 'Pending' | 'Taken' | 'Drafting' | 'Completed' | 'Declined' | 'Cancelled';
+/** Documento que atiende la solicitud. */
+export interface DraftingRequestDocumentEntity {
+    id: string;
+    status: DocumentStatus;
+    /** «D.E. N° 590/2026», o `null` mientras no tiene número. */
+    folio: string | null;
+}
+export interface DraftingRequestListItemEntity {
+    id: string;
+    /** «N° 3/2026». */
+    label: string;
+    subject: string;
+    status: DraftingRequestStatus;
+    state: DraftingRequestState;
+    requesterEmployeeId: string;
+    requesterFullName: string;
+    requesterAreaName: string | null;
+    targetDirectorateCode: number;
+    targetDirectorateName: string;
+    takenByEmployeeId: string | null;
+    takenByFullName: string | null;
+    documentType: {
+        id: string;
+        name: string;
+    } | null;
+    dueAt: string | null;
+    createdAt: string;
+    document: DraftingRequestDocumentEntity | null;
+}
+export interface DraftingRequestAttachmentResponseEntity {
+    id: string;
+    name: string;
+}
+export interface DraftingRequestEventResponseEntity {
+    id: string;
+    action: DraftingRequestEventAction;
+    note: string | null;
+    employeeFullName: string;
+    createdAt: string;
+}
+export interface DraftingRequestDetailEntity extends DraftingRequestListItemEntity {
+    details: string;
+    takenAt: string | null;
+    closedAt: string | null;
+    closingNote: string | null;
+    /** Funcionarios de la dirección a los que les llegó. */
+    recipientCount: number;
+    attachments: DraftingRequestAttachmentResponseEntity[];
+    events: DraftingRequestEventResponseEntity[];
+    /** Qué puede hacer con ella quien la consulta. */
+    capabilities: {
+        canTake: boolean;
+        canRelease: boolean;
+        canDecline: boolean;
+        canCancel: boolean;
+        /** La tomó y aún no tiene documento (o lo descartó): puede redactarlo. */
+        canDraft: boolean;
+    };
+    /** Funcionarios a los que avisar de la operación que se acaba de hacer (lo usa el gateway). */
+    notify?: {
+        employeeIds: string[];
+    };
+}
+/** Solicitud enlazada a un documento, como se muestra en su detalle. */
+export interface DocumentDraftingRequestEntity {
+    id: string;
+    label: string;
+    requesterFullName: string;
+    requesterAreaName: string | null;
+}

package/dist/entities/draftingRequest/draftingRequest.entity.js

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

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

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

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

package/dist/entities/index.d.ts

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

package/dist/entities/index.js

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

package/package.json

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

package/src/base/entities.ts

@@ -604,6 +604,26 @@ export const MailAuthentication = {
   Unknown: 'Unknown',
 } satisfies Record<string, MailAuthentication>;
 
+export type DraftingRequestStatus = 'Pending' | 'Taken' | 'Declined' | 'Cancelled';
+
+export const DraftingRequestStatus = {
+  Pending: 'Pending',
+  Taken: 'Taken',
+  Declined: 'Declined',
+  Cancelled: 'Cancelled',
+} satisfies Record<string, DraftingRequestStatus>;
+
+export type DraftingRequestEventAction = 'Created' | 'Taken' | 'Released' | 'Declined' | 'Cancelled' | 'DocumentLinked';
+
+export const DraftingRequestEventAction = {
+  Created: 'Created',
+  Taken: 'Taken',
+  Released: 'Released',
+  Declined: 'Declined',
+  Cancelled: 'Cancelled',
+  DocumentLinked: 'DocumentLinked',
+} satisfies Record<string, DraftingRequestEventAction>;
+
 export interface DocumentTypeEntity {
   id: string;
   name: string;
@@ -628,6 +648,7 @@ export interface DocumentTypeEntity {
   numberingMembers?: DocumentTypeEntity[];
   enabled: boolean;
   documents?: DocumentEntity[];
+  draftingRequests?: DraftingRequestEntity[];
   annulledNumbers?: DocumentAnnulledNumberEntity[];
   flowSteps?: DocumentTypeFlowStepEntity[];
   signatureBatches?: SignatureBatchEntity[];
@@ -705,6 +726,7 @@ export interface DocumentEntity {
   versions?: DocumentVersionEntity[];
   comments?: DocumentCommentEntity[];
   draftReviews?: DocumentDraftReviewEntity[];
+  draftingRequest?: DraftingRequestEntity | null;
   accessRequestDeliveries?: AccessRequestDocumentEntity[];
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
@@ -1602,4 +1624,59 @@ export interface DocumentCommentEntity {
   createdAt: string;
 }
 
+export interface DraftingRequestEntity {
+  id: string;
+  number: number;
+  year: number;
+  subject: string;
+  details: string;
+  documentTypeId?: string | null;
+  documentType?: DocumentTypeEntity | null;
+  dueAt?: string | null;
+  requesterEmployeeId: string;
+  requesterFullName: string;
+  requesterAreaName?: string | null;
+  targetDirectorateCode: number;
+  targetDirectorateName: string;
+  status: DraftingRequestStatus;
+  takenByEmployeeId?: string | null;
+  takenByFullName?: string | null;
+  takenAt?: string | null;
+  closedAt?: string | null;
+  closingNote?: string | null;
+  documentId?: string | null;
+  document?: DocumentEntity | null;
+  recipients?: DraftingRequestRecipientEntity[];
+  attachments?: DraftingRequestAttachmentEntity[];
+  events?: DraftingRequestEventEntity[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface DraftingRequestRecipientEntity {
+  id: string;
+  requestId: string;
+  request?: DraftingRequestEntity;
+  employeeId: string;
+}
+
+export interface DraftingRequestAttachmentEntity {
+  id: string;
+  requestId: string;
+  request?: DraftingRequestEntity;
+  fileId: string;
+  name: string;
+}
+
+export interface DraftingRequestEventEntity {
+  id: string;
+  requestId: string;
+  request?: DraftingRequestEntity;
+  action: DraftingRequestEventAction;
+  note?: string | null;
+  employeeId: string;
+  employeeFullName: string;
+  createdAt: string;
+}
+
 type JsonValue = string | number | boolean | { [key in string]?: JsonValue } | Array<JsonValue> | null;

package/src/contracts/document.contract.ts

@@ -115,6 +115,8 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
   keywords: string[];
   /** Qué cambió, si el guardado crea una versión nueva (otro PDF, otro texto u otro asunto). */
   versionNote?: string | null;
+  /** Al crearlo: solicitud de redacción que atiende (la tomó quien redacta). */
+  draftingRequestId?: string | null;
   accessLevel?: DocumentAccessLevel;
   hasSensitiveData?: boolean;
   directorateCodeReference?: number | null;

package/src/contracts/draftingRequest.contract.ts

@@ -0,0 +1,73 @@
+import { type DraftingRequestDetailEntity, type DraftingRequestListItemEntity } from '../entities';
+import { type RpcPage } from './contract';
+
+/** Patrones NATS de `draftingRequest`: solicitudes de redacción entre áreas. */
+export const DraftingRequestPatterns = {
+  getAll: 'gestorDocumental.draftingRequest.getAll',
+  getById: 'gestorDocumental.draftingRequest.getById',
+  create: 'gestorDocumental.draftingRequest.create',
+  act: 'gestorDocumental.draftingRequest.act',
+  getAttachmentFile: 'gestorDocumental.draftingRequest.getAttachmentFile',
+} as const;
+
+/** Quien consulta o actúa: el funcionario de la sesión, con su nombre. */
+export interface DraftingRequestActor {
+  employeeId: string;
+  fullName: string;
+}
+
+/**
+ * Bandeja: las que le llegaron a su dirección, las que tomó o las que pidió. `state`: abiertas (sin tomar, tomadas o
+ * en redacción), cerradas (atendidas, devueltas o retiradas) o todas.
+ */
+export type DraftingRequestBox = 'received' | 'taken' | 'sent';
+
+export interface DraftingRequestCreatePayload {
+  subject: string;
+  details: string;
+  documentTypeId?: string | null;
+  dueAt?: string | null;
+  attachments?: { fileId: string; name: string }[];
+  /** Dirección a la que se pide, con el nombre que le pone el gateway. */
+  targetDirectorateCode: number;
+  targetDirectorateName: string;
+  /** Quienes la integran hoy, resueltos por el gateway (sin quien la pide). */
+  recipientEmployeeIds: string[];
+  requesterAreaName?: string | null;
+  actor: DraftingRequestActor;
+}
+
+/** Lo que se hace con una solicitud, un paso a la vez. */
+export type DraftingRequestAction =
+  | { type: 'take' }
+  | { type: 'release'; note?: string | null }
+  | { type: 'decline'; note: string }
+  | { type: 'cancel'; note?: string | null };
+
+export interface DraftingRequestContract {
+  [DraftingRequestPatterns.getAll]: {
+    payload: {
+      box: DraftingRequestBox;
+      state?: 'open' | 'closed' | 'all';
+      search?: string;
+      page?: number;
+      limit?: number;
+      actor: Pick<DraftingRequestActor, 'employeeId'>;
+    };
+    response: RpcPage<DraftingRequestListItemEntity[]>;
+  };
+  [DraftingRequestPatterns.getById]: {
+    payload: { id: string; actor: Pick<DraftingRequestActor, 'employeeId'> };
+    response: DraftingRequestDetailEntity;
+  };
+  [DraftingRequestPatterns.create]: { payload: DraftingRequestCreatePayload; response: DraftingRequestDetailEntity };
+  [DraftingRequestPatterns.act]: {
+    payload: { id: string; action: DraftingRequestAction; actor: DraftingRequestActor };
+    response: DraftingRequestDetailEntity;
+  };
+  /** Archivo adjunto, con las mismas reglas de acceso del detalle. */
+  [DraftingRequestPatterns.getAttachmentFile]: {
+    payload: { id: string; attachmentId: string; actor: Pick<DraftingRequestActor, 'employeeId'> };
+    response: { fileId: string; fileName: string };
+  };
+}

package/src/contracts/index.ts

@@ -23,6 +23,7 @@ import { ProcedurePatterns, type ProcedureContract } from './procedure.contract'
 import { RegisterBookPatterns, type RegisterBookContract } from './registerBook.contract';
 import { SignatureBatchPatterns, type SignatureBatchContract } from './signatureBatch.contract';
 import { WorkFolderPatterns, type WorkFolderContract } from './workFolder.contract';
+import { DraftingRequestPatterns, type DraftingRequestContract } from './draftingRequest.contract';
 
 export * from './contract';
 export * from './document.contract';
@@ -50,6 +51,7 @@ export * from './dataProtection.contract';
 export * from './desk.contract';
 export * from './mailIntake.contract';
 export * from './push.contract';
+export * from './draftingRequest.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -78,6 +80,7 @@ export const GestorDocumentalPatterns = {
   desk: DeskPatterns,
   mailIntake: MailIntakePatterns,
   push: PushPatterns,
+  draftingRequest: DraftingRequestPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -105,4 +108,5 @@ export type GestorDocumentalContract = DocumentTypeContract &
   DataProtectionContract &
   DeskContract &
   MailIntakeContract &
-  PushContract;
+  PushContract &
+  DraftingRequestContract;

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

@@ -10,6 +10,7 @@ import {
   DocumentTrackingEntity,
   DocumentTypeEntity,
 } from '../../base/entities';
+import { type DocumentDraftingRequestEntity } from '../draftingRequest/draftingRequest.entity';
 
 /** Tipo documental de un documento, con lo necesario para citarlo. */
 export interface DocumentTypeSummaryEntity {
@@ -217,6 +218,8 @@ export interface DocumentGetByIdResponseEntity {
    * más reciente primero) y si la versión vigente ya está aprobada. `null` si el tipo no la exige.
    */
   draftReview: DocumentDraftReviewInfoEntity | null;
+  /** Solicitud de redacción que atiende, si se redactó a pedido de otra área. */
+  draftingRequest: DocumentDraftingRequestEntity | null;
   replies: DocumentLinkEntity[];
   /** Expedientes en que está incorporado y que quien consulta puede ver. */
   caseFiles: { id: string; code: string; title: string; status: 'Open' | 'Closed' }[];
@@ -279,6 +282,8 @@ export interface DocumentGetSummaryResponseEntity {
   toSign: number;
   /** Borradores que esperan su revisión (como jefatura de la dirección que los revisa). */
   toReview: number;
+  /** Solicitudes de redacción: sin tomar dirigidas a su dirección, y tomadas por él aún sin atender. */
+  draftingRequests: { pending: number; taken: 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: {

package/src/entities/draftingRequest/draftingRequest.entity.ts

@@ -0,0 +1,78 @@
+import { type DocumentStatus, type DraftingRequestEventAction, type DraftingRequestStatus } from '../../base/entities';
+
+/**
+ * Cómo va la solicitud, para mostrarla: sin tomar, tomada (aún sin documento), en redacción (con documento en curso),
+ * atendida (su documento quedó finalizado), devuelta o retirada.
+ */
+export type DraftingRequestState = 'Pending' | 'Taken' | 'Drafting' | 'Completed' | 'Declined' | 'Cancelled';
+
+/** Documento que atiende la solicitud. */
+export interface DraftingRequestDocumentEntity {
+  id: string;
+  status: DocumentStatus;
+  /** «D.E. N° 590/2026», o `null` mientras no tiene número. */
+  folio: string | null;
+}
+
+export interface DraftingRequestListItemEntity {
+  id: string;
+  /** «N° 3/2026». */
+  label: string;
+  subject: string;
+  status: DraftingRequestStatus;
+  state: DraftingRequestState;
+  requesterEmployeeId: string;
+  requesterFullName: string;
+  requesterAreaName: string | null;
+  targetDirectorateCode: number;
+  targetDirectorateName: string;
+  takenByEmployeeId: string | null;
+  takenByFullName: string | null;
+  documentType: { id: string; name: string } | null;
+  dueAt: string | null;
+  createdAt: string;
+  document: DraftingRequestDocumentEntity | null;
+}
+
+export interface DraftingRequestAttachmentResponseEntity {
+  id: string;
+  name: string;
+}
+
+export interface DraftingRequestEventResponseEntity {
+  id: string;
+  action: DraftingRequestEventAction;
+  note: string | null;
+  employeeFullName: string;
+  createdAt: string;
+}
+
+export interface DraftingRequestDetailEntity extends DraftingRequestListItemEntity {
+  details: string;
+  takenAt: string | null;
+  closedAt: string | null;
+  closingNote: string | null;
+  /** Funcionarios de la dirección a los que les llegó. */
+  recipientCount: number;
+  attachments: DraftingRequestAttachmentResponseEntity[];
+  events: DraftingRequestEventResponseEntity[];
+  /** Qué puede hacer con ella quien la consulta. */
+  capabilities: {
+    canTake: boolean;
+    canRelease: boolean;
+    canDecline: boolean;
+    canCancel: boolean;
+    /** La tomó y aún no tiene documento (o lo descartó): puede redactarlo. */
+    canDraft: boolean;
+  };
+  /** Funcionarios a los que avisar de la operación que se acaba de hacer (lo usa el gateway). */
+  notify?: { employeeIds: string[] };
+}
+
+/** Solicitud enlazada a un documento, como se muestra en su detalle. */
+export interface DocumentDraftingRequestEntity {
+  id: string;
+  label: string;
+  requesterFullName: string;
+  requesterAreaName: string | null;
+}

package/src/entities/draftingRequest/index.ts

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

package/src/entities/index.ts

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