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

package/dist/base/entities.d.ts

@@ -33,7 +33,7 @@ export declare const DocumentParticipantStatus: {
     Resolved: "Resolved";
     Rejected: "Rejected";
 };
-export type DocumentTrackingAction = 'Created' | 'Updated' | 'Submitted' | 'Visaed' | 'Signed' | 'Rejected' | 'Finished' | 'Discarded' | 'Numbered' | 'NumberAnnulled' | 'Annulled' | 'Delivered' | 'Derived' | 'Reassigned' | 'Dispatched' | 'DispatchReturned' | 'Received' | 'EmailCopySent' | 'EmailCopyOpened' | 'DispositionRecorded';
+export type DocumentTrackingAction = 'Created' | 'Updated' | 'Submitted' | 'Visaed' | 'Signed' | 'Rejected' | 'Finished' | 'Discarded' | 'Numbered' | 'NumberAnnulled' | 'Annulled' | 'Delivered' | 'Derived' | 'Reassigned' | 'Dispatched' | 'DispatchReturned' | 'DispatchedByContingency' | 'Received' | 'EmailCopySent' | 'EmailCopyOpened' | 'DispositionRecorded';
 export declare const DocumentTrackingAction: {
     Created: "Created";
     Updated: "Updated";
@@ -51,15 +51,24 @@ export declare const DocumentTrackingAction: {
     Reassigned: "Reassigned";
     Dispatched: "Dispatched";
     DispatchReturned: "DispatchReturned";
+    DispatchedByContingency: "DispatchedByContingency";
     Received: "Received";
     EmailCopySent: "EmailCopySent";
     EmailCopyOpened: "EmailCopyOpened";
     DispositionRecorded: "DispositionRecorded";
 };
-export type DocumentOrigin = 'Internal' | 'DocDigital';
+export type DocumentOrigin = 'Internal' | 'DocDigital' | 'Manual';
 export declare const DocumentOrigin: {
     Internal: "Internal";
     DocDigital: "DocDigital";
+    Manual: "Manual";
+};
+export type CommunicationMeans = 'Paper' | 'Email' | 'Courier' | 'Other';
+export declare const CommunicationMeans: {
+    Paper: "Paper";
+    Email: "Email";
+    Courier: "Courier";
+    Other: "Other";
 };
 export type DocumentDispatchStatus = 'Pending' | 'Dispatched' | 'Returned';
 export declare const DocumentDispatchStatus: {
@@ -324,6 +333,7 @@ export interface DocumentEntity {
     externalFolio?: string | null;
     externalSender?: string | null;
     externalDate?: string | null;
+    intakeMeans?: CommunicationMeans | null;
     composition?: JsonValue | null;
     contentText?: string | null;
     textExtractedAt?: string | null;
@@ -691,6 +701,11 @@ export interface DocumentDispatchEntity {
     returnedByEmployeeId?: string | null;
     returnedByFullName?: string | null;
     returnReason?: string | null;
+    contingencyMeans?: CommunicationMeans | null;
+    contingencySentTo?: string | null;
+    contingencyReason?: string | null;
+    contingencyReceiptFileId?: string | null;
+    contingencyReceiptName?: string | null;
     document?: DocumentEntity;
     documentId: string;
     createdAt: string;

package/dist/base/entities.js

@@ -1,7 +1,7 @@
 "use strict";
 // This file was auto-generated by prisma-generator-typescript-interfaces
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AccessRequestEventAction = exports.AccessRequestResolution = exports.AccessRequestStatus = exports.AccessRequestChannel = exports.DispositionKind = exports.FinalDisposition = exports.AuditAction = exports.AuditEntity = exports.DocumentAccessAction = exports.QualityMetricKey = exports.ServiceOutageKind = exports.WorkFolderItemKind = exports.TextSnippetSection = exports.ScanSessionStatus = exports.CaseFileAccessAction = exports.CaseFileTrackingAction = exports.CaseFileActorType = exports.CaseFileActorRelation = exports.CaseFileEntryKind = exports.CaseFileActuationType = exports.CaseFileIncorporationMechanism = exports.CaseFileStatus = exports.DocumentInstruction = exports.DocumentDeliveryOrigin = exports.DocumentRecipientType = exports.DocumentAttachmentType = exports.DocumentFlowStepType = exports.DocDigitalInboundStatus = exports.DocumentDispatchStatus = exports.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
+exports.AccessRequestEventAction = exports.AccessRequestResolution = exports.AccessRequestStatus = exports.AccessRequestChannel = exports.DispositionKind = exports.FinalDisposition = exports.AuditAction = exports.AuditEntity = exports.DocumentAccessAction = exports.QualityMetricKey = exports.ServiceOutageKind = exports.WorkFolderItemKind = exports.TextSnippetSection = exports.ScanSessionStatus = exports.CaseFileAccessAction = exports.CaseFileTrackingAction = exports.CaseFileActorType = exports.CaseFileActorRelation = exports.CaseFileEntryKind = exports.CaseFileActuationType = exports.CaseFileIncorporationMechanism = exports.CaseFileStatus = exports.DocumentInstruction = exports.DocumentDeliveryOrigin = exports.DocumentRecipientType = exports.DocumentAttachmentType = exports.DocumentFlowStepType = exports.DocDigitalInboundStatus = exports.DocumentDispatchStatus = exports.CommunicationMeans = exports.DocumentOrigin = exports.DocumentTrackingAction = exports.DocumentParticipantStatus = exports.DocumentParticipantRole = exports.DocumentAccessLevel = exports.DocumentStatus = exports.DocumentCategory = void 0;
 exports.DocumentCategory = {
     Decree: 'Decree',
     Communication: 'Communication',
@@ -49,6 +49,7 @@ exports.DocumentTrackingAction = {
     Reassigned: 'Reassigned',
     Dispatched: 'Dispatched',
     DispatchReturned: 'DispatchReturned',
+    DispatchedByContingency: 'DispatchedByContingency',
     Received: 'Received',
     EmailCopySent: 'EmailCopySent',
     EmailCopyOpened: 'EmailCopyOpened',
@@ -57,6 +58,13 @@ exports.DocumentTrackingAction = {
 exports.DocumentOrigin = {
     Internal: 'Internal',
     DocDigital: 'DocDigital',
+    Manual: 'Manual',
+};
+exports.CommunicationMeans = {
+    Paper: 'Paper',
+    Email: 'Email',
+    Courier: 'Courier',
+    Other: 'Other',
 };
 exports.DocumentDispatchStatus = {
     Pending: 'Pending',

package/dist/contracts/index.d.ts

@@ -126,6 +126,8 @@ export declare const GestorDocumentalPatterns: {
         readonly returnInbound: "gestorDocumental.partsOffice.returnInbound";
         readonly getInboundFile: "gestorDocumental.partsOffice.getInboundFile";
         readonly checkEnablement: "gestorDocumental.partsOffice.checkEnablement";
+        readonly dispatchByContingency: "gestorDocumental.partsOffice.dispatchByContingency";
+        readonly registerManualIntake: "gestorDocumental.partsOffice.registerManualIntake";
     };
     readonly registerBook: {
         readonly get: "gestorDocumental.registerBook.get";

package/dist/contracts/partsOffice.contract.d.ts

@@ -1,4 +1,4 @@
-import { type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
+import { type CommunicationMeans, type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
 import { type DocDigitalDocumentTypeEntity, type DocDigitalEntityEntity, type PartsOfficeInboundEntity, type DocDigitalUserEntity, type EnablementPersonInput, type PartsOfficeEnablementEntity, type PartsOfficeDispatchEntity, type PartsOfficeFileEntity, type PartsOfficeOkResponseEntity, type PartsOfficeRegisterResponseEntity, type PartsOfficeStatusEntity, type PartsOfficeSummaryEntity, type PartsOfficeSyncResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
 import { type DocumentActor, type DocumentExternalRecipientInput } from './document.contract';
@@ -22,6 +22,8 @@ export declare const PartsOfficePatterns: {
     readonly returnInbound: "gestorDocumental.partsOffice.returnInbound";
     readonly getInboundFile: "gestorDocumental.partsOffice.getInboundFile";
     readonly checkEnablement: "gestorDocumental.partsOffice.checkEnablement";
+    readonly dispatchByContingency: "gestorDocumental.partsOffice.dispatchByContingency";
+    readonly registerManualIntake: "gestorDocumental.partsOffice.registerManualIntake";
 };
 /** Destinatario interno de un ingreso, ya resuelto por el gateway (las áreas con sus integrantes). */
 export type PartsOfficeRecipientInput = {
@@ -48,6 +50,35 @@ interface IListPayload<S> {
         status?: S;
     };
 }
+/** Lo que llegó fuera de DocDigital y Oficina de Partes ingresa a mano. */
+export interface ManualIntakePayload {
+    file: {
+        fileId: string;
+        name: string;
+    };
+    attachments?: {
+        fileId: string;
+        name: string;
+    }[];
+    means: CommunicationMeans;
+    /** Cuándo llegó (ISO); sin él, ahora. */
+    receivedAt?: string | null;
+    senderEntityName: string;
+    senderName?: string | null;
+    externalFolio?: string | null;
+    externalDate?: string | null;
+    subject: string;
+    documentTypeId: string;
+    keywords: string[];
+    accessLevel?: DocumentAccessLevel;
+    hasSensitiveData?: boolean;
+    recipients: unknown[];
+    instruction: DocumentInstruction;
+    note?: string | null;
+    dueAt?: string | null;
+    dueBusinessDays?: number | null;
+    actor: DocumentActor;
+}
 export interface PartsOfficeContract {
     [PartsOfficePatterns.getStatus]: {
         payload: Record<string, never>;
@@ -118,6 +149,7 @@ export interface PartsOfficeContract {
     [PartsOfficePatterns.getDispatchFile]: {
         payload: {
             id: string;
+            receipt?: boolean;
         };
         response: PartsOfficeFileEntity;
     };
@@ -184,5 +216,33 @@ export interface PartsOfficeContract {
         };
         response: PartsOfficeEnablementEntity;
     };
+    /**
+     * Registro por contingencia: el documento no se pudo despachar por DocDigital y salió por otro medio. Queda
+     * despachado, con el medio, a quién, el motivo y el comprobante; si después se registra en DocDigital, su número.
+     */
+    [PartsOfficePatterns.dispatchByContingency]: {
+        payload: {
+            id: string;
+            means: CommunicationMeans;
+            sentAt: string;
+            sentTo: string;
+            reason: string;
+            receipt?: {
+                fileId: string;
+                name: string;
+            } | null;
+            docDigitalDocumentId?: string | null;
+            actor: DocumentActor;
+        };
+        response: PartsOfficeOkResponseEntity;
+    };
+    /**
+     * Ingreso manual: lo que llegó fuera de DocDigital (papel, correo) entra con folio de ingreso, como lo recibido
+     * por DocDigital, y se deriva.
+     */
+    [PartsOfficePatterns.registerManualIntake]: {
+        payload: ManualIntakePayload;
+        response: PartsOfficeRegisterResponseEntity;
+    };
 }
 export {};

package/dist/contracts/partsOffice.contract.js

@@ -21,4 +21,6 @@ exports.PartsOfficePatterns = {
     returnInbound: 'gestorDocumental.partsOffice.returnInbound',
     getInboundFile: 'gestorDocumental.partsOffice.getInboundFile',
     checkEnablement: 'gestorDocumental.partsOffice.checkEnablement',
+    dispatchByContingency: 'gestorDocumental.partsOffice.dispatchByContingency',
+    registerManualIntake: 'gestorDocumental.partsOffice.registerManualIntake',
 };

package/dist/entities/document/document.entity.d.ts

@@ -1,4 +1,4 @@
-import { DocumentAnnulledNumberEntity, DocumentAttachmentEntity, DocumentDeliveryEntity, DocumentEntity, DocumentParticipantEntity, DocumentRecipientEntity, DocumentTrackingEntity, DocumentTypeEntity } from '../../base/entities';
+import { type CommunicationMeans, DocumentAnnulledNumberEntity, DocumentAttachmentEntity, DocumentDeliveryEntity, DocumentEntity, DocumentParticipantEntity, DocumentRecipientEntity, DocumentTrackingEntity, DocumentTypeEntity } from '../../base/entities';
 /** Tipo documental de un documento, con lo necesario para citarlo. */
 export interface DocumentTypeSummaryEntity {
     id: DocumentTypeEntity['id'];
@@ -82,6 +82,14 @@ export interface DocumentDispatchResponseEntity {
     returnedAt: string | null;
     returnedByFullName: string | null;
     returnReason: string | null;
+    /** Registro por contingencia: salió por otro medio porque no se pudo por DocDigital. */
+    contingency: {
+        means: CommunicationMeans;
+        sentTo: string | null;
+        reason: string | null;
+        /** Nombre del comprobante, si se adjuntó. */
+        receiptName: string | null;
+    } | null;
 }
 export interface DocumentGetAllResponseEntity {
     id: DocumentEntity['id'];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muni-sanfer/types-gestor-documental",
-  "version": "0.0.1-beta.25",
+  "version": "0.0.1-beta.26",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/base/entities.ts

@@ -63,6 +63,7 @@ export type DocumentTrackingAction =
   | 'Reassigned'
   | 'Dispatched'
   | 'DispatchReturned'
+  | 'DispatchedByContingency'
   | 'Received'
   | 'EmailCopySent'
   | 'EmailCopyOpened'
@@ -85,19 +86,30 @@ export const DocumentTrackingAction = {
   Reassigned: 'Reassigned',
   Dispatched: 'Dispatched',
   DispatchReturned: 'DispatchReturned',
+  DispatchedByContingency: 'DispatchedByContingency',
   Received: 'Received',
   EmailCopySent: 'EmailCopySent',
   EmailCopyOpened: 'EmailCopyOpened',
   DispositionRecorded: 'DispositionRecorded',
 } satisfies Record<string, DocumentTrackingAction>;
 
-export type DocumentOrigin = 'Internal' | 'DocDigital';
+export type DocumentOrigin = 'Internal' | 'DocDigital' | 'Manual';
 
 export const DocumentOrigin = {
   Internal: 'Internal',
   DocDigital: 'DocDigital',
+  Manual: 'Manual',
 } satisfies Record<string, DocumentOrigin>;
 
+export type CommunicationMeans = 'Paper' | 'Email' | 'Courier' | 'Other';
+
+export const CommunicationMeans = {
+  Paper: 'Paper',
+  Email: 'Email',
+  Courier: 'Courier',
+  Other: 'Other',
+} satisfies Record<string, CommunicationMeans>;
+
 export type DocumentDispatchStatus = 'Pending' | 'Dispatched' | 'Returned';
 
 export const DocumentDispatchStatus = {
@@ -468,6 +480,7 @@ export interface DocumentEntity {
   externalFolio?: string | null;
   externalSender?: string | null;
   externalDate?: string | null;
+  intakeMeans?: CommunicationMeans | null;
   composition?: JsonValue | null;
   contentText?: string | null;
   textExtractedAt?: string | null;
@@ -857,6 +870,11 @@ export interface DocumentDispatchEntity {
   returnedByEmployeeId?: string | null;
   returnedByFullName?: string | null;
   returnReason?: string | null;
+  contingencyMeans?: CommunicationMeans | null;
+  contingencySentTo?: string | null;
+  contingencyReason?: string | null;
+  contingencyReceiptFileId?: string | null;
+  contingencyReceiptName?: string | null;
   document?: DocumentEntity;
   documentId: string;
   createdAt: string;

package/src/contracts/partsOffice.contract.ts

@@ -1,4 +1,4 @@
-import { type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
+import { type CommunicationMeans, type DocumentAccessLevel, type DocumentInstruction } from '../base/entities';
 import {
   type DocDigitalDocumentTypeEntity,
   type DocDigitalEntityEntity,
@@ -37,6 +37,8 @@ export const PartsOfficePatterns = {
   returnInbound: 'gestorDocumental.partsOffice.returnInbound',
   getInboundFile: 'gestorDocumental.partsOffice.getInboundFile',
   checkEnablement: 'gestorDocumental.partsOffice.checkEnablement',
+  dispatchByContingency: 'gestorDocumental.partsOffice.dispatchByContingency',
+  registerManualIntake: 'gestorDocumental.partsOffice.registerManualIntake',
 } as const;
 
 /** Destinatario interno de un ingreso, ya resuelto por el gateway (las áreas con sus integrantes). */
@@ -50,6 +52,30 @@ interface IListPayload<S> {
   filters?: { search?: string; status?: S };
 }
 
+/** Lo que llegó fuera de DocDigital y Oficina de Partes ingresa a mano. */
+export interface ManualIntakePayload {
+  file: { fileId: string; name: string };
+  attachments?: { fileId: string; name: string }[];
+  means: CommunicationMeans;
+  /** Cuándo llegó (ISO); sin él, ahora. */
+  receivedAt?: string | null;
+  senderEntityName: string;
+  senderName?: string | null;
+  externalFolio?: string | null;
+  externalDate?: string | null;
+  subject: string;
+  documentTypeId: string;
+  keywords: string[];
+  accessLevel?: DocumentAccessLevel;
+  hasSensitiveData?: boolean;
+  recipients: unknown[];
+  instruction: DocumentInstruction;
+  note?: string | null;
+  dueAt?: string | null;
+  dueBusinessDays?: number | null;
+  actor: DocumentActor;
+}
+
 export interface PartsOfficeContract {
   [PartsOfficePatterns.getStatus]: { payload: Record<string, never>; response: PartsOfficeStatusEntity };
   [PartsOfficePatterns.getSummary]: { payload: Record<string, never>; response: PartsOfficeSummaryEntity };
@@ -82,7 +108,11 @@ export interface PartsOfficeContract {
     response: PartsOfficeOkResponseEntity;
   };
   /** PDF firmado de un documento por despachar, para que Oficina de Partes lo revise. */
-  [PartsOfficePatterns.getDispatchFile]: { payload: { id: string }; response: PartsOfficeFileEntity };
+  [PartsOfficePatterns.getDispatchFile]: {
+    // con `receipt`, el comprobante del despacho por contingencia
+    payload: { id: string; receipt?: boolean };
+    response: PartsOfficeFileEntity;
+  };
   [PartsOfficePatterns.getInbound]: {
     payload: IListPayload<'Pending' | 'Registered' | 'Returned'>;
     response: RpcPage<PartsOfficeInboundEntity[]>;
@@ -131,4 +161,29 @@ export interface PartsOfficeContract {
     payload: { people: EnablementPersonInput[] };
     response: PartsOfficeEnablementEntity;
   };
+  /**
+   * Registro por contingencia: el documento no se pudo despachar por DocDigital y salió por otro medio. Queda
+   * despachado, con el medio, a quién, el motivo y el comprobante; si después se registra en DocDigital, su número.
+   */
+  [PartsOfficePatterns.dispatchByContingency]: {
+    payload: {
+      id: string;
+      means: CommunicationMeans;
+      sentAt: string;
+      sentTo: string;
+      reason: string;
+      receipt?: { fileId: string; name: string } | null;
+      docDigitalDocumentId?: string | null;
+      actor: DocumentActor;
+    };
+    response: PartsOfficeOkResponseEntity;
+  };
+  /**
+   * Ingreso manual: lo que llegó fuera de DocDigital (papel, correo) entra con folio de ingreso, como lo recibido
+   * por DocDigital, y se deriva.
+   */
+  [PartsOfficePatterns.registerManualIntake]: {
+    payload: ManualIntakePayload;
+    response: PartsOfficeRegisterResponseEntity;
+  };
 }

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

@@ -1,4 +1,5 @@
 import {
+  type CommunicationMeans,
   DocumentAnnulledNumberEntity,
   DocumentAttachmentEntity,
   DocumentDeliveryEntity,
@@ -101,6 +102,14 @@ export interface DocumentDispatchResponseEntity {
   returnedAt: string | null;
   returnedByFullName: string | null;
   returnReason: string | null;
+  /** Registro por contingencia: salió por otro medio porque no se pudo por DocDigital. */
+  contingency: {
+    means: CommunicationMeans;
+    sentTo: string | null;
+    reason: string | null;
+    /** Nombre del comprobante, si se adjuntó. */
+    receiptName: string | null;
+  } | null;
 }
 
 export interface DocumentGetAllResponseEntity {