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

package/dist/base/entities.d.ts

@@ -231,7 +231,7 @@ export declare const DocumentAccessAction: {
     FileDownloaded: "FileDownloaded";
     TrailExported: "TrailExported";
 };
-export type AuditEntity = 'DocumentType' | 'IssuingEntity' | 'ArchivalSeries' | 'TextSnippet' | 'Holiday' | 'Procedure' | 'QualityMetric' | 'ServiceOutage' | 'Repository' | 'DataTreatment' | 'DocumentTemplate';
+export type AuditEntity = 'DocumentType' | 'IssuingEntity' | 'ArchivalSeries' | 'TextSnippet' | 'Holiday' | 'Procedure' | 'QualityMetric' | 'ServiceOutage' | 'Repository' | 'DataTreatment' | 'DocumentTemplate' | 'DirectorateReviewer';
 export declare const AuditEntity: {
     DocumentType: "DocumentType";
     IssuingEntity: "IssuingEntity";
@@ -244,6 +244,7 @@ export declare const AuditEntity: {
     Repository: "Repository";
     DataTreatment: "DataTreatment";
     DocumentTemplate: "DocumentTemplate";
+    DirectorateReviewer: "DirectorateReviewer";
 };
 export type AuditAction = 'Created' | 'Updated' | 'Enabled' | 'Disabled' | 'Removed' | 'Exported';
 export declare const AuditAction: {
@@ -523,6 +524,7 @@ export interface DocumentEntity {
     comments?: DocumentCommentEntity[];
     draftReviews?: DocumentDraftReviewEntity[];
     draftingRequest?: DraftingRequestEntity | null;
+    internalNotes?: DocumentInternalNoteEntity[];
     accessRequestDeliveries?: AccessRequestDocumentEntity[];
     dispatch?: DocumentDispatchEntity | null;
     docDigitalInbound?: DocDigitalInboundEntity | null;
@@ -1417,6 +1419,28 @@ export interface DraftingRequestEventEntity {
     employeeFullName: string;
     createdAt: string;
 }
+export interface DirectorateReviewerEntity {
+    id: string;
+    directorateCode: number;
+    directorateName: string;
+    employeeId: string;
+    fullName: string;
+    createdAt: string;
+}
+export interface DocumentInternalNoteEntity {
+    id: string;
+    documentId: string;
+    document?: DocumentEntity;
+    directorateCode: number;
+    directorateName: string;
+    headEmployeeIds: string[];
+    versionNumber: number;
+    authorEmployeeId: string;
+    authorFullName: string;
+    authorRole: string;
+    text: string;
+    createdAt: string;
+}
 type JsonValue = string | number | boolean | {
     [key in string]?: JsonValue;
 } | Array<JsonValue> | null;

package/dist/base/entities.js

@@ -218,6 +218,7 @@ exports.AuditEntity = {
     Repository: 'Repository',
     DataTreatment: 'DataTreatment',
     DocumentTemplate: 'DocumentTemplate',
+    DirectorateReviewer: 'DirectorateReviewer',
 };
 exports.AuditAction = {
     Created: 'Created',

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

@@ -42,6 +42,11 @@ export interface DocumentActor {
     employeeId: string;
     directorateCodes: number[];
     departmentIds: string[];
+    /**
+     * Jefaturas para las que revisa (revisora de jefatura): ve los documentos que les esperan. Lo resuelve el gateway
+     * solo donde hace falta (el detalle y el PDF).
+     */
+    reviewFor?: string[];
 }
 /** Bandeja desde la que se lista. Todas son del funcionario (`actor`), salvo `all`. */
 export type DocumentBucket = 'created' | 'sent' | 'toVisa' | 'toSign' | 'participated' | 'toReview' | 'all';

package/dist/contracts/index.d.ts

@@ -24,6 +24,7 @@ import { type RegisterBookContract } from './registerBook.contract';
 import { type SignatureBatchContract } from './signatureBatch.contract';
 import { type WorkFolderContract } from './workFolder.contract';
 import { type DraftingRequestContract } from './draftingRequest.contract';
+import { type InternalReviewContract } from './internalReview.contract';
 export * from './contract';
 export * from './document.contract';
 export * from './documentType.contract';
@@ -51,6 +52,7 @@ export * from './desk.contract';
 export * from './mailIntake.contract';
 export * from './push.contract';
 export * from './draftingRequest.contract';
+export * from './internalReview.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -307,6 +309,14 @@ export declare const GestorDocumentalPatterns: {
         readonly act: "gestorDocumental.draftingRequest.act";
         readonly getAttachmentFile: "gestorDocumental.draftingRequest.getAttachmentFile";
     };
+    readonly internalReview: {
+        readonly getReviewers: "gestorDocumental.internalReview.getReviewers";
+        readonly setReviewers: "gestorDocumental.internalReview.setReviewers";
+        readonly getAssignments: "gestorDocumental.internalReview.getAssignments";
+        readonly getQueue: "gestorDocumental.internalReview.getQueue";
+        readonly getNotes: "gestorDocumental.internalReview.getNotes";
+        readonly addNote: "gestorDocumental.internalReview.addNote";
+    };
 };
 /** 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 & DraftingRequestContract;
+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 & InternalReviewContract;

package/dist/contracts/index.js

@@ -41,6 +41,7 @@ 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");
+const internalReview_contract_1 = require("./internalReview.contract");
 __exportStar(require("./contract"), exports);
 __exportStar(require("./document.contract"), exports);
 __exportStar(require("./documentType.contract"), exports);
@@ -68,6 +69,7 @@ __exportStar(require("./desk.contract"), exports);
 __exportStar(require("./mailIntake.contract"), exports);
 __exportStar(require("./push.contract"), exports);
 __exportStar(require("./draftingRequest.contract"), exports);
+__exportStar(require("./internalReview.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -96,4 +98,5 @@ exports.GestorDocumentalPatterns = {
     mailIntake: mailIntake_contract_1.MailIntakePatterns,
     push: push_contract_1.PushPatterns,
     draftingRequest: draftingRequest_contract_1.DraftingRequestPatterns,
+    internalReview: internalReview_contract_1.InternalReviewPatterns,
 };

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

@@ -0,0 +1,86 @@
+import { type DirectorateReviewersEntity, type DocumentInternalNoteResponseEntity, type DocumentInternalNotesResponseEntity, type InternalReviewQueueItemEntity } from '../entities';
+import { type AuditActorInput } from '../entities';
+/** Patrones NATS de `internalReview`: revisoras de jefatura y sus observaciones internas. */
+export declare const InternalReviewPatterns: {
+    readonly getReviewers: "gestorDocumental.internalReview.getReviewers";
+    readonly setReviewers: "gestorDocumental.internalReview.setReviewers";
+    readonly getAssignments: "gestorDocumental.internalReview.getAssignments";
+    readonly getQueue: "gestorDocumental.internalReview.getQueue";
+    readonly getNotes: "gestorDocumental.internalReview.getNotes";
+    readonly addNote: "gestorDocumental.internalReview.addNote";
+};
+/**
+ * Dirección para la que actúa quien consulta: como revisora de su jefatura o como la jefatura misma. La resuelve el
+ * gateway: quiénes la dirigen hoy (titular y subrogante) no los dice el navegador.
+ */
+export interface InternalReviewScope {
+    directorateCode: number;
+    directorateName: string;
+    headEmployeeIds: string[];
+    role: 'Reviewer' | 'Head';
+}
+export interface InternalReviewContract {
+    [InternalReviewPatterns.getReviewers]: {
+        payload: Record<string, never>;
+        response: DirectorateReviewersEntity[];
+    };
+    /** Reemplaza las revisoras de una dirección (sin ninguna, la dirección queda sin revisoras). */
+    [InternalReviewPatterns.setReviewers]: {
+        payload: {
+            directorateCode: number;
+            directorateName: string;
+            reviewers: {
+                employeeId: string;
+                fullName: string;
+            }[];
+            auditActor?: AuditActorInput;
+        };
+        response: {
+            id: string;
+            ok: boolean;
+        };
+    };
+    /** Direcciones para cuya jefatura revisa una funcionaria. */
+    [InternalReviewPatterns.getAssignments]: {
+        payload: {
+            employeeId: string;
+        };
+        response: {
+            directorateCode: number;
+            directorateName: string;
+        }[];
+    };
+    /** Documentos que esperan a las jefaturas para las que revisa quien consulta. */
+    [InternalReviewPatterns.getQueue]: {
+        payload: {
+            actor: {
+                employeeId: string;
+            };
+            scopes: InternalReviewScope[];
+        };
+        response: InternalReviewQueueItemEntity[];
+    };
+    [InternalReviewPatterns.getNotes]: {
+        payload: {
+            documentId: string;
+            actor: {
+                employeeId: string;
+            };
+            scopes: InternalReviewScope[];
+        };
+        response: DocumentInternalNotesResponseEntity;
+    };
+    [InternalReviewPatterns.addNote]: {
+        payload: {
+            documentId: string;
+            directorateCode: number;
+            text: string;
+            actor: {
+                employeeId: string;
+                fullName: string;
+            };
+            scopes: InternalReviewScope[];
+        };
+        response: DocumentInternalNoteResponseEntity;
+    };
+}

package/dist/contracts/internalReview.contract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InternalReviewPatterns = void 0;
+/** Patrones NATS de `internalReview`: revisoras de jefatura y sus observaciones internas. */
+exports.InternalReviewPatterns = {
+    getReviewers: 'gestorDocumental.internalReview.getReviewers',
+    setReviewers: 'gestorDocumental.internalReview.setReviewers',
+    getAssignments: 'gestorDocumental.internalReview.getAssignments',
+    getQueue: 'gestorDocumental.internalReview.getQueue',
+    getNotes: 'gestorDocumental.internalReview.getNotes',
+    addNote: 'gestorDocumental.internalReview.addNote',
+};

package/dist/entities/index.d.ts

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

package/dist/entities/index.js

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

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

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

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

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

@@ -0,0 +1,59 @@
+import { type DocumentStatus } from '../../base/entities';
+/** Revisoras asignadas a la jefatura de una dirección. */
+export interface DirectorateReviewersEntity {
+    directorateCode: number;
+    directorateName: string;
+    reviewers: {
+        employeeId: string;
+        fullName: string;
+    }[];
+}
+/** Qué espera de la jefatura un documento de la cola de revisión. */
+export type InternalReviewTurn = 'Visa' | 'Signature' | 'DraftReview';
+/** Documento que espera a la jefatura para la que revisa la funcionaria. */
+export interface InternalReviewQueueItemEntity {
+    documentId: string;
+    subject: string;
+    documentTypeName: string;
+    /** «D.E. N° 590/2026», o `null` mientras no tiene número. */
+    folio: string | null;
+    status: DocumentStatus;
+    createdByFullName: string;
+    directorateCode: number;
+    directorateName: string;
+    /** Quién de la jefatura tiene el turno (titular o subrogante). */
+    headFullName: string;
+    turn: InternalReviewTurn;
+    /** Ya le toca a la jefatura (si no, espera turnos anteriores). */
+    isCurrent: boolean;
+    /** Observaciones internas ya dejadas para esta jefatura. */
+    notes: number;
+    updatedAt: string;
+}
+/** Observación interna para la jefatura de una dirección. */
+export interface InternalNoteResponseEntity {
+    id: string;
+    directorateCode: number;
+    directorateName: string;
+    authorFullName: string;
+    /** `Reviewer`: la revisora; `Head`: la jefatura que responde. */
+    authorRole: 'Reviewer' | 'Head';
+    versionNumber: number;
+    text: string;
+    createdAt: string;
+}
+export interface DocumentInternalNotesResponseEntity {
+    notes: InternalNoteResponseEntity[];
+    /** Direcciones para las que quien consulta puede dejar una observación en este documento. */
+    canAddFor: {
+        directorateCode: number;
+        directorateName: string;
+    }[];
+}
+export interface DocumentInternalNoteResponseEntity {
+    note: InternalNoteResponseEntity;
+    /** A quién avisar (lo usa el gateway): la jefatura, si escribió la revisora; las revisoras, si respondió la jefatura. */
+    notify: {
+        employeeIds: string[];
+    };
+}

package/dist/entities/internalReview/internalReview.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.40",
+  "version": "0.0.1-beta.41",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/base/entities.ts

@@ -362,7 +362,8 @@ export type AuditEntity =
   | 'ServiceOutage'
   | 'Repository'
   | 'DataTreatment'
-  | 'DocumentTemplate';
+  | 'DocumentTemplate'
+  | 'DirectorateReviewer';
 
 export const AuditEntity = {
   DocumentType: 'DocumentType',
@@ -376,6 +377,7 @@ export const AuditEntity = {
   Repository: 'Repository',
   DataTreatment: 'DataTreatment',
   DocumentTemplate: 'DocumentTemplate',
+  DirectorateReviewer: 'DirectorateReviewer',
 } satisfies Record<string, AuditEntity>;
 
 export type AuditAction = 'Created' | 'Updated' | 'Enabled' | 'Disabled' | 'Removed' | 'Exported';
@@ -727,6 +729,7 @@ export interface DocumentEntity {
   comments?: DocumentCommentEntity[];
   draftReviews?: DocumentDraftReviewEntity[];
   draftingRequest?: DraftingRequestEntity | null;
+  internalNotes?: DocumentInternalNoteEntity[];
   accessRequestDeliveries?: AccessRequestDocumentEntity[];
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
@@ -1679,4 +1682,28 @@ export interface DraftingRequestEventEntity {
   createdAt: string;
 }
 
+export interface DirectorateReviewerEntity {
+  id: string;
+  directorateCode: number;
+  directorateName: string;
+  employeeId: string;
+  fullName: string;
+  createdAt: string;
+}
+
+export interface DocumentInternalNoteEntity {
+  id: string;
+  documentId: string;
+  document?: DocumentEntity;
+  directorateCode: number;
+  directorateName: string;
+  headEmployeeIds: string[];
+  versionNumber: number;
+  authorEmployeeId: string;
+  authorFullName: string;
+  authorRole: string;
+  text: string;
+  createdAt: string;
+}
+
 type JsonValue = string | number | boolean | { [key in string]?: JsonValue } | Array<JsonValue> | null;

package/src/contracts/document.contract.ts

@@ -80,6 +80,11 @@ export interface DocumentActor {
   employeeId: string;
   directorateCodes: number[];
   departmentIds: string[];
+  /**
+   * Jefaturas para las que revisa (revisora de jefatura): ve los documentos que les esperan. Lo resuelve el gateway
+   * solo donde hace falta (el detalle y el PDF).
+   */
+  reviewFor?: string[];
 }
 
 /** Bandeja desde la que se lista. Todas son del funcionario (`actor`), salvo `all`. */

package/src/contracts/index.ts

@@ -24,6 +24,7 @@ import { RegisterBookPatterns, type RegisterBookContract } from './registerBook.
 import { SignatureBatchPatterns, type SignatureBatchContract } from './signatureBatch.contract';
 import { WorkFolderPatterns, type WorkFolderContract } from './workFolder.contract';
 import { DraftingRequestPatterns, type DraftingRequestContract } from './draftingRequest.contract';
+import { InternalReviewPatterns, type InternalReviewContract } from './internalReview.contract';
 
 export * from './contract';
 export * from './document.contract';
@@ -52,6 +53,7 @@ export * from './desk.contract';
 export * from './mailIntake.contract';
 export * from './push.contract';
 export * from './draftingRequest.contract';
+export * from './internalReview.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -81,6 +83,7 @@ export const GestorDocumentalPatterns = {
   mailIntake: MailIntakePatterns,
   push: PushPatterns,
   draftingRequest: DraftingRequestPatterns,
+  internalReview: InternalReviewPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -109,4 +112,5 @@ export type GestorDocumentalContract = DocumentTypeContract &
   DeskContract &
   MailIntakeContract &
   PushContract &
-  DraftingRequestContract;
+  DraftingRequestContract &
+  InternalReviewContract;

package/src/contracts/internalReview.contract.ts

@@ -0,0 +1,66 @@
+import {
+  type DirectorateReviewersEntity,
+  type DocumentInternalNoteResponseEntity,
+  type DocumentInternalNotesResponseEntity,
+  type InternalReviewQueueItemEntity,
+} from '../entities';
+import { type AuditActorInput } from '../entities';
+
+/** Patrones NATS de `internalReview`: revisoras de jefatura y sus observaciones internas. */
+export const InternalReviewPatterns = {
+  getReviewers: 'gestorDocumental.internalReview.getReviewers',
+  setReviewers: 'gestorDocumental.internalReview.setReviewers',
+  getAssignments: 'gestorDocumental.internalReview.getAssignments',
+  getQueue: 'gestorDocumental.internalReview.getQueue',
+  getNotes: 'gestorDocumental.internalReview.getNotes',
+  addNote: 'gestorDocumental.internalReview.addNote',
+} as const;
+
+/**
+ * Dirección para la que actúa quien consulta: como revisora de su jefatura o como la jefatura misma. La resuelve el
+ * gateway: quiénes la dirigen hoy (titular y subrogante) no los dice el navegador.
+ */
+export interface InternalReviewScope {
+  directorateCode: number;
+  directorateName: string;
+  headEmployeeIds: string[];
+  role: 'Reviewer' | 'Head';
+}
+
+export interface InternalReviewContract {
+  [InternalReviewPatterns.getReviewers]: { payload: Record<string, never>; response: DirectorateReviewersEntity[] };
+  /** Reemplaza las revisoras de una dirección (sin ninguna, la dirección queda sin revisoras). */
+  [InternalReviewPatterns.setReviewers]: {
+    payload: {
+      directorateCode: number;
+      directorateName: string;
+      reviewers: { employeeId: string; fullName: string }[];
+      auditActor?: AuditActorInput;
+    };
+    response: { id: string; ok: boolean };
+  };
+  /** Direcciones para cuya jefatura revisa una funcionaria. */
+  [InternalReviewPatterns.getAssignments]: {
+    payload: { employeeId: string };
+    response: { directorateCode: number; directorateName: string }[];
+  };
+  /** Documentos que esperan a las jefaturas para las que revisa quien consulta. */
+  [InternalReviewPatterns.getQueue]: {
+    payload: { actor: { employeeId: string }; scopes: InternalReviewScope[] };
+    response: InternalReviewQueueItemEntity[];
+  };
+  [InternalReviewPatterns.getNotes]: {
+    payload: { documentId: string; actor: { employeeId: string }; scopes: InternalReviewScope[] };
+    response: DocumentInternalNotesResponseEntity;
+  };
+  [InternalReviewPatterns.addNote]: {
+    payload: {
+      documentId: string;
+      directorateCode: number;
+      text: string;
+      actor: { employeeId: string; fullName: string };
+      scopes: InternalReviewScope[];
+    };
+    response: DocumentInternalNoteResponseEntity;
+  };
+}

package/src/entities/index.ts

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

package/src/entities/internalReview/index.ts

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

package/src/entities/internalReview/internalReview.entity.ts

@@ -0,0 +1,57 @@
+import { type DocumentStatus } from '../../base/entities';
+
+/** Revisoras asignadas a la jefatura de una dirección. */
+export interface DirectorateReviewersEntity {
+  directorateCode: number;
+  directorateName: string;
+  reviewers: { employeeId: string; fullName: string }[];
+}
+
+/** Qué espera de la jefatura un documento de la cola de revisión. */
+export type InternalReviewTurn = 'Visa' | 'Signature' | 'DraftReview';
+
+/** Documento que espera a la jefatura para la que revisa la funcionaria. */
+export interface InternalReviewQueueItemEntity {
+  documentId: string;
+  subject: string;
+  documentTypeName: string;
+  /** «D.E. N° 590/2026», o `null` mientras no tiene número. */
+  folio: string | null;
+  status: DocumentStatus;
+  createdByFullName: string;
+  directorateCode: number;
+  directorateName: string;
+  /** Quién de la jefatura tiene el turno (titular o subrogante). */
+  headFullName: string;
+  turn: InternalReviewTurn;
+  /** Ya le toca a la jefatura (si no, espera turnos anteriores). */
+  isCurrent: boolean;
+  /** Observaciones internas ya dejadas para esta jefatura. */
+  notes: number;
+  updatedAt: string;
+}
+
+/** Observación interna para la jefatura de una dirección. */
+export interface InternalNoteResponseEntity {
+  id: string;
+  directorateCode: number;
+  directorateName: string;
+  authorFullName: string;
+  /** `Reviewer`: la revisora; `Head`: la jefatura que responde. */
+  authorRole: 'Reviewer' | 'Head';
+  versionNumber: number;
+  text: string;
+  createdAt: string;
+}
+
+export interface DocumentInternalNotesResponseEntity {
+  notes: InternalNoteResponseEntity[];
+  /** Direcciones para las que quien consulta puede dejar una observación en este documento. */
+  canAddFor: { directorateCode: number; directorateName: string }[];
+}
+
+export interface DocumentInternalNoteResponseEntity {
+  note: InternalNoteResponseEntity;
+  /** A quién avisar (lo usa el gateway): la jefatura, si escribió la revisora; las revisoras, si respondió la jefatura. */
+  notify: { employeeIds: string[] };
+}