@muni-sanfer/types-gestor-documental 0.0.1-beta.4 → 0.0.1-beta.6

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

@@ -0,0 +1,98 @@
+import { type DocumentDispatchResponseEntity, type DocumentExternalRecipientResponseEntity, type DocumentLinkEntity } from '../document';
+/** Institución del Estado en DocDigital. */
+export interface DocDigitalEntityEntity {
+    id: number;
+    name: string;
+    /** Organismo al que pertenece (la entidad padre). */
+    organism: string | null;
+}
+/** Usuario habilitado de una institución en DocDigital. */
+export interface DocDigitalUserEntity {
+    id: number;
+    name: string;
+    position: string | null;
+}
+export interface DocDigitalDocumentTypeEntity {
+    id: number;
+    name: string;
+}
+/** Si DocDigital está configurado en el gestor y cada cuánto se revisa lo recibido. */
+export interface PartsOfficeStatusEntity {
+    configured: boolean;
+    syncMinutes: number;
+}
+/** Totales del Panel de Partes. */
+export interface PartsOfficeSummaryEntity {
+    toDispatch: number;
+    received: number;
+}
+/** Documento firmado que va a otras instituciones: lo despacha Oficina de Partes. */
+export interface PartsOfficeDispatchEntity extends DocumentDispatchResponseEntity {
+    document: DocumentLinkEntity & {
+        accessLevel: string;
+    };
+    externalRecipients: DocumentExternalRecipientResponseEntity[];
+    createdAt: string;
+}
+/** Documento que llegó por DocDigital. */
+export interface PartsOfficeInboundEntity {
+    id: string;
+    docDigitalDocumentId: string;
+    status: 'Pending' | 'Registered' | 'Returned';
+    subject: string;
+    description: string | null;
+    folio: string | null;
+    folioDate: string | null;
+    typeName: string | null;
+    reserved: boolean;
+    senderEntityName: string | null;
+    senderName: string | null;
+    senderPosition: string | null;
+    fileName: string | null;
+    hasFile: boolean;
+    attachments: {
+        name: string;
+        url: string | null;
+        hasFile: boolean;
+    }[];
+    createdAt: string;
+    registeredAt: string | null;
+    registeredByFullName: string | null;
+    acknowledgedAt: string | null;
+    acknowledgeError: string | null;
+    returnedAt: string | null;
+    returnedByFullName: string | null;
+    returnReason: string | null;
+    /** El documento con que quedó ingresado al gestor. */
+    document: {
+        id: string;
+        intakeNumber: number | null;
+        intakeYear: number | null;
+    } | null;
+}
+export interface PartsOfficeOkResponseEntity {
+    id: string;
+    ok: boolean;
+    /** Documento al que corresponde el despacho (al despachar o devolver). */
+    documentId?: string;
+}
+export interface PartsOfficeSyncResponseEntity {
+    /** Recibidos nuevos que se trajeron. */
+    created: number;
+    /** Los que no se pudieron traer (se reintentan en la próxima revisión). */
+    failed: number;
+}
+export interface PartsOfficeRegisterResponseEntity {
+    id: string;
+    documentId: string;
+    intakeNumber: number;
+    intakeYear: number;
+    /** `false` si DocDigital no aceptó el acuse de recibo: se puede reintentar. */
+    acknowledged: boolean;
+    ok: boolean;
+}
+/** Archivo de un recibido, ya copiado al gestor. */
+export interface PartsOfficeFileEntity {
+    fileId: string;
+    fileName: string;
+}

package/dist/entities/partsOffice/partsOffice.entity.js

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

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

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

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

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

@@ -0,0 +1,42 @@
+/** Libro de registro: el de un tipo documental (sus números) o el de ingresos de Oficina de Partes. */
+export type RegisterBookKind = 'documentType' | 'intake';
+/**
+ * Estado de un número en el libro: vigente, en tramitación (numerado con la primera firma, aún sin todas las firmas),
+ * documento anulado, número anulado por un rechazo, o número sin registro en el gestor (un salto en la numeración).
+ */
+export type RegisterBookRowState = 'Valid' | 'InProgress' | 'Annulled' | 'NumberAnnulled' | 'Unused';
+export interface RegisterBookRowEntity {
+    number: number;
+    /** Fecha del número (o del ingreso), en ISO 8601. `null` en un salto. */
+    date: string | null;
+    state: RegisterBookRowState;
+    documentId: string | null;
+    subject: string | null;
+    /** Quién redactó el documento (o, en el libro de ingresos, quién lo ingresó). */
+    author: string | null;
+    signers: string[];
+    /** Libro de ingresos: institución que lo envió y su folio. */
+    sender: string | null;
+    externalFolio: string | null;
+    /** Libro de ingresos: a quiénes se derivó. */
+    recipients: string[];
+    /** Despacho por DocDigital: «DocDigital N° 777001 · 14-10-2026». */
+    dispatch: string | null;
+    /** Motivo de la anulación (del documento o del número). */
+    observation: string | null;
+}
+export interface RegisterBookEntity {
+    kind: RegisterBookKind;
+    /** «Decreto alcaldicio exento» o «Ingresos de Oficina de Partes». */
+    title: string;
+    year: number;
+    month: number | null;
+    rows: RegisterBookRowEntity[];
+    totals: Record<RegisterBookRowState, number>;
+}
+/** Libro exportado, listo para descargar. */
+export interface RegisterBookExportEntity {
+    fileName: string;
+    contentType: string;
+    contentBase64: string;
+}

package/dist/entities/registerBook/registerBook.entity.js

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

package/package.json

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

package/src/base/entities.ts

@@ -60,7 +60,10 @@ export type DocumentTrackingAction =
   | 'Annulled'
   | 'Delivered'
   | 'Derived'
-  | 'Reassigned';
+  | 'Reassigned'
+  | 'Dispatched'
+  | 'DispatchReturned'
+  | 'Received';
 
 export const DocumentTrackingAction = {
   Created: 'Created',
@@ -77,8 +80,34 @@ export const DocumentTrackingAction = {
   Delivered: 'Delivered',
   Derived: 'Derived',
   Reassigned: 'Reassigned',
+  Dispatched: 'Dispatched',
+  DispatchReturned: 'DispatchReturned',
+  Received: 'Received',
 } satisfies Record<string, DocumentTrackingAction>;
 
+export type DocumentOrigin = 'Internal' | 'DocDigital';
+
+export const DocumentOrigin = {
+  Internal: 'Internal',
+  DocDigital: 'DocDigital',
+} satisfies Record<string, DocumentOrigin>;
+
+export type DocumentDispatchStatus = 'Pending' | 'Dispatched' | 'Returned';
+
+export const DocumentDispatchStatus = {
+  Pending: 'Pending',
+  Dispatched: 'Dispatched',
+  Returned: 'Returned',
+} satisfies Record<string, DocumentDispatchStatus>;
+
+export type DocDigitalInboundStatus = 'Pending' | 'Registered' | 'Returned';
+
+export const DocDigitalInboundStatus = {
+  Pending: 'Pending',
+  Registered: 'Registered',
+  Returned: 'Returned',
+} satisfies Record<string, DocDigitalInboundStatus>;
+
 export type DocumentFlowStepType = 'Employee' | 'DirectorateHead';
 
 export const DocumentFlowStepType = {
@@ -246,6 +275,14 @@ export interface DocumentEntity {
   annulledAt?: string | null;
   annulmentReason?: string | null;
   responseDueAt?: string | null;
+  origin: DocumentOrigin;
+  intakeNumber?: number | null;
+  intakeYear?: number | null;
+  externalFolio?: string | null;
+  externalSender?: string | null;
+  externalDate?: string | null;
+  contentText?: string | null;
+  textExtractedAt?: string | null;
   replyTo?: DocumentEntity | null;
   replyToDocumentId?: string | null;
   replies?: DocumentEntity[];
@@ -268,6 +305,9 @@ export interface DocumentEntity {
   recipients?: DocumentRecipientEntity[];
   deliveries?: DocumentDeliveryEntity[];
   caseFileEntries?: CaseFileEntryEntity[];
+  externalRecipients?: DocumentExternalRecipientEntity[];
+  dispatch?: DocumentDispatchEntity | null;
+  docDigitalInbound?: DocDigitalInboundEntity | null;
   deleted: boolean;
   createdAt: string;
   updatedAt: string;
@@ -514,3 +554,76 @@ export interface CaseFileAccessEntity {
   caseFileId: string;
   createdAt: string;
 }
+
+export interface DocumentExternalRecipientEntity {
+  id: string;
+  entityId: number;
+  entityName: string;
+  userId?: number | null;
+  userName?: string | null;
+  userPosition?: string | null;
+  document?: DocumentEntity;
+  documentId: string;
+  createdAt: string;
+}
+
+export interface DocumentDispatchEntity {
+  id: string;
+  status: DocumentDispatchStatus;
+  folio?: string | null;
+  docDigitalTypeId?: number | null;
+  docDigitalTypeName?: string | null;
+  docDigitalDocumentId?: string | null;
+  docDigitalRequestId?: string | null;
+  dispatchedAt?: string | null;
+  dispatchedByEmployeeId?: string | null;
+  dispatchedByFullName?: string | null;
+  returnedAt?: string | null;
+  returnedByEmployeeId?: string | null;
+  returnedByFullName?: string | null;
+  returnReason?: string | null;
+  document?: DocumentEntity;
+  documentId: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface DocDigitalInboundEntity {
+  id: string;
+  docDigitalDocumentId: string;
+  docDigitalRequestId?: string | null;
+  status: DocDigitalInboundStatus;
+  subject: string;
+  description?: string | null;
+  folio?: string | null;
+  folioDate?: string | null;
+  typeName?: string | null;
+  reserved: boolean;
+  senderEntityId?: number | null;
+  senderEntityName?: string | null;
+  senderName?: string | null;
+  senderPosition?: string | null;
+  fileId?: string | null;
+  fileName?: string | null;
+  attachments: JsonValue;
+  registeredAt?: string | null;
+  registeredByEmployeeId?: string | null;
+  registeredByFullName?: string | null;
+  acknowledgedAt?: string | null;
+  acknowledgeError?: string | null;
+  returnedAt?: string | null;
+  returnedByEmployeeId?: string | null;
+  returnedByFullName?: string | null;
+  returnReason?: string | null;
+  document?: DocumentEntity | null;
+  documentId?: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface IntakeSequenceEntity {
+  year: number;
+  next: number;
+}
+
+type JsonValue = string | number | boolean | { [key in string]?: JsonValue } | Array<JsonValue> | null;

package/src/contracts/document.contract.ts

@@ -102,10 +102,18 @@ export interface DocumentWritePayload extends Pick<DocumentEntity, 'subject' | '
   responseDueAt?: string | null;
   // Documento al que este responde.
   replyToDocumentId?: string | null;
+  // Instituciones (y usuarios) de DocDigital a quienes va: al terminar la firma pasa a Oficina de Partes.
+  externalRecipients?: DocumentExternalRecipientInput[];
   action?: 'Submit';
   actor: DocumentActor;
 }
 
+/** Destinatario externo: una institución de DocDigital y, si se indica, uno de sus usuarios. */
+export interface DocumentExternalRecipientInput {
+  entityId: number;
+  userId?: number | null;
+}
+
 /**
  * Qué se envía y qué se responde en cada patrón. Generado desde los handlers y los DTO del microservicio.
  */
@@ -121,6 +129,14 @@ export interface DocumentContract {
         // Rango de fechas de creación (ISO 8601).
         dateFrom?: string;
         dateTo?: string;
+        // Búsqueda avanzada: número (del documento o folio de ingreso) y año, firmante, redactor y unidad emisora.
+        number?: number;
+        year?: number;
+        signerEmployeeId?: string;
+        authorEmployeeId?: string;
+        directorateCodeReference?: number;
+        // Texto completo, en el asunto y en el contenido del PDF.
+        text?: string;
       };
       // Obligatorio en todas las bandejas salvo `all`.
       actor?: DocumentActor;

package/src/contracts/index.ts

@@ -1,13 +1,17 @@
 import { CaseFilePatterns, type CaseFileContract } from './caseFile.contract';
 import { DocumentPatterns, type DocumentContract } from './document.contract';
 import { DocumentTypePatterns, type DocumentTypeContract } from './documentType.contract';
+import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
+import { RegisterBookPatterns, type RegisterBookContract } from './registerBook.contract';
 
 export * from './contract';
 export * from './document.contract';
 export * from './documentType.contract';
 export * from './procedure.contract';
 export * from './caseFile.contract';
+export * from './partsOffice.contract';
+export * from './registerBook.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -15,7 +19,14 @@ export const GestorDocumentalPatterns = {
   document: DocumentPatterns,
   procedure: ProcedurePatterns,
   caseFile: CaseFilePatterns,
+  partsOffice: PartsOfficePatterns,
+  registerBook: RegisterBookPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
-export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & CaseFileContract;
+export type GestorDocumentalContract = DocumentTypeContract &
+  DocumentContract &
+  ProcedureContract &
+  CaseFileContract &
+  PartsOfficeContract &
+  RegisterBookContract;

package/src/contracts/partsOffice.contract.ts

@@ -0,0 +1,120 @@
+import { type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
+import {
+  type DocDigitalDocumentTypeEntity,
+  type DocDigitalEntityEntity,
+  type PartsOfficeInboundEntity,
+  type DocDigitalUserEntity,
+  type PartsOfficeDispatchEntity,
+  type PartsOfficeFileEntity,
+  type PartsOfficeOkResponseEntity,
+  type PartsOfficeRegisterResponseEntity,
+  type PartsOfficeStatusEntity,
+  type PartsOfficeSummaryEntity,
+  type PartsOfficeSyncResponseEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+import { type DocumentActor, type DocumentExternalRecipientInput } from './document.contract';
+
+/** Patrones NATS de `partsOffice` (Oficina de Partes y DocDigital): `<servicio>.<recurso>.<acción>`. */
+export const PartsOfficePatterns = {
+  getStatus: 'gestorDocumental.partsOffice.getStatus',
+  getSummary: 'gestorDocumental.partsOffice.getSummary',
+  getEntities: 'gestorDocumental.partsOffice.getEntities',
+  getUsers: 'gestorDocumental.partsOffice.getUsers',
+  getDocumentTypes: 'gestorDocumental.partsOffice.getDocumentTypes',
+  getDispatches: 'gestorDocumental.partsOffice.getDispatches',
+  dispatch: 'gestorDocumental.partsOffice.dispatch',
+  returnDispatch: 'gestorDocumental.partsOffice.returnDispatch',
+  resendDispatch: 'gestorDocumental.partsOffice.resendDispatch',
+  getDispatchFile: 'gestorDocumental.partsOffice.getDispatchFile',
+  getInbound: 'gestorDocumental.partsOffice.getInbound',
+  syncInbound: 'gestorDocumental.partsOffice.syncInbound',
+  registerInbound: 'gestorDocumental.partsOffice.registerInbound',
+  acknowledgeInbound: 'gestorDocumental.partsOffice.acknowledgeInbound',
+  returnInbound: 'gestorDocumental.partsOffice.returnInbound',
+  getInboundFile: 'gestorDocumental.partsOffice.getInboundFile',
+} as const;
+
+/** Destinatario interno de un ingreso, ya resuelto por el gateway (las áreas con sus integrantes). */
+export type PartsOfficeRecipientInput =
+  | { type: 'Employee'; employeeId: string }
+  | { type: 'Directorate'; directorateCodeReference: number; name: string; memberEmployeeIds: string[] }
+  | { type: 'Department'; departmentId: string; name: string; memberEmployeeIds: string[] };
+
+interface IListPayload<S> {
+  pagination?: { page?: number; limit?: number };
+  filters?: { search?: string; status?: S };
+}
+
+export interface PartsOfficeContract {
+  [PartsOfficePatterns.getStatus]: { payload: Record<string, never>; response: PartsOfficeStatusEntity };
+  [PartsOfficePatterns.getSummary]: { payload: Record<string, never>; response: PartsOfficeSummaryEntity };
+  /** Directorio de DocDigital: instituciones por nombre. */
+  [PartsOfficePatterns.getEntities]: { payload: { search?: string }; response: DocDigitalEntityEntity[] };
+  [PartsOfficePatterns.getUsers]: {
+    payload: { entityId: number; search?: string };
+    response: DocDigitalUserEntity[];
+  };
+  [PartsOfficePatterns.getDocumentTypes]: { payload: Record<string, never>; response: DocDigitalDocumentTypeEntity[] };
+  [PartsOfficePatterns.getDispatches]: {
+    payload: IListPayload<'Pending' | 'Dispatched' | 'Returned'>;
+    response: RpcPage<PartsOfficeDispatchEntity[]>;
+  };
+  /** Despacha por DocDigital, con el número del documento como folio. `operatorRun`: RUN de quien despacha. */
+  [PartsOfficePatterns.dispatch]: {
+    payload: { id: string; docDigitalTypeId: number; operatorRun?: string | null; actor: DocumentActor };
+    response: PartsOfficeOkResponseEntity & { docDigitalDocumentId: string };
+  };
+  /** Devuelve el despacho al redactor, con el motivo (por ejemplo, un destinatario equivocado). */
+  [PartsOfficePatterns.returnDispatch]: {
+    payload: { id: string; reason: string; actor: DocumentActor };
+    response: PartsOfficeOkResponseEntity;
+  };
+  /** El redactor corrige las instituciones de destino de un despacho devuelto y lo envía de nuevo a Partes. */
+  [PartsOfficePatterns.resendDispatch]: {
+    payload: { id: string; externalRecipients: DocumentExternalRecipientInput[]; actor: DocumentActor };
+    response: PartsOfficeOkResponseEntity;
+  };
+  /** PDF firmado de un documento por despachar, para que Oficina de Partes lo revise. */
+  [PartsOfficePatterns.getDispatchFile]: { payload: { id: string }; response: PartsOfficeFileEntity };
+  [PartsOfficePatterns.getInbound]: {
+    payload: IListPayload<'Pending' | 'Registered' | 'Returned'>;
+    response: RpcPage<PartsOfficeInboundEntity[]>;
+  };
+  /** Trae de DocDigital lo recibido que aún no tiene acuse de recibo. */
+  [PartsOfficePatterns.syncInbound]: { payload: Record<string, never>; response: PartsOfficeSyncResponseEntity };
+  /**
+   * Ingresa un recibido al gestor: le da folio de ingreso, lo deriva a quienes corresponda y da el acuse de recibo
+   * en DocDigital.
+   */
+  [PartsOfficePatterns.registerInbound]: {
+    payload: {
+      id: string;
+      documentTypeId: string;
+      keywords: string[];
+      accessLevel: DocumentAccessLevel;
+      hasSensitiveData: boolean;
+      recipients: PartsOfficeRecipientInput[];
+      instruction: DocumentInstruction;
+      note?: string | null;
+      dueAt?: string | null;
+      actor: DocumentActor;
+    };
+    response: PartsOfficeRegisterResponseEntity;
+  };
+  /** Reintenta el acuse de recibo de un recibido ya ingresado. */
+  [PartsOfficePatterns.acknowledgeInbound]: {
+    payload: { id: string; actor: DocumentActor };
+    response: PartsOfficeOkResponseEntity;
+  };
+  /** Devuelve el recibido a la institución que lo envió, con el motivo (entre 3 y 255 caracteres). */
+  [PartsOfficePatterns.returnInbound]: {
+    payload: { id: string; reason: string; actor: DocumentActor };
+    response: PartsOfficeOkResponseEntity;
+  };
+  /** Archivo de un recibido: el principal o, con `attachment`, uno de sus anexos (por su posición). */
+  [PartsOfficePatterns.getInboundFile]: {
+    payload: { id: string; attachment?: number };
+    response: PartsOfficeFileEntity;
+  };
+}

package/src/contracts/registerBook.contract.ts

@@ -0,0 +1,24 @@
+import { type RegisterBookEntity, type RegisterBookExportEntity, type RegisterBookKind } from '../entities';
+
+/** Patrones NATS de `registerBook` (libros de registro): `<servicio>.<recurso>.<acción>`. */
+export const RegisterBookPatterns = {
+  get: 'gestorDocumental.registerBook.get',
+  export: 'gestorDocumental.registerBook.export',
+} as const;
+
+/** Qué libro y qué período: un año y, si se indica, un mes. El de un tipo documental exige el tipo. */
+export interface RegisterBookQuery {
+  kind: RegisterBookKind;
+  documentTypeId?: string;
+  year: number;
+  month?: number | null;
+}
+
+export interface RegisterBookContract {
+  [RegisterBookPatterns.get]: { payload: RegisterBookQuery; response: RegisterBookEntity };
+  /** El libro en Excel o PDF. `generatedBy`: quién lo descarga (va en el encabezado). */
+  [RegisterBookPatterns.export]: {
+    payload: RegisterBookQuery & { format: 'xlsx' | 'pdf'; generatedBy: string };
+    response: RegisterBookExportEntity;
+  };
+}

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

@@ -72,6 +72,33 @@ export interface DocumentLinkEntity {
   createdByFullName: DocumentEntity['createdByFullName'];
   finishedAt: DocumentEntity['finishedAt'];
   documentType: DocumentTypeSummaryEntity;
+  /** Folio de ingreso de Oficina de Partes, si llegó por DocDigital. */
+  intakeNumber: DocumentEntity['intakeNumber'];
+  intakeYear: DocumentEntity['intakeYear'];
+}
+
+/** Institución (y usuario) de DocDigital a la que va dirigido un documento. */
+export interface DocumentExternalRecipientResponseEntity {
+  id: string;
+  entityId: number;
+  entityName: string;
+  userId: number | null;
+  userName: string | null;
+  userPosition: string | null;
+}
+
+/** Despacho de un documento por DocDigital. */
+export interface DocumentDispatchResponseEntity {
+  id: string;
+  status: 'Pending' | 'Dispatched' | 'Returned';
+  folio: string | null;
+  docDigitalTypeName: string | null;
+  docDigitalDocumentId: string | null;
+  dispatchedAt: string | null;
+  dispatchedByFullName: string | null;
+  returnedAt: string | null;
+  returnedByFullName: string | null;
+  returnReason: string | null;
 }
 
 export interface DocumentGetAllResponseEntity {
@@ -87,6 +114,11 @@ export interface DocumentGetAllResponseEntity {
   createdByEmployeeId: DocumentEntity['createdByEmployeeId'];
   createdByFullName: DocumentEntity['createdByFullName'];
   documentType: DocumentTypeSummaryEntity;
+  intakeNumber: DocumentEntity['intakeNumber'];
+  intakeYear: DocumentEntity['intakeYear'];
+  origin: DocumentEntity['origin'];
+  /** Con búsqueda de texto completo: el fragmento donde aparece lo buscado, con lo encontrado entre ⟦ y ⟧. */
+  snippet?: string | null;
   // A quién le toca visar o firmar (null si el documento no está en tramitación).
   currentParticipant: Pick<DocumentParticipantResponseEntity, 'role' | 'employeeId' | 'fullName'> | null;
   // A cuántos funcionarios llegó y cuántos ya lo abrieron (null si aún no se distribuye a nadie).
@@ -147,6 +179,16 @@ export interface DocumentGetByIdResponseEntity {
   replies: DocumentLinkEntity[];
   /** Expedientes en que está incorporado y que quien consulta puede ver. */
   caseFiles: { id: string; code: string; title: string; status: 'Open' | 'Closed' }[];
+  /** De dónde viene: del gestor o recibido por DocDigital, con su folio de ingreso y los datos de quien lo envió. */
+  origin: DocumentEntity['origin'];
+  intakeNumber: DocumentEntity['intakeNumber'];
+  intakeYear: DocumentEntity['intakeYear'];
+  externalFolio: DocumentEntity['externalFolio'];
+  externalSender: DocumentEntity['externalSender'];
+  externalDate: DocumentEntity['externalDate'];
+  /** Instituciones de DocDigital a quienes va dirigido, y su despacho por Oficina de Partes. */
+  externalRecipients: DocumentExternalRecipientResponseEntity[];
+  dispatch: DocumentDispatchResponseEntity | null;
   documentType: DocumentTypeSummaryEntity;
   participants: DocumentParticipantResponseEntity[];
   attachments: {
@@ -175,6 +217,8 @@ export interface DocumentGetByIdResponseEntity {
     canReply: boolean;
     // Es quien redactó un documento en tramitación: puede pasar un turno pendiente a otro funcionario.
     canReassign: boolean;
+    /** Quien consulta redactó el documento (o lo ingresó, si llegó por DocDigital). */
+    isAuthor: boolean;
     // Sus propias entregas de este documento (puede tener más de una si además se lo derivaron).
     inbox: DocumentDeliveryResponseEntity[];
   };

package/src/entities/index.ts

@@ -2,3 +2,5 @@ export * from './documentType';
 export * from './document';
 export * from './procedure';
 export * from './caseFile';
+export * from './partsOffice';
+export * from './registerBook';

package/src/entities/partsOffice/index.ts

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