@muni-sanfer/types-gestor-documental 0.0.1-beta.46 → 0.0.1-beta.48

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/documentTemplate.contract.d.ts

@@ -1,54 +1,13 @@
-import { type DocumentTemplateEntity } from '../base/entities';
-import { type DocumentTemplateAvailableResponseEntity, type DocumentTemplateContent, type DocumentTemplateCreateResponseEntity, type DocumentTemplateGetAllResponseEntity, type DocumentTemplateGetByIdResponseEntity, type DocumentTemplateUpdateResponseEntity } from '../entities';
-import { type RpcPage } from './contract';
-/** Patrones NATS de `documentTemplate` (plantillas propias del editor): `<servicio>.<recurso>.<acción>`. */
+import { type DocumentTemplateAvailableResponseEntity } from '../entities';
+/**
+ * Patrones NATS de `documentTemplate`. La plantilla de cada tipo documental se define y edita con el tipo
+ * (`documentType.create` y `documentType.update`); aquí solo se consulta al redactar.
+ */
 export declare const DocumentTemplatePatterns: {
-    readonly getAll: "gestorDocumental.documentTemplate.getAll";
-    readonly getById: "gestorDocumental.documentTemplate.getById";
-    readonly create: "gestorDocumental.documentTemplate.create";
-    readonly update: "gestorDocumental.documentTemplate.update";
-    readonly setEnabled: "gestorDocumental.documentTemplate.setEnabled";
     readonly getAvailable: "gestorDocumental.documentTemplate.getAvailable";
 };
-/** Datos de una plantilla propia al crearla o editarla. */
-export interface DocumentTemplateWritePayload {
-    name: string;
-    description?: string | null;
-    documentTypeIds?: string[];
-    content: DocumentTemplateContent;
-    enabled?: boolean;
-}
 export interface DocumentTemplateContract {
-    [DocumentTemplatePatterns.getAll]: {
-        payload: {
-            pagination?: {
-                page?: number;
-                limit?: number;
-            };
-            filters?: {
-                search?: string;
-                enabled?: boolean;
-            };
-        };
-        response: RpcPage<DocumentTemplateGetAllResponseEntity[]>;
-    };
-    [DocumentTemplatePatterns.getById]: {
-        payload: Pick<DocumentTemplateEntity, 'id'>;
-        response: DocumentTemplateGetByIdResponseEntity;
-    };
-    [DocumentTemplatePatterns.create]: {
-        payload: DocumentTemplateWritePayload;
-        response: DocumentTemplateCreateResponseEntity;
-    };
-    [DocumentTemplatePatterns.update]: {
-        payload: DocumentTemplateWritePayload & Pick<DocumentTemplateEntity, 'id'>;
-        response: DocumentTemplateUpdateResponseEntity;
-    };
-    [DocumentTemplatePatterns.setEnabled]: {
-        payload: Pick<DocumentTemplateEntity, 'id' | 'enabled'>;
-        response: DocumentTemplateUpdateResponseEntity;
-    };
-    /** Las habilitadas que se ofrecen al redactar un documento del tipo (las de todos los tipos y las suyas). */
+    /** La plantilla habilitada del tipo documental, si tiene (una lista de a lo sumo una). */
     [DocumentTemplatePatterns.getAvailable]: {
         payload: {
             documentTypeId: string;

package/dist/contracts/documentTemplate.contract.js

@@ -1,12 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocumentTemplatePatterns = void 0;
-/** Patrones NATS de `documentTemplate` (plantillas propias del editor): `<servicio>.<recurso>.<acción>`. */
+/**
+ * Patrones NATS de `documentTemplate`. La plantilla de cada tipo documental se define y edita con el tipo
+ * (`documentType.create` y `documentType.update`); aquí solo se consulta al redactar.
+ */
 exports.DocumentTemplatePatterns = {
-    getAll: 'gestorDocumental.documentTemplate.getAll',
-    getById: 'gestorDocumental.documentTemplate.getById',
-    create: 'gestorDocumental.documentTemplate.create',
-    update: 'gestorDocumental.documentTemplate.update',
-    setEnabled: 'gestorDocumental.documentTemplate.setEnabled',
     getAvailable: 'gestorDocumental.documentTemplate.getAvailable',
 };

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";
@@ -203,11 +202,6 @@ export declare const GestorDocumentalPatterns: {
         readonly setEnabled: "gestorDocumental.textSnippet.setEnabled";
     };
     readonly documentTemplate: {
-        readonly getAll: "gestorDocumental.documentTemplate.getAll";
-        readonly getById: "gestorDocumental.documentTemplate.getById";
-        readonly create: "gestorDocumental.documentTemplate.create";
-        readonly update: "gestorDocumental.documentTemplate.update";
-        readonly setEnabled: "gestorDocumental.documentTemplate.setEnabled";
         readonly getAvailable: "gestorDocumental.documentTemplate.getAvailable";
     };
     readonly holiday: {

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/documentTemplate/documentTemplate.entity.d.ts

@@ -2,8 +2,8 @@ import { type DocumentTemplateEntity } from '../../base/entities';
 import { type RichBlock, type RichField } from '../document/document.entity';
 import { type RichLetterhead, type RichPage } from '../document/richStyle';
 /**
- * Contenido de una plantilla propia: los bloques del editor (con sus partes fijas) y los campos que completa quien
- * redacta (en la plantilla, sin valor).
+ * Contenido de la plantilla de un tipo documental: los bloques del editor (con sus partes fijas) y los campos que
+ * completa quien redacta (en la plantilla, sin valor).
  */
 export interface DocumentTemplateContent {
     blocks: RichBlock[];
@@ -13,30 +13,7 @@ export interface DocumentTemplateContent {
     /** Membrete con logo. Sin valor, el nombre de la municipalidad y de la unidad. */
     letterhead?: RichLetterhead;
 }
-/** Plantilla propia en el listado de quien las administra. */
-export interface DocumentTemplateGetAllResponseEntity {
-    id: DocumentTemplateEntity['id'];
-    name: DocumentTemplateEntity['name'];
-    description: string | null;
-    /** Tipos documentales donde se ofrece; vacío, en todos. */
-    documentTypeIds: DocumentTemplateEntity['documentTypeIds'];
-    documentTypeNames: string[];
-    version: DocumentTemplateEntity['version'];
-    enabled: DocumentTemplateEntity['enabled'];
-    updatedAt: DocumentTemplateEntity['updatedAt'];
-    updatedByFullName: string | null;
-}
-/** Una versión del contenido de una plantilla. */
-export interface DocumentTemplateVersionResponseEntity {
-    version: number;
-    createdAt: string;
-    createdByFullName: string | null;
-}
-export interface DocumentTemplateGetByIdResponseEntity extends DocumentTemplateGetAllResponseEntity {
-    content: DocumentTemplateContent;
-    versions: DocumentTemplateVersionResponseEntity[];
-}
-/** Plantilla que se ofrece al redactar un documento de un tipo: con su contenido, lista para usar. */
+/** La plantilla de un tipo documental, que se aplica al redactar uno de sus documentos: lista para usar. */
 export interface DocumentTemplateAvailableResponseEntity {
     id: DocumentTemplateEntity['id'];
     name: DocumentTemplateEntity['name'];
@@ -46,13 +23,3 @@ export interface DocumentTemplateAvailableResponseEntity {
     /** Es la plantilla del tipo documental pedido: se aplica sola al redactar. */
     ownedByType: boolean;
 }
-export interface DocumentTemplateCreateResponseEntity {
-    id: DocumentTemplateEntity['id'];
-    ok: boolean;
-}
-export interface DocumentTemplateUpdateResponseEntity {
-    id: DocumentTemplateEntity['id'];
-    ok: boolean;
-    /** Versión vigente: sube solo si cambió el contenido. */
-    version: number;
-}

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.46",
+  "version": "0.0.1-beta.48",
   "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/documentTemplate.contract.ts

@@ -1,59 +1,15 @@
-import { type DocumentTemplateEntity } from '../base/entities';
-import {
-  type DocumentTemplateAvailableResponseEntity,
-  type DocumentTemplateContent,
-  type DocumentTemplateCreateResponseEntity,
-  type DocumentTemplateGetAllResponseEntity,
-  type DocumentTemplateGetByIdResponseEntity,
-  type DocumentTemplateUpdateResponseEntity,
-} from '../entities';
-import { type RpcPage } from './contract';
+import { type DocumentTemplateAvailableResponseEntity } from '../entities';
 
-/** Patrones NATS de `documentTemplate` (plantillas propias del editor): `<servicio>.<recurso>.<acción>`. */
+/**
+ * Patrones NATS de `documentTemplate`. La plantilla de cada tipo documental se define y edita con el tipo
+ * (`documentType.create` y `documentType.update`); aquí solo se consulta al redactar.
+ */
 export const DocumentTemplatePatterns = {
-  getAll: 'gestorDocumental.documentTemplate.getAll',
-  getById: 'gestorDocumental.documentTemplate.getById',
-  create: 'gestorDocumental.documentTemplate.create',
-  update: 'gestorDocumental.documentTemplate.update',
-  setEnabled: 'gestorDocumental.documentTemplate.setEnabled',
   getAvailable: 'gestorDocumental.documentTemplate.getAvailable',
 } as const;
 
-/** Datos de una plantilla propia al crearla o editarla. */
-export interface DocumentTemplateWritePayload {
-  name: string;
-  description?: string | null;
-  documentTypeIds?: string[];
-  content: DocumentTemplateContent;
-  enabled?: boolean;
-}
-
 export interface DocumentTemplateContract {
-  [DocumentTemplatePatterns.getAll]: {
-    // sin `page` y `limit` responde todas en una sola página
-    payload: {
-      pagination?: { page?: number; limit?: number };
-      filters?: { search?: string; enabled?: boolean };
-    };
-    response: RpcPage<DocumentTemplateGetAllResponseEntity[]>;
-  };
-  [DocumentTemplatePatterns.getById]: {
-    payload: Pick<DocumentTemplateEntity, 'id'>;
-    response: DocumentTemplateGetByIdResponseEntity;
-  };
-  [DocumentTemplatePatterns.create]: {
-    payload: DocumentTemplateWritePayload;
-    response: DocumentTemplateCreateResponseEntity;
-  };
-  [DocumentTemplatePatterns.update]: {
-    payload: DocumentTemplateWritePayload & Pick<DocumentTemplateEntity, 'id'>;
-    response: DocumentTemplateUpdateResponseEntity;
-  };
-  [DocumentTemplatePatterns.setEnabled]: {
-    payload: Pick<DocumentTemplateEntity, 'id' | 'enabled'>;
-    response: DocumentTemplateUpdateResponseEntity;
-  };
-  /** Las habilitadas que se ofrecen al redactar un documento del tipo (las de todos los tipos y las suyas). */
+  /** La plantilla habilitada del tipo documental, si tiene (una lista de a lo sumo una). */
   [DocumentTemplatePatterns.getAvailable]: {
     payload: { documentTypeId: string };
     response: DocumentTemplateAvailableResponseEntity[];

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/documentTemplate/documentTemplate.entity.ts

@@ -3,8 +3,8 @@ import { type RichBlock, type RichField } from '../document/document.entity';
 import { type RichLetterhead, type RichPage } from '../document/richStyle';
 
 /**
- * Contenido de una plantilla propia: los bloques del editor (con sus partes fijas) y los campos que completa quien
- * redacta (en la plantilla, sin valor).
+ * Contenido de la plantilla de un tipo documental: los bloques del editor (con sus partes fijas) y los campos que
+ * completa quien redacta (en la plantilla, sin valor).
  */
 export interface DocumentTemplateContent {
   blocks: RichBlock[];
@@ -15,33 +15,7 @@ export interface DocumentTemplateContent {
   letterhead?: RichLetterhead;
 }
 
-/** Plantilla propia en el listado de quien las administra. */
-export interface DocumentTemplateGetAllResponseEntity {
-  id: DocumentTemplateEntity['id'];
-  name: DocumentTemplateEntity['name'];
-  description: string | null;
-  /** Tipos documentales donde se ofrece; vacío, en todos. */
-  documentTypeIds: DocumentTemplateEntity['documentTypeIds'];
-  documentTypeNames: string[];
-  version: DocumentTemplateEntity['version'];
-  enabled: DocumentTemplateEntity['enabled'];
-  updatedAt: DocumentTemplateEntity['updatedAt'];
-  updatedByFullName: string | null;
-}
-
-/** Una versión del contenido de una plantilla. */
-export interface DocumentTemplateVersionResponseEntity {
-  version: number;
-  createdAt: string;
-  createdByFullName: string | null;
-}
-
-export interface DocumentTemplateGetByIdResponseEntity extends DocumentTemplateGetAllResponseEntity {
-  content: DocumentTemplateContent;
-  versions: DocumentTemplateVersionResponseEntity[];
-}
-
-/** Plantilla que se ofrece al redactar un documento de un tipo: con su contenido, lista para usar. */
+/** La plantilla de un tipo documental, que se aplica al redactar uno de sus documentos: lista para usar. */
 export interface DocumentTemplateAvailableResponseEntity {
   id: DocumentTemplateEntity['id'];
   name: DocumentTemplateEntity['name'];
@@ -51,15 +25,3 @@ export interface DocumentTemplateAvailableResponseEntity {
   /** Es la plantilla del tipo documental pedido: se aplica sola al redactar. */
   ownedByType: boolean;
 }
-
-export interface DocumentTemplateCreateResponseEntity {
-  id: DocumentTemplateEntity['id'];
-  ok: boolean;
-}
-
-export interface DocumentTemplateUpdateResponseEntity {
-  id: DocumentTemplateEntity['id'];
-  ok: boolean;
-  /** Versión vigente: sube solo si cambió el contenido. */
-  version: number;
-}

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;
 }