@muni-sanfer/types-gestor-documental 0.0.1-beta.15 → 0.0.1-beta.17

package/src/entities/archivalSeries/archivalSeries.entity.ts

@@ -0,0 +1,32 @@
+import { ArchivalSeriesEntity } from '../../base/entities';
+
+export interface ArchivalSeriesGetAllResponseEntity {
+  id: ArchivalSeriesEntity['id'];
+  code: ArchivalSeriesEntity['code'];
+  name: ArchivalSeriesEntity['name'];
+  section: ArchivalSeriesEntity['section'];
+  description: ArchivalSeriesEntity['description'];
+  enabled: ArchivalSeriesEntity['enabled'];
+  /** Cuántos tipos documentales y expedientes la usan. */
+  documentTypes: number;
+  caseFiles: number;
+}
+
+export type ArchivalSeriesGetByIdResponseEntity = ArchivalSeriesGetAllResponseEntity;
+
+/** Cómo se cita una serie donde se usa: código y nombre. */
+export interface ArchivalSeriesSummaryEntity {
+  id: string;
+  code: string;
+  name: string;
+}
+
+export interface ArchivalSeriesCreateResponseEntity {
+  id: ArchivalSeriesEntity['id'];
+  ok: boolean;
+}
+
+export interface ArchivalSeriesUpdateResponseEntity {
+  id: ArchivalSeriesEntity['id'];
+  ok: boolean;
+}

package/src/entities/archivalSeries/index.ts

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

package/src/entities/caseFile/caseFile.entity.ts

@@ -140,6 +140,10 @@ export interface CaseFileGetByIdResponseEntity extends CaseFileGetAllResponseEnt
   closingNote: CaseFileEntity['closingNote'];
   /** Expediente híbrido: tiene documentos en papel que no se pudieron digitalizar. */
   isHybrid: boolean;
+  /** MGDEE1_2: serie del Cuadro de Clasificación. */
+  archivalSeries: { id: string; code: string; name: string } | null;
+  /** MGDEE8_2: fin de la restricción de acceso. */
+  restrictionEndsAt: string | null;
   index: CaseFileEntryResponseEntity[];
   sharedWith: CaseFileParticipantResponseEntity[];
   actors: CaseFileActorResponseEntity[];

package/src/entities/document/document.entity.ts

@@ -130,7 +130,14 @@ export interface DocumentGetAllResponseEntity {
 }
 
 /** Una entrada de la bandeja de recibidos: la entrega y el documento al que corresponde. */
+/** Semáforo de un plazo pendiente: a tiempo, por vencer (2 días hábiles o menos) o vencido. */
+export type DocumentDueStatus = 'OnTime' | 'DueSoon' | 'Overdue';
+
 export interface DocumentInboxItemEntity extends DocumentDeliveryResponseEntity {
+  /** Semáforo de lo pendiente con plazo (sin plazo o ya atendido, `null`). */
+  dueStatus: DocumentDueStatus | null;
+  /** Días hábiles que quedan, sin contar hoy (vencido: `null`). */
+  businessDaysLeft: number | null;
   document: DocumentLinkEntity;
 }
 
@@ -138,6 +145,10 @@ export interface DocumentGetByIdResponseEntity {
   id: DocumentEntity['id'];
   // Quién lo emite: la entidad emisora del tipo (Educación, Salud, Juzgado) o la municipalidad.
   issuerName: string;
+  // Serie documental del Cuadro de Clasificación (la de su tipo documental; MGDDE1_2).
+  archivalSeries: { id: string; code: string; name: string } | null;
+  // Fin de la restricción de acceso: desde entonces se consulta como público si no tiene datos sensibles.
+  restrictionEndsAt: string | null;
   subject: DocumentEntity['subject'];
   keywords: DocumentEntity['keywords'];
   accessLevel: DocumentEntity['accessLevel'];
@@ -372,6 +383,10 @@ export interface DocumentReassignResponseEntity {
  */
 export interface DocumentAgendaItemEntity {
   kind: 'Received' | 'Sent';
+  /** Semáforo de lo pendiente (atendido o ya respondido por todos: `null`). */
+  dueStatus: DocumentDueStatus | null;
+  /** Días hábiles que quedan, sin contar hoy (vencido: `null`). */
+  businessDaysLeft: number | null;
   /** La entrega (lo recibido) o el documento (lo enviado). */
   id: string;
   documentId: DocumentEntity['id'];
@@ -491,3 +506,18 @@ export interface DocumentEmailCopyViewEntity {
   verificationCode: string | null;
   signers: { fullName: string; position: string | null; signedAt: string | null }[];
 }
+
+/** Recordatorio de un plazo: al recibido y, si venció, también a su jefatura (la resuelve el gateway). */
+export interface DocumentReminderEntity {
+  deliveryId: string;
+  kind: 'DueSoon' | 'Overdue';
+  employeeId: string;
+  fullName: string;
+  documentId: string;
+  /** Cómo se cita: «D.E. N° 590/2026», el folio de ingreso o el tipo. */
+  folio: string;
+  subject: string;
+  dueAt: string;
+  instruction: DocumentDeliveryEntity['instruction'];
+  sentByFullName: string | null;
+}

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

@@ -27,6 +27,8 @@ export interface DocumentTypeGetAllResponseEntity {
   // Sin numeración, sus documentos solo llevan fecha, código de verificación y QR.
   numbered: DocumentTypeEntity['numbered'];
   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;
   // Entidad que emite sus documentos (Educación, Salud, Juzgado). `null`: la municipalidad.
   issuingEntity: { id: string; name: string; shortName: string | null } | null;
   // Tipo cuyo correlativo comparte: sus números salen de esa serie (y `nextCorrelative`, `correlativeYear` y

package/src/entities/holiday/holiday.entity.ts

@@ -0,0 +1,11 @@
+/** Feriado: el día («AAAA-MM-DD») no cuenta como hábil en los plazos. */
+export interface HolidayResponseEntity {
+  id: string;
+  date: string;
+  name: string;
+}
+
+export interface HolidayRemoveResponseEntity {
+  id: string;
+  ok: boolean;
+}

package/src/entities/holiday/index.ts

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

package/src/entities/index.ts

@@ -7,3 +7,7 @@ export * from './partsOffice';
 export * from './registerBook';
 export * from './signatureBatch';
 export * from './workFolder';
+export * from './scan';
+export * from './archivalSeries';
+export * from './textSnippet';
+export * from './holiday';

package/src/entities/scan/index.ts

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

package/src/entities/scan/scan.entity.ts

@@ -0,0 +1,32 @@
+/** Sesión recién abierta: el token y el QR viajan solo aquí. */
+export interface ScanSessionCreateResponseEntity {
+  id: string;
+  token: string;
+  /** Dirección que abre el celular, con el token. */
+  url: string;
+  /** El QR de esa dirección, como imagen PNG en data URL. */
+  qrDataUrl: string;
+  expiresAt: string;
+}
+
+/** Estado de la sesión, como lo ve en el escritorio quien la abrió. */
+export interface ScanSessionResponseEntity {
+  id: string;
+  status: 'Open' | 'Ready';
+  pageCount: number;
+  expiresAt: string;
+  fileName: string | null;
+}
+
+export interface ScanSessionFileResponseEntity {
+  fileId: string;
+  fileName: string;
+}
+
+/** La sesión como la ve el celular. */
+export interface ScanSessionPublicEntity {
+  status: 'Open' | 'Ready';
+  pageCount: number;
+  maxPages: number;
+  expiresAt: string;
+}

package/src/entities/textSnippet/index.ts

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

package/src/entities/textSnippet/textSnippet.entity.ts

@@ -0,0 +1,24 @@
+import { TextSnippetEntity } from '../../base/entities';
+
+/** Texto de la biblioteca de vistos y cláusulas. */
+export interface TextSnippetGetAllResponseEntity {
+  id: TextSnippetEntity['id'];
+  title: TextSnippetEntity['title'];
+  text: TextSnippetEntity['text'];
+  section: TextSnippetEntity['section'];
+  keywords: TextSnippetEntity['keywords'];
+  enabled: TextSnippetEntity['enabled'];
+  updatedAt: TextSnippetEntity['updatedAt'];
+}
+
+export type TextSnippetGetByIdResponseEntity = TextSnippetGetAllResponseEntity;
+
+export interface TextSnippetCreateResponseEntity {
+  id: TextSnippetEntity['id'];
+  ok: boolean;
+}
+
+export interface TextSnippetUpdateResponseEntity {
+  id: TextSnippetEntity['id'];
+  ok: boolean;
+}