@muni-sanfer/types-gestor-documental 0.0.1-beta.45 → 0.0.1-beta.47

package/dist/base/entities.d.ts

@@ -660,6 +660,10 @@ export interface ProcedureEntity {
     cpatId?: string | null;
     cpatCode?: string | null;
     description?: string | null;
+    kind?: string | null;
+    responsibleArea?: string | null;
+    cpatStatus?: string | null;
+    fromCpat: boolean;
     enabled: boolean;
     caseFiles?: CaseFileEntity[];
     documents?: DocumentEntity[];
@@ -926,6 +930,12 @@ export interface HolidayEntity {
     createdAt: string;
     updatedAt: string;
 }
+export interface ProcedureSyncEntity {
+    institutionCode: string;
+    syncedAt: string;
+    total: number;
+    resourceName: string;
+}
 export interface HolidaySyncEntity {
     year: number;
     syncedAt: string;

package/dist/contracts/index.d.ts

@@ -99,9 +99,8 @@ export declare const GestorDocumentalPatterns: {
     readonly procedure: {
         readonly getAll: "gestorDocumental.procedure.getAll";
         readonly getById: "gestorDocumental.procedure.getById";
-        readonly create: "gestorDocumental.procedure.create";
-        readonly update: "gestorDocumental.procedure.update";
-        readonly setEnabled: "gestorDocumental.procedure.setEnabled";
+        readonly getCpatStatus: "gestorDocumental.procedure.getCpatStatus";
+        readonly sync: "gestorDocumental.procedure.sync";
     };
     readonly issuingEntity: {
         readonly getAll: "gestorDocumental.issuingEntity.getAll";
@@ -313,9 +312,6 @@ export declare const GestorDocumentalPatterns: {
         readonly getAttachmentFile: "gestorDocumental.draftingRequest.getAttachmentFile";
     };
     readonly internalReview: {
-        readonly getReviewers: "gestorDocumental.internalReview.getReviewers";
-        readonly setReviewers: "gestorDocumental.internalReview.setReviewers";
-        readonly getAssignments: "gestorDocumental.internalReview.getAssignments";
         readonly getQueue: "gestorDocumental.internalReview.getQueue";
         readonly getNotes: "gestorDocumental.internalReview.getNotes";
         readonly addNote: "gestorDocumental.internalReview.addNote";

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

@@ -1,55 +1,24 @@
-import { type DirectorateReviewersEntity, type DocumentInternalNoteResponseEntity, type DocumentInternalNotesResponseEntity, type InternalReviewQueueItemEntity } from '../entities';
-import { type AuditActorInput } from '../entities';
-/** Patrones NATS de `internalReview`: revisoras de jefatura y sus observaciones internas. */
+import { type DocumentInternalNoteResponseEntity, type DocumentInternalNotesResponseEntity, type InternalReviewQueueItemEntity } from '../entities';
+/** Patrones NATS de `internalReview`: la revisión para la jefatura y sus observaciones internas. */
 export declare const InternalReviewPatterns: {
-    readonly getReviewers: "gestorDocumental.internalReview.getReviewers";
-    readonly setReviewers: "gestorDocumental.internalReview.setReviewers";
-    readonly getAssignments: "gestorDocumental.internalReview.getAssignments";
     readonly getQueue: "gestorDocumental.internalReview.getQueue";
     readonly getNotes: "gestorDocumental.internalReview.getNotes";
     readonly addNote: "gestorDocumental.internalReview.addNote";
 };
 /**
- * Dirección para la que actúa quien consulta: como revisora de su jefatura o como la jefatura misma. La resuelve el
- * gateway: quiénes la dirigen hoy (titular y subrogante) no los dice el navegador.
+ * Dirección para la que actúa quien consulta: como revisora de su jefatura (integra la dirección y tiene el permiso de
+ * revisar) o como la jefatura misma (la dirige hoy y tiene el permiso de jefatura). La resuelve el gateway: ni quiénes
+ * la dirigen hoy (titular y subrogante) ni quiénes tienen cada permiso los dice el navegador.
  */
 export interface InternalReviewScope {
     directorateCode: number;
     directorateName: string;
     headEmployeeIds: string[];
     role: 'Reviewer' | 'Head';
+    /** Como jefatura, al dejar una observación: quiénes revisan hoy para ella (a quienes se avisa). */
+    reviewerEmployeeIds?: string[];
 }
 export interface InternalReviewContract {
-    [InternalReviewPatterns.getReviewers]: {
-        payload: Record<string, never>;
-        response: DirectorateReviewersEntity[];
-    };
-    /** Reemplaza las revisoras de una dirección (sin ninguna, la dirección queda sin revisoras). */
-    [InternalReviewPatterns.setReviewers]: {
-        payload: {
-            directorateCode: number;
-            directorateName: string;
-            reviewers: {
-                employeeId: string;
-                fullName: string;
-            }[];
-            auditActor?: AuditActorInput;
-        };
-        response: {
-            id: string;
-            ok: boolean;
-        };
-    };
-    /** Direcciones para cuya jefatura revisa una funcionaria. */
-    [InternalReviewPatterns.getAssignments]: {
-        payload: {
-            employeeId: string;
-        };
-        response: {
-            directorateCode: number;
-            directorateName: string;
-        }[];
-    };
     /** Documentos que esperan a las jefaturas para las que revisa quien consulta. */
     [InternalReviewPatterns.getQueue]: {
         payload: {

package/dist/contracts/internalReview.contract.js

@@ -1,11 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InternalReviewPatterns = void 0;
-/** Patrones NATS de `internalReview`: revisoras de jefatura y sus observaciones internas. */
+/** Patrones NATS de `internalReview`: la revisión para la jefatura y sus observaciones internas. */
 exports.InternalReviewPatterns = {
-    getReviewers: 'gestorDocumental.internalReview.getReviewers',
-    setReviewers: 'gestorDocumental.internalReview.setReviewers',
-    getAssignments: 'gestorDocumental.internalReview.getAssignments',
     getQueue: 'gestorDocumental.internalReview.getQueue',
     getNotes: 'gestorDocumental.internalReview.getNotes',
     addNote: 'gestorDocumental.internalReview.addNote',

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

@@ -1,22 +1,16 @@
 import { type ProcedureEntity } from '../base/entities';
-import { type ProcedureCreateResponseEntity, type ProcedureGetAllResponseEntity, type ProcedureGetByIdResponseEntity, type ProcedureUpdateResponseEntity } from '../entities';
+import { type ProcedureCpatStatusEntity, type ProcedureGetAllResponseEntity, type ProcedureGetByIdResponseEntity, type ProcedureSyncResponseEntity } from '../entities';
 import { type RpcPage } from './contract';
-/** Patrones NATS de `procedure`: `<servicio>.<recurso>.<acción>`. */
+/**
+ * Patrones NATS de `procedure`: los procedimientos administrativos vienen del CPAT (nómina en datos.gob.cl) y no se
+ * crean ni editan en el gestor.
+ */
 export declare const ProcedurePatterns: {
     readonly getAll: "gestorDocumental.procedure.getAll";
     readonly getById: "gestorDocumental.procedure.getById";
-    readonly create: "gestorDocumental.procedure.create";
-    readonly update: "gestorDocumental.procedure.update";
-    readonly setEnabled: "gestorDocumental.procedure.setEnabled";
+    readonly getCpatStatus: "gestorDocumental.procedure.getCpatStatus";
+    readonly sync: "gestorDocumental.procedure.sync";
 };
-/** Datos de un procedimiento administrativo al crearlo o editarlo. */
-export interface ProcedureWritePayload {
-    name: string;
-    cpatId?: string | null;
-    cpatCode?: string | null;
-    description?: string | null;
-    enabled?: boolean;
-}
 export interface ProcedureContract {
     [ProcedurePatterns.getAll]: {
         payload: {
@@ -35,16 +29,13 @@ export interface ProcedureContract {
         payload: Pick<ProcedureEntity, 'id'>;
         response: ProcedureGetByIdResponseEntity;
     };
-    [ProcedurePatterns.create]: {
-        payload: ProcedureWritePayload;
-        response: ProcedureCreateResponseEntity;
-    };
-    [ProcedurePatterns.update]: {
-        payload: ProcedureWritePayload & Pick<ProcedureEntity, 'id'>;
-        response: ProcedureUpdateResponseEntity;
+    [ProcedurePatterns.getCpatStatus]: {
+        payload: Record<string, never>;
+        response: ProcedureCpatStatusEntity;
     };
-    [ProcedurePatterns.setEnabled]: {
-        payload: Pick<ProcedureEntity, 'id' | 'enabled'>;
-        response: ProcedureUpdateResponseEntity;
+    /** Trae del CPAT los procedimientos de la institución `CPAT_INSTITUTION_CODE`. */
+    [ProcedurePatterns.sync]: {
+        payload: Record<string, never>;
+        response: ProcedureSyncResponseEntity;
     };
 }

package/dist/contracts/procedure.contract.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProcedurePatterns = void 0;
-/** Patrones NATS de `procedure`: `<servicio>.<recurso>.<acción>`. */
+/**
+ * Patrones NATS de `procedure`: los procedimientos administrativos vienen del CPAT (nómina en datos.gob.cl) y no se
+ * crean ni editan en el gestor.
+ */
 exports.ProcedurePatterns = {
     getAll: 'gestorDocumental.procedure.getAll',
     getById: 'gestorDocumental.procedure.getById',
-    create: 'gestorDocumental.procedure.create',
-    update: 'gestorDocumental.procedure.update',
-    setEnabled: 'gestorDocumental.procedure.setEnabled',
+    getCpatStatus: 'gestorDocumental.procedure.getCpatStatus',
+    sync: 'gestorDocumental.procedure.sync',
 };

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

@@ -1,13 +1,4 @@
 import { type DocumentStatus } from '../../base/entities';
-/** Revisoras asignadas a la jefatura de una dirección. */
-export interface DirectorateReviewersEntity {
-    directorateCode: number;
-    directorateName: string;
-    reviewers: {
-        employeeId: string;
-        fullName: string;
-    }[];
-}
 /** Qué espera de la jefatura un documento de la cola de revisión. */
 export type InternalReviewTurn = 'Visa' | 'Signature' | 'DraftReview';
 /** Documento que espera a la jefatura para la que revisa la funcionaria. */

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

@@ -1,20 +1,41 @@
 import { ProcedureEntity } from '../../base/entities';
+/** Procedimiento administrativo de la municipalidad, como lo informa el CPAT. */
 export interface ProcedureGetAllResponseEntity {
     id: ProcedureEntity['id'];
     name: ProcedureEntity['name'];
     cpatId: ProcedureEntity['cpatId'];
     cpatCode: ProcedureEntity['cpatCode'];
     description: ProcedureEntity['description'];
+    /** Tipo de registro en el CPAT: de función común, de función específica u otra tramitación. */
+    kind: string | null;
+    responsibleArea: string | null;
+    /** Estado del registro en el CPAT: completado o pendiente. */
+    cpatStatus: string | null;
+    /** Viene del CPAT; si no, es uno de los cargados a mano antes, que quedan solo para sus expedientes. */
+    fromCpat: boolean;
+    /** Se puede elegir: está en la última nómina del CPAT. */
     enabled: ProcedureEntity['enabled'];
     /** Cuántos expedientes pertenecen a este procedimiento. */
     caseFiles: number;
 }
 export type ProcedureGetByIdResponseEntity = ProcedureGetAllResponseEntity;
-export interface ProcedureCreateResponseEntity {
-    id: ProcedureEntity['id'];
-    ok: boolean;
+/** De qué institución y nómina del CPAT vienen los procedimientos, y cuándo se trajeron. */
+export interface ProcedureCpatStatusEntity {
+    /** Código de la municipalidad en el CPAT (`CPAT_INSTITUTION_CODE`); `null` si no está configurado. */
+    institutionCode: string | null;
+    syncedAt: string | null;
+    total: number | null;
+    /** Nómina de datos.gob.cl. Ej: «Nómina CPAT septiembre 2026». */
+    resourceName: string | null;
 }
-export interface ProcedureUpdateResponseEntity {
-    id: ProcedureEntity['id'];
-    ok: boolean;
+/** Resultado de traer los procedimientos del CPAT. */
+export interface ProcedureSyncResponseEntity {
+    institutionCode: string;
+    resourceName: string;
+    added: number;
+    updated: number;
+    /** Los que ya no informa el CPAT: dejan de elegirse, pero siguen en sus expedientes. */
+    retired: number;
+    total: number;
+    syncedAt: string;
 }

package/package.json

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

package/src/base/entities.ts

@@ -876,6 +876,10 @@ export interface ProcedureEntity {
   cpatId?: string | null;
   cpatCode?: string | null;
   description?: string | null;
+  kind?: string | null;
+  responsibleArea?: string | null;
+  cpatStatus?: string | null;
+  fromCpat: boolean;
   enabled: boolean;
   caseFiles?: CaseFileEntity[];
   documents?: DocumentEntity[];
@@ -1158,6 +1162,13 @@ export interface HolidayEntity {
   updatedAt: string;
 }
 
+export interface ProcedureSyncEntity {
+  institutionCode: string;
+  syncedAt: string;
+  total: number;
+  resourceName: string;
+}
+
 export interface HolidaySyncEntity {
   year: number;
   syncedAt: string;

package/src/contracts/internalReview.contract.ts

@@ -1,49 +1,31 @@
 import {
-  type DirectorateReviewersEntity,
   type DocumentInternalNoteResponseEntity,
   type DocumentInternalNotesResponseEntity,
   type InternalReviewQueueItemEntity,
 } from '../entities';
-import { type AuditActorInput } from '../entities';
 
-/** Patrones NATS de `internalReview`: revisoras de jefatura y sus observaciones internas. */
+/** Patrones NATS de `internalReview`: la revisión para la jefatura y sus observaciones internas. */
 export const InternalReviewPatterns = {
-  getReviewers: 'gestorDocumental.internalReview.getReviewers',
-  setReviewers: 'gestorDocumental.internalReview.setReviewers',
-  getAssignments: 'gestorDocumental.internalReview.getAssignments',
   getQueue: 'gestorDocumental.internalReview.getQueue',
   getNotes: 'gestorDocumental.internalReview.getNotes',
   addNote: 'gestorDocumental.internalReview.addNote',
 } as const;
 
 /**
- * Dirección para la que actúa quien consulta: como revisora de su jefatura o como la jefatura misma. La resuelve el
- * gateway: quiénes la dirigen hoy (titular y subrogante) no los dice el navegador.
+ * Dirección para la que actúa quien consulta: como revisora de su jefatura (integra la dirección y tiene el permiso de
+ * revisar) o como la jefatura misma (la dirige hoy y tiene el permiso de jefatura). La resuelve el gateway: ni quiénes
+ * la dirigen hoy (titular y subrogante) ni quiénes tienen cada permiso los dice el navegador.
  */
 export interface InternalReviewScope {
   directorateCode: number;
   directorateName: string;
   headEmployeeIds: string[];
   role: 'Reviewer' | 'Head';
+  /** Como jefatura, al dejar una observación: quiénes revisan hoy para ella (a quienes se avisa). */
+  reviewerEmployeeIds?: string[];
 }
 
 export interface InternalReviewContract {
-  [InternalReviewPatterns.getReviewers]: { payload: Record<string, never>; response: DirectorateReviewersEntity[] };
-  /** Reemplaza las revisoras de una dirección (sin ninguna, la dirección queda sin revisoras). */
-  [InternalReviewPatterns.setReviewers]: {
-    payload: {
-      directorateCode: number;
-      directorateName: string;
-      reviewers: { employeeId: string; fullName: string }[];
-      auditActor?: AuditActorInput;
-    };
-    response: { id: string; ok: boolean };
-  };
-  /** Direcciones para cuya jefatura revisa una funcionaria. */
-  [InternalReviewPatterns.getAssignments]: {
-    payload: { employeeId: string };
-    response: { directorateCode: number; directorateName: string }[];
-  };
   /** Documentos que esperan a las jefaturas para las que revisa quien consulta. */
   [InternalReviewPatterns.getQueue]: {
     payload: { actor: { employeeId: string }; scopes: InternalReviewScope[] };

package/src/contracts/procedure.contract.ts

@@ -1,30 +1,23 @@
 import { type ProcedureEntity } from '../base/entities';
 import {
-  type ProcedureCreateResponseEntity,
+  type ProcedureCpatStatusEntity,
   type ProcedureGetAllResponseEntity,
   type ProcedureGetByIdResponseEntity,
-  type ProcedureUpdateResponseEntity,
+  type ProcedureSyncResponseEntity,
 } from '../entities';
 import { type RpcPage } from './contract';
 
-/** Patrones NATS de `procedure`: `<servicio>.<recurso>.<acción>`. */
+/**
+ * Patrones NATS de `procedure`: los procedimientos administrativos vienen del CPAT (nómina en datos.gob.cl) y no se
+ * crean ni editan en el gestor.
+ */
 export const ProcedurePatterns = {
   getAll: 'gestorDocumental.procedure.getAll',
   getById: 'gestorDocumental.procedure.getById',
-  create: 'gestorDocumental.procedure.create',
-  update: 'gestorDocumental.procedure.update',
-  setEnabled: 'gestorDocumental.procedure.setEnabled',
+  getCpatStatus: 'gestorDocumental.procedure.getCpatStatus',
+  sync: 'gestorDocumental.procedure.sync',
 } as const;
 
-/** Datos de un procedimiento administrativo al crearlo o editarlo. */
-export interface ProcedureWritePayload {
-  name: string;
-  cpatId?: string | null;
-  cpatCode?: string | null;
-  description?: string | null;
-  enabled?: boolean;
-}
-
 export interface ProcedureContract {
   [ProcedurePatterns.getAll]: {
     // sin `page` y `limit` responde todos en una sola página
@@ -38,16 +31,7 @@ export interface ProcedureContract {
     payload: Pick<ProcedureEntity, 'id'>;
     response: ProcedureGetByIdResponseEntity;
   };
-  [ProcedurePatterns.create]: {
-    payload: ProcedureWritePayload;
-    response: ProcedureCreateResponseEntity;
-  };
-  [ProcedurePatterns.update]: {
-    payload: ProcedureWritePayload & Pick<ProcedureEntity, 'id'>;
-    response: ProcedureUpdateResponseEntity;
-  };
-  [ProcedurePatterns.setEnabled]: {
-    payload: Pick<ProcedureEntity, 'id' | 'enabled'>;
-    response: ProcedureUpdateResponseEntity;
-  };
+  [ProcedurePatterns.getCpatStatus]: { payload: Record<string, never>; response: ProcedureCpatStatusEntity };
+  /** Trae del CPAT los procedimientos de la institución `CPAT_INSTITUTION_CODE`. */
+  [ProcedurePatterns.sync]: { payload: Record<string, never>; response: ProcedureSyncResponseEntity };
 }

package/src/entities/internalReview/internalReview.entity.ts

@@ -1,12 +1,5 @@
 import { type DocumentStatus } from '../../base/entities';
 
-/** Revisoras asignadas a la jefatura de una dirección. */
-export interface DirectorateReviewersEntity {
-  directorateCode: number;
-  directorateName: string;
-  reviewers: { employeeId: string; fullName: string }[];
-}
-
 /** Qué espera de la jefatura un documento de la cola de revisión. */
 export type InternalReviewTurn = 'Visa' | 'Signature' | 'DraftReview';
 

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

@@ -1,11 +1,20 @@
 import { ProcedureEntity } from '../../base/entities';
 
+/** Procedimiento administrativo de la municipalidad, como lo informa el CPAT. */
 export interface ProcedureGetAllResponseEntity {
   id: ProcedureEntity['id'];
   name: ProcedureEntity['name'];
   cpatId: ProcedureEntity['cpatId'];
   cpatCode: ProcedureEntity['cpatCode'];
   description: ProcedureEntity['description'];
+  /** Tipo de registro en el CPAT: de función común, de función específica u otra tramitación. */
+  kind: string | null;
+  responsibleArea: string | null;
+  /** Estado del registro en el CPAT: completado o pendiente. */
+  cpatStatus: string | null;
+  /** Viene del CPAT; si no, es uno de los cargados a mano antes, que quedan solo para sus expedientes. */
+  fromCpat: boolean;
+  /** Se puede elegir: está en la última nómina del CPAT. */
   enabled: ProcedureEntity['enabled'];
   /** Cuántos expedientes pertenecen a este procedimiento. */
   caseFiles: number;
@@ -13,12 +22,24 @@ export interface ProcedureGetAllResponseEntity {
 
 export type ProcedureGetByIdResponseEntity = ProcedureGetAllResponseEntity;
 
-export interface ProcedureCreateResponseEntity {
-  id: ProcedureEntity['id'];
-  ok: boolean;
+/** De qué institución y nómina del CPAT vienen los procedimientos, y cuándo se trajeron. */
+export interface ProcedureCpatStatusEntity {
+  /** Código de la municipalidad en el CPAT (`CPAT_INSTITUTION_CODE`); `null` si no está configurado. */
+  institutionCode: string | null;
+  syncedAt: string | null;
+  total: number | null;
+  /** Nómina de datos.gob.cl. Ej: «Nómina CPAT septiembre 2026». */
+  resourceName: string | null;
 }
 
-export interface ProcedureUpdateResponseEntity {
-  id: ProcedureEntity['id'];
-  ok: boolean;
+/** Resultado de traer los procedimientos del CPAT. */
+export interface ProcedureSyncResponseEntity {
+  institutionCode: string;
+  resourceName: string;
+  added: number;
+  updated: number;
+  /** Los que ya no informa el CPAT: dejan de elegirse, pero siguen en sus expedientes. */
+  retired: number;
+  total: number;
+  syncedAt: string;
 }