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

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

@@ -136,6 +136,8 @@ export interface DocumentInboxItemEntity extends DocumentDeliveryResponseEntity
 
 export interface DocumentGetByIdResponseEntity {
   id: DocumentEntity['id'];
+  // Quién lo emite: la entidad emisora del tipo (Educación, Salud, Juzgado) o la municipalidad.
+  issuerName: string;
   subject: DocumentEntity['subject'];
   keywords: DocumentEntity['keywords'];
   accessLevel: DocumentEntity['accessLevel'];
@@ -197,6 +199,8 @@ export interface DocumentGetByIdResponseEntity {
   /** Instituciones de DocDigital a quienes va dirigido, y su despacho por Oficina de Partes. */
   externalRecipients: DocumentExternalRecipientResponseEntity[];
   dispatch: DocumentDispatchResponseEntity | null;
+  // Copias por correo a quienes están fuera del Estado, con su envío y apertura.
+  emailCopies: DocumentEmailCopyResponseEntity[];
   documentType: DocumentTypeSummaryEntity;
   participants: DocumentParticipantResponseEntity[];
   attachments: {
@@ -321,6 +325,8 @@ export interface DocumentVerifyResponseEntity {
   state: DocumentVerificationState;
   verificationCode: string;
   documentType: Pick<DocumentTypeSummaryEntity, 'name' | 'abbreviation'>;
+  // Quién lo emite: la entidad emisora del tipo (Educación, Salud, Juzgado) o la municipalidad.
+  issuerName: string;
   correlative: DocumentEntity['correlative'];
   correlativeYear: DocumentEntity['correlativeYear'];
   numberedAt: DocumentEntity['numberedAt'];
@@ -446,3 +452,42 @@ export interface DocumentComposeResponseEntity {
   fileId?: string;
   contentBase64?: string;
 }
+
+/** Copia por correo de un documento, como la ve quien lo consulta en el gestor. */
+export interface DocumentEmailCopyResponseEntity {
+  id: string;
+  name: string;
+  email: string;
+  /** Cuándo se envió (sin valor: aún no corresponde). */
+  issuedAt: string | null;
+  expiresAt: string | null;
+  openedAt: string | null;
+  downloadCount: number;
+}
+
+/** Copia recién emitida: el gateway le envía el enlace a su destinatario. El token viaja solo aquí. */
+export interface DocumentEmailCopyIssuedEntity {
+  copyId: string;
+  documentId: string;
+  name: string;
+  email: string;
+  token: string;
+  expiresAt: string;
+  /** Cómo se cita: «D.E. N° 590/2026», o el tipo si no lleva número. */
+  folio: string;
+  subject: string;
+  issuerName: string;
+}
+
+/** El documento como lo ve quien abre su copia por correo. */
+export interface DocumentEmailCopyViewEntity {
+  recipientName: string;
+  expiresAt: string;
+  documentTypeName: string;
+  folio: string;
+  subject: string;
+  issuerName: string;
+  finishedAt: string | null;
+  verificationCode: string | null;
+  signers: { fullName: string; position: string | null; signedAt: string | null }[];
+}

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

@@ -27,6 +27,13 @@ export interface DocumentTypeGetAllResponseEntity {
   // Sin numeración, sus documentos solo llevan fecha, código de verificación y QR.
   numbered: DocumentTypeEntity['numbered'];
   directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
+  // 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
+  // `resetsYearly` son los de ese tipo). `null`: lleva su propio correlativo.
+  sharesNumberingWith: { id: string; name: string } | null;
+  // Tipos que toman sus números del correlativo de este.
+  numberingMembers: { id: string; name: string }[];
   enabled: DocumentTypeEntity['enabled'];
   // Cuántos visadores y firmantes tiene su flujo sugerido.
   flow: { visa: number; signature: number };

package/src/entities/index.ts

@@ -1,6 +1,7 @@
 export * from './documentType';
 export * from './document';
 export * from './procedure';
+export * from './issuingEntity';
 export * from './caseFile';
 export * from './partsOffice';
 export * from './registerBook';

package/src/entities/issuingEntity/index.ts

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

package/src/entities/issuingEntity/issuingEntity.entity.ts

@@ -0,0 +1,24 @@
+import { IssuingEntityEntity } from '../../base/entities';
+
+export interface IssuingEntityGetAllResponseEntity {
+  id: IssuingEntityEntity['id'];
+  name: IssuingEntityEntity['name'];
+  shortName: IssuingEntityEntity['shortName'];
+  directorateCodeReferences: IssuingEntityEntity['directorateCodeReferences'];
+  docDigitalEntityId: IssuingEntityEntity['docDigitalEntityId'];
+  enabled: IssuingEntityEntity['enabled'];
+  /** Cuántos tipos documentales emite. */
+  documentTypes: number;
+}
+
+export type IssuingEntityGetByIdResponseEntity = IssuingEntityGetAllResponseEntity;
+
+export interface IssuingEntityCreateResponseEntity {
+  id: IssuingEntityEntity['id'];
+  ok: boolean;
+}
+
+export interface IssuingEntityUpdateResponseEntity {
+  id: IssuingEntityEntity['id'];
+  ok: boolean;
+}

package/src/entities/partsOffice/partsOffice.entity.ts

@@ -40,6 +40,8 @@ export interface PartsOfficeSummaryEntity {
 export interface PartsOfficeDispatchEntity extends DocumentDispatchResponseEntity {
   document: DocumentLinkEntity & { accessLevel: string };
   externalRecipients: DocumentExternalRecipientResponseEntity[];
+  /** A nombre de quién sale: la entidad emisora del tipo documental o la municipalidad. */
+  issuerName: string;
   createdAt: string;
 }
 
@@ -54,6 +56,8 @@ export interface PartsOfficeInboundEntity {
   folioDate: string | null;
   typeName: string | null;
   reserved: boolean;
+  /** Entidad propia a la que llegó (la municipalidad o una entidad emisora). */
+  recipientEntityName: string | null;
   senderEntityName: string | null;
   senderName: string | null;
   senderPosition: string | null;

package/src/entities/registerBook/registerBook.entity.ts

@@ -26,12 +26,18 @@ export interface RegisterBookRowEntity {
   dispatch: string | null;
   /** Motivo de la anulación (del documento o del número). */
   observation: string | null;
+  /** Numeración compartida: tipo documental del número (`null` en un salto o si el libro es de un solo tipo). */
+  documentTypeName: string | null;
 }
 
 export interface RegisterBookEntity {
   kind: RegisterBookKind;
   /** «Decreto alcaldicio exento» o «Ingresos de Oficina de Partes». */
   title: string;
+  /** Quién lleva el libro: la entidad emisora del tipo o la municipalidad. */
+  issuerName: string;
+  /** Numeración compartida: los tipos que numeran en la serie del libro (vacío si es de un solo tipo). */
+  series: string[];
   year: number;
   month: number | null;
   rows: RegisterBookRowEntity[];