@muni-sanfer/types-gestor-documental 0.0.1-beta.5 → 0.0.1-beta.50

package/src/entities/document/richStyle.ts

@@ -0,0 +1,193 @@
+/**
+ * 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,
+};
+
+/**
+ * Una imagen del encabezado (logo, escudo, sello) en el diseño libre: imagen registrada en el gestor, con su lugar y su
+ * tamaño en puntos desde la esquina superior izquierda de la hoja. Cabe en el margen superior.
+ */
+export interface RichLetterheadImage {
+  imageId: string;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
+export type RichLetterheadAlign = 'left' | 'center' | 'right';
+
+/** El texto del membrete (nombre de la municipalidad, unidad y líneas propias) en el diseño libre. */
+export interface RichLetterheadText {
+  x: number;
+  y: number;
+  width: number;
+  align: RichLetterheadAlign;
+  /** Tamaño del nombre de la municipalidad, en puntos (sin valor, 10). */
+  organSize?: number;
+  /** Tamaño de la unidad y de las líneas propias, en puntos (sin valor, 8). */
+  lineSize?: number;
+}
+
+/**
+ * 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.
+ *
+ * Con `text`, el diseño es libre: las imágenes de `images` y el texto van donde se ubicaron (y `imageId` e
+ * `imageHeight` no se usan). Sin `text`, el de siempre: el logo de `imageId` y, a su lado, el texto.
+ */
+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[];
+  /** Diseño libre: las imágenes del encabezado, donde se ubicaron. */
+  images?: RichLetterheadImage[];
+  /** Diseño libre: dónde va el texto y con qué tamaño. */
+  text?: RichLetterheadText;
+  /** Línea divisoria bajo el encabezado, de margen a margen. */
+  rule?: boolean;
+}
+
+/** Límites del diseño libre del encabezado. */
+export const RICH_LETTERHEAD_LIMITS = {
+  maxImages: 4,
+  /** Lado mínimo de una imagen, en puntos. */
+  minImageSize: 12,
+  /** Ancho mínimo del texto, en puntos. */
+  minTextWidth: 60,
+  organSizes: [8, 9, 10, 11, 12, 13, 14, 16],
+  lineSizes: [6, 7, 8, 9, 10, 11, 12],
+} as const;
+
+/**
+ * Lo que ocupa en la primera página el número y la fecha que estampa el sistema, arriba a la derecha: el encabezado no
+ * debe taparlo. En puntos; `right` es la distancia al borde derecho.
+ */
+export const RICH_NUMBER_ZONE = { right: 36, top: 18, height: 30, width: 230 } as const;
+
+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

@@ -0,0 +1,27 @@
+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 la plantilla de un tipo documental: los bloques del editor (con sus partes fijas) y los campos que
+ * completa quien redacta (en la plantilla, sin valor).
+ */
+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;
+}
+
+/** La plantilla de un tipo documental, que se aplica al redactar uno de sus documentos: lista para usar. */
+export interface DocumentTemplateAvailableResponseEntity {
+  id: DocumentTemplateEntity['id'];
+  name: DocumentTemplateEntity['name'];
+  description: string | null;
+  version: DocumentTemplateEntity['version'];
+  content: DocumentTemplateContent;
+  /** Es la plantilla del tipo documental pedido: se aplica sola al redactar. */
+  ownedByType: boolean;
+}

package/src/entities/documentTemplate/index.ts

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

package/src/entities/documentType/documentType.entity.ts

@@ -1,4 +1,5 @@
 import { DocumentTypeEntity, DocumentTypeFlowStepEntity } from '../../base/entities';
+import { type DocumentTemplateContent } from '../documentTemplate/documentTemplate.entity';
 
 /** Paso del flujo sugerido de un tipo documental: quién visa o firma, en su orden. */
 export interface DocumentTypeFlowStepResponseEntity {
@@ -11,6 +12,8 @@ export interface DocumentTypeFlowStepResponseEntity {
   // Nombre del funcionario o de la dirección, como estaba al definir el flujo.
   name: DocumentTypeFlowStepEntity['name'];
   position: DocumentTypeFlowStepEntity['position'];
+  // Visa a la vez con el paso anterior (visación en paralelo).
+  withPrevious: DocumentTypeFlowStepEntity['withPrevious'];
 }
 
 export interface DocumentTypeGetAllResponseEntity {
@@ -22,10 +25,48 @@ export interface DocumentTypeGetAllResponseEntity {
   nextCorrelative: DocumentTypeEntity['nextCorrelative'];
   correlativeYear: DocumentTypeEntity['correlativeYear'];
   resetsYearly: DocumentTypeEntity['resetsYearly'];
+  // Sin numeración, sus documentos solo llevan fecha, código de verificación y QR.
+  numbered: DocumentTypeEntity['numbered'];
+  /** Transparencia Activa: sus documentos se publican cada mes, en esta sección del Portal. */
+  activeTransparency: DocumentTypeEntity['activeTransparency'];
+  transparencySection: DocumentTypeEntity['transparencySection'];
   directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
+  // Dirección cuya jefatura revisa los borradores antes de enviarlos a tramitación (sin valor: no hay revisión).
+  draftReviewDirectorateCode: DocumentTypeEntity['draftReviewDirectorateCode'];
+  draftReviewDirectorateName: DocumentTypeEntity['draftReviewDirectorateName'];
+  // Serie documental del Cuadro de Clasificación a la que van sus documentos (MGDDE1_2).
+  archivalSeries: { id: string; code: string; name: string } | null;
+  // Entidad que emite sus documentos (Educación, Salud, Juzgado). `null`: la municipalidad.
+  issuingEntity: { id: string; name: string; shortName: string | null } | null;
+  // Tipo cuyo correlativo comparte: sus números salen de esa serie (y `nextCorrelative`, `correlativeYear` y
+  // `resetsYearly` son los de ese tipo). `null`: lleva su propio correlativo.
+  sharesNumberingWith: { id: string; name: string } | null;
+  // Tipos que toman sus números del correlativo de este.
+  numberingMembers: { id: string; name: string }[];
   enabled: DocumentTypeEntity['enabled'];
+  // Versión vigente de su configuración: la toman los documentos nuevos y los borradores al guardarse.
+  version: DocumentTypeEntity['version'];
   // Cuántos visadores y firmantes tiene su flujo sugerido.
   flow: { visa: number; signature: number };
+  // Tiene plantilla propia: se aplica sola al redactar.
+  hasTemplate: boolean;
+}
+
+/** Plantilla propia de un tipo documental: la versión vigente de su contenido. */
+export interface DocumentTypeTemplateResponseEntity {
+  id: string;
+  version: number;
+  content: DocumentTemplateContent;
+}
+
+/** Una versión de la configuración del tipo: los documentos enviados a tramitación con ella la conservan. */
+export interface DocumentTypeVersionResponseEntity {
+  version: number;
+  createdAt: string;
+  // Quién guardó el cambio (sin valor en la primera versión de un tipo anterior a las versiones).
+  createdByFullName: string | null;
+  // Documentos en tramitación (o devueltos para corregir) que siguen con esta versión.
+  documentsInProcess: number;
 }
 
 export interface DocumentTypeGetByIdResponseEntity extends DocumentTypeGetAllResponseEntity {
@@ -34,6 +75,10 @@ export interface DocumentTypeGetByIdResponseEntity extends DocumentTypeGetAllRes
   lastCorrelative: number | null;
   // Flujo sugerido: primero los visadores y después los firmantes, cada grupo en su orden.
   flowSteps: DocumentTypeFlowStepResponseEntity[];
+  // Plantilla propia del tipo (sin valor: no la tiene).
+  template: DocumentTypeTemplateResponseEntity | null;
+  // Versiones, de la más nueva a la más antigua.
+  versions: DocumentTypeVersionResponseEntity[];
 }
 
 export interface DocumentTypeCreateResponseEntity {

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

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

package/src/entities/draftingRequest/index.ts

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

package/src/entities/holiday/holiday.entity.ts

@@ -0,0 +1,36 @@
+import { type HolidaySource } from '../../base/entities';
+
+/** Feriado: el día («AAAA-MM-DD») no cuenta como hábil en los plazos. */
+export interface HolidayResponseEntity {
+  id: string;
+  date: string;
+  name: string;
+  /** Cargado a mano o traído de la API pública de feriados. */
+  source: HolidaySource;
+  /** Como lo informa la API. Ej: «Civil e Irrenunciable». */
+  kind: string | null;
+  /** Uno de la API que se quitó a mano: no cuenta, y la próxima actualización no lo vuelve a agregar. */
+  excluded: boolean;
+}
+
+/** Feriados de un año y cuándo se trajeron de la API por última vez (`null` si nunca). */
+export interface HolidayListResponseEntity {
+  holidays: HolidayResponseEntity[];
+  syncedAt: string | null;
+}
+
+export interface HolidayRemoveResponseEntity {
+  id: string;
+  ok: boolean;
+}
+
+/** Resultado de traer de la API los feriados de un año: los agregados, actualizados y quitados por la API. */
+export interface HolidaySyncResponseEntity {
+  year: number;
+  added: number;
+  updated: number;
+  removed: number;
+  /** Cuántos informó la API para ese año. */
+  total: number;
+  syncedAt: string;
+}

package/src/entities/holiday/index.ts

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

package/src/entities/index.ts

@@ -1,5 +1,27 @@
 export * from './documentType';
 export * from './document';
 export * from './procedure';
+export * from './issuingEntity';
 export * from './caseFile';
 export * from './partsOffice';
+export * from './registerBook';
+export * from './signatureBatch';
+export * from './workFolder';
+export * from './scan';
+export * from './archivalSeries';
+export * from './textSnippet';
+export * from './holiday';
+export * from './indicators';
+export * from './audit';
+export * from './signatureCheck';
+export * from './repositoryExport';
+export * from './retention';
+export * from './accessRequest';
+export * from './transparency';
+export * from './dataProtection';
+export * from './desk';
+export * from './mailIntake';
+export * from './push';
+export * from './documentTemplate';
+export * from './draftingRequest';
+export * from './internalReview';

package/src/entities/indicators/index.ts

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

package/src/entities/indicators/indicators.entity.ts

@@ -0,0 +1,157 @@
+import { type DocumentParticipantRole, type QualityMetricKey, type ServiceOutageKind } from '../../base/entities';
+
+/** Tiempos de tramitación, desde el primer envío a tramitación hasta la última firma. En días corridos y hábiles. */
+export interface ProcessingTimeEntity {
+  count: number;
+  averageDays: number | null;
+  medianDays: number | null;
+  p90Days: number | null;
+  averageBusinessDays: number | null;
+}
+
+export interface IndicatorsByTypeEntity {
+  documentTypeId: string;
+  name: string;
+  submitted: number;
+  finished: number;
+  rejections: number;
+  averageDays: number | null;
+  averageBusinessDays: number | null;
+}
+
+/** Unidad emisora: una dirección (código de caschile) o un departamento; el nombre lo pone el front. */
+export interface IndicatorsByUnitEntity {
+  directorateCode: number | null;
+  departmentId: string | null;
+  submitted: number;
+  finished: number;
+  averageDays: number | null;
+  averageBusinessDays: number | null;
+}
+
+/** Quién demora más en su turno de visación o firma, y cuánto tiene pendiente hoy. */
+export interface IndicatorsBottleneckEntity {
+  employeeId: string;
+  fullName: string;
+  role: DocumentParticipantRole;
+  resolved: number;
+  averageDays: number | null;
+  pending: number;
+  oldestPendingDays: number | null;
+}
+
+export interface ManagementIndicatorsEntity {
+  /** Período consultado, días de Chile «AAAA-MM-DD». */
+  from: string;
+  to: string;
+  generatedAt: string;
+  filters: { documentTypeId: string | null; directorateCode: number | null };
+  volume: {
+    /** Enviados a tramitación por primera vez en el período. */
+    submitted: number;
+    finished: number;
+    /** Rechazos de visadores y firmantes (un documento puede tener varios). */
+    rejections: number;
+    annulled: number;
+    discarded: number;
+    /** En tramitación hoy, sin importar el período. */
+    inProcess: number;
+  };
+  processing: ProcessingTimeEntity;
+  byType: IndicatorsByTypeEntity[];
+  byUnit: IndicatorsByUnitEntity[];
+  /** Por mes de Chile «AAAA-MM». */
+  monthly: { month: string; submitted: number; finished: number }[];
+  bottlenecks: IndicatorsBottleneckEntity[];
+  /** Plazos de lo recibido y derivado que vencían en el período. */
+  deadlines: {
+    withDeadline: number;
+    onTime: number;
+    late: number;
+    /** Vencidos sin atender. */
+    overdue: number;
+    /** Sin atender, todavía en plazo. */
+    pending: number;
+    /** A tiempo sobre los ya resueltos o vencidos, en %. */
+    onTimeRate: number | null;
+  };
+  partsOffice: {
+    received: number;
+    registered: number;
+    returned: number;
+    /** Días desde que llegó por DocDigital hasta que Partes lo ingresó. */
+    averageIntakeDays: number | null;
+    dispatched: number;
+    dispatchReturned: number;
+  };
+}
+
+export type QualityMetricUnit = 'Percent' | 'Ratio' | 'Milliseconds';
+export type QualityMetricDirection = 'AtLeast' | 'AtMost';
+
+/** Una métrica del Plan de Mejora Continua, con su valor en el período y su umbral. */
+export interface QualityMetricEntity {
+  key: QualityMetricKey;
+  /** Subcaracterística de la ISO/IEC 25010 que mide. */
+  subcharacteristic: string;
+  model: 'Product' | 'InUse';
+  name: string;
+  description: string;
+  /** La mide el sistema o la declara quien administra la calidad, con su respaldo. */
+  source: 'Measured' | 'Declared';
+  value: number | null;
+  unit: QualityMetricUnit;
+  threshold: number;
+  direction: QualityMetricDirection;
+  /** Cumple el umbral. `null` sin valor. */
+  meets: boolean | null;
+  /** Con qué se calculó: cantidades del período. */
+  detail: string | null;
+  declaredNote: string | null;
+  declaredAt: string | null;
+  declaredByFullName: string | null;
+}
+
+export interface ServiceOutageResponseEntity {
+  id: string;
+  kind: ServiceOutageKind;
+  startedAt: string;
+  endedAt: string | null;
+  /** Duración en minutos; si sigue caído, hasta ahora. */
+  minutes: number;
+  cause: string;
+  affectedServices: string | null;
+  createdByFullName: string;
+  updatedByFullName: string | null;
+  createdAt: string;
+}
+
+export interface QualityReportEntity {
+  from: string;
+  to: string;
+  generatedAt: string;
+  metrics: QualityMetricEntity[];
+  /** Caídas que tocan el período. */
+  outages: ServiceOutageResponseEntity[];
+}
+
+export interface QualityMetricSettingResponseEntity {
+  key: QualityMetricKey;
+  threshold: number;
+  declaredValue: number | null;
+  declaredNote: string | null;
+  declaredAt: string | null;
+  declaredByFullName: string | null;
+}
+
+export interface ServiceOutageRemoveResponseEntity {
+  id: string;
+  ok: boolean;
+}
+
+/** Un archivo generado (planilla o certificado), en base64. */
+export interface IndicatorsFileEntity {
+  fileName: string;
+  contentType: string;
+  contentBase64: string;
+}

package/src/entities/internalReview/index.ts

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

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

@@ -0,0 +1,50 @@
+import { type DocumentStatus } from '../../base/entities';
+
+/** 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/src/entities/issuingEntity/index.ts

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