@muni-sanfer/types-gestor-documental 0.0.1-beta.2 → 0.0.1-beta.4

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

@@ -0,0 +1,196 @@
+import {
+  CaseFileAccessEntity,
+  CaseFileActorEntity,
+  CaseFileEntity,
+  CaseFileEntryEntity,
+  CaseFileMetadataChangeEntity,
+  CaseFileParticipantEntity,
+  CaseFileTrackingEntity,
+  DocumentEntity,
+  ProcedureEntity,
+} from '../../base/entities';
+import { DocumentTypeSummaryEntity } from '../document';
+
+/** Expediente al que se hace referencia desde otro lado: cómo se cita y en qué estado está. */
+export interface CaseFileLinkEntity {
+  id: CaseFileEntity['id'];
+  code: CaseFileEntity['code'];
+  title: CaseFileEntity['title'];
+  status: CaseFileEntity['status'];
+}
+
+export interface CaseFileGetAllResponseEntity extends CaseFileLinkEntity {
+  subject: CaseFileEntity['subject'];
+  accessLevel: CaseFileEntity['accessLevel'];
+  hasSensitiveData: CaseFileEntity['hasSensitiveData'];
+  procedure: Pick<ProcedureEntity, 'id' | 'name'>;
+  responsibleEmployeeId: CaseFileEntity['responsibleEmployeeId'];
+  responsibleFullName: CaseFileEntity['responsibleFullName'];
+  /** Actuaciones vigentes del índice (las que quedaron sin efecto no cuentan). */
+  entries: number;
+  participants: number;
+  createdAt: CaseFileEntity['createdAt'];
+  closedAt: CaseFileEntity['closedAt'];
+}
+
+/** Documento del gestor incorporado al expediente. */
+export interface CaseFileEntryDocumentEntity {
+  id: DocumentEntity['id'];
+  subject: DocumentEntity['subject'];
+  status: DocumentEntity['status'];
+  correlative: DocumentEntity['correlative'];
+  correlativeYear: DocumentEntity['correlativeYear'];
+  documentType: DocumentTypeSummaryEntity;
+}
+
+/** Entrada del índice electrónico: una actuación, en su orden de incorporación. */
+export interface CaseFileEntryResponseEntity {
+  id: CaseFileEntryEntity['id'];
+  sequence: CaseFileEntryEntity['sequence'];
+  kind: CaseFileEntryEntity['kind'];
+  actuationType: CaseFileEntryEntity['actuationType'];
+  title: CaseFileEntryEntity['title'];
+  document: CaseFileEntryDocumentEntity | null;
+  fileName: CaseFileEntryEntity['fileName'];
+  documentTypeName: CaseFileEntryEntity['documentTypeName'];
+  originDate: CaseFileEntryEntity['originDate'];
+  author: CaseFileEntryEntity['author'];
+  keywords: CaseFileEntryEntity['keywords'];
+  accessLevel: CaseFileEntryEntity['accessLevel'];
+  hasSensitiveData: CaseFileEntryEntity['hasSensitiveData'];
+  linkedCaseFile: CaseFileLinkEntity | null;
+  /** `true` si la entrada tiene un archivo que se puede abrir (un documento o un archivo subido). */
+  hasFile: boolean;
+  sha256: CaseFileEntryEntity['sha256'];
+  size: CaseFileEntryEntity['size'];
+  hasAdvancedSignature: CaseFileEntryEntity['hasAdvancedSignature'];
+  incorporatedByEmployeeId: CaseFileEntryEntity['incorporatedByEmployeeId'];
+  incorporatedByFullName: CaseFileEntryEntity['incorporatedByFullName'];
+  createdAt: CaseFileEntryEntity['createdAt'];
+  voidedAt: CaseFileEntryEntity['voidedAt'];
+  voidedByFullName: CaseFileEntryEntity['voidedByFullName'];
+  voidReason: CaseFileEntryEntity['voidReason'];
+  /** `true` si quien consulta puede dejarla sin efecto: el responsable o quien la incorporó, con el expediente abierto. */
+  canVoid: boolean;
+}
+
+export interface CaseFileParticipantResponseEntity {
+  id: CaseFileParticipantEntity['id'];
+  employeeId: CaseFileParticipantEntity['employeeId'];
+  fullName: CaseFileParticipantEntity['fullName'];
+  position: CaseFileParticipantEntity['position'];
+  addedByFullName: CaseFileParticipantEntity['addedByFullName'];
+  createdAt: CaseFileParticipantEntity['createdAt'];
+}
+
+export interface CaseFileActorResponseEntity {
+  id: CaseFileActorEntity['id'];
+  relation: CaseFileActorEntity['relation'];
+  actorType: CaseFileActorEntity['actorType'];
+  identifier: CaseFileActorEntity['identifier'];
+  name: CaseFileActorEntity['name'];
+}
+
+export interface CaseFileTrackingResponseEntity {
+  id: CaseFileTrackingEntity['id'];
+  action: CaseFileTrackingEntity['action'];
+  observation: CaseFileTrackingEntity['observation'];
+  employeeFullName: CaseFileTrackingEntity['employeeFullName'];
+  createdAt: CaseFileTrackingEntity['createdAt'];
+}
+
+export interface CaseFileMetadataChangeResponseEntity {
+  id: CaseFileMetadataChangeEntity['id'];
+  /** Código oficial del metadato. Ej: `MGDEE1_5`. */
+  field: CaseFileMetadataChangeEntity['field'];
+  previousValue: CaseFileMetadataChangeEntity['previousValue'];
+  newValue: CaseFileMetadataChangeEntity['newValue'];
+  employeeFullName: CaseFileMetadataChangeEntity['employeeFullName'];
+  createdAt: CaseFileMetadataChangeEntity['createdAt'];
+}
+
+export interface CaseFileAccessResponseEntity {
+  id: CaseFileAccessEntity['id'];
+  action: CaseFileAccessEntity['action'];
+  entryId: CaseFileAccessEntity['entryId'];
+  /** Título del documento que se abrió, si el acceso fue a uno. */
+  entryTitle: string | null;
+  employeeFullName: CaseFileAccessEntity['employeeFullName'];
+  createdAt: CaseFileAccessEntity['createdAt'];
+}
+
+export interface CaseFileGetByIdResponseEntity extends CaseFileGetAllResponseEntity {
+  summary: CaseFileEntity['summary'];
+  procedure: Pick<ProcedureEntity, 'id' | 'name' | 'cpatId' | 'cpatCode'>;
+  responsiblePosition: CaseFileEntity['responsiblePosition'];
+  incorporationMechanism: CaseFileEntity['incorporationMechanism'];
+  schemaVersion: CaseFileEntity['schemaVersion'];
+  /** Enlace persistente del expediente (MGDEE4_2). `null` si el servicio no tiene configurada la dirección. */
+  uri: string | null;
+  closedByFullName: CaseFileEntity['closedByFullName'];
+  closingNote: CaseFileEntity['closingNote'];
+  index: CaseFileEntryResponseEntity[];
+  sharedWith: CaseFileParticipantResponseEntity[];
+  actors: CaseFileActorResponseEntity[];
+  trackings: CaseFileTrackingResponseEntity[];
+  metadataChanges: CaseFileMetadataChangeResponseEntity[];
+  /** Registro de accesos. Solo lo recibe el responsable y quien puede ver todos los expedientes. */
+  accesses: CaseFileAccessResponseEntity[];
+  /** Qué puede hacer con el expediente quien lo consulta. Sin `actor` en la consulta, no viene. */
+  actorCapabilities?: {
+    isResponsible: boolean;
+    /** Editar sus metadatos y cerrarlo: el responsable, mientras esté abierto. */
+    canEdit: boolean;
+    /** Incorporar actuaciones: el responsable y aquellos con quienes se compartió, mientras esté abierto. */
+    canIncorporate: boolean;
+    /** Compartirlo con otros funcionarios: el responsable, también después de cerrado. */
+    canShare: boolean;
+  };
+}
+
+export interface CaseFileCreateResponseEntity {
+  id: CaseFileEntity['id'];
+  code: CaseFileEntity['code'];
+  ok: boolean;
+}
+
+export interface CaseFileUpdateResponseEntity {
+  id: CaseFileEntity['id'];
+  ok: boolean;
+}
+
+export interface CaseFileAddEntryResponseEntity {
+  id: CaseFileEntity['id'];
+  entryId: CaseFileEntryEntity['id'];
+  sequence: CaseFileEntryEntity['sequence'];
+  ok: boolean;
+}
+
+/** Archivo de una entrada del índice, para servirlo a quien puede ver el expediente. */
+export interface CaseFileEntryFileResponseEntity {
+  fileId: string;
+  fileName: string;
+}
+
+/** Archivo que va dentro del expediente exportado, con la huella que tenía al incorporarse. */
+export interface CaseFileExportFileEntity {
+  entryId: CaseFileEntryEntity['id'];
+  sequence: CaseFileEntryEntity['sequence'];
+  /** Ruta dentro del ZIP. Ej: `documentos/001-decreto-alcaldicio-exento-590-2026.pdf`. */
+  path: string;
+  fileId: string;
+  sha256: string | null;
+}
+
+/**
+ * Expediente listo para exportar: los metadatos con sus códigos oficiales (va tal cual como `expediente.json`) y los
+ * archivos que hay que agregar. El ZIP lo arma el gateway.
+ */
+export interface CaseFileExportResponseEntity {
+  code: CaseFileEntity['code'];
+  manifest: Record<string, unknown>;
+  files: CaseFileExportFileEntity[];
+}
+
+/** Expediente en que está incorporado un documento, visto desde el documento. */
+export type DocumentCaseFileEntity = CaseFileLinkEntity;

package/src/entities/caseFile/index.ts

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

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

@@ -145,6 +145,8 @@ export interface DocumentGetByIdResponseEntity {
   // Documento al que este responde, y los que le responden (solo los ya finalizados, más los propios de quien consulta).
   replyTo: DocumentLinkEntity | null;
   replies: DocumentLinkEntity[];
+  /** Expedientes en que está incorporado y que quien consulta puede ver. */
+  caseFiles: { id: string; code: string; title: string; status: 'Open' | 'Closed' }[];
   documentType: DocumentTypeSummaryEntity;
   participants: DocumentParticipantResponseEntity[];
   attachments: {
@@ -171,6 +173,8 @@ export interface DocumentGetByIdResponseEntity {
     // Puede derivarlo a otros funcionarios y responderlo: el documento ya es oficial y está a su alcance.
     canDerive: boolean;
     canReply: boolean;
+    // Es quien redactó un documento en tramitación: puede pasar un turno pendiente a otro funcionario.
+    canReassign: boolean;
     // Sus propias entregas de este documento (puede tener más de una si además se lo derivaron).
     inbox: DocumentDeliveryResponseEntity[];
   };
@@ -271,3 +275,8 @@ export interface DocumentCloseDeliveryResponseEntity {
   id: DocumentDeliveryEntity['id'];
   ok: boolean;
 }
+
+export interface DocumentReassignResponseEntity {
+  id: DocumentEntity['id'];
+  ok: boolean;
+}

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

@@ -1,4 +1,17 @@
-import { DocumentTypeEntity } from '../../base/entities';
+import { DocumentTypeEntity, DocumentTypeFlowStepEntity } from '../../base/entities';
+
+/** Paso del flujo sugerido de un tipo documental: quién visa o firma, en su orden. */
+export interface DocumentTypeFlowStepResponseEntity {
+  id: DocumentTypeFlowStepEntity['id'];
+  role: DocumentTypeFlowStepEntity['role'];
+  order: DocumentTypeFlowStepEntity['order'];
+  type: DocumentTypeFlowStepEntity['type'];
+  employeeId: DocumentTypeFlowStepEntity['employeeId'];
+  directorateCodeReference: DocumentTypeFlowStepEntity['directorateCodeReference'];
+  // Nombre del funcionario o de la dirección, como estaba al definir el flujo.
+  name: DocumentTypeFlowStepEntity['name'];
+  position: DocumentTypeFlowStepEntity['position'];
+}
 
 export interface DocumentTypeGetAllResponseEntity {
   id: DocumentTypeEntity['id'];
@@ -11,12 +24,16 @@ export interface DocumentTypeGetAllResponseEntity {
   resetsYearly: DocumentTypeEntity['resetsYearly'];
   directorateCodeReference: DocumentTypeEntity['directorateCodeReference'];
   enabled: DocumentTypeEntity['enabled'];
+  // Cuántos visadores y firmantes tiene su flujo sugerido.
+  flow: { visa: number; signature: number };
 }
 
 export interface DocumentTypeGetByIdResponseEntity extends DocumentTypeGetAllResponseEntity {
   // Último número ya asignado en el año vigente del correlativo (null si aún no se numera ninguno): el próximo
   // correlativo no puede quedar por debajo de él.
   lastCorrelative: number | null;
+  // Flujo sugerido: primero los visadores y después los firmantes, cada grupo en su orden.
+  flowSteps: DocumentTypeFlowStepResponseEntity[];
 }
 
 export interface DocumentTypeCreateResponseEntity {

package/src/entities/index.ts

@@ -1,2 +1,4 @@
 export * from './documentType';
 export * from './document';
+export * from './procedure';
+export * from './caseFile';

package/src/entities/procedure/index.ts

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

package/src/entities/procedure/procedure.entity.ts

@@ -0,0 +1,24 @@
+import { ProcedureEntity } from '../../base/entities';
+
+export interface ProcedureGetAllResponseEntity {
+  id: ProcedureEntity['id'];
+  name: ProcedureEntity['name'];
+  cpatId: ProcedureEntity['cpatId'];
+  cpatCode: ProcedureEntity['cpatCode'];
+  description: ProcedureEntity['description'];
+  enabled: ProcedureEntity['enabled'];
+  /** Cuántos expedientes pertenecen a este procedimiento. */
+  caseFiles: number;
+}
+
+export type ProcedureGetByIdResponseEntity = ProcedureGetAllResponseEntity;
+
+export interface ProcedureCreateResponseEntity {
+  id: ProcedureEntity['id'];
+  ok: boolean;
+}
+
+export interface ProcedureUpdateResponseEntity {
+  id: ProcedureEntity['id'];
+  ok: boolean;
+}