@muni-sanfer/types-gestor-documental 0.0.1-beta.26 → 0.0.1-beta.28

package/src/contracts/index.ts

@@ -11,6 +11,8 @@ import { SignatureCheckPatterns, type SignatureCheckContract } from './signature
 import { RepositoryExportPatterns, type RepositoryExportContract } from './repositoryExport.contract';
 import { RetentionPatterns, type RetentionContract } from './retention.contract';
 import { AccessRequestPatterns, type AccessRequestContract } from './accessRequest.contract';
+import { TransparencyPatterns, type TransparencyContract } from './transparency.contract';
+import { DataProtectionPatterns, type DataProtectionContract } from './dataProtection.contract';
 import { ScanPatterns, type ScanContract } from './scan.contract';
 import { PartsOfficePatterns, type PartsOfficeContract } from './partsOffice.contract';
 import { ProcedurePatterns, type ProcedureContract } from './procedure.contract';
@@ -38,6 +40,8 @@ export * from './signatureCheck.contract';
 export * from './repositoryExport.contract';
 export * from './retention.contract';
 export * from './accessRequest.contract';
+export * from './transparency.contract';
+export * from './dataProtection.contract';
 
 /** Patrones NATS de gestor-documental-ms, por recurso: `gestorDocumental.<recurso>.<acción>`. */
 export const GestorDocumentalPatterns = {
@@ -60,6 +64,8 @@ export const GestorDocumentalPatterns = {
   repositoryExport: RepositoryExportPatterns,
   retention: RetentionPatterns,
   accessRequest: AccessRequestPatterns,
+  transparency: TransparencyPatterns,
+  dataProtection: DataProtectionPatterns,
 } as const;
 
 /** Contrato completo de gestor-documental-ms: la unión de los contratos de sus recursos. */
@@ -81,4 +87,6 @@ export type GestorDocumentalContract = DocumentTypeContract &
   SignatureCheckContract &
   RepositoryExportContract &
   RetentionContract &
-  AccessRequestContract;
+  AccessRequestContract &
+  TransparencyContract &
+  DataProtectionContract;

package/src/contracts/transparency.contract.ts

@@ -0,0 +1,55 @@
+import {
+  type DocumentPublicFileResponseEntity,
+  type IndicatorsFileEntity,
+  type TransparencyItemEntity,
+  type TransparencyItemStatus,
+  type TransparencyMonthEntity,
+  type TransparencyPublicEntity,
+} from '../entities';
+
+/** Patrones NATS de `transparency`: Transparencia Activa de los documentos firmados (Ley 20.285, art. 7°). */
+export const TransparencyPatterns = {
+  getMonth: 'gestorDocumental.transparency.getMonth',
+  update: 'gestorDocumental.transparency.update',
+  export: 'gestorDocumental.transparency.export',
+  getRedactedFile: 'gestorDocumental.transparency.getRedactedFile',
+  getPublic: 'gestorDocumental.transparency.getPublic',
+  getPublicFile: 'gestorDocumental.transparency.getPublicFile',
+} as const;
+
+type TTransparencyActor = { employeeId: string; fullName: string };
+
+/** Lo que se decide sobre un documento en Transparencia Activa. */
+export type TransparencyUpdatePayload =
+  /** Publicarlo (o corregir el enlace): si el original no es público, exige antes la versión tarjada. */
+  | { action: 'publish'; documentId: string; url?: string | null; note?: string | null; actor: TTransparencyActor }
+  /** No se publica, con su motivo (p. ej. reservado por el art. 21 de la Ley 20.285). */
+  | { action: 'exclude'; documentId: string; reason: string; actor: TTransparencyActor }
+  /** Vuelve a pendiente: se retiró la publicación o se revisó la exclusión. */
+  | { action: 'withdraw'; documentId: string; reason: string; actor: TTransparencyActor }
+  /** Versión tarjada ya subida al gestor de archivos (PDF). */
+  | { action: 'setRedacted'; documentId: string; fileId: string; fileName: string; actor: TTransparencyActor }
+  | { action: 'removeRedacted'; documentId: string; actor: TTransparencyActor };
+
+export interface TransparencyContract {
+  /** Lo firmado en el mes (hora de Chile) de los tipos que se publican, y lo que ya se publicó aunque el tipo cambie. */
+  [TransparencyPatterns.getMonth]: {
+    payload: { year: number; month: number; status?: TransparencyItemStatus | null };
+    response: TransparencyMonthEntity;
+  };
+  [TransparencyPatterns.update]: { payload: TransparencyUpdatePayload; response: TransparencyItemEntity };
+  /** Planilla del mes (Excel) para cargar en el Portal de Transparencia. */
+  [TransparencyPatterns.export]: {
+    payload: { year: number; month: number; generatedBy: string };
+    response: IndicatorsFileEntity;
+  };
+  /** La versión tarjada cargada, para revisarla antes de publicar. */
+  [TransparencyPatterns.getRedactedFile]: {
+    payload: { documentId: string };
+    response: DocumentPublicFileResponseEntity;
+  };
+  /** Página pública de un documento publicado, por su código de verificación. No exige sesión. */
+  [TransparencyPatterns.getPublic]: { payload: { code: string }; response: TransparencyPublicEntity };
+  /** La versión publicada: la tarjada si existe; si no, el original público. Solo de un documento vigente. */
+  [TransparencyPatterns.getPublicFile]: { payload: { code: string }; response: DocumentPublicFileResponseEntity };
+}

package/src/entities/dataProtection/dataProtection.entity.ts

@@ -0,0 +1,140 @@
+import {
+  type CommunicationMeans,
+  type DataLegalBasis,
+  type DataRight,
+  type DataRightsChannel,
+  type DataRightsEventAction,
+  type DataRightsRequestStatus,
+  type DataRightsResolution,
+} from '../../base/entities';
+
+/** Tratamiento de datos personales de la municipalidad: lo que se informa al público (Ley 19.628, art. 14 ter). */
+export interface DataTreatmentResponseEntity {
+  id: string;
+  name: string;
+  purpose: string;
+  legalBasis: DataLegalBasis;
+  legalBasisDetail: string | null;
+  dataCategories: string[];
+  sensitiveData: boolean;
+  dataSubjects: string;
+  recipients: string | null;
+  source: string | null;
+  retention: string | null;
+  securityMeasures: string | null;
+  internationalTransfer: string | null;
+  responsibleUnit: string | null;
+  published: boolean;
+  enabled: boolean;
+  /** Solicitudes de titulares que lo mencionan. */
+  requests: number;
+  updatedAt: string;
+}
+
+/** Página pública de protección de datos: quién es el responsable, cómo ejercer los derechos y qué se trata. */
+export interface DataProtectionPolicyEntity {
+  organ: string;
+  /** Correo o medio en que se reciben las solicitudes de los titulares (art. 14 ter letra c). */
+  contact: string | null;
+  /** Dirección de la política de tratamiento, si está publicada aparte. */
+  policyUrl: string | null;
+  treatments: Omit<DataTreatmentResponseEntity, 'published' | 'enabled' | 'requests' | 'securityMeasures'>[];
+}
+
+/** Semáforo del plazo: a tiempo, por vencer (5 días corridos o menos) o vencido. */
+export type DataRightsDueStatus = 'OnTime' | 'DueSoon' | 'Overdue';
+
+export interface DataRightsRequestListItemEntity {
+  id: string;
+  /** «N° 4/2026». */
+  label: string;
+  channel: DataRightsChannel;
+  rights: DataRight[];
+  requesterName: string;
+  requestText: string;
+  treatmentName: string | null;
+  receivedAt: string;
+  dueAt: string;
+  status: DataRightsRequestStatus;
+  resolution: DataRightsResolution | null;
+  assigneeFullName: string | null;
+  acknowledged: boolean;
+  identityVerified: boolean;
+  /** Bloqueo temporal pedido y sin resolver. */
+  blockingPending: boolean;
+  /** Solo mientras está abierta. */
+  dueStatus: DataRightsDueStatus | null;
+  daysLeft: number | null;
+  resolvedOnTime: boolean | null;
+}
+
+export interface DataRightsDocumentLinkEntity {
+  id: string;
+  folio: string | null;
+  subject: string;
+}
+
+export interface DataRightsRequestDetailEntity extends DataRightsRequestListItemEntity {
+  year: number;
+  number: number;
+  requesterRut: string | null;
+  requesterEmail: string | null;
+  requesterAddress: string | null;
+  representativeName: string | null;
+  identityVerifiedAt: string | null;
+  identityNote: string | null;
+  treatmentId: string | null;
+  acknowledgedAt: string | null;
+  extendedAt: string | null;
+  extensionNote: string | null;
+  blockingRequested: boolean;
+  blockingReason: string | null;
+  blockingDueAt: string | null;
+  blockingGranted: boolean | null;
+  blockingResolvedAt: string | null;
+  blockingNote: string | null;
+  assigneeEmployeeId: string | null;
+  resolvedAt: string | null;
+  denialGrounds: string[];
+  resolutionNote: string | null;
+  responseDocument: DataRightsDocumentLinkEntity | null;
+  responseSentAt: string | null;
+  responseSentTo: string | null;
+  responseSentMeans: CommunicationMeans | null;
+  /** Hasta cuándo el titular puede reclamar ante la Agencia (30 días hábiles), si se denegó en todo o en parte. */
+  complaintDeadline: string | null;
+  complaintAt: string | null;
+  complaintNote: string | null;
+  createdByFullName: string;
+  /** Se puede prorrogar: abierta, sin prórroga y antes de vencer. */
+  canExtend: boolean;
+  /** El titular ya puede reclamar ante la Agencia: denegación o plazo vencido sin respuesta. */
+  canRegisterComplaint: boolean;
+  events: { action: DataRightsEventAction; note: string | null; employeeFullName: string; createdAt: string }[];
+}
+
+export interface DataRightsSummaryEntity {
+  year: number;
+  total: number;
+  open: number;
+  overdue: number;
+  dueSoon: number;
+  /** Abiertas sin acuse de recibo. */
+  unacknowledged: number;
+  /** Bloqueos temporales pedidos y sin resolver. */
+  blockingPending: number;
+  byRight: Record<DataRight, number>;
+  resolved: Record<DataRightsResolution, number>;
+  /** Respondidas dentro del plazo sobre las respondidas, en %. */
+  onTimeRate: number | null;
+  complaints: number;
+}
+
+/** Datos personales que se reconocen en el texto de un documento, enmascarados: ayudan a tarjar. */
+export interface PersonalDataHintsEntity {
+  ruts: number;
+  emails: number;
+  phones: number;
+  /** Algunos ejemplos enmascarados («11.1••.•••-1»). */
+  samples: string[];
+}

package/src/entities/dataProtection/index.ts

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

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

@@ -26,6 +26,9 @@ export interface DocumentTypeGetAllResponseEntity {
   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'];
   // Serie documental del Cuadro de Clasificación a la que van sus documentos (MGDDE1_2).
   archivalSeries: { id: string; code: string; name: string } | null;

package/src/entities/index.ts

@@ -17,3 +17,5 @@ export * from './signatureCheck';
 export * from './repositoryExport';
 export * from './retention';
 export * from './accessRequest';
+export * from './transparency';
+export * from './dataProtection';

package/src/entities/transparency/index.ts

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

package/src/entities/transparency/transparency.entity.ts

@@ -0,0 +1,78 @@
+import { type DocumentAccessLevel, type DocumentStatus } from '../../base/entities';
+import { type PersonalDataHintsEntity } from '../dataProtection';
+
+/** En qué quedó un documento en Transparencia Activa: aún sin decidir, publicado o excluido con su motivo. */
+export type TransparencyItemStatus = 'Pending' | 'Published' | 'Excluded';
+
+/** Un documento que se publica en Transparencia Activa (Ley 20.285, art. 7°), con lo que se decidió de él. */
+export interface TransparencyItemEntity {
+  documentId: string;
+  documentStatus: DocumentStatus;
+  verificationCode: string | null;
+  documentTypeName: string;
+  documentTypeAbbreviation: string | null;
+  /** Sección del Portal en que se publica, según su tipo documental. */
+  section: string | null;
+  /** Folio del documento (`Decreto Alcaldicio N° 15/2026`), o el nombre del tipo si no lleva número. */
+  reference: string;
+  correlative: number | null;
+  correlativeYear: number | null;
+  subject: string;
+  finishedAt: string | null;
+  annulledAt: string | null;
+  accessLevel: DocumentAccessLevel;
+  hasSensitiveData: boolean;
+  /** El original se puede publicar tal cual: es público (o su restricción terminó) y no tiene datos sensibles. */
+  originalIsPublic: boolean;
+  /** Para publicarlo hace falta antes la versión tarjada. */
+  needsRedacted: boolean;
+  redactedFileName: string | null;
+  /** RUN, correos y teléfonos que se reconocen en el texto del original (`null` si no tiene texto): ayudan a tarjar. */
+  personalData: PersonalDataHintsEntity | null;
+  status: TransparencyItemStatus;
+  /** Dirección de la publicación en el Portal de Transparencia, si se anotó. */
+  transparencyUrl: string | null;
+  /** Motivo de la exclusión, u observación de la publicación. */
+  transparencyNote: string | null;
+  transparencyAt: string | null;
+  transparencyByFullName: string | null;
+  /** Enlace público estable a la versión que se publica (`<TRANSPARENCY_URL>/<código>`), si está configurado. */
+  publicLink: string | null;
+}
+
+export interface TransparencyMonthCountsEntity {
+  total: number;
+  pending: number;
+  published: number;
+  excluded: number;
+  /** Publicados que después se anularon: hay que retirarlos o actualizarlos en el Portal. */
+  annulledPublished: number;
+}
+
+/** Lo firmado en un mes de los tipos documentales que se publican, con lo que falta por decidir. */
+export interface TransparencyMonthEntity {
+  year: number;
+  month: number;
+  counts: TransparencyMonthCountsEntity;
+  /** Tipos documentales marcados para Transparencia Activa. Sin ninguno, la bandeja queda vacía. */
+  documentTypes: { id: string; name: string; section: string | null }[];
+  items: TransparencyItemEntity[];
+}
+
+/** Lo que muestra la página pública de un documento publicado en Transparencia Activa. No exige sesión. */
+export interface TransparencyPublicEntity {
+  verificationCode: string;
+  documentTypeName: string;
+  issuerName: string;
+  section: string | null;
+  reference: string;
+  /** La materia solo se muestra si el original es público; si se publicó tarjado, se lee en el archivo. */
+  subject: string | null;
+  finishedAt: string | null;
+  /** Anulado después de publicarse: se informa y ya no se descarga. */
+  annulled: boolean;
+  /** Se publicó una versión tarjada (sin datos personales o reservados). */
+  redacted: boolean;
+  canDownload: boolean;
+  publishedAt: string | null;
+}