sigo-entities 1.2.518 → 1.2.520

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/`.

package/__tests__/asistenciaCuadrilla.test.mjs

@@ -0,0 +1,67 @@
+// Ejecutar tras `npm run build`: npm test
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import {
+    toFechaKey,
+    mapAsistenciaToCuadrillaOrden,
+    validateAndFormatData,
+    CuadrillaBtAlpPluzOrder2DTO,
+    EstadoIntegranteCuadrilla,
+    OrigenIntegrante,
+    AttendanceStatus,
+} from "../dist/index.mjs";
+
+test("toFechaKey: 23:30 hora Lima no corre al día siguiente", () => {
+    assert.equal(toFechaKey(new Date("2026-10-04T23:30:00-05:00")), "2026-10-04");
+});
+
+test("toFechaKey: medianoche UTC es el día anterior en Lima", () => {
+    assert.equal(toFechaKey(new Date("2026-10-05T00:00:00Z")), "2026-10-04");
+});
+
+test("toFechaKey: fin de mes y fin de año", () => {
+    assert.equal(toFechaKey(new Date("2026-11-01T03:00:00Z")), "2026-10-31");
+    assert.equal(toFechaKey(new Date("2027-01-01T04:59:59Z")), "2026-12-31");
+});
+
+const integrante = (overrides) => ({
+    Identificacion: "", Apellidos: "AP", Nombres: "NOM", Cargo: "TECNICO", PesoPersonal: 1, IdRecurso: "",
+    EsJefeTitular: false, EsJefe: false, Origen: OrigenIntegrante.TITULAR,
+    Estado: EstadoIntegranteCuadrilla.PRESENTE, Motivo: "", Observacion: "",
+    ...overrides,
+});
+
+const asistencia = {
+    Cuadrilla: { ID_Cuadrilla: 12, Codigo: "CUA-012", Nombre: "Cuadrilla 12" },
+    Integrantes: [
+        integrante({ Identificacion: "1", Cargo: "JEFE DE CUADRILLA", EsJefeTitular: true, Estado: EstadoIntegranteCuadrilla.AUSENTE, Motivo: AttendanceStatus.DescansoMedico }),
+        integrante({ Identificacion: "2", EsJefe: true, IdRecurso: "R2" }),
+        integrante({ Identificacion: "3", Estado: EstadoIntegranteCuadrilla.CEDIDO, CuadrillaDestino: { ID_Cuadrilla: 20, Codigo: "CUA-020", Nombre: "" } }),
+        integrante({ Identificacion: "99", Origen: OrigenIntegrante.PRESTADO, CuadrillaOrigen: { ID_Cuadrilla: 7, Codigo: "CUA-007", Nombre: "" } }),
+    ],
+};
+
+test("mapAsistenciaToCuadrillaOrden: excluye AUSENTE y CEDIDO", () => {
+    const cuadrilla = mapAsistenciaToCuadrillaOrden(asistencia);
+    assert.deepEqual(cuadrilla.map((m) => m.Identificacion), ["2", "99"]);
+    assert.ok(cuadrilla.every((m) => m instanceof CuadrillaBtAlpPluzOrder2DTO));
+});
+
+test("mapAsistenciaToCuadrillaOrden: marca al suplente", () => {
+    const suplente = mapAsistenciaToCuadrillaOrden(asistencia).find((m) => m.Identificacion === "2");
+    assert.equal(suplente.EsJefe, true);
+    assert.equal(suplente.EsJefeSuplente, true);
+    assert.equal(suplente.IdRecurso, "R2");
+});
+
+test("mapAsistenciaToCuadrillaOrden: prestado lleva Codigo destino y CodigoCuadrillaOrigen", () => {
+    const prestado = mapAsistenciaToCuadrillaOrden(asistencia).find((m) => m.Identificacion === "99");
+    assert.equal(prestado.Codigo, "CUA-012");
+    assert.equal(prestado.CodigoCuadrillaOrigen, "CUA-007");
+    assert.equal(prestado.Origen, OrigenIntegrante.PRESTADO);
+});
+
+test("CuadrillaBtAlpPluzOrder2DTO: documento antiguo sin campos nuevos valida", async () => {
+    const antiguo = { Codigo: "CUA-1", Identificacion: "1", Apellidos: "A", Nombres: "N", Cargo: "TECNICO", PesoPersonal: 1 };
+    await assert.doesNotReject(validateAndFormatData(antiguo, CuadrillaBtAlpPluzOrder2DTO));
+});

package/dist/index.d.mts

@@ -10364,6 +10364,8 @@ declare class BtAlpPluzOrder2ENTITY {
     en_ejecucion_por_tecnico_act_udf: string;
     EECC: EECCBtAlpPluzDTO;
     liquidacion: LiquidacionBtAlpPluzOrder2DTO[];
+    preliquidacion: LiquidacionBtAlpPluzOrder2DTO[];
+    documentacion: FilesDocDTO[];
     id_preliquidacion: number;
     estado_preliquidacion: number;
     bitacora: BitacoraDTO[];
@@ -10436,7 +10438,7 @@ declare class PayloadTokenDto {
 }
 
 declare class SelectCrewDto {
-    crewCode: number;
+    crewCode: string;
 }
 
 declare class SystemOptionEntity {

package/dist/index.d.ts

@@ -10364,6 +10364,8 @@ declare class BtAlpPluzOrder2ENTITY {
     en_ejecucion_por_tecnico_act_udf: string;
     EECC: EECCBtAlpPluzDTO;
     liquidacion: LiquidacionBtAlpPluzOrder2DTO[];
+    preliquidacion: LiquidacionBtAlpPluzOrder2DTO[];
+    documentacion: FilesDocDTO[];
     id_preliquidacion: number;
     estado_preliquidacion: number;
     bitacora: BitacoraDTO[];
@@ -10436,7 +10438,7 @@ declare class PayloadTokenDto {
 }
 
 declare class SelectCrewDto {
-    crewCode: number;
+    crewCode: string;
 }
 
 declare class SystemOptionEntity {

package/dist/index.js

@@ -53795,6 +53795,8 @@ var BtAlpPluzOrder2ENTITY = class {
   en_ejecucion_por_tecnico_act_udf = "";
   EECC = new EECCBtAlpPluzDTO();
   liquidacion = [];
+  preliquidacion = [];
+  documentacion = [];
   id_preliquidacion = 0;
   estado_preliquidacion = 0;
   bitacora = [];
@@ -54335,6 +54337,20 @@ __decorateClass([
   (0, import_class_validator809.ValidateNested)({ each: true }),
   (0, import_class_transformer832.Type)(() => LiquidacionBtAlpPluzOrder2DTO)
 ], BtAlpPluzOrder2ENTITY.prototype, "liquidacion", 2);
+__decorateClass([
+  (0, import_class_transformer832.Expose)(),
+  (0, import_class_validator809.IsDefined)(),
+  (0, import_class_validator809.IsArray)(),
+  (0, import_class_validator809.ValidateNested)({ each: true }),
+  (0, import_class_transformer832.Type)(() => LiquidacionBtAlpPluzOrder2DTO)
+], BtAlpPluzOrder2ENTITY.prototype, "preliquidacion", 2);
+__decorateClass([
+  (0, import_class_transformer832.Expose)(),
+  (0, import_class_validator809.IsDefined)(),
+  (0, import_class_validator809.IsArray)(),
+  (0, import_class_validator809.ValidateNested)({ each: true }),
+  (0, import_class_transformer832.Type)(() => FilesDocDTO)
+], BtAlpPluzOrder2ENTITY.prototype, "documentacion", 2);
 __decorateClass([
   (0, import_class_transformer832.Expose)(),
   (0, import_class_validator809.IsDefined)(),
@@ -54654,13 +54670,13 @@ __decorateClass([
 var import_class_transformer839 = require("class-transformer");
 var import_class_validator816 = require("class-validator");
 var SelectCrewDto = class {
-  crewCode = 0;
+  crewCode = "";
 };
 __decorateClass([
+  (0, import_class_transformer839.Transform)(({ value }) => typeof value === "string" ? value.trim() : value),
   (0, import_class_validator816.IsDefined)({ message: "Debe proporcionar el c\xF3digo de la cuadrilla" }),
-  (0, import_class_transformer839.Type)(() => Number),
-  (0, import_class_validator816.IsInt)({ message: "El c\xF3digo de la cuadrilla debe ser un n\xFAmero entero" }),
-  (0, import_class_validator816.Min)(1, { message: "El c\xF3digo de la cuadrilla es inv\xE1lido" }),
+  (0, import_class_validator816.IsString)({ message: "El c\xF3digo de la cuadrilla debe ser una cadena de texto" }),
+  (0, import_class_validator816.IsNotEmpty)({ message: "Debe proporcionar el c\xF3digo de la cuadrilla" }),
   (0, import_class_transformer839.Expose)()
 ], SelectCrewDto.prototype, "crewCode", 2);