@muni-sanfer/types-gestor-documental 0.0.1-beta.18 → 0.0.1-beta.19

package/dist/base/entities.d.ts

@@ -184,6 +184,21 @@ export declare const WorkFolderItemKind: {
     Document: "Document";
     File: "File";
 };
+export type ServiceOutageKind = 'Unplanned' | 'Planned';
+export declare const ServiceOutageKind: {
+    Unplanned: "Unplanned";
+    Planned: "Planned";
+};
+export type QualityMetricKey = 'Effectiveness' | 'Efficiency' | 'Availability' | 'ResponseTime' | 'Accessibility' | 'FunctionalCompleteness' | 'Interoperability';
+export declare const QualityMetricKey: {
+    Effectiveness: "Effectiveness";
+    Efficiency: "Efficiency";
+    Availability: "Availability";
+    ResponseTime: "ResponseTime";
+    Accessibility: "Accessibility";
+    FunctionalCompleteness: "FunctionalCompleteness";
+    Interoperability: "Interoperability";
+};
 export interface DocumentTypeEntity {
     id: string;
     name: string;
@@ -713,6 +728,43 @@ export interface WorkFolderItemEntity {
     folderId: string;
     createdAt: string;
 }
+export interface ServiceOutageEntity {
+    id: string;
+    kind: ServiceOutageKind;
+    startedAt: string;
+    endedAt?: string | null;
+    cause: string;
+    affectedServices?: string | null;
+    createdByEmployeeId: string;
+    createdByFullName: string;
+    updatedByFullName?: string | null;
+    deleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface QualityMetricSettingEntity {
+    key: QualityMetricKey;
+    threshold: number;
+    declaredValue?: number | null;
+    declaredNote?: string | null;
+    declaredAt?: string | null;
+    declaredByFullName?: string | null;
+    updatedAt: string;
+}
+export interface ServiceTimingEntity {
+    hour: string;
+    count: number;
+    errorCount: number;
+    totalMs: number;
+    maxMs: number;
+    under100: number;
+    under250: number;
+    under500: number;
+    under1000: number;
+    under2000: number;
+    under5000: number;
+    over5000: number;
+}
 type JsonValue = string | number | boolean | {
     [key in string]?: JsonValue;
 } | Array<JsonValue> | null;

package/dist/base/entities.js

@@ -1,7 +1,7 @@
 "use strict";
 // This file was auto-generated by prisma-generator-typescript-interfaces
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkFolderItemKind = exports.TextSnippetSection = exports.ScanSessionStatus = exports.CaseFileAccessAction = exports.CaseFileTrackingAction = exports.CaseFileActorType = exports.CaseFileActorRelation = exports.CaseFileEntryKind = exports.CaseFileActuationType = exports.CaseFileIncorporationMechanism = exports.CaseFileStatus = exports.DocumentInstruction = exports.DocumentDeliveryOrigin = exports.DocumentRecipientType = exports.DocumentAttachmentType = exports.DocumentFlowStepType = exports.DocDigitalInboundStatus = exports.DocumentDispatchStatus = exports.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
+exports.QualityMetricKey = exports.ServiceOutageKind = exports.WorkFolderItemKind = exports.TextSnippetSection = exports.ScanSessionStatus = exports.CaseFileAccessAction = exports.CaseFileTrackingAction = exports.CaseFileActorType = exports.CaseFileActorRelation = exports.CaseFileEntryKind = exports.CaseFileActuationType = exports.CaseFileIncorporationMechanism = exports.CaseFileStatus = exports.DocumentInstruction = exports.DocumentDeliveryOrigin = exports.DocumentRecipientType = exports.DocumentAttachmentType = exports.DocumentFlowStepType = exports.DocDigitalInboundStatus = exports.DocumentDispatchStatus = exports.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
 exports.DocumentCategory = {
     Decree: 'Decree',
     Communication: 'Communication',
@@ -163,3 +163,16 @@ exports.WorkFolderItemKind = {
     Document: 'Document',
     File: 'File',
 };
+exports.ServiceOutageKind = {
+    Unplanned: 'Unplanned',
+    Planned: 'Planned',
+};
+exports.QualityMetricKey = {
+    Effectiveness: 'Effectiveness',
+    Efficiency: 'Efficiency',
+    Availability: 'Availability',
+    ResponseTime: 'ResponseTime',
+    Accessibility: 'Accessibility',
+    FunctionalCompleteness: 'FunctionalCompleteness',
+    Interoperability: 'Interoperability',
+};

package/dist/contracts/index.d.ts

@@ -5,6 +5,7 @@ import { type IssuingEntityContract } from './issuingEntity.contract';
 import { type ArchivalSeriesContract } from './archivalSeries.contract';
 import { type TextSnippetContract } from './textSnippet.contract';
 import { type HolidayContract } from './holiday.contract';
+import { type IndicatorsContract } from './indicators.contract';
 import { type ScanContract } from './scan.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
@@ -25,6 +26,7 @@ export * from './scan.contract';
 export * from './archivalSeries.contract';
 export * from './textSnippet.contract';
 export * from './holiday.contract';
+export * from './indicators.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -165,6 +167,17 @@ export declare const GestorDocumentalPatterns: {
         readonly create: "gestorDocumental.holiday.create";
         readonly remove: "gestorDocumental.holiday.remove";
     };
+    readonly indicators: {
+        readonly getManagement: "gestorDocumental.indicators.getManagement";
+        readonly getQuality: "gestorDocumental.indicators.getQuality";
+        readonly export: "gestorDocumental.indicators.export";
+        readonly updateQualityMetric: "gestorDocumental.indicators.updateQualityMetric";
+        readonly getOutages: "gestorDocumental.indicators.getOutages";
+        readonly createOutage: "gestorDocumental.indicators.createOutage";
+        readonly updateOutage: "gestorDocumental.indicators.updateOutage";
+        readonly removeOutage: "gestorDocumental.indicators.removeOutage";
+        readonly getOutageCertificate: "gestorDocumental.indicators.getOutageCertificate";
+    };
 };
 /** 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 & HolidayContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract;

package/dist/contracts/index.js

@@ -22,6 +22,7 @@ const issuingEntity_contract_1 = require("./issuingEntity.contract");
 const archivalSeries_contract_1 = require("./archivalSeries.contract");
 const textSnippet_contract_1 = require("./textSnippet.contract");
 const holiday_contract_1 = require("./holiday.contract");
+const indicators_contract_1 = require("./indicators.contract");
 const scan_contract_1 = require("./scan.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
@@ -42,6 +43,7 @@ __exportStar(require("./scan.contract"), exports);
 __exportStar(require("./archivalSeries.contract"), exports);
 __exportStar(require("./textSnippet.contract"), exports);
 __exportStar(require("./holiday.contract"), exports);
+__exportStar(require("./indicators.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -57,4 +59,5 @@ exports.GestorDocumentalPatterns = {
     archivalSeries: archivalSeries_contract_1.ArchivalSeriesPatterns,
     textSnippet: textSnippet_contract_1.TextSnippetPatterns,
     holiday: holiday_contract_1.HolidayPatterns,
+    indicators: indicators_contract_1.IndicatorsPatterns,
 };

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

@@ -0,0 +1,103 @@
+import { type IndicatorsFileEntity, type ManagementIndicatorsEntity, type QualityMetricSettingResponseEntity, type QualityReportEntity, type ServiceOutageRemoveResponseEntity, type ServiceOutageResponseEntity } from '../entities';
+import { type QualityMetricKey, type ServiceOutageKind } from '../base/entities';
+/** Patrones NATS de `indicators`: indicadores de gestión y Plan de Mejora Continua (DS 11/2023). */
+export declare const IndicatorsPatterns: {
+    readonly getManagement: "gestorDocumental.indicators.getManagement";
+    readonly getQuality: "gestorDocumental.indicators.getQuality";
+    readonly export: "gestorDocumental.indicators.export";
+    readonly updateQualityMetric: "gestorDocumental.indicators.updateQualityMetric";
+    readonly getOutages: "gestorDocumental.indicators.getOutages";
+    readonly createOutage: "gestorDocumental.indicators.createOutage";
+    readonly updateOutage: "gestorDocumental.indicators.updateOutage";
+    readonly removeOutage: "gestorDocumental.indicators.removeOutage";
+    readonly getOutageCertificate: "gestorDocumental.indicators.getOutageCertificate";
+};
+/** Período: días de Chile «AAAA-MM-DD», hasta dos años. */
+export interface IndicatorsPeriodQuery {
+    from: string;
+    to: string;
+}
+export interface ManagementIndicatorsQuery extends IndicatorsPeriodQuery {
+    documentTypeId?: string | null;
+    directorateCode?: number | null;
+}
+export interface ServiceOutageInput {
+    kind: ServiceOutageKind;
+    startedAt: string;
+    endedAt?: string | null;
+    cause: string;
+    affectedServices?: string | null;
+}
+export interface IndicatorsContract {
+    [IndicatorsPatterns.getManagement]: {
+        payload: ManagementIndicatorsQuery;
+        response: ManagementIndicatorsEntity;
+    };
+    [IndicatorsPatterns.getQuality]: {
+        payload: IndicatorsPeriodQuery;
+        response: QualityReportEntity;
+    };
+    /**
+     * Indicadores y Plan de Mejora en una planilla Excel. `generatedBy`: quién la descarga. `unitNames`: nombre de cada
+     * unidad (`c:<código de dirección>` o `d:<id de departamento>`), que el ms no conoce.
+     */
+    [IndicatorsPatterns.export]: {
+        payload: ManagementIndicatorsQuery & {
+            generatedBy: string;
+            unitNames?: Record<string, string>;
+        };
+        response: IndicatorsFileEntity;
+    };
+    /** Umbral y, en las métricas declaradas, su valor y respaldo. */
+    [IndicatorsPatterns.updateQualityMetric]: {
+        payload: {
+            key: QualityMetricKey;
+            threshold: number;
+            declaredValue?: number | null;
+            declaredNote?: string | null;
+            actor: {
+                fullName: string;
+            };
+        };
+        response: QualityMetricSettingResponseEntity;
+    };
+    [IndicatorsPatterns.getOutages]: {
+        payload: {
+            year: number;
+        };
+        response: ServiceOutageResponseEntity[];
+    };
+    [IndicatorsPatterns.createOutage]: {
+        payload: ServiceOutageInput & {
+            actor: {
+                employeeId: string;
+                fullName: string;
+            };
+        };
+        response: ServiceOutageResponseEntity;
+    };
+    [IndicatorsPatterns.updateOutage]: {
+        payload: ServiceOutageInput & {
+            id: string;
+            actor: {
+                employeeId: string;
+                fullName: string;
+            };
+        };
+        response: ServiceOutageResponseEntity;
+    };
+    [IndicatorsPatterns.removeOutage]: {
+        payload: {
+            id: string;
+        };
+        response: ServiceOutageRemoveResponseEntity;
+    };
+    /** Certificado de indisponibilidad (DS 10/2023) en PDF, de una caída ya terminada. */
+    [IndicatorsPatterns.getOutageCertificate]: {
+        payload: {
+            id: string;
+            generatedBy: string;
+        };
+        response: IndicatorsFileEntity;
+    };
+}

package/dist/contracts/indicators.contract.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndicatorsPatterns = void 0;
+/** Patrones NATS de `indicators`: indicadores de gestión y Plan de Mejora Continua (DS 11/2023). */
+exports.IndicatorsPatterns = {
+    getManagement: 'gestorDocumental.indicators.getManagement',
+    getQuality: 'gestorDocumental.indicators.getQuality',
+    export: 'gestorDocumental.indicators.export',
+    updateQualityMetric: 'gestorDocumental.indicators.updateQualityMetric',
+    getOutages: 'gestorDocumental.indicators.getOutages',
+    createOutage: 'gestorDocumental.indicators.createOutage',
+    updateOutage: 'gestorDocumental.indicators.updateOutage',
+    removeOutage: 'gestorDocumental.indicators.removeOutage',
+    getOutageCertificate: 'gestorDocumental.indicators.getOutageCertificate',
+};

package/dist/entities/index.d.ts

@@ -11,3 +11,4 @@ export * from './scan';
 export * from './archivalSeries';
 export * from './textSnippet';
 export * from './holiday';
+export * from './indicators';

package/dist/entities/index.js

@@ -27,3 +27,4 @@ __exportStar(require("./scan"), exports);
 __exportStar(require("./archivalSeries"), exports);
 __exportStar(require("./textSnippet"), exports);
 __exportStar(require("./holiday"), exports);
+__exportStar(require("./indicators"), exports);

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

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

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

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

@@ -0,0 +1,152 @@
+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/dist/entities/indicators/indicators.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.18",
+  "version": "0.0.1-beta.19",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/base/entities.ts

@@ -276,6 +276,32 @@ export const WorkFolderItemKind = {
   File: 'File',
 } satisfies Record<string, WorkFolderItemKind>;
 
+export type ServiceOutageKind = 'Unplanned' | 'Planned';
+
+export const ServiceOutageKind = {
+  Unplanned: 'Unplanned',
+  Planned: 'Planned',
+} satisfies Record<string, ServiceOutageKind>;
+
+export type QualityMetricKey =
+  | 'Effectiveness'
+  | 'Efficiency'
+  | 'Availability'
+  | 'ResponseTime'
+  | 'Accessibility'
+  | 'FunctionalCompleteness'
+  | 'Interoperability';
+
+export const QualityMetricKey = {
+  Effectiveness: 'Effectiveness',
+  Efficiency: 'Efficiency',
+  Availability: 'Availability',
+  ResponseTime: 'ResponseTime',
+  Accessibility: 'Accessibility',
+  FunctionalCompleteness: 'FunctionalCompleteness',
+  Interoperability: 'Interoperability',
+} satisfies Record<string, QualityMetricKey>;
+
 export interface DocumentTypeEntity {
   id: string;
   name: string;
@@ -838,4 +864,44 @@ export interface WorkFolderItemEntity {
   createdAt: string;
 }
 
+export interface ServiceOutageEntity {
+  id: string;
+  kind: ServiceOutageKind;
+  startedAt: string;
+  endedAt?: string | null;
+  cause: string;
+  affectedServices?: string | null;
+  createdByEmployeeId: string;
+  createdByFullName: string;
+  updatedByFullName?: string | null;
+  deleted: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface QualityMetricSettingEntity {
+  key: QualityMetricKey;
+  threshold: number;
+  declaredValue?: number | null;
+  declaredNote?: string | null;
+  declaredAt?: string | null;
+  declaredByFullName?: string | null;
+  updatedAt: string;
+}
+
+export interface ServiceTimingEntity {
+  hour: string;
+  count: number;
+  errorCount: number;
+  totalMs: number;
+  maxMs: number;
+  under100: number;
+  under250: number;
+  under500: number;
+  under1000: number;
+  under2000: number;
+  under5000: number;
+  over5000: number;
+}
+
 type JsonValue = string | number | boolean | { [key in string]?: JsonValue } | Array<JsonValue> | null;

package/src/contracts/index.ts

@@ -5,6 +5,7 @@ import { IssuingEntityPatterns, type IssuingEntityContract } from './issuingEnti
 import { ArchivalSeriesPatterns, type ArchivalSeriesContract } from './archivalSeries.contract';
 import { TextSnippetPatterns, type TextSnippetContract } from './textSnippet.contract';
 import { HolidayPatterns, type HolidayContract } from './holiday.contract';
+import { IndicatorsPatterns, type IndicatorsContract } from './indicators.contract';
 import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
@@ -26,6 +27,7 @@ export * from './scan.contract';
 export * from './archivalSeries.contract';
 export * from './textSnippet.contract';
 export * from './holiday.contract';
+export * from './indicators.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -42,6 +44,7 @@ export const GestorDocumentalPatterns = {
   archivalSeries: ArchivalSeriesPatterns,
   textSnippet: TextSnippetPatterns,
   holiday: HolidayPatterns,
+  indicators: IndicatorsPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -57,4 +60,5 @@ export type GestorDocumentalContract = DocumentTypeContract &
   ScanContract &
   ArchivalSeriesContract &
   TextSnippetContract &
-  HolidayContract;
+  HolidayContract &
+  IndicatorsContract;

package/src/contracts/indicators.contract.ts

@@ -0,0 +1,80 @@
+import {
+  type IndicatorsFileEntity,
+  type ManagementIndicatorsEntity,
+  type QualityMetricSettingResponseEntity,
+  type QualityReportEntity,
+  type ServiceOutageRemoveResponseEntity,
+  type ServiceOutageResponseEntity,
+} from '../entities';
+import { type QualityMetricKey, type ServiceOutageKind } from '../base/entities';
+
+/** Patrones NATS de `indicators`: indicadores de gestión y Plan de Mejora Continua (DS 11/2023). */
+export const IndicatorsPatterns = {
+  getManagement: 'gestorDocumental.indicators.getManagement',
+  getQuality: 'gestorDocumental.indicators.getQuality',
+  export: 'gestorDocumental.indicators.export',
+  updateQualityMetric: 'gestorDocumental.indicators.updateQualityMetric',
+  getOutages: 'gestorDocumental.indicators.getOutages',
+  createOutage: 'gestorDocumental.indicators.createOutage',
+  updateOutage: 'gestorDocumental.indicators.updateOutage',
+  removeOutage: 'gestorDocumental.indicators.removeOutage',
+  getOutageCertificate: 'gestorDocumental.indicators.getOutageCertificate',
+} as const;
+
+/** Período: días de Chile «AAAA-MM-DD», hasta dos años. */
+export interface IndicatorsPeriodQuery {
+  from: string;
+  to: string;
+}
+
+export interface ManagementIndicatorsQuery extends IndicatorsPeriodQuery {
+  documentTypeId?: string | null;
+  directorateCode?: number | null;
+}
+
+export interface ServiceOutageInput {
+  kind: ServiceOutageKind;
+  startedAt: string;
+  endedAt?: string | null;
+  cause: string;
+  affectedServices?: string | null;
+}
+
+export interface IndicatorsContract {
+  [IndicatorsPatterns.getManagement]: { payload: ManagementIndicatorsQuery; response: ManagementIndicatorsEntity };
+  [IndicatorsPatterns.getQuality]: { payload: IndicatorsPeriodQuery; response: QualityReportEntity };
+  /**
+   * Indicadores y Plan de Mejora en una planilla Excel. `generatedBy`: quién la descarga. `unitNames`: nombre de cada
+   * unidad (`c:<código de dirección>` o `d:<id de departamento>`), que el ms no conoce.
+   */
+  [IndicatorsPatterns.export]: {
+    payload: ManagementIndicatorsQuery & { generatedBy: string; unitNames?: Record<string, string> };
+    response: IndicatorsFileEntity;
+  };
+  /** Umbral y, en las métricas declaradas, su valor y respaldo. */
+  [IndicatorsPatterns.updateQualityMetric]: {
+    payload: {
+      key: QualityMetricKey;
+      threshold: number;
+      declaredValue?: number | null;
+      declaredNote?: string | null;
+      actor: { fullName: string };
+    };
+    response: QualityMetricSettingResponseEntity;
+  };
+  [IndicatorsPatterns.getOutages]: { payload: { year: number }; response: ServiceOutageResponseEntity[] };
+  [IndicatorsPatterns.createOutage]: {
+    payload: ServiceOutageInput & { actor: { employeeId: string; fullName: string } };
+    response: ServiceOutageResponseEntity;
+  };
+  [IndicatorsPatterns.updateOutage]: {
+    payload: ServiceOutageInput & { id: string; actor: { employeeId: string; fullName: string } };
+    response: ServiceOutageResponseEntity;
+  };
+  [IndicatorsPatterns.removeOutage]: { payload: { id: string }; response: ServiceOutageRemoveResponseEntity };
+  /** Certificado de indisponibilidad (DS 10/2023) en PDF, de una caída ya terminada. */
+  [IndicatorsPatterns.getOutageCertificate]: {
+    payload: { id: string; generatedBy: string };
+    response: IndicatorsFileEntity;
+  };
+}

package/src/entities/index.ts

@@ -11,3 +11,4 @@ export * from './scan';
 export * from './archivalSeries';
 export * from './textSnippet';
 export * from './holiday';
+export * from './indicators';

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