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

package/dist/base/entities.d.ts

@@ -199,6 +199,31 @@ export declare const QualityMetricKey: {
     FunctionalCompleteness: "FunctionalCompleteness";
     Interoperability: "Interoperability";
 };
+export type DocumentAccessAction = 'Viewed' | 'FileDownloaded' | 'TrailExported';
+export declare const DocumentAccessAction: {
+    Viewed: "Viewed";
+    FileDownloaded: "FileDownloaded";
+    TrailExported: "TrailExported";
+};
+export type AuditEntity = 'DocumentType' | 'IssuingEntity' | 'ArchivalSeries' | 'TextSnippet' | 'Holiday' | 'Procedure' | 'QualityMetric' | 'ServiceOutage';
+export declare const AuditEntity: {
+    DocumentType: "DocumentType";
+    IssuingEntity: "IssuingEntity";
+    ArchivalSeries: "ArchivalSeries";
+    TextSnippet: "TextSnippet";
+    Holiday: "Holiday";
+    Procedure: "Procedure";
+    QualityMetric: "QualityMetric";
+    ServiceOutage: "ServiceOutage";
+};
+export type AuditAction = 'Created' | 'Updated' | 'Enabled' | 'Disabled' | 'Removed';
+export declare const AuditAction: {
+    Created: "Created";
+    Updated: "Updated";
+    Enabled: "Enabled";
+    Disabled: "Disabled";
+    Removed: "Removed";
+};
 export interface DocumentTypeEntity {
     id: string;
     name: string;
@@ -278,6 +303,7 @@ export interface DocumentEntity {
     workFolderItems?: WorkFolderItemEntity[];
     externalRecipients?: DocumentExternalRecipientEntity[];
     emailCopies?: DocumentEmailCopyEntity[];
+    accesses?: DocumentAccessEntity[];
     dispatch?: DocumentDispatchEntity | null;
     docDigitalInbound?: DocDigitalInboundEntity | null;
     deleted: boolean;
@@ -765,6 +791,26 @@ export interface ServiceTimingEntity {
     under5000: number;
     over5000: number;
 }
+export interface DocumentAccessEntity {
+    id: string;
+    action: DocumentAccessAction;
+    employeeId?: string | null;
+    employeeFullName: string;
+    document?: DocumentEntity;
+    documentId: string;
+    createdAt: string;
+}
+export interface AuditLogEntity {
+    id: string;
+    entity: AuditEntity;
+    action: AuditAction;
+    entityId?: string | null;
+    name: string;
+    details?: JsonValue | null;
+    employeeId?: string | null;
+    employeeFullName: string;
+    createdAt: string;
+}
 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.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.AuditAction = exports.AuditEntity = exports.DocumentAccessAction = 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',
@@ -176,3 +176,25 @@ exports.QualityMetricKey = {
     FunctionalCompleteness: 'FunctionalCompleteness',
     Interoperability: 'Interoperability',
 };
+exports.DocumentAccessAction = {
+    Viewed: 'Viewed',
+    FileDownloaded: 'FileDownloaded',
+    TrailExported: 'TrailExported',
+};
+exports.AuditEntity = {
+    DocumentType: 'DocumentType',
+    IssuingEntity: 'IssuingEntity',
+    ArchivalSeries: 'ArchivalSeries',
+    TextSnippet: 'TextSnippet',
+    Holiday: 'Holiday',
+    Procedure: 'Procedure',
+    QualityMetric: 'QualityMetric',
+    ServiceOutage: 'ServiceOutage',
+};
+exports.AuditAction = {
+    Created: 'Created',
+    Updated: 'Updated',
+    Enabled: 'Enabled',
+    Disabled: 'Disabled',
+    Removed: 'Removed',
+};

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

@@ -0,0 +1,32 @@
+import { type AuditEventEntity, type AuditSource, type IndicatorsFileEntity } from '../entities';
+import { type RpcPage } from './contract';
+/** Patrones NATS de `audit`: la auditoría reúne todos los registros del gestor en una sola vista. */
+export declare const AuditPatterns: {
+    readonly getEvents: "gestorDocumental.audit.getEvents";
+    readonly export: "gestorDocumental.audit.export";
+};
+/** Qué hechos: período (días de Chile «AAAA-MM-DD», hasta un año) y filtros optativos. */
+export interface AuditQuery {
+    from: string;
+    to: string;
+    sources?: AuditSource[];
+    /** Parte del nombre de quien actuó. */
+    person?: string;
+    /** Parte del folio, materia, IUIe, título o nombre de lo afectado. */
+    reference?: string;
+    page?: number;
+    limit?: number;
+}
+export interface AuditContract {
+    [AuditPatterns.getEvents]: {
+        payload: AuditQuery;
+        response: RpcPage<AuditEventEntity[]>;
+    };
+    /** Los hechos filtrados (hasta 10.000) en Excel. `generatedBy`: quién la descarga. */
+    [AuditPatterns.export]: {
+        payload: Omit<AuditQuery, 'page' | 'limit'> & {
+            generatedBy: string;
+        };
+        response: IndicatorsFileEntity;
+    };
+}

package/dist/contracts/audit.contract.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditPatterns = void 0;
+/** Patrones NATS de `audit`: la auditoría reúne todos los registros del gestor en una sola vista. */
+exports.AuditPatterns = {
+    getEvents: 'gestorDocumental.audit.getEvents',
+    export: 'gestorDocumental.audit.export',
+};

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

@@ -1,4 +1,4 @@
-import { type DocumentAccessLevel, type DocumentAttachmentEntity, type DocumentDeliveryEntity, type DocumentEntity, type DocumentInstruction, type DocumentParticipantEntity, type DocumentStatus } from '../base/entities';
+import { type DocumentAccessAction, type DocumentAccessLevel, type DocumentAttachmentEntity, type DocumentDeliveryEntity, type DocumentEntity, type DocumentInstruction, type DocumentParticipantEntity, type DocumentStatus } from '../base/entities';
 import { type DocumentAnnulResponseEntity, type DocumentCloseDeliveryResponseEntity, type DocumentCreateResponseEntity, type DocumentDeriveResponseEntity, type DocumentDiscardResponseEntity, type DocumentEmailCopyIssuedEntity, type DocumentEmailCopyViewEntity, type DocumentReminderEntity, type DocumentGetAllResponseEntity, type DocumentGetByIdResponseEntity, type DocumentGetSummaryResponseEntity, type DocumentInboxItemEntity, type DocumentPublicFileResponseEntity, type DocumentReassignResponseEntity, type DocumentReviewResponseEntity, type DocumentSignManyResponseEntity, type DocumentAgendaResponseEntity, type DocumentComposeResponseEntity, type DocumentComposition, type DocumentTrailExportEntity, type DocumentUpdateResponseEntity, type DocumentVerifyResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 /** Patrones NATS de `document`: `<servicio>.<recurso>.<acción>`. */
@@ -103,6 +103,11 @@ export interface DocumentExternalRecipientInput {
 /**
  * Qué se envía y qué se responde en cada patrón. Generado desde los handlers y los DTO del microservicio.
  */
+/** Una lectura que queda en el registro de accesos del documento. */
+export interface DocumentAccessInput {
+    action: DocumentAccessAction;
+    fullName: string;
+}
 export interface DocumentContract {
     /**
      * Arma el PDF de un documento redactado con una plantilla oficial: membrete, estructura y espacio libre para el
@@ -194,6 +199,7 @@ export interface DocumentContract {
         payload: Pick<DocumentEntity, 'id'> & {
             actor?: DocumentActor;
             viewAll?: boolean;
+            access?: DocumentAccessInput;
         };
         response: DocumentGetByIdResponseEntity;
     };

package/dist/contracts/index.d.ts

@@ -6,6 +6,7 @@ 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 AuditContract } from './audit.contract';
 import { type ScanContract } from './scan.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
@@ -27,6 +28,7 @@ export * from './archivalSeries.contract';
 export * from './textSnippet.contract';
 export * from './holiday.contract';
 export * from './indicators.contract';
+export * from './audit.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -178,6 +180,10 @@ export declare const GestorDocumentalPatterns: {
         readonly removeOutage: "gestorDocumental.indicators.removeOutage";
         readonly getOutageCertificate: "gestorDocumental.indicators.getOutageCertificate";
     };
+    readonly audit: {
+        readonly getEvents: "gestorDocumental.audit.getEvents";
+        readonly export: "gestorDocumental.audit.export";
+    };
 };
 /** 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 & IndicatorsContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract & AuditContract;

package/dist/contracts/index.js

@@ -23,6 +23,7 @@ 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 audit_contract_1 = require("./audit.contract");
 const scan_contract_1 = require("./scan.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
@@ -44,6 +45,7 @@ __exportStar(require("./archivalSeries.contract"), exports);
 __exportStar(require("./textSnippet.contract"), exports);
 __exportStar(require("./holiday.contract"), exports);
 __exportStar(require("./indicators.contract"), exports);
+__exportStar(require("./audit.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -60,4 +62,5 @@ exports.GestorDocumentalPatterns = {
     textSnippet: textSnippet_contract_1.TextSnippetPatterns,
     holiday: holiday_contract_1.HolidayPatterns,
     indicators: indicators_contract_1.IndicatorsPatterns,
+    audit: audit_contract_1.AuditPatterns,
 };

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

@@ -0,0 +1,27 @@
+import { type AuditEntity } from '../../base/entities';
+/** De dónde sale un hecho de la auditoría. */
+export type AuditSource = 'Document' | 'DocumentAccess' | 'CaseFile' | 'CaseFileAccess' | 'Configuration';
+/**
+ * Un hecho de la auditoría, de cualquiera de los registros: trazabilidad de documentos y expedientes, accesos y
+ * cambios de configuración. `action` es la acción del registro de origen (p. ej. `Signed`, `Viewed`, `Updated`).
+ */
+export interface AuditEventEntity {
+    id: string;
+    source: AuditSource;
+    action: string;
+    employeeId: string | null;
+    employeeFullName: string | null;
+    /** Documento, expediente o elemento de configuración al que se refiere. */
+    targetId: string | null;
+    /** Cómo se cita: folio o materia del documento, IUIe y título del expediente, nombre de lo configurado. */
+    reference: string;
+    /** Qué se configuró, en los cambios de configuración. */
+    entity: AuditEntity | null;
+    observation: string | null;
+    createdAt: string;
+}
+/** Quién hace un cambio de configuración, según la sesión. Lo agrega el gateway; el ms lo deja en la bitácora. */
+export interface AuditActorInput {
+    employeeId: string | null;
+    fullName: string;
+}

package/dist/entities/audit/audit.entity.js

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

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

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

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

package/dist/entities/index.d.ts

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

package/dist/entities/index.js

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

package/package.json

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

package/src/base/entities.ts

@@ -302,6 +302,45 @@ export const QualityMetricKey = {
   Interoperability: 'Interoperability',
 } satisfies Record<string, QualityMetricKey>;
 
+export type DocumentAccessAction = 'Viewed' | 'FileDownloaded' | 'TrailExported';
+
+export const DocumentAccessAction = {
+  Viewed: 'Viewed',
+  FileDownloaded: 'FileDownloaded',
+  TrailExported: 'TrailExported',
+} satisfies Record<string, DocumentAccessAction>;
+
+export type AuditEntity =
+  | 'DocumentType'
+  | 'IssuingEntity'
+  | 'ArchivalSeries'
+  | 'TextSnippet'
+  | 'Holiday'
+  | 'Procedure'
+  | 'QualityMetric'
+  | 'ServiceOutage';
+
+export const AuditEntity = {
+  DocumentType: 'DocumentType',
+  IssuingEntity: 'IssuingEntity',
+  ArchivalSeries: 'ArchivalSeries',
+  TextSnippet: 'TextSnippet',
+  Holiday: 'Holiday',
+  Procedure: 'Procedure',
+  QualityMetric: 'QualityMetric',
+  ServiceOutage: 'ServiceOutage',
+} satisfies Record<string, AuditEntity>;
+
+export type AuditAction = 'Created' | 'Updated' | 'Enabled' | 'Disabled' | 'Removed';
+
+export const AuditAction = {
+  Created: 'Created',
+  Updated: 'Updated',
+  Enabled: 'Enabled',
+  Disabled: 'Disabled',
+  Removed: 'Removed',
+} satisfies Record<string, AuditAction>;
+
 export interface DocumentTypeEntity {
   id: string;
   name: string;
@@ -382,6 +421,7 @@ export interface DocumentEntity {
   workFolderItems?: WorkFolderItemEntity[];
   externalRecipients?: DocumentExternalRecipientEntity[];
   emailCopies?: DocumentEmailCopyEntity[];
+  accesses?: DocumentAccessEntity[];
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
   deleted: boolean;
@@ -904,4 +944,26 @@ export interface ServiceTimingEntity {
   over5000: number;
 }
 
+export interface DocumentAccessEntity {
+  id: string;
+  action: DocumentAccessAction;
+  employeeId?: string | null;
+  employeeFullName: string;
+  document?: DocumentEntity;
+  documentId: string;
+  createdAt: string;
+}
+
+export interface AuditLogEntity {
+  id: string;
+  entity: AuditEntity;
+  action: AuditAction;
+  entityId?: string | null;
+  name: string;
+  details?: JsonValue | null;
+  employeeId?: string | null;
+  employeeFullName: string;
+  createdAt: string;
+}
+
 type JsonValue = string | number | boolean | { [key in string]?: JsonValue } | Array<JsonValue> | null;

package/src/contracts/audit.contract.ts

@@ -0,0 +1,30 @@
+import { type AuditEventEntity, type AuditSource, type IndicatorsFileEntity } from '../entities';
+import { type RpcPage } from './contract';
+
+/** Patrones NATS de `audit`: la auditoría reúne todos los registros del gestor en una sola vista. */
+export const AuditPatterns = {
+  getEvents: 'gestorDocumental.audit.getEvents',
+  export: 'gestorDocumental.audit.export',
+} as const;
+
+/** Qué hechos: período (días de Chile «AAAA-MM-DD», hasta un año) y filtros optativos. */
+export interface AuditQuery {
+  from: string;
+  to: string;
+  sources?: AuditSource[];
+  /** Parte del nombre de quien actuó. */
+  person?: string;
+  /** Parte del folio, materia, IUIe, título o nombre de lo afectado. */
+  reference?: string;
+  page?: number;
+  limit?: number;
+}
+
+export interface AuditContract {
+  [AuditPatterns.getEvents]: { payload: AuditQuery; response: RpcPage<AuditEventEntity[]> };
+  /** Los hechos filtrados (hasta 10.000) en Excel. `generatedBy`: quién la descarga. */
+  [AuditPatterns.export]: {
+    payload: Omit<AuditQuery, 'page' | 'limit'> & { generatedBy: string };
+    response: IndicatorsFileEntity;
+  };
+}

package/src/contracts/document.contract.ts

@@ -1,4 +1,5 @@
 import {
+  type DocumentAccessAction,
   type DocumentAccessLevel,
   type DocumentAttachmentEntity,
   type DocumentDeliveryEntity,
@@ -149,6 +150,12 @@ export interface DocumentExternalRecipientInput {
 /**
  * Qué se envía y qué se responde en cada patrón. Generado desde los handlers y los DTO del microservicio.
  */
+/** Una lectura que queda en el registro de accesos del documento. */
+export interface DocumentAccessInput {
+  action: DocumentAccessAction;
+  fullName: string;
+}
+
 export interface DocumentContract {
   /**
    * Arma el PDF de un documento redactado con una plantilla oficial: membrete, estructura y espacio libre para el
@@ -224,8 +231,9 @@ export interface DocumentContract {
   [DocumentPatterns.getById]: {
     // Con `actor`, el documento solo se entrega a su redactor y a quienes lo visan o firman, y la respuesta dice qué
     // puede hacer con él. `viewAll` levanta esa restricción para quien tiene permiso de ver todos los documentos
-    // (historial), sin perder lo que puede hacer si además participa.
-    payload: Pick<DocumentEntity, 'id'> & { actor?: DocumentActor; viewAll?: boolean };
+    // (historial), sin perder lo que puede hacer si además participa. Con `access`, la lectura queda en el registro de
+    // accesos del documento a nombre de `fullName` (abrirlo varias veces seguidas cuenta una vez).
+    payload: Pick<DocumentEntity, 'id'> & { actor?: DocumentActor; viewAll?: boolean; access?: DocumentAccessInput };
     response: DocumentGetByIdResponseEntity;
   };
   [DocumentPatterns.create]: {

package/src/contracts/index.ts

@@ -6,6 +6,7 @@ import { ArchivalSeriesPatterns, type ArchivalSeriesContract } from './archivalS
 import { TextSnippetPatterns, type TextSnippetContract } from './textSnippet.contract';
 import { HolidayPatterns, type HolidayContract } from './holiday.contract';
 import { IndicatorsPatterns, type IndicatorsContract } from './indicators.contract';
+import { AuditPatterns, type AuditContract } from './audit.contract';
 import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
@@ -28,6 +29,7 @@ export * from './archivalSeries.contract';
 export * from './textSnippet.contract';
 export * from './holiday.contract';
 export * from './indicators.contract';
+export * from './audit.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -45,6 +47,7 @@ export const GestorDocumentalPatterns = {
   textSnippet: TextSnippetPatterns,
   holiday: HolidayPatterns,
   indicators: IndicatorsPatterns,
+  audit: AuditPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -61,4 +64,5 @@ export type GestorDocumentalContract = DocumentTypeContract &
   ArchivalSeriesContract &
   TextSnippetContract &
   HolidayContract &
-  IndicatorsContract;
+  IndicatorsContract &
+  AuditContract;

package/src/entities/audit/audit.entity.ts

@@ -0,0 +1,30 @@
+import { type AuditEntity } from '../../base/entities';
+
+/** De dónde sale un hecho de la auditoría. */
+export type AuditSource = 'Document' | 'DocumentAccess' | 'CaseFile' | 'CaseFileAccess' | 'Configuration';
+
+/**
+ * Un hecho de la auditoría, de cualquiera de los registros: trazabilidad de documentos y expedientes, accesos y
+ * cambios de configuración. `action` es la acción del registro de origen (p. ej. `Signed`, `Viewed`, `Updated`).
+ */
+export interface AuditEventEntity {
+  id: string;
+  source: AuditSource;
+  action: string;
+  employeeId: string | null;
+  employeeFullName: string | null;
+  /** Documento, expediente o elemento de configuración al que se refiere. */
+  targetId: string | null;
+  /** Cómo se cita: folio o materia del documento, IUIe y título del expediente, nombre de lo configurado. */
+  reference: string;
+  /** Qué se configuró, en los cambios de configuración. */
+  entity: AuditEntity | null;
+  observation: string | null;
+  createdAt: string;
+}
+
+/** Quién hace un cambio de configuración, según la sesión. Lo agrega el gateway; el ms lo deja en la bitácora. */
+export interface AuditActorInput {
+  employeeId: string | null;
+  fullName: string;
+}

package/src/entities/audit/index.ts

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

package/src/entities/index.ts

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