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

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,40 @@ 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;
+}
+export interface RichImageEntity {
+    id: string;
+    fileId: string;
+    name: string;
+    mimeType: string;
+    width: number;
+    height: number;
+    sha256: string;
+    sizeBytes: number;
+    employeeId: 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,8 @@ 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';
+import { type RichImageContract } from './richImage.contract';
 export * from './contract';
 export * from './document.contract';
 export * from './documentType.contract';
@@ -51,6 +53,8 @@ export * from './desk.contract';
 export * from './mailIntake.contract';
 export * from './push.contract';
 export * from './draftingRequest.contract';
+export * from './internalReview.contract';
+export * from './richImage.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -307,6 +311,18 @@ 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";
+    };
+    readonly richImage: {
+        readonly register: "gestorDocumental.richImage.register";
+        readonly getFile: "gestorDocumental.richImage.getFile";
+    };
 };
 /** 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 & RichImageContract;

package/dist/contracts/index.js

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

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/contracts/richImage.contract.d.ts

@@ -0,0 +1,33 @@
+import { type RichImageResponseEntity } from '../entities';
+/** Patrones NATS de `richImage`: imágenes del editor (logos de membrete e imágenes del texto). */
+export declare const RichImagePatterns: {
+    readonly register: "gestorDocumental.richImage.register";
+    readonly getFile: "gestorDocumental.richImage.getFile";
+};
+export interface RichImageContract {
+    /**
+     * Registra una imagen ya subida a Drive por el gateway (en la carpeta de los documentos). El ms descarga el archivo, comprueba que sea PNG o JPEG y de
+     * tamaño aceptable, y guarda sus medidas y su huella.
+     */
+    [RichImagePatterns.register]: {
+        payload: {
+            fileId: string;
+            name: string;
+            actor: {
+                employeeId: string;
+            };
+        };
+        response: RichImageResponseEntity;
+    };
+    /** El archivo de una imagen registrada, para mostrarla en el editor. */
+    [RichImagePatterns.getFile]: {
+        payload: {
+            id: string;
+        };
+        response: {
+            fileId: string;
+            fileName: string;
+            mimeType: string;
+        };
+    };
+}

package/dist/contracts/richImage.contract.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RichImagePatterns = void 0;
+/** Patrones NATS de `richImage`: imágenes del editor (logos de membrete e imágenes del texto). */
+exports.RichImagePatterns = {
+    register: 'gestorDocumental.richImage.register',
+    getFile: 'gestorDocumental.richImage.getFile',
+};

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 RichLetterhead, type RichPage, type RichSpacing, type RichTextStyle } from './richStyle';
 import { type DocumentDraftingRequestEntity } from '../draftingRequest/draftingRequest.entity';
 /** Tipo documental de un documento, con lo necesario para citarlo. */
 export interface DocumentTypeSummaryEntity {
@@ -407,8 +408,8 @@ export interface DocumentTrailExportEntity {
 }
 /** Plantilla oficial con que se redacta un documento en el sistema. */
 export type DocumentTemplateKind = 'Decree' | 'Office' | 'Memorandum' | 'General';
-/** Formato de un trozo de texto en el editor del gestor. */
-export type RichMark = 'bold' | 'italic' | 'underline';
+/** Formato de un trozo de texto en el editor del gestor. Superíndice y subíndice no van juntos. */
+export type RichMark = 'bold' | 'italic' | 'underline' | 'strike' | 'superscript' | 'subscript';
 /**
  * Texto con su formato, o un campo de la plantilla (`field`: su clave), que se reemplaza por su valor al armar el PDF.
  * Un salto de línea dentro del texto (`\n`) es un salto de línea del párrafo.
@@ -416,8 +417,11 @@ export type RichMark = 'bold' | 'italic' | 'underline';
 export type RichInline = {
     text: string;
     marks?: RichMark[];
+    style?: RichTextStyle;
 } | {
     field: string;
+    marks?: RichMark[];
+    style?: RichTextStyle;
 };
 export type RichAlign = 'left' | 'center' | 'right' | 'justify';
 /** Numeración de una lista: viñetas, «1.» o la de los decretos, «1.-». */
@@ -435,6 +439,7 @@ export type RichBlock = {
     id: string;
     type: 'paragraph';
     align?: RichAlign;
+    spacing?: RichSpacing;
     locked?: boolean;
     content: RichInline[];
 } | {
@@ -442,6 +447,7 @@ export type RichBlock = {
     type: 'heading';
     level: 1 | 2;
     align?: RichAlign;
+    spacing?: RichSpacing;
     locked?: boolean;
     content: RichInline[];
 } | {
@@ -449,9 +455,20 @@ export type RichBlock = {
     type: 'listItem';
     list: RichListStyle;
     level: number;
+    spacing?: RichSpacing;
     locked?: boolean;
     content: RichInline[];
 }
+/** Imagen registrada en el gestor (`imageId`), con su ancho en puntos (sin pasar el del texto) y alineación. */
+ | {
+    id: string;
+    type: 'image';
+    imageId: string;
+    width: number;
+    align?: 'left' | 'center' | 'right';
+    caption?: string;
+    locked?: boolean;
+}
 /** `rows[fila][columna]`: el contenido de cada celda. */
  | {
     id: string;
@@ -526,6 +543,9 @@ export type DocumentComposition = {
     blocks: RichBlock[];
     fields: RichField[];
     distribution: string[];
+    /** Página y membrete. En una plantilla propia los pone su versión: lo que mande el navegador no cuenta. */
+    page?: RichPage;
+    letterhead?: RichLetterhead;
 };
 /** PDF armado con una plantilla: para la vista previa (`contentBase64`) o ya subido (`fileId`). */
 export interface DocumentComposeResponseEntity {

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

@@ -1 +1,2 @@
 export * from './document.entity';
+export * from './richStyle';

package/dist/entities/document/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./document.entity"), exports);
+__exportStar(require("./richStyle"), exports);

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

@@ -0,0 +1,160 @@
+/**
+ * Formato del editor del gestor que comparten el navegador y el microservicio: tipografías, colores, tamaños de hoja y
+ * márgenes. Todo lo que el PDF muestra sale de aquí, así que el editor y el documento oficial se ven igual.
+ */
+/**
+ * Tipografías incrustadas en el PDF (PDF/A exige fuentes incrustadas). Liberation Sans, Liberation Serif y Carlito
+ * miden igual que Arial, Times New Roman y Calibri: lo que se pegó desde Word ocupa lo mismo.
+ */
+export declare const RICH_FONTS: {
+    readonly Roboto: "Roboto";
+    readonly LiberationSans: "Liberation Sans (Arial)";
+    readonly LiberationSerif: "Liberation Serif (Times New Roman)";
+    readonly Carlito: "Carlito (Calibri)";
+};
+export type RichFont = keyof typeof RICH_FONTS;
+/** Tamaños de letra que se ofrecen, en puntos. */
+export declare const RICH_FONT_SIZES: readonly [8, 9, 10, 11, 12, 13, 14, 16, 18, 20, 24];
+/** Colores de letra: una paleta acotada, sobria, para documentos oficiales. */
+export declare const RICH_COLORS: {
+    readonly black: {
+        readonly label: "Negro";
+        readonly hex: "#111827";
+    };
+    readonly gray: {
+        readonly label: "Gris";
+        readonly hex: "#4B5563";
+    };
+    readonly blue: {
+        readonly label: "Azul";
+        readonly hex: "#1E40AF";
+    };
+    readonly red: {
+        readonly label: "Rojo";
+        readonly hex: "#B91C1C";
+    };
+    readonly green: {
+        readonly label: "Verde";
+        readonly hex: "#166534";
+    };
+    readonly brown: {
+        readonly label: "Café";
+        readonly hex: "#78350F";
+    };
+};
+export type RichColor = keyof typeof RICH_COLORS;
+/** Resaltado del texto. */
+export declare const RICH_HIGHLIGHTS: {
+    readonly yellow: {
+        readonly label: "Amarillo";
+        readonly hex: "#FEF08A";
+    };
+    readonly green: {
+        readonly label: "Verde";
+        readonly hex: "#BBF7D0";
+    };
+    readonly blue: {
+        readonly label: "Celeste";
+        readonly hex: "#BFDBFE";
+    };
+    readonly pink: {
+        readonly label: "Rosado";
+        readonly hex: "#FBCFE8";
+    };
+    readonly gray: {
+        readonly label: "Gris";
+        readonly hex: "#E5E7EB";
+    };
+};
+export type RichHighlight = keyof typeof RICH_HIGHLIGHTS;
+/** Formato propio de un trozo de texto, además de sus marcas. Sin valor, el de la página. */
+export interface RichTextStyle {
+    font?: RichFont;
+    size?: number;
+    color?: RichColor;
+    highlight?: RichHighlight;
+}
+/** Espaciado y sangría de un párrafo, título o punto de lista, en puntos (el interlineado, en veces la letra). */
+export interface RichSpacing {
+    before?: number;
+    after?: number;
+    lineHeight?: number;
+    /** Sangría de la primera línea. */
+    firstLine?: number;
+    /** Sangría de todo el párrafo, desde el margen izquierdo. */
+    left?: number;
+}
+/** Límites del espaciado, en puntos. */
+export declare const RICH_SPACING_LIMITS: {
+    readonly maxSpace: 72;
+    readonly maxIndent: 216;
+    readonly minLineHeight: 0.8;
+    readonly maxLineHeight: 3;
+};
+/** Tamaños de hoja, en puntos. Oficio es el chileno: 216 x 330 mm. */
+export declare const RICH_PAGE_SIZES: {
+    readonly letter: {
+        readonly label: "Carta (216 x 279 mm)";
+        readonly width: 612;
+        readonly height: 792;
+    };
+    readonly oficio: {
+        readonly label: "Oficio (216 x 330 mm)";
+        readonly width: 612;
+        readonly height: 936;
+    };
+};
+export type RichPageSize = keyof typeof RICH_PAGE_SIZES;
+export interface RichMargins {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/**
+ * Márgenes mínimos, en puntos: arriba van el membrete y el número con la fecha que estampa el sistema; abajo, la
+ * franja del QR en cada página; a los costados, los sellos. Con menos, lo estampado taparía el texto.
+ */
+export declare const RICH_MIN_MARGINS: RichMargins;
+/** Márgenes máximos, en puntos (unos 5 cm). */
+export declare const RICH_MAX_MARGIN = 144;
+/** Página de un documento: tamaño, márgenes y letra base. La define la plantilla; quien redacta no la cambia. */
+export interface RichPage {
+    size: RichPageSize;
+    margins: RichMargins;
+    font: RichFont;
+    fontSize: number;
+    lineHeight: number;
+}
+/** Página de siempre: Carta, con el espacio del membrete y los sellos, en Roboto 11. */
+export declare const RICH_DEFAULT_PAGE: RichPage;
+/**
+ * Membrete de la plantilla, en el margen superior de cada página: un logo o escudo (opcional) y el nombre de la
+ * municipalidad y de la unidad que emite. Va a la izquierda: a la derecha el sistema estampa el número y la fecha.
+ */
+export interface RichLetterhead {
+    /** Imagen registrada en el gestor (`RichImage`), no un archivo de Drive. */
+    imageId?: string | null;
+    /** Alto del logo, en puntos. */
+    imageHeight?: number;
+    showOrganName: boolean;
+    showUnitName: boolean;
+    /** Líneas propias bajo el nombre, como la dirección o el teléfono. */
+    lines?: string[];
+}
+export declare const RICH_DEFAULT_LETTERHEAD: RichLetterhead;
+/** Límites de una imagen: formatos, peso y tamaño en el texto. */
+export declare const RICH_IMAGE_LIMITS: {
+    readonly types: readonly ["image/png", "image/jpeg"];
+    readonly maxBytes: 2000000;
+    readonly minWidth: 24;
+    readonly maxLetterheadHeight: 56;
+};
+/** Imagen subida al gestor para el editor: se usa por su id; el archivo está en Drive. */
+export interface RichImageResponseEntity {
+    id: string;
+    name: string;
+    mimeType: string;
+    width: number;
+    height: number;
+}

package/dist/entities/document/richStyle.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Formato del editor del gestor que comparten el navegador y el microservicio: tipografías, colores, tamaños de hoja y
+ * márgenes. Todo lo que el PDF muestra sale de aquí, así que el editor y el documento oficial se ven igual.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RICH_IMAGE_LIMITS = exports.RICH_DEFAULT_LETTERHEAD = exports.RICH_DEFAULT_PAGE = exports.RICH_MAX_MARGIN = exports.RICH_MIN_MARGINS = exports.RICH_PAGE_SIZES = exports.RICH_SPACING_LIMITS = exports.RICH_HIGHLIGHTS = exports.RICH_COLORS = exports.RICH_FONT_SIZES = exports.RICH_FONTS = void 0;
+/**
+ * Tipografías incrustadas en el PDF (PDF/A exige fuentes incrustadas). Liberation Sans, Liberation Serif y Carlito
+ * miden igual que Arial, Times New Roman y Calibri: lo que se pegó desde Word ocupa lo mismo.
+ */
+exports.RICH_FONTS = {
+    Roboto: 'Roboto',
+    LiberationSans: 'Liberation Sans (Arial)',
+    LiberationSerif: 'Liberation Serif (Times New Roman)',
+    Carlito: 'Carlito (Calibri)',
+};
+/** Tamaños de letra que se ofrecen, en puntos. */
+exports.RICH_FONT_SIZES = [8, 9, 10, 11, 12, 13, 14, 16, 18, 20, 24];
+/** Colores de letra: una paleta acotada, sobria, para documentos oficiales. */
+exports.RICH_COLORS = {
+    black: { label: 'Negro', hex: '#111827' },
+    gray: { label: 'Gris', hex: '#4B5563' },
+    blue: { label: 'Azul', hex: '#1E40AF' },
+    red: { label: 'Rojo', hex: '#B91C1C' },
+    green: { label: 'Verde', hex: '#166534' },
+    brown: { label: 'Café', hex: '#78350F' },
+};
+/** Resaltado del texto. */
+exports.RICH_HIGHLIGHTS = {
+    yellow: { label: 'Amarillo', hex: '#FEF08A' },
+    green: { label: 'Verde', hex: '#BBF7D0' },
+    blue: { label: 'Celeste', hex: '#BFDBFE' },
+    pink: { label: 'Rosado', hex: '#FBCFE8' },
+    gray: { label: 'Gris', hex: '#E5E7EB' },
+};
+/** Límites del espaciado, en puntos. */
+exports.RICH_SPACING_LIMITS = { maxSpace: 72, maxIndent: 216, minLineHeight: 0.8, maxLineHeight: 3 };
+/** Tamaños de hoja, en puntos. Oficio es el chileno: 216 x 330 mm. */
+exports.RICH_PAGE_SIZES = {
+    letter: { label: 'Carta (216 x 279 mm)', width: 612, height: 792 },
+    oficio: { label: 'Oficio (216 x 330 mm)', width: 612, height: 936 },
+};
+/**
+ * Márgenes mínimos, en puntos: arriba van el membrete y el número con la fecha que estampa el sistema; abajo, la
+ * franja del QR en cada página; a los costados, los sellos. Con menos, lo estampado taparía el texto.
+ */
+exports.RICH_MIN_MARGINS = { top: 64, right: 42, bottom: 64, left: 42 };
+/** Márgenes máximos, en puntos (unos 5 cm). */
+exports.RICH_MAX_MARGIN = 144;
+/** Página de siempre: Carta, con el espacio del membrete y los sellos, en Roboto 11. */
+exports.RICH_DEFAULT_PAGE = {
+    size: 'letter',
+    margins: { top: 104, right: 64, bottom: 76, left: 72 },
+    font: 'Roboto',
+    fontSize: 11,
+    lineHeight: 1.2,
+};
+exports.RICH_DEFAULT_LETTERHEAD = { imageId: null, showOrganName: true, showUnitName: true };
+/** Límites de una imagen: formatos, peso y tamaño en el texto. */
+exports.RICH_IMAGE_LIMITS = {
+    types: ['image/png', 'image/jpeg'],
+    maxBytes: 2000000,
+    minWidth: 24,
+    maxLetterheadHeight: 56,
+};

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

@@ -1,5 +1,6 @@
 import { type DocumentTemplateEntity } from '../../base/entities';
 import { type RichBlock, type RichField } from '../document/document.entity';
+import { type RichLetterhead, type RichPage } from '../document/richStyle';
 /**
  * Contenido de una plantilla propia: los bloques del editor (con sus partes fijas) y los campos que completa quien
  * redacta (en la plantilla, sin valor).
@@ -7,6 +8,10 @@ import { type RichBlock, type RichField } from '../document/document.entity';
 export interface DocumentTemplateContent {
     blocks: RichBlock[];
     fields: RichField[];
+    /** Tamaño de hoja, márgenes y letra base. Sin valor, la página de siempre (`RICH_DEFAULT_PAGE`). */
+    page?: RichPage;
+    /** Membrete con logo. Sin valor, el nombre de la municipalidad y de la unidad. */
+    letterhead?: RichLetterhead;
 }
 /** Plantilla propia en el listado de quien las administra. */
 export interface DocumentTemplateGetAllResponseEntity {

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.42",
   "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,41 @@ 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;
+}
+
+export interface RichImageEntity {
+  id: string;
+  fileId: string;
+  name: string;
+  mimeType: string;
+  width: number;
+  height: number;
+  sha256: string;
+  sizeBytes: number;
+  employeeId: 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,8 @@ 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';
+import { RichImagePatterns, type RichImageContract } from './richImage.contract';
 
 export * from './contract';
 export * from './document.contract';
@@ -52,6 +54,8 @@ export * from './desk.contract';
 export * from './mailIntake.contract';
 export * from './push.contract';
 export * from './draftingRequest.contract';
+export * from './internalReview.contract';
+export * from './richImage.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -81,6 +85,8 @@ export const GestorDocumentalPatterns = {
   mailIntake: MailIntakePatterns,
   push: PushPatterns,
   draftingRequest: DraftingRequestPatterns,
+  internalReview: InternalReviewPatterns,
+  richImage: RichImagePatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -109,4 +115,6 @@ export type GestorDocumentalContract = DocumentTypeContract &
   DeskContract &
   MailIntakeContract &
   PushContract &
-  DraftingRequestContract;
+  DraftingRequestContract &
+  InternalReviewContract &
+  RichImageContract;

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/contracts/richImage.contract.ts

@@ -0,0 +1,23 @@
+import { type RichImageResponseEntity } from '../entities';
+
+/** Patrones NATS de `richImage`: imágenes del editor (logos de membrete e imágenes del texto). */
+export const RichImagePatterns = {
+  register: 'gestorDocumental.richImage.register',
+  getFile: 'gestorDocumental.richImage.getFile',
+} as const;
+
+export interface RichImageContract {
+  /**
+   * Registra una imagen ya subida a Drive por el gateway (en la carpeta de los documentos). El ms descarga el archivo, comprueba que sea PNG o JPEG y de
+   * tamaño aceptable, y guarda sus medidas y su huella.
+   */
+  [RichImagePatterns.register]: {
+    payload: { fileId: string; name: string; actor: { employeeId: string } };
+    response: RichImageResponseEntity;
+  };
+  /** El archivo de una imagen registrada, para mostrarla en el editor. */
+  [RichImagePatterns.getFile]: {
+    payload: { id: string };
+    response: { fileId: string; fileName: string; mimeType: string };
+  };
+}

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

@@ -10,6 +10,7 @@ import {
   DocumentTrackingEntity,
   DocumentTypeEntity,
 } from '../../base/entities';
+import { type RichLetterhead, type RichPage, type RichSpacing, type RichTextStyle } from './richStyle';
 import { type DocumentDraftingRequestEntity } from '../draftingRequest/draftingRequest.entity';
 
 /** Tipo documental de un documento, con lo necesario para citarlo. */
@@ -453,14 +454,16 @@ export interface DocumentTrailExportEntity {
 /** Plantilla oficial con que se redacta un documento en el sistema. */
 export type DocumentTemplateKind = 'Decree' | 'Office' | 'Memorandum' | 'General';
 
-/** Formato de un trozo de texto en el editor del gestor. */
-export type RichMark = 'bold' | 'italic' | 'underline';
+/** Formato de un trozo de texto en el editor del gestor. Superíndice y subíndice no van juntos. */
+export type RichMark = 'bold' | 'italic' | 'underline' | 'strike' | 'superscript' | 'subscript';
 
 /**
  * Texto con su formato, o un campo de la plantilla (`field`: su clave), que se reemplaza por su valor al armar el PDF.
  * Un salto de línea dentro del texto (`\n`) es un salto de línea del párrafo.
  */
-export type RichInline = { text: string; marks?: RichMark[] } | { field: string };
+export type RichInline =
+  | { text: string; marks?: RichMark[]; style?: RichTextStyle }
+  | { field: string; marks?: RichMark[]; style?: RichTextStyle };
 
 export type RichAlign = 'left' | 'center' | 'right' | 'justify';
 
@@ -478,9 +481,35 @@ export type RichTableVariant = 'grid' | 'labels' | 'labelsRight';
  * bloques seguidos del mismo estilo (su nivel es la sangría, desde 0); un título o un párrafo reinicia la numeración.
  */
 export type RichBlock =
-  | { id: string; type: 'paragraph'; align?: RichAlign; locked?: boolean; content: RichInline[] }
-  | { id: string; type: 'heading'; level: 1 | 2; align?: RichAlign; locked?: boolean; content: RichInline[] }
-  | { id: string; type: 'listItem'; list: RichListStyle; level: number; locked?: boolean; content: RichInline[] }
+  | { id: string; type: 'paragraph'; align?: RichAlign; spacing?: RichSpacing; locked?: boolean; content: RichInline[] }
+  | {
+      id: string;
+      type: 'heading';
+      level: 1 | 2;
+      align?: RichAlign;
+      spacing?: RichSpacing;
+      locked?: boolean;
+      content: RichInline[];
+    }
+  | {
+      id: string;
+      type: 'listItem';
+      list: RichListStyle;
+      level: number;
+      spacing?: RichSpacing;
+      locked?: boolean;
+      content: RichInline[];
+    }
+  /** Imagen registrada en el gestor (`imageId`), con su ancho en puntos (sin pasar el del texto) y alineación. */
+  | {
+      id: string;
+      type: 'image';
+      imageId: string;
+      width: number;
+      align?: 'left' | 'center' | 'right';
+      caption?: string;
+      locked?: boolean;
+    }
   /** `rows[fila][columna]`: el contenido de cada celda. */
   | { id: string; type: 'table'; variant: RichTableVariant; locked?: boolean; rows: RichInline[][][] }
   | { id: string; type: 'rule'; locked?: boolean }
@@ -544,6 +573,9 @@ export type DocumentComposition =
       blocks: RichBlock[];
       fields: RichField[];
       distribution: string[];
+      /** Página y membrete. En una plantilla propia los pone su versión: lo que mande el navegador no cuenta. */
+      page?: RichPage;
+      letterhead?: RichLetterhead;
     };
 
 /** PDF armado con una plantilla: para la vista previa (`contentBase64`) o ya subido (`fileId`). */

package/src/entities/document/index.ts

@@ -1 +1,2 @@
 export * from './document.entity';
+export * from './richStyle';

package/src/entities/document/richStyle.ts

@@ -0,0 +1,141 @@
+/**
+ * Formato del editor del gestor que comparten el navegador y el microservicio: tipografías, colores, tamaños de hoja y
+ * márgenes. Todo lo que el PDF muestra sale de aquí, así que el editor y el documento oficial se ven igual.
+ */
+
+/**
+ * Tipografías incrustadas en el PDF (PDF/A exige fuentes incrustadas). Liberation Sans, Liberation Serif y Carlito
+ * miden igual que Arial, Times New Roman y Calibri: lo que se pegó desde Word ocupa lo mismo.
+ */
+export const RICH_FONTS = {
+  Roboto: 'Roboto',
+  LiberationSans: 'Liberation Sans (Arial)',
+  LiberationSerif: 'Liberation Serif (Times New Roman)',
+  Carlito: 'Carlito (Calibri)',
+} as const;
+
+export type RichFont = keyof typeof RICH_FONTS;
+
+/** Tamaños de letra que se ofrecen, en puntos. */
+export const RICH_FONT_SIZES = [8, 9, 10, 11, 12, 13, 14, 16, 18, 20, 24] as const;
+
+/** Colores de letra: una paleta acotada, sobria, para documentos oficiales. */
+export const RICH_COLORS = {
+  black: { label: 'Negro', hex: '#111827' },
+  gray: { label: 'Gris', hex: '#4B5563' },
+  blue: { label: 'Azul', hex: '#1E40AF' },
+  red: { label: 'Rojo', hex: '#B91C1C' },
+  green: { label: 'Verde', hex: '#166534' },
+  brown: { label: 'Café', hex: '#78350F' },
+} as const;
+
+export type RichColor = keyof typeof RICH_COLORS;
+
+/** Resaltado del texto. */
+export const RICH_HIGHLIGHTS = {
+  yellow: { label: 'Amarillo', hex: '#FEF08A' },
+  green: { label: 'Verde', hex: '#BBF7D0' },
+  blue: { label: 'Celeste', hex: '#BFDBFE' },
+  pink: { label: 'Rosado', hex: '#FBCFE8' },
+  gray: { label: 'Gris', hex: '#E5E7EB' },
+} as const;
+
+export type RichHighlight = keyof typeof RICH_HIGHLIGHTS;
+
+/** Formato propio de un trozo de texto, además de sus marcas. Sin valor, el de la página. */
+export interface RichTextStyle {
+  font?: RichFont;
+  size?: number;
+  color?: RichColor;
+  highlight?: RichHighlight;
+}
+
+/** Espaciado y sangría de un párrafo, título o punto de lista, en puntos (el interlineado, en veces la letra). */
+export interface RichSpacing {
+  before?: number;
+  after?: number;
+  lineHeight?: number;
+  /** Sangría de la primera línea. */
+  firstLine?: number;
+  /** Sangría de todo el párrafo, desde el margen izquierdo. */
+  left?: number;
+}
+
+/** Límites del espaciado, en puntos. */
+export const RICH_SPACING_LIMITS = { maxSpace: 72, maxIndent: 216, minLineHeight: 0.8, maxLineHeight: 3 } as const;
+
+/** Tamaños de hoja, en puntos. Oficio es el chileno: 216 x 330 mm. */
+export const RICH_PAGE_SIZES = {
+  letter: { label: 'Carta (216 x 279 mm)', width: 612, height: 792 },
+  oficio: { label: 'Oficio (216 x 330 mm)', width: 612, height: 936 },
+} as const;
+
+export type RichPageSize = keyof typeof RICH_PAGE_SIZES;
+
+export interface RichMargins {
+  top: number;
+  right: number;
+  bottom: number;
+  left: number;
+}
+
+/**
+ * Márgenes mínimos, en puntos: arriba van el membrete y el número con la fecha que estampa el sistema; abajo, la
+ * franja del QR en cada página; a los costados, los sellos. Con menos, lo estampado taparía el texto.
+ */
+export const RICH_MIN_MARGINS: RichMargins = { top: 64, right: 42, bottom: 64, left: 42 };
+
+/** Márgenes máximos, en puntos (unos 5 cm). */
+export const RICH_MAX_MARGIN = 144;
+
+/** Página de un documento: tamaño, márgenes y letra base. La define la plantilla; quien redacta no la cambia. */
+export interface RichPage {
+  size: RichPageSize;
+  margins: RichMargins;
+  font: RichFont;
+  fontSize: number;
+  lineHeight: number;
+}
+
+/** Página de siempre: Carta, con el espacio del membrete y los sellos, en Roboto 11. */
+export const RICH_DEFAULT_PAGE: RichPage = {
+  size: 'letter',
+  margins: { top: 104, right: 64, bottom: 76, left: 72 },
+  font: 'Roboto',
+  fontSize: 11,
+  lineHeight: 1.2,
+};
+
+/**
+ * Membrete de la plantilla, en el margen superior de cada página: un logo o escudo (opcional) y el nombre de la
+ * municipalidad y de la unidad que emite. Va a la izquierda: a la derecha el sistema estampa el número y la fecha.
+ */
+export interface RichLetterhead {
+  /** Imagen registrada en el gestor (`RichImage`), no un archivo de Drive. */
+  imageId?: string | null;
+  /** Alto del logo, en puntos. */
+  imageHeight?: number;
+  showOrganName: boolean;
+  showUnitName: boolean;
+  /** Líneas propias bajo el nombre, como la dirección o el teléfono. */
+  lines?: string[];
+}
+
+export const RICH_DEFAULT_LETTERHEAD: RichLetterhead = { imageId: null, showOrganName: true, showUnitName: true };
+
+/** Límites de una imagen: formatos, peso y tamaño en el texto. */
+export const RICH_IMAGE_LIMITS = {
+  types: ['image/png', 'image/jpeg'],
+  maxBytes: 2_000_000,
+  minWidth: 24,
+  maxLetterheadHeight: 56,
+} as const;
+
+/** Imagen subida al gestor para el editor: se usa por su id; el archivo está en Drive. */
+export interface RichImageResponseEntity {
+  id: string;
+  name: string;
+  mimeType: string;
+  width: number;
+  height: number;
+}

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

@@ -1,5 +1,6 @@
 import { type DocumentTemplateEntity } from '../../base/entities';
 import { type RichBlock, type RichField } from '../document/document.entity';
+import { type RichLetterhead, type RichPage } from '../document/richStyle';
 
 /**
  * Contenido de una plantilla propia: los bloques del editor (con sus partes fijas) y los campos que completa quien
@@ -8,6 +9,10 @@ import { type RichBlock, type RichField } from '../document/document.entity';
 export interface DocumentTemplateContent {
   blocks: RichBlock[];
   fields: RichField[];
+  /** Tamaño de hoja, márgenes y letra base. Sin valor, la página de siempre (`RICH_DEFAULT_PAGE`). */
+  page?: RichPage;
+  /** Membrete con logo. Sin valor, el nombre de la municipalidad y de la unidad. */
+  letterhead?: RichLetterhead;
 }
 
 /** Plantilla propia en el listado de quien las administra. */

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[] };
+}