@muni-sanfer/types-gestor-documental 0.0.1-beta.24 → 0.0.1-beta.25

package/dist/base/entities.d.ts

@@ -239,6 +239,42 @@ export declare const DispositionKind: {
     Transfer: "Transfer";
     Elimination: "Elimination";
 };
+export type AccessRequestChannel = 'Portal' | 'Email' | 'InPerson' | 'Letter';
+export declare const AccessRequestChannel: {
+    Portal: "Portal";
+    Email: "Email";
+    InPerson: "InPerson";
+    Letter: "Letter";
+};
+export type AccessRequestStatus = 'Received' | 'InCorrection' | 'InProgress' | 'Resolved';
+export declare const AccessRequestStatus: {
+    Received: "Received";
+    InCorrection: "InCorrection";
+    InProgress: "InProgress";
+    Resolved: "Resolved";
+};
+export type AccessRequestResolution = 'Delivered' | 'PartiallyDelivered' | 'Denied' | 'Derived' | 'NonExistent' | 'Withdrawn';
+export declare const AccessRequestResolution: {
+    Delivered: "Delivered";
+    PartiallyDelivered: "PartiallyDelivered";
+    Denied: "Denied";
+    Derived: "Derived";
+    NonExistent: "NonExistent";
+    Withdrawn: "Withdrawn";
+};
+export type AccessRequestEventAction = 'Received' | 'Updated' | 'CorrectionRequested' | 'Corrected' | 'Assigned' | 'ThirdPartyNotified' | 'OppositionRegistered' | 'Extended' | 'Resolved' | 'AppealRegistered';
+export declare const AccessRequestEventAction: {
+    Received: "Received";
+    Updated: "Updated";
+    CorrectionRequested: "CorrectionRequested";
+    Corrected: "Corrected";
+    Assigned: "Assigned";
+    ThirdPartyNotified: "ThirdPartyNotified";
+    OppositionRegistered: "OppositionRegistered";
+    Extended: "Extended";
+    Resolved: "Resolved";
+    AppealRegistered: "AppealRegistered";
+};
 export interface DocumentTypeEntity {
     id: string;
     name: string;
@@ -321,6 +357,8 @@ export interface DocumentEntity {
     accesses?: DocumentAccessEntity[];
     disposition?: DispositionRecordEntity | null;
     dispositionId?: string | null;
+    accessRequestResponses?: AccessRequestEntity[];
+    accessRequestDeliveries?: AccessRequestDocumentEntity[];
     dispatch?: DocumentDispatchEntity | null;
     docDigitalInbound?: DocDigitalInboundEntity | null;
     deleted: boolean;
@@ -851,6 +889,62 @@ export interface DispositionRecordEntity {
     createdByFullName: string;
     createdAt: string;
 }
+export interface AccessRequestEntity {
+    id: string;
+    number: number;
+    year: number;
+    externalFolio?: string | null;
+    channel: AccessRequestChannel;
+    receivedAt: string;
+    requesterName: string;
+    requesterEmail?: string | null;
+    requesterAddress?: string | null;
+    requestText: string;
+    deliveryFormat?: string | null;
+    status: AccessRequestStatus;
+    correctionRequestedAt?: string | null;
+    correctionDueAt?: string | null;
+    correctedAt?: string | null;
+    dueAt: string;
+    extendedAt?: string | null;
+    extensionNote?: string | null;
+    assigneeEmployeeId?: string | null;
+    assigneeFullName?: string | null;
+    thirdPartyNotifiedAt?: string | null;
+    oppositionDueAt?: string | null;
+    thirdPartyOpposed?: boolean | null;
+    resolution?: AccessRequestResolution | null;
+    resolvedAt?: string | null;
+    denialGrounds: string[];
+    derivedTo?: string | null;
+    resolutionNote?: string | null;
+    responseDocument?: DocumentEntity | null;
+    responseDocumentId?: string | null;
+    appealedAt?: string | null;
+    appealNote?: string | null;
+    createdByEmployeeId: string;
+    createdByFullName: string;
+    documents?: AccessRequestDocumentEntity[];
+    events?: AccessRequestEventEntity[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AccessRequestDocumentEntity {
+    accessRequest?: AccessRequestEntity;
+    accessRequestId: string;
+    document?: DocumentEntity;
+    documentId: string;
+}
+export interface AccessRequestEventEntity {
+    id: string;
+    action: AccessRequestEventAction;
+    note?: string | null;
+    employeeId?: string | null;
+    employeeFullName: string;
+    accessRequest?: AccessRequestEntity;
+    accessRequestId: 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.DispositionKind = exports.FinalDisposition = 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.AccessRequestEventAction = exports.AccessRequestResolution = exports.AccessRequestStatus = exports.AccessRequestChannel = exports.DispositionKind = exports.FinalDisposition = 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',
@@ -211,3 +211,35 @@ exports.DispositionKind = {
     Transfer: 'Transfer',
     Elimination: 'Elimination',
 };
+exports.AccessRequestChannel = {
+    Portal: 'Portal',
+    Email: 'Email',
+    InPerson: 'InPerson',
+    Letter: 'Letter',
+};
+exports.AccessRequestStatus = {
+    Received: 'Received',
+    InCorrection: 'InCorrection',
+    InProgress: 'InProgress',
+    Resolved: 'Resolved',
+};
+exports.AccessRequestResolution = {
+    Delivered: 'Delivered',
+    PartiallyDelivered: 'PartiallyDelivered',
+    Denied: 'Denied',
+    Derived: 'Derived',
+    NonExistent: 'NonExistent',
+    Withdrawn: 'Withdrawn',
+};
+exports.AccessRequestEventAction = {
+    Received: 'Received',
+    Updated: 'Updated',
+    CorrectionRequested: 'CorrectionRequested',
+    Corrected: 'Corrected',
+    Assigned: 'Assigned',
+    ThirdPartyNotified: 'ThirdPartyNotified',
+    OppositionRegistered: 'OppositionRegistered',
+    Extended: 'Extended',
+    Resolved: 'Resolved',
+    AppealRegistered: 'AppealRegistered',
+};

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

@@ -0,0 +1,109 @@
+import { type AccessRequestChannel, type AccessRequestResolution } from '../base/entities';
+import { type AccessRequestDetailEntity, type AccessRequestListItemEntity, type AccessRequestSummaryEntity } from '../entities';
+import { type RpcPage } from './contract';
+/** Patrones NATS de `accessRequest`: solicitudes de acceso a la información pública (Ley 20.285). */
+export declare const AccessRequestPatterns: {
+    readonly getAll: "gestorDocumental.accessRequest.getAll";
+    readonly getById: "gestorDocumental.accessRequest.getById";
+    readonly getSummary: "gestorDocumental.accessRequest.getSummary";
+    readonly create: "gestorDocumental.accessRequest.create";
+    readonly update: "gestorDocumental.accessRequest.update";
+    readonly act: "gestorDocumental.accessRequest.act";
+};
+export interface AccessRequestWritePayload {
+    externalFolio?: string | null;
+    channel: AccessRequestChannel;
+    /** Fecha y hora de ingreso (ISO): desde ahí corren los 20 días hábiles. */
+    receivedAt: string;
+    requesterName: string;
+    requesterEmail?: string | null;
+    requesterAddress?: string | null;
+    requestText: string;
+    deliveryFormat?: string | null;
+}
+/** Lo que se hace con una solicitud, un paso a la vez. */
+export type AccessRequestAction = {
+    type: 'requestCorrection';
+    note: string;
+} | {
+    type: 'registerCorrection';
+    correctedAt?: string | null;
+    note?: string | null;
+} | {
+    type: 'assign';
+    employeeId: string;
+    fullName: string;
+    note?: string | null;
+} | {
+    type: 'notifyThirdParty';
+    note: string;
+} | {
+    type: 'registerOpposition';
+    opposed: boolean;
+    note?: string | null;
+} | {
+    type: 'extend';
+    note: string;
+} | {
+    type: 'resolve';
+    resolution: AccessRequestResolution;
+    grounds?: string[];
+    derivedTo?: string | null;
+    note?: string | null;
+    responseDocumentId?: string | null;
+    documentIds?: string[];
+} | {
+    type: 'registerAppeal';
+    appealedAt?: string | null;
+    note: string;
+};
+export interface AccessRequestActor {
+    employeeId: string;
+    fullName: string;
+}
+export interface AccessRequestContract {
+    [AccessRequestPatterns.getAll]: {
+        payload: {
+            status?: 'open' | 'resolved' | 'all';
+            year?: number | null;
+            search?: string;
+            page?: number;
+            limit?: number;
+        };
+        response: RpcPage<AccessRequestListItemEntity[]>;
+    };
+    [AccessRequestPatterns.getById]: {
+        payload: {
+            id: string;
+        };
+        response: AccessRequestDetailEntity;
+    };
+    [AccessRequestPatterns.getSummary]: {
+        payload: {
+            year: number;
+        };
+        response: AccessRequestSummaryEntity;
+    };
+    [AccessRequestPatterns.create]: {
+        payload: AccessRequestWritePayload & {
+            actor: AccessRequestActor;
+        };
+        response: AccessRequestDetailEntity;
+    };
+    /** Corrige los datos mientras no está resuelta. */
+    [AccessRequestPatterns.update]: {
+        payload: AccessRequestWritePayload & {
+            id: string;
+            actor: AccessRequestActor;
+        };
+        response: AccessRequestDetailEntity;
+    };
+    [AccessRequestPatterns.act]: {
+        payload: {
+            id: string;
+            action: AccessRequestAction;
+            actor: AccessRequestActor;
+        };
+        response: AccessRequestDetailEntity;
+    };
+}

package/dist/contracts/accessRequest.contract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessRequestPatterns = void 0;
+/** Patrones NATS de `accessRequest`: solicitudes de acceso a la información pública (Ley 20.285). */
+exports.AccessRequestPatterns = {
+    getAll: 'gestorDocumental.accessRequest.getAll',
+    getById: 'gestorDocumental.accessRequest.getById',
+    getSummary: 'gestorDocumental.accessRequest.getSummary',
+    create: 'gestorDocumental.accessRequest.create',
+    update: 'gestorDocumental.accessRequest.update',
+    act: 'gestorDocumental.accessRequest.act',
+};

package/dist/contracts/index.d.ts

@@ -10,6 +10,7 @@ import { type AuditContract } from './audit.contract';
 import { type SignatureCheckContract } from './signatureCheck.contract';
 import { type RepositoryExportContract } from './repositoryExport.contract';
 import { type RetentionContract } from './retention.contract';
+import { type AccessRequestContract } from './accessRequest.contract';
 import { type ScanContract } from './scan.contract';
 import { type PartsOfficeContract } from './partsOffice.contract';
 import { type ProcedureContract } from './procedure.contract';
@@ -35,6 +36,7 @@ export * from './audit.contract';
 export * from './signatureCheck.contract';
 export * from './repositoryExport.contract';
 export * from './retention.contract';
+export * from './accessRequest.contract';
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export declare const GestorDocumentalPatterns: {
     readonly documentType: {
@@ -207,6 +209,14 @@ export declare const GestorDocumentalPatterns: {
         readonly getRecords: "gestorDocumental.retention.getRecords";
         readonly getRecordPdf: "gestorDocumental.retention.getRecordPdf";
     };
+    readonly accessRequest: {
+        readonly getAll: "gestorDocumental.accessRequest.getAll";
+        readonly getById: "gestorDocumental.accessRequest.getById";
+        readonly getSummary: "gestorDocumental.accessRequest.getSummary";
+        readonly create: "gestorDocumental.accessRequest.create";
+        readonly update: "gestorDocumental.accessRequest.update";
+        readonly act: "gestorDocumental.accessRequest.act";
+    };
 };
 /** 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 & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract;
+export type GestorDocumentalContract = DocumentTypeContract & DocumentContract & ProcedureContract & IssuingEntityContract & CaseFileContract & PartsOfficeContract & RegisterBookContract & SignatureBatchContract & WorkFolderContract & ScanContract & ArchivalSeriesContract & TextSnippetContract & HolidayContract & IndicatorsContract & AuditContract & SignatureCheckContract & RepositoryExportContract & RetentionContract & AccessRequestContract;

package/dist/contracts/index.js

@@ -27,6 +27,7 @@ const audit_contract_1 = require("./audit.contract");
 const signatureCheck_contract_1 = require("./signatureCheck.contract");
 const repositoryExport_contract_1 = require("./repositoryExport.contract");
 const retention_contract_1 = require("./retention.contract");
+const accessRequest_contract_1 = require("./accessRequest.contract");
 const scan_contract_1 = require("./scan.contract");
 const partsOffice_contract_1 = require("./partsOffice.contract");
 const procedure_contract_1 = require("./procedure.contract");
@@ -52,6 +53,7 @@ __exportStar(require("./audit.contract"), exports);
 __exportStar(require("./signatureCheck.contract"), exports);
 __exportStar(require("./repositoryExport.contract"), exports);
 __exportStar(require("./retention.contract"), exports);
+__exportStar(require("./accessRequest.contract"), exports);
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 exports.GestorDocumentalPatterns = {
     documentType: documentType_contract_1.DocumentTypePatterns,
@@ -72,4 +74,5 @@ exports.GestorDocumentalPatterns = {
     signatureCheck: signatureCheck_contract_1.SignatureCheckPatterns,
     repositoryExport: repositoryExport_contract_1.RepositoryExportPatterns,
     retention: retention_contract_1.RetentionPatterns,
+    accessRequest: accessRequest_contract_1.AccessRequestPatterns,
 };

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

@@ -0,0 +1,73 @@
+import { type AccessRequestChannel, type AccessRequestEventAction, type AccessRequestResolution, type AccessRequestStatus } from '../../base/entities';
+/** Semáforo del plazo de respuesta: a tiempo, por vencer (2 días hábiles o menos) o vencido. */
+export type AccessRequestDueStatus = 'OnTime' | 'DueSoon' | 'Overdue';
+export interface AccessRequestListItemEntity {
+    id: string;
+    /** «N° 15/2026». */
+    label: string;
+    externalFolio: string | null;
+    channel: AccessRequestChannel;
+    requesterName: string;
+    requestText: string;
+    receivedAt: string;
+    dueAt: string;
+    status: AccessRequestStatus;
+    resolution: AccessRequestResolution | null;
+    assigneeFullName: string | null;
+    /** Solo mientras está abierta. */
+    dueStatus: AccessRequestDueStatus | null;
+    businessDaysLeft: number | null;
+    /** Ya resuelta: si se respondió dentro del plazo. */
+    resolvedOnTime: boolean | null;
+}
+export interface AccessRequestDocumentLinkEntity {
+    id: string;
+    folio: string | null;
+    subject: string;
+}
+export interface AccessRequestDetailEntity extends AccessRequestListItemEntity {
+    year: number;
+    number: number;
+    requesterEmail: string | null;
+    requesterAddress: string | null;
+    deliveryFormat: string | null;
+    correctionRequestedAt: string | null;
+    correctionDueAt: string | null;
+    correctedAt: string | null;
+    extendedAt: string | null;
+    extensionNote: string | null;
+    assigneeEmployeeId: string | null;
+    thirdPartyNotifiedAt: string | null;
+    oppositionDueAt: string | null;
+    thirdPartyOpposed: boolean | null;
+    resolvedAt: string | null;
+    denialGrounds: string[];
+    derivedTo: string | null;
+    resolutionNote: string | null;
+    responseDocument: AccessRequestDocumentLinkEntity | null;
+    documents: AccessRequestDocumentLinkEntity[];
+    appealedAt: string | null;
+    appealNote: string | null;
+    createdByFullName: string;
+    /** Se puede prorrogar: abierta, sin prórroga y antes de vencer. */
+    canExtend: boolean;
+    events: {
+        action: AccessRequestEventAction;
+        note: string | null;
+        employeeFullName: string;
+        createdAt: string;
+    }[];
+}
+export interface AccessRequestSummaryEntity {
+    year: number;
+    total: number;
+    open: number;
+    overdue: number;
+    dueSoon: number;
+    resolved: Record<AccessRequestResolution, number>;
+    /** Respondidas dentro del plazo sobre las respondidas, en %. */
+    onTimeRate: number | null;
+    /** Días hábiles promedio entre el ingreso (o la subsanación) y la respuesta. */
+    averageBusinessDays: number | null;
+    appealed: number;
+}

package/dist/entities/accessRequest/accessRequest.entity.js

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

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

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

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

package/dist/entities/index.d.ts

@@ -16,3 +16,4 @@ export * from './audit';
 export * from './signatureCheck';
 export * from './repositoryExport';
 export * from './retention';
+export * from './accessRequest';

package/dist/entities/index.js

@@ -32,3 +32,4 @@ __exportStar(require("./audit"), exports);
 __exportStar(require("./signatureCheck"), exports);
 __exportStar(require("./repositoryExport"), exports);
 __exportStar(require("./retention"), exports);
+__exportStar(require("./accessRequest"), exports);

package/package.json

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

package/src/base/entities.ts

@@ -363,6 +363,61 @@ export const DispositionKind = {
   Elimination: 'Elimination',
 } satisfies Record<string, DispositionKind>;
 
+export type AccessRequestChannel = 'Portal' | 'Email' | 'InPerson' | 'Letter';
+
+export const AccessRequestChannel = {
+  Portal: 'Portal',
+  Email: 'Email',
+  InPerson: 'InPerson',
+  Letter: 'Letter',
+} satisfies Record<string, AccessRequestChannel>;
+
+export type AccessRequestStatus = 'Received' | 'InCorrection' | 'InProgress' | 'Resolved';
+
+export const AccessRequestStatus = {
+  Received: 'Received',
+  InCorrection: 'InCorrection',
+  InProgress: 'InProgress',
+  Resolved: 'Resolved',
+} satisfies Record<string, AccessRequestStatus>;
+
+export type AccessRequestResolution =
+  'Delivered' | 'PartiallyDelivered' | 'Denied' | 'Derived' | 'NonExistent' | 'Withdrawn';
+
+export const AccessRequestResolution = {
+  Delivered: 'Delivered',
+  PartiallyDelivered: 'PartiallyDelivered',
+  Denied: 'Denied',
+  Derived: 'Derived',
+  NonExistent: 'NonExistent',
+  Withdrawn: 'Withdrawn',
+} satisfies Record<string, AccessRequestResolution>;
+
+export type AccessRequestEventAction =
+  | 'Received'
+  | 'Updated'
+  | 'CorrectionRequested'
+  | 'Corrected'
+  | 'Assigned'
+  | 'ThirdPartyNotified'
+  | 'OppositionRegistered'
+  | 'Extended'
+  | 'Resolved'
+  | 'AppealRegistered';
+
+export const AccessRequestEventAction = {
+  Received: 'Received',
+  Updated: 'Updated',
+  CorrectionRequested: 'CorrectionRequested',
+  Corrected: 'Corrected',
+  Assigned: 'Assigned',
+  ThirdPartyNotified: 'ThirdPartyNotified',
+  OppositionRegistered: 'OppositionRegistered',
+  Extended: 'Extended',
+  Resolved: 'Resolved',
+  AppealRegistered: 'AppealRegistered',
+} satisfies Record<string, AccessRequestEventAction>;
+
 export interface DocumentTypeEntity {
   id: string;
   name: string;
@@ -446,6 +501,8 @@ export interface DocumentEntity {
   accesses?: DocumentAccessEntity[];
   disposition?: DispositionRecordEntity | null;
   dispositionId?: string | null;
+  accessRequestResponses?: AccessRequestEntity[];
+  accessRequestDeliveries?: AccessRequestDocumentEntity[];
   dispatch?: DocumentDispatchEntity | null;
   docDigitalInbound?: DocDigitalInboundEntity | null;
   deleted: boolean;
@@ -1014,4 +1071,63 @@ export interface DispositionRecordEntity {
   createdAt: string;
 }
 
+export interface AccessRequestEntity {
+  id: string;
+  number: number;
+  year: number;
+  externalFolio?: string | null;
+  channel: AccessRequestChannel;
+  receivedAt: string;
+  requesterName: string;
+  requesterEmail?: string | null;
+  requesterAddress?: string | null;
+  requestText: string;
+  deliveryFormat?: string | null;
+  status: AccessRequestStatus;
+  correctionRequestedAt?: string | null;
+  correctionDueAt?: string | null;
+  correctedAt?: string | null;
+  dueAt: string;
+  extendedAt?: string | null;
+  extensionNote?: string | null;
+  assigneeEmployeeId?: string | null;
+  assigneeFullName?: string | null;
+  thirdPartyNotifiedAt?: string | null;
+  oppositionDueAt?: string | null;
+  thirdPartyOpposed?: boolean | null;
+  resolution?: AccessRequestResolution | null;
+  resolvedAt?: string | null;
+  denialGrounds: string[];
+  derivedTo?: string | null;
+  resolutionNote?: string | null;
+  responseDocument?: DocumentEntity | null;
+  responseDocumentId?: string | null;
+  appealedAt?: string | null;
+  appealNote?: string | null;
+  createdByEmployeeId: string;
+  createdByFullName: string;
+  documents?: AccessRequestDocumentEntity[];
+  events?: AccessRequestEventEntity[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface AccessRequestDocumentEntity {
+  accessRequest?: AccessRequestEntity;
+  accessRequestId: string;
+  document?: DocumentEntity;
+  documentId: string;
+}
+
+export interface AccessRequestEventEntity {
+  id: string;
+  action: AccessRequestEventAction;
+  note?: string | null;
+  employeeId?: string | null;
+  employeeFullName: string;
+  accessRequest?: AccessRequestEntity;
+  accessRequestId: string;
+  createdAt: string;
+}
+
 type JsonValue = string | number | boolean | { [key in string]?: JsonValue } | Array<JsonValue> | null;

package/src/contracts/accessRequest.contract.ts

@@ -0,0 +1,81 @@
+import { type AccessRequestChannel, type AccessRequestResolution } from '../base/entities';
+import {
+  type AccessRequestDetailEntity,
+  type AccessRequestListItemEntity,
+  type AccessRequestSummaryEntity,
+} from '../entities';
+import { type RpcPage } from './contract';
+
+/** Patrones NATS de `accessRequest`: solicitudes de acceso a la información pública (Ley 20.285). */
+export const AccessRequestPatterns = {
+  getAll: 'gestorDocumental.accessRequest.getAll',
+  getById: 'gestorDocumental.accessRequest.getById',
+  getSummary: 'gestorDocumental.accessRequest.getSummary',
+  create: 'gestorDocumental.accessRequest.create',
+  update: 'gestorDocumental.accessRequest.update',
+  act: 'gestorDocumental.accessRequest.act',
+} as const;
+
+export interface AccessRequestWritePayload {
+  externalFolio?: string | null;
+  channel: AccessRequestChannel;
+  /** Fecha y hora de ingreso (ISO): desde ahí corren los 20 días hábiles. */
+  receivedAt: string;
+  requesterName: string;
+  requesterEmail?: string | null;
+  requesterAddress?: string | null;
+  requestText: string;
+  deliveryFormat?: string | null;
+}
+
+/** Lo que se hace con una solicitud, un paso a la vez. */
+export type AccessRequestAction =
+  | { type: 'requestCorrection'; note: string }
+  | { type: 'registerCorrection'; correctedAt?: string | null; note?: string | null }
+  | { type: 'assign'; employeeId: string; fullName: string; note?: string | null }
+  | { type: 'notifyThirdParty'; note: string }
+  | { type: 'registerOpposition'; opposed: boolean; note?: string | null }
+  | { type: 'extend'; note: string }
+  | {
+      type: 'resolve';
+      resolution: AccessRequestResolution;
+      grounds?: string[];
+      derivedTo?: string | null;
+      note?: string | null;
+      responseDocumentId?: string | null;
+      documentIds?: string[];
+    }
+  | { type: 'registerAppeal'; appealedAt?: string | null; note: string };
+
+export interface AccessRequestActor {
+  employeeId: string;
+  fullName: string;
+}
+
+export interface AccessRequestContract {
+  [AccessRequestPatterns.getAll]: {
+    payload: {
+      status?: 'open' | 'resolved' | 'all';
+      year?: number | null;
+      search?: string;
+      page?: number;
+      limit?: number;
+    };
+    response: RpcPage<AccessRequestListItemEntity[]>;
+  };
+  [AccessRequestPatterns.getById]: { payload: { id: string }; response: AccessRequestDetailEntity };
+  [AccessRequestPatterns.getSummary]: { payload: { year: number }; response: AccessRequestSummaryEntity };
+  [AccessRequestPatterns.create]: {
+    payload: AccessRequestWritePayload & { actor: AccessRequestActor };
+    response: AccessRequestDetailEntity;
+  };
+  /** Corrige los datos mientras no está resuelta. */
+  [AccessRequestPatterns.update]: {
+    payload: AccessRequestWritePayload & { id: string; actor: AccessRequestActor };
+    response: AccessRequestDetailEntity;
+  };
+  [AccessRequestPatterns.act]: {
+    payload: { id: string; action: AccessRequestAction; actor: AccessRequestActor };
+    response: AccessRequestDetailEntity;
+  };
+}

package/src/contracts/index.ts

@@ -10,6 +10,7 @@ import { AuditPatterns, type AuditContract } from './audit.contract';
 import { SignatureCheckPatterns, type SignatureCheckContract } from './signatureCheck.contract';
 import { RepositoryExportPatterns, type RepositoryExportContract } from './repositoryExport.contract';
 import { RetentionPatterns, type RetentionContract } from './retention.contract';
+import { AccessRequestPatterns, type AccessRequestContract } from './accessRequest.contract';
 import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
@@ -36,6 +37,7 @@ export * from './audit.contract';
 export * from './signatureCheck.contract';
 export * from './repositoryExport.contract';
 export * from './retention.contract';
+export * from './accessRequest.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -57,6 +59,7 @@ export const GestorDocumentalPatterns = {
   signatureCheck: SignatureCheckPatterns,
   repositoryExport: RepositoryExportPatterns,
   retention: RetentionPatterns,
+  accessRequest: AccessRequestPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -77,4 +80,5 @@ export type GestorDocumentalContract = DocumentTypeContract &
   AuditContract &
   SignatureCheckContract &
   RepositoryExportContract &
-  RetentionContract;
+  RetentionContract &
+  AccessRequestContract;

package/src/entities/accessRequest/accessRequest.entity.ts

@@ -0,0 +1,78 @@
+import {
+  type AccessRequestChannel,
+  type AccessRequestEventAction,
+  type AccessRequestResolution,
+  type AccessRequestStatus,
+} from '../../base/entities';
+
+/** Semáforo del plazo de respuesta: a tiempo, por vencer (2 días hábiles o menos) o vencido. */
+export type AccessRequestDueStatus = 'OnTime' | 'DueSoon' | 'Overdue';
+
+export interface AccessRequestListItemEntity {
+  id: string;
+  /** «N° 15/2026». */
+  label: string;
+  externalFolio: string | null;
+  channel: AccessRequestChannel;
+  requesterName: string;
+  requestText: string;
+  receivedAt: string;
+  dueAt: string;
+  status: AccessRequestStatus;
+  resolution: AccessRequestResolution | null;
+  assigneeFullName: string | null;
+  /** Solo mientras está abierta. */
+  dueStatus: AccessRequestDueStatus | null;
+  businessDaysLeft: number | null;
+  /** Ya resuelta: si se respondió dentro del plazo. */
+  resolvedOnTime: boolean | null;
+}
+
+export interface AccessRequestDocumentLinkEntity {
+  id: string;
+  folio: string | null;
+  subject: string;
+}
+
+export interface AccessRequestDetailEntity extends AccessRequestListItemEntity {
+  year: number;
+  number: number;
+  requesterEmail: string | null;
+  requesterAddress: string | null;
+  deliveryFormat: string | null;
+  correctionRequestedAt: string | null;
+  correctionDueAt: string | null;
+  correctedAt: string | null;
+  extendedAt: string | null;
+  extensionNote: string | null;
+  assigneeEmployeeId: string | null;
+  thirdPartyNotifiedAt: string | null;
+  oppositionDueAt: string | null;
+  thirdPartyOpposed: boolean | null;
+  resolvedAt: string | null;
+  denialGrounds: string[];
+  derivedTo: string | null;
+  resolutionNote: string | null;
+  responseDocument: AccessRequestDocumentLinkEntity | null;
+  documents: AccessRequestDocumentLinkEntity[];
+  appealedAt: string | null;
+  appealNote: string | null;
+  createdByFullName: string;
+  /** Se puede prorrogar: abierta, sin prórroga y antes de vencer. */
+  canExtend: boolean;
+  events: { action: AccessRequestEventAction; note: string | null; employeeFullName: string; createdAt: string }[];
+}
+
+export interface AccessRequestSummaryEntity {
+  year: number;
+  total: number;
+  open: number;
+  overdue: number;
+  dueSoon: number;
+  resolved: Record<AccessRequestResolution, number>;
+  /** Respondidas dentro del plazo sobre las respondidas, en %. */
+  onTimeRate: number | null;
+  /** Días hábiles promedio entre el ingreso (o la subsanación) y la respuesta. */
+  averageBusinessDays: number | null;
+  appealed: number;
+}

package/src/entities/accessRequest/index.ts

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

package/src/entities/index.ts

@@ -16,3 +16,4 @@ export * from './audit';
 export * from './signatureCheck';
 export * from './repositoryExport';
 export * from './retention';
+export * from './accessRequest';