@muni-sanfer/types-gestor-documental 0.0.1-beta.27 → 0.0.1-beta.29

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

@@ -0,0 +1,185 @@
+import {
+  type CommunicationMeans,
+  type DataBreachEventAction,
+  type DataBreachKind,
+  type DataBreachNoticeMeans,
+  type DataBreachStatus,
+  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[];
+}
+
+/** Vulneración de las medidas de seguridad que afecta datos personales (Ley 19.628, art. 14 sexies). */
+export interface DataBreachResponseEntity {
+  id: string;
+  /** «N° 2/2026». */
+  label: string;
+  year: number;
+  number: number;
+  detectedAt: string;
+  occurredAt: string | null;
+  kinds: DataBreachKind[];
+  description: string;
+  effects: string | null;
+  dataCategories: string[];
+  affectedCount: number | null;
+  measures: string | null;
+  sensitiveData: boolean;
+  minorsData: boolean;
+  financialData: boolean;
+  riskToRights: boolean;
+  treatmentId: string | null;
+  treatmentName: string | null;
+  status: DataBreachStatus;
+  /** Hay riesgo razonable para los titulares: se reporta a la Agencia sin dilaciones indebidas. */
+  mustReportAgency: boolean;
+  /** Además, datos sensibles, de menores de 14 o de obligaciones económicas: se comunica a los titulares. */
+  mustNotifyHolders: boolean;
+  agencyReportedAt: string | null;
+  agencyReportNote: string | null;
+  /** Horas entre la detección y el reporte a la Agencia (o hasta ahora, si falta reportarla). */
+  agencyDelayHours: number | null;
+  holdersNotifiedAt: string | null;
+  holdersNoticeMeans: DataBreachNoticeMeans | null;
+  holdersNoticeNote: string | null;
+  closedAt: string | null;
+  closeNote: string | null;
+  createdByFullName: string;
+  /** Por qué todavía no se puede cerrar, o `null` si se puede. */
+  closeBlock: string | null;
+  events: { action: DataBreachEventAction; note: string | null; employeeFullName: string; createdAt: string }[];
+}

package/src/entities/dataProtection/index.ts

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

package/src/entities/index.ts

@@ -18,3 +18,4 @@ export * from './repositoryExport';
 export * from './retention';
 export * from './accessRequest';
 export * from './transparency';
+export * from './dataProtection';

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

@@ -1,4 +1,5 @@
 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';
@@ -26,6 +27,8 @@ export interface TransparencyItemEntity {
   /** 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;