sigo-entities 1.2.320 → 1.2.321

package/.claude/CLAUDE.md

@@ -0,0 +1,70 @@
+# CLAUDE.md
+
+Frontend: C:\Users\USER\Desktop\Michael\5_cobra\1_workspace\1_projects\SIGO\Frontend\sigo-frontend-2
+Backend: C:\Users\USER\Desktop\Michael\5_cobra\1_workspace\1_projects\SIGO\Backend\sigo-backend
+Sigo-entities: C:\Users\USER\Desktop\Michael\5_cobra\1_workspace\1_projects\SIGO\npm\sigo-entities
+
+## Descripción
+Paquete NPM interno — contrato compartido de tipos, validación y transformación entre `sigo-frontend` y `sigo-backend`.
+
+## Comandos
+
+```bash
+npm run build   # Compila con tsup (CJS + ESM) y resuelve path aliases con tsc-alias
+```
+
+## Arquitectura
+
+El paquete exporta todo desde `src/index.ts`, que re-exporta por dominio:
+
+```
+src/
+  administracion/   — asistencia, personal, etc.
+  configuracion/    — usuarios, perfiles
+  logistica/        — bodega, items, almacen
+  operativa/        — mantenimientos, procesos
+  programados/      — tareas programadas
+  shared/           — DTOs, enums, types y utils reutilizables
+  v2/               — versión 2 de entidades/DTOs
+```
+
+Cada dominio tiene su propio `index.ts` que agrega exports de sus submódulos. El entry point es `dist/index.js` (CJS) / `dist/index.mjs` (ESM) con tipos en `dist/index.d.ts`.
+
+## Patrón de entidades y DTOs
+
+**ENTITY**: Representa un documento completo de una colección MongoDB.
+**DTO**: Representa una sub-estructura reutilizable o forma de datos anidados.
+
+Ejemplo de propiedad con el patrón completo:
+
+```ts
+@Expose()
+@IsDefined({ message: "El campo X es obligatorio" })
+@IsString()
+@Length(0, 75)
+@Transform(({ value }) => value?.toUpperCase().trim())
+Codigo: string = ''
+```
+
+Patrones clave:
+
+- Todas las propiedades se inicializan con valores por defecto (strings vacíos, `0`, `new Class()`)
+- Objetos anidados usan `@Type(() => DtoClass)` + `@ValidateNested()`
+- Arrays usan `@IsArray()` + `@ValidateNested({ each: true })`
+- Texto normalmente se transforma con `.toUpperCase().trim()`
+
+## Path aliases (tsconfig)
+
+```json
+"@shared-dto/*"   → "src/shared/dto/*"
+"@shared-types/*" → "src/shared/types/*"
+"@shared-enums/*" → "src/shared/enums/*"
+```
+
+## Convenciones importantes
+
+- Cada colección MongoDB tiene exactamente una `ENTITY`
+- Naming: `[Nombre]ENTITY` y `[Nombre]DTO`
+- Este paquete es la única fuente de verdad para los tipos — no duplicar en front ni back
+- Cualquier cambio en una entidad impacta ambos proyectos — cuidado con breaking changes
+- `reflect-metadata` se importa en el `src/index.ts` raíz (requerido por class-validator/transformer)

package/.claude/settings.json

@@ -0,0 +1,21 @@
+{
+  "allow": [
+      "Read(//c/Users/USER/Desktop/Michael/5_cobra/1_workspace/1_projects/SIGO/Frontend/sigo-frontend-2/**)",
+      "Read(//c/Users/USER/Desktop/Michael/5_cobra/1_workspace/1_projects/SIGO/Backend/sigo-backend/**)",
+      "Read(//c/Users/USER/Desktop/Michael/5_cobra/1_workspace/1_projects/SIGO/npm/sigo-entities/**)",
+      "Read(//c/Users/USER/Desktop/Michael/5_cobra/1_workspace/1_projects/SIGO/npm/sigo-package/**)",
+      "Read(.env)",
+      "Read(.env.*)"
+    ],
+  "env": {
+    "SIGO_FRONTEND": "C:/Users/USER/Desktop/Michael/5_cobra/1_workspace/1_projects/SIGO/Frontend/sigo-frontend-2",
+    "SIGO_BACKEND": "C:/Users/USER/Desktop/Michael/5_cobra/1_workspace/1_projects/SIGO/Backend/sigo-backend",
+    "SIGO_ENTITIES": "C:/Users/USER/Desktop/Michael/5_cobra/1_workspace/1_projects/SIGO/npm/sigo-entities"
+  },
+  "permissions": {
+    "deny": [
+      "Read(node_modules/**)",
+      "Read(dist/**)"
+    ]
+  }
+}

package/.claude/skills/mdl-administracion/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: mdl-administracion
+description: >
+  Dominio administracion/ — base de datos MDL_ADMINISTRACION. Usar cuando se trabaje con
+  órdenes de trabajo (OT), asistencia, mano de obra, precios, baremos, documentación PEX,
+  zonas de trabajo, o cualquier entidad/DTO dentro de src/administracion/.
+---
+
+# Skill: MDL_ADMINISTRACION
+
+Carpeta: `src/administracion/`
+Base de datos MongoDB: **MDL_ADMINISTRACION**
+
+También contiene parte de **MDL_CATALOGO** — datos de referencia como precios, tipos y unidades.
+
+## Sub-dominios principales
+
+| Carpeta | Contenido |
+|---|---|
+| `ot/` | Órdenes de Trabajo — vigencia, estado |
+| `otglobal/` | OT globales |
+| `asistencia/` | Registro de asistencia y resumen |
+| `mano-obra-unidad-obra/` | Relación mano de obra ↔ unidad de obra |
+| `mano_obra_mtto/` | Mano de obra en mantenimiento |
+| `precio-mano-obra/` | Precios de MO (global, empresa, precio actual) — **MDL_CATALOGO** |
+| `precio material/` | Precios de materiales — **MDL_CATALOGO** |
+| `precio especialidad/` | Precios por especialidad y agencia — **MDL_CATALOGO** |
+| `unidad_obra/` | Catálogo de unidades de obra — **MDL_CATALOGO** |
+| `unidad obra material/` | Materiales por unidad de obra — **MDL_CATALOGO** |
+| `zona trabajo/` | Zonas de trabajo y contratos OT |
+| `documentacion-pex/` | Documentación de procesos PEX |
+| `documentacion-baremo-pex/` | Baremos para documentación PEX |
+| `tipo movil/` | Tipos de vehículo/móvil — **MDL_CATALOGO** |
+| `tipo_clave/` | Tipos de clave — **MDL_CATALOGO** |
+| `rm_zona_actividad/` | Relación RM zona-actividad |
+| `ItemExtra/` | Ítems extra (SKU, proveedor) |
+| `EstadoInterno/` | Estados internos de OT |
+| `permisos-app/` | Permisos de la app |
+| `mail structure/` | Estructura de destinatarios de mail |
+| `key integracion/` | Claves de integración externa |
+| `PrecioAgencia_mam_onnet/` | Precios de agencia MAM/Onnet |
+| `chile 9512 paquetizado mano obra/` | Chile: MO paquetizada contrato 9512 |
+| `chile 9512 paquetizado material/` | Chile: material paquetizado contrato 9512 |
+
+## Naming
+
+- Entidades: `[Nombre]ENTITY` — representan una colección MongoDB completa
+- DTOs: `[Nombre]DTO` — sub-estructuras anidadas o reutilizables
+- Ejemplo: `OtENTITY`, `VigenciaOtDTO`, `PrecioManoObraENTITY`, `PrecioEmpresaDTO`
+
+## Ubicación de archivos
+
+```
+src/administracion/
+└── [nombre-modulo]/
+    └── shared/
+        ├── [nombre].entity.ts    ← ENTITY principal
+        └── dto/
+            └── [nombre]-dto.ts   ← DTOs anidados
+```

package/.claude/skills/mdl-configuracion/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: mdl-configuracion
+description: >
+  Dominio configuracion/ — base de datos MDL_CONFIGURACION. Usar cuando se trabaje con
+  usuarios, perfiles, empresas, sistema, notificaciones, cargos, contratos OT,
+  o cualquier entidad/DTO dentro de src/configuracion/.
+---
+
+# Skill: MDL_CONFIGURACION
+
+Carpeta: `src/configuracion/`
+Base de datos MongoDB: **MDL_CONFIGURACION**
+
+## Sub-dominios principales
+
+| Carpeta | Contenido |
+|---|---|
+| `usuarios/` | Usuarios del sistema |
+| `usuarios autoinventario/` | Usuarios del módulo autoinventario |
+| `perfiles/` | Perfiles de acceso y sistemas asociados |
+| `personal/` | Datos del personal |
+| `cargo personal/` | Cargos/roles del personal |
+| `empresa/` | Empresas (datos generales, GIA, grupo empresa, representante legal, tipo) |
+| `sistema/` | Configuración general del sistema |
+| `opcion sistema/` | Opciones del sistema |
+| `tipo opcion sistema/` | Tipos de opciones del sistema |
+| `tipo especialidad mo/` | Tipos de especialidad de mano de obra |
+| `tipo clave/` | Tipos de clave de configuración |
+| `contrato ot/` | Contratos de órdenes de trabajo |
+| `notificaciones/` | Notificaciones (data adicional) |
+| `scraping credential/` | Credenciales para scraping |
+| `theme config country/` | Configuración de tema por país |
+
+## Naming
+
+- Entidades: `[Nombre]ENTITY`
+- DTOs: `[Nombre]DTO`
+- Ejemplo: `UsuarioENTITY`, `EmpresaENTITY`, `DatosGeneralesDTO`, `SistemaDTO`, `PerfilENTITY`
+
+## Ubicación de archivos
+
+```
+src/configuracion/
+└── [nombre-modulo]/
+    └── shared/
+        ├── [nombre].entity.ts
+        └── dto/
+            └── [nombre]-dto.ts
+```

package/.claude/skills/ope-im/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: ope-im
+description: >
+  Dominio operativa/ — base de datos OPE_IM. Usar cuando se trabaje con
+  mantenimientos, procesos de integración externa (TOA, WAOO, WIN, Fibramas, Onnet,
+  Movistar, Somacyl, Tuves, TDC), órdenes de liquidación, order stock,
+  o cualquier entidad/DTO dentro de src/operativa/.
+---
+
+# Skill: OPE_IM
+
+Carpeta: `src/operativa/`
+Base de datos MongoDB: **OPE_IM**
+
+Contiene integraciones con sistemas externos de operadores de telecomunicaciones y procesos de mantenimiento.
+
+## Sub-dominios principales
+
+### `mantenimientos/`
+Entidades de mantenimiento operativo.
+
+### `procesos/`
+Integraciones con sistemas externos por operador:
+
+| Carpeta | Operador / Sistema |
+|---|---|
+| `TOA orden liquidacion/` | TOA — órdenes de liquidación |
+| `TOA orden liquidacion_db/` | TOA — órdenes de liquidación (versión BD) |
+| `TOA Claro order stock/` | TOA Claro — order stock |
+| `TOA order stock/` | TOA — order stock genérico |
+| `toa_claro/` | TOA Claro (scraper + shared) |
+| `toa_movistar/` | TOA Movistar |
+| `toa_movistar_db/` | TOA Movistar (versión BD) |
+| `baremos_toa/` | Baremos TOA (Chile + shared) |
+| `liquidadas_toa/` | Órdenes TOA liquidadas |
+| `valorizadas_toa/` | Órdenes TOA valorizadas |
+| `onnet_fibra/` | Onnet Fibra (DTOs + utils) |
+| `fibramas_order/` | Fibramas — órdenes |
+| `fibramas_order_db/` | Fibramas — órdenes (versión BD) |
+| `win_order/` | WIN — órdenes |
+| `win_order_db/` | WIN — órdenes (versión BD) |
+| `waoo_order_stock/` | WAOO — order stock |
+| `cliente_waoo/` | WAOO — clientes |
+| `somacyl_order/` | Somacyl — órdenes |
+| `tuves/` | Tuves |
+| `tuves_order_stock/` | Tuves — order stock |
+| `tdc/` | TDC (Chile — DTOs + interfaces) |
+| `stb_dth_toaperu/` | STB DTH TOA Perú |
+| `order stock/` | Order stock genérico |
+| `request number TTL/` | Request number TTL |
+
+## Naming
+
+- Entidades: `[Nombre]ENTITY`
+- DTOs: `[Nombre]DTO`
+- Ejemplo: `ToaOrdenLiquidacionENTITY`, `BaremoToaENTITY`, `OnnetFibraENTITY`
+
+## Ubicación de archivos
+
+```
+src/operativa/
+├── mantenimientos/
+│   └── shared/
+│       └── [nombre].entity.ts
+└── procesos/
+    └── [nombre-operador]/
+        └── shared/
+            ├── [nombre].entity.ts
+            └── dto/
+                └── [nombre]-dto.ts
+```

package/.claude/skills/ope-logistica/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: ope-logistica
+description: >
+  Dominio logistica/ — base de datos OPE_LOGISTICA. Usar cuando se trabaje con
+  almacenes, bodega, stock, inventario, movimientos de almacén, consumo de material,
+  devoluciones, ítems, kits, o cualquier entidad/DTO dentro de src/logistica/.
+---
+
+# Skill: OPE_LOGISTICA
+
+Carpeta: `src/logistica/`
+Base de datos MongoDB: **OPE_LOGISTICA**
+
+También contiene parte de **MDL_CATALOGO** — catálogo de ítems, tipos de almacén, unidades de medida.
+
+## Sub-dominios principales
+
+| Carpeta | Contenido |
+|---|---|
+| `almacen/` | Almacenes |
+| `almacen extra/` | Almacenes extra |
+| `bodega/` | Bodegas |
+| `stock almacen/` | Stock en almacén |
+| `stock almacen equipos/` | Stock de equipos en almacén |
+| `stock personal/` | Stock asignado a personal |
+| `stock personal equipos/` | Stock de equipos del personal |
+| `movimiento almacen/` | Movimientos de almacén |
+| `ingreso almacen/` | Ingresos a almacén |
+| `salida almacen/` | Salidas de almacén |
+| `devolucion almacen/` | Devoluciones de almacén |
+| `consumo material/` | Consumo de material (incluye variante Alemania) |
+| `consumos P117/` | Consumos protocolo P117 |
+| `kitconsumo/` | Kits de consumo |
+| `autoinventario/` | Autoinventario |
+| `transaccion folios/` | Transacciones con folios |
+| `atencion ordenes liquidadas/` | Atención de órdenes liquidadas |
+| `items/` | Catálogo de ítems (incluye variante Alemania) — **MDL_CATALOGO** |
+| `gran familia item/` | Gran familia de ítems — **MDL_CATALOGO** |
+| `tipo almacen/` | Tipos de almacén — **MDL_CATALOGO** |
+| `tipo movimiento almacen/` | Tipos de movimiento de almacén — **MDL_CATALOGO** |
+| `tipo stock/` | Tipos de stock — **MDL_CATALOGO** |
+| `unidad medida/` | Unidades de medida — **MDL_CATALOGO** |
+| `procesos/navisionpreorden/` | Pre-órdenes Navision (DTOs, enums, requestDtos) |
+
+## Naming
+
+- Entidades: `[Nombre]ENTITY`
+- DTOs: `[Nombre]DTO`
+- Ejemplo: `AlmacenENTITY`, `AlmacenDTO`, `StockAlmacenENTITY`, `MovimientoAlmacenENTITY`
+
+## Ubicación de archivos
+
+```
+src/logistica/
+└── [nombre-modulo]/
+    └── shared/
+        ├── [nombre].entity.ts
+        └── dto/
+            └── [nombre]-dto.ts
+```

package/.claude/skills/ope-pex/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: ope-pex
+description: >
+  Dominio programados/ — base de datos OPE_PEX. Usar cuando se trabaje con
+  procesos programados de ejecución: obra, trabajo, cubicación, macroobra,
+  reservas (MO y material), reportes de producción, liberación de pagos,
+  mantenimientos de catálogos (agencia, cuadrilla, periodo, presupuesto),
+  o cualquier entidad/DTO dentro de src/programados/.
+---
+
+# Skill: OPE_PEX
+
+Carpeta: `src/programados/`
+Base de datos MongoDB: **OPE_PEX**
+
+Procesos programados de ejecución — el dominio más grande del paquete.
+
+## Sub-dominios principales
+
+### `Reportes/`
+
+| Carpeta | Contenido |
+|---|---|
+| `LiberacionDePagos/` | Reporte de liberación de pagos (DTOs + requestDtos) |
+| `ReporteProduccion/` | Reporte de producción (Alemania, Chile, Colombia — baremos y resumen) |
+| `RptProduccionCurso_Baremos_Fases/` | Reporte producción en curso con baremos y fases |
+
+### `mantenimientos/`
+Catálogos y configuraciones base de OPE_PEX:
+
+| Carpeta | Contenido |
+|---|---|
+| `agencia/` | Agencias |
+| `area_gom/` | Áreas GOM |
+| `centro costos/` | Centros de costo |
+| `contrato-pagos/` | Contratos de pago (Alemania) |
+| `cuadrilla/` | Cuadrillas de trabajo |
+| `mano obra global/` | Mano de obra global |
+| `mano-obra-baremo/` | Mano de obra × baremo |
+| `periodo/` | Períodos |
+| `presupuesto-ot/` | Presupuesto de OT |
+| `rm actividad/` | RM actividad |
+| `rm comuna/` | RM comuna |
+| `rm mano obra/` | RM mano de obra |
+| `rm paquetizado/` | RM paquetizado |
+| `rm-material/` | RM material |
+| `rm-zonas-actividad/` | RM zonas de actividad |
+| `tipo actividad mo/` | Tipos de actividad MO |
+| `tipo obra/` | Tipos de obra |
+
+### `procesos/`
+Procesos de ejecución programada:
+
+| Carpeta | Contenido |
+|---|---|
+| `obra/` | Obra (Alemania AL02/AL04, Chile 9512, Colombia 9612, Perú 9112, shared) |
+| `trabajo/` | Trabajo (Alemania + shared) |
+| `macroobra/` | Macro-obra (Chile, Perú, shared) |
+| `trabajoMacroObra/` | Trabajo en macro-obra (Alemania + shared) |
+| `cubicacion/` | Cubicación (Alemania, Chile, Colombia, Perú, shared) |
+| `reservaManoObra/` | Reserva de mano de obra (Alemania + shared) |
+| `reservaManoObraRegularizacion/` | Regularización de reserva MO |
+| `reservaMaterial/` | Reserva de material |
+| `precioContratistaIssue/` | Precio contratista — issues (Alemania AL02 + shared) |
+| `precioContratistaMO/` | Precio contratista MO (Alemania AL02/AL04 + shared) |
+| `precioContratistaMaterial/` | Precio contratista material |
+| `gom/` | GOM (Colombia + shared) |
+| `Issue/` | Issues generales |
+| `addressList_AL04/` | Lista de direcciones AL04 (Alemania) |
+| `data-migrations/` | Migraciones de datos |
+| `model mo sql/` | Modelo MO SQL (Perú) |
+| `model obra sql/` | Modelo obra SQL (Perú) |
+
+## Naming
+
+- Entidades: `[Nombre]ENTITY`
+- DTOs: `[Nombre]DTO`
+- Ejemplo: `ObraENTITY`, `TrabajoENTITY`, `CubicacionENTITY`, `ReservaManoObraENTITY`
+
+## Patrón por país
+
+Muchos módulos tienen variantes por país dentro del mismo proceso:
+
+```
+procesos/obra/
+├── alemania/AL02/    ← contrato alemán AL02
+├── alemania/AL04/    ← contrato alemán AL04
+├── chile/9512/       ← contrato chileno 9512
+├── colombia/9612/    ← contrato colombiano 9612
+├── peru/9112/        ← contrato peruano 9112
+└── shared/           ← estructura base compartida
+```
+
+## Ubicación de archivos
+
+```
+src/programados/
+├── Reportes/[nombre]/shared/(dto|request_dto)/
+├── mantenimientos/[nombre]/shared/(entity|dto)/
+└── procesos/[nombre]/
+    ├── shared/
+    │   ├── [nombre].entity.ts
+    │   ├── dto/
+    │   └── requestDto/
+    └── [pais]/dto/
+```

package/.claude/skills/shared-dtos/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: shared-dtos
+description: >
+  Dominio shared/ — DTOs, enums, types y utils reutilizables en todos los dominios.
+  Usar cuando se necesite un DTO transversal como CodigoNombre, UsuarioDTO, o cualquier
+  estructura que se repite en múltiples colecciones/módulos. También contiene enums
+  globales, tipos TypeScript y utilidades de transformación.
+---
+
+# Skill: Shared DTOs
+
+Carpeta: `src/shared/`
+**No tiene base de datos propia** — es código reutilizado por todos los dominios.
+
+## Sub-carpetas
+
+### `dto/`
+DTOs transversales usados en múltiples entidades y dominios.
+
+Ejemplos clave:
+
+| DTO | Forma | Uso |
+|---|---|---|
+| `CodigoNombre` | `{ Codigo: string, Nombre: string }` | Referencia genérica a catálogos |
+| `UsuarioDTO` | datos del usuario | Auditoría, asignaciones |
+| `AlmacenDTO` | datos de almacén | Referencia a almacenes en otros módulos |
+| `AutoinventarioDTO` | — | Inventario en múltiples dominios |
+| `ZonasDTO` | — | Zonas de trabajo transversales |
+
+> Si una estructura `{ Codigo, Nombre }` aparece en varios módulos, usar `CodigoNombre` de shared en vez de redefinirla.
+
+### `enums/`
+Enums globales del sistema:
+
+| Archivo | Contenido |
+|---|---|
+| `RequeridoEnum.ts` | Enum de campos requeridos |
+| `StateInternalOrder.ts` | Estados de órdenes internas |
+| `StateInternalOrderTOA.ts` | Estados de órdenes TOA |
+
+### `types/`
+Tipos TypeScript globales:
+
+| Archivo | Contenido |
+|---|---|
+| `sistema-recurso.ts` | Tipo de recurso del sistema |
+| `state-inventory.ts` | Tipo de estado de inventario |
+
+### `utils/`
+Utilidades de transformación usadas en decoradores `@Transform`:
+
+| Utilidad | Función |
+|---|---|
+| `trimAndUpperCaseString` | `.trim().toUpperCase()` — la más usada |
+| `smartDateTransformer` | Transforma strings a Date de forma segura |
+| `convertStringsToDates` | Convierte strings ISO a Date en objetos |
+| `convertTypeNumber` | Fuerza conversión a número |
+| `forceString` | Fuerza conversión a string |
+| `transformToDateIfEmpty` | Date con fallback si vacío |
+| `enumToArray` | Convierte enum a array |
+| `entity_generator` | Genera instancias de entidad con defaults |
+| `entity_generator_under_hyphen` | Variante con naming hyphen |
+| `validarYFormatearDatos` | Valida y formatea datos |
+| `validateArrayBody` | Valida arrays en body |
+
+## Path aliases
+
+```ts
+import { ... } from '@shared-dto/nombre-dto'     // src/shared/dto/
+import { ... } from '@shared-types/nombre-type'   // src/shared/types/
+import { ... } from '@shared-enums/nombre-enum'   // src/shared/enums/
+```
+
+## Regla
+
+Antes de crear un DTO nuevo, revisar si ya existe en `shared/dto/`. Si la misma forma de datos aparece en ≥2 módulos distintos, pertenece a `shared/`.