sigo-entities 1.2.571 → 1.2.573

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,215 +1,215 @@
1
- # Reporte — Estructura de sigo-entities
2
-
3
- **Fecha:** 2026-08-31
4
- **Autor:** Brayan Andrés Valero Pinzón — Hermes Agent (sigo-frontend-dev)
5
- **Destinatario:** Ingeniero Josue — Repositorio `sigo-entities`
6
-
7
- ---
8
-
9
- ## Resumen
10
-
11
- Se detectaron **47 carpetas con nombres incorrectos** (sin guiones), **30 archivos `shared/index.ts` con Entity + DTO + `_id` mezclados**, y **3 carpetas en configuracion que ya fueron corregidas**.
12
-
13
- ---
14
-
15
- ## ✅ CORREGIDAS (3 archivos)
16
-
17
- Las siguientes 3 Entities fueron corregidas siguiendo el patrón correcto:
18
-
19
- | Carpeta | Archivos creados | Cambios |
20
- |---|---|---|
21
- | `theme config country` | `shared/theme-config-country-entity.ts` | Eliminado `_id`, DTOs inline en entity.ts, `shared/index.ts` solo exporta entity |
22
- | `theme config user` | `shared/dto/favorito-dto.ts` + `shared/theme-config-user-entity.ts` | Eliminado `_id`, DTOs separados en carpeta `dto/`, `shared/index.ts` solo exporta entity |
23
- | `scraping credential` | `shared/scraping-credential-entity.ts` | Eliminado `_id`, `shared/index.ts` solo exporta entity |
24
-
25
- **Patrón aplicado:**
26
- ```
27
- carpeta/
28
- shared/
29
- dto/
30
- nombre-dto.ts ← DTOs aquí
31
- nombre-entity.ts ← solo la Entity aquí
32
- index.ts ← solo export * from './nombre-entity'
33
- ```
34
-
35
- ---
36
-
37
- ## ❌ CARPETA 1: Carpetas con nombres SIN guiones (47 carpetas)
38
-
39
- **Regla:** Nombres compuestos deben usar guiones (`-`) en lugar de espacios.
40
-
41
- ### Configuración (10 carpetas)
42
- | Actual | Debería ser |
43
- |---|---|
44
- | `cargo personal` | `cargo-personal` |
45
- | `contrato ot` | `contrato-ot` |
46
- | `opcion sistema` | `opcion-sistema` |
47
- | ~~`scraping credential`~~ | ~~`scraping-credential`~~ ✅ renombrada |
48
- | ~~`theme config country`~~ | ~~`theme-config-country`~~ ✅ renombrada |
49
- | ~~`theme config user`~~ | ~~`theme-config-user`~~ ✅ renombrada |
50
- | `tipo clave` | `tipo-clave` |
51
- | `tipo especialidad mo` | `tipo-especialidad-mo` |
52
- | `tipo opcion sistema` | `tipo-opcion-sistema` |
53
- | `usuarios autoinventario` | `usuarios-autoinventario` |
54
-
55
- ### Administración (8 carpetas)
56
- | Actual | Debería ser |
57
- |---|---|
58
- | `chile 9512 paquetizado mano obra` | `chile-9512-paquetizado-mano-obra` |
59
- | `chile 9512 paquetizado material` | `chile-9512-paquetizado-material` |
60
- | `key integracion` | `key-integracion` |
61
- | `mail structure` | `mail-structure` |
62
- | `precio especialidad` | `precio-especialidad` |
63
- | `precio material` | `precio-material` |
64
- | `unidad obra material` | `unidad-obra-material` |
65
- | `zona trabajo` | `zona-trabajo` |
66
-
67
- ### Logística (17 carpetas)
68
- | Actual | Debería ser |
69
- |---|---|
70
- | `almacen extra` | `almacen-extra` |
71
- | `atencion ordenes liquidadas` | `atencion-ordenes-liquidadas` |
72
- | `consumo material` | `consumo-material` |
73
- | `consumos P117` | `consumos-P117` |
74
- | `devolucion almacen` | `devolucion-almacen` |
75
- | `gran familia item` | `gran-familia-item` |
76
- | `ingreso almacen` | `ingreso-almacen` |
77
- | `movimiento almacen` | `movimiento-almacen` |
78
- | `salida almacen` | `salida-almacen` |
79
- | `stock almacen` | `stock-almacen` |
80
- | `stock almacen equipos` | `stock-almacen-equipos` |
81
- | `stock personal` | `stock-personal` |
82
- | `stock personal equipos` | `stock-personal-equipos` |
83
- | `tipo almacen` | `tipo-almacen` |
84
- | `tipo movimiento almacen` | `tipo-movimiento-almacen` |
85
- | `tipo stock` | `tipo-stock` |
86
- | `transaccion folios` | `transaccion-folios` |
87
- | `unidad medida` | `unidad--medida` |
88
-
89
- ### Programados (10 carpetas)
90
- | Actual | Debería ser |
91
- |---|---|
92
- | `centro costos` | `centro-costos` |
93
- | `mano obra global` | `mano-obra-global` |
94
- | `rm actividad` | `rm-actividad` |
95
- | `rm comuna` | `rm-comuna` |
96
- | `rm mano obra` | `rm-mano-obra` |
97
- | `rm paquetizado` | `rm-paquetizado` |
98
- | `tipo actividad mo` | `tipo-actividad-mo` |
99
- | `tipo obra` | `tipo-obra` |
100
- | `model mo sql` | `model-mo-sql` |
101
- | `model obra sql` | `model-obra-sql` |
102
-
103
- ### Operativa (7 carpetas)
104
- | Actual | Debería ser |
105
- |---|---|
106
- | `order stock` | `order-stock` |
107
- | `order stock store` | `order-stock-store` |
108
- | `request number TTL` | `request-number-TTL` |
109
- | `Tdc order stock` | `Tdc-order-stock` |
110
- | `TOA Claro order stock` | `TOA-Claro-order-stock` |
111
- | `TOA orden liquidacion` | `TOA-orden-liquidacion` |
112
- | `TOA order stock` | `TOA-order-stock` |
113
-
114
- ---
115
-
116
- ## ❌ CARPETA 2: `shared/index.ts` con Entity + DTO + `_id` mezclados (30 carpetas)
117
-
118
- **Regla:** `shared/index.ts` debe contener SOLO la Entity. Los DTOs deben estar en `shared/dto/`.
119
-
120
- ### Configuración (3 carpetas — ya corregidas)
121
- | Carpeta | Entity | DTOs presentes | `_id` | Estado |
122
- |---|---|---|---|---|
123
- | `configuracion/ theme-config-country/shared/index.ts` | `ThemeConfigCountryENTITY` | `ImgLogoNavBarDTO`, `ThemeCountryManualDTO` | ✅ Línea 50 | ✅ CORREGIDA (carpeta renombrada, DTOs en `shared/dto/`, `_id` eliminado) |
124
- | `configuracion/ theme-config-user/shared/index.ts` | `ThemeConfigUserENTITY` | `FavoritoDTO` | ✅ Línea 33 | ✅ CORREGIDA (carpeta renombrada, DTOs en `shared/dto/`, `_id` eliminado) |
125
- | `configuracion/ scraping-credential/shared/index.ts` | `ScrapingCredentialENTITY` | `CodigoNombreDTO` | ✅ Línea 10 | ✅ CORREGIDA (carpeta renombrada, `_id` eliminado) |
126
-
127
- ### Logística (2 carpetas)
128
- | Carpeta | Entity | DTOs presentes | `_id` |
129
- |---|---|---|---|
130
- | `logistica/stock personal/shared/index.ts` | `StockPersonalENTITY` | Varios | ✅ |
131
- | `logistica/stock personal equipos/shared/index.ts` | `StockPersonalEquiposENTITY` | Varios | ✅ |
132
-
133
- ### Operativa/Procesos (25 carpetas)
134
- | Carpeta | Entity | `_id` |
135
- |---|---|---|
136
- | `operativa/procesos/altas_nvt_order/shared/index.ts` | `AltasNVTOrderENTITY` | ✅ Línea 35 |
137
- | `operativa/procesos/bantel/shared/index.ts` | `BantelENTITY` | ❌ `resource_id` (equivalente a `_id`) |
138
- | `operativa/procesos/claro_peru9112/shared/index.ts` | `Peru9112ClaroENTITY` | ✅ Línea 32 |
139
- | `operativa/procesos/cliente_waoo/shared/index.ts` | `ClienteWAOOENTITY` | ❌ `line_id` (equivalente a `_id`) |
140
- | `operativa/procesos/fibramas_order/shared/index.ts` | `Peru9112FibramasENTITY` | ❌ `resource_id` (equivalente a `_id`) |
141
- | `operativa/procesos/fibramas_order_db/shared/index.ts` | `Peru9112FibramasENTITYDB` | ❌ `resource_id` (equivalente a `_id`) |
142
- | `operativa/procesos/mifibra_db/shared/index.ts` | `MiFibraENTITYDB` | ❌ `resource_id` (equivalente a `_id`) |
143
- | `operativa/procesos/order stock/shared/index.ts` | `OrderStockENTITY` | ✅ |
144
- | `operativa/procesos/order stock store/shared/index.ts` | `OrderStockStoreENTITY` | ✅ |
145
- | `operativa/procesos/request number TTL/shared/index.ts` | `RequestNumberTTLENTITY` | ✅ Línea 14 |
146
- | `operativa/procesos/somacyl_order/shared/index.ts` | `SomacylOrderENTITY` | ✅ Línea 32 |
147
- | `operativa/procesos/stb_dth_toaperu/shared/index.ts` | `STB_DTH_ToaENTITY` | ✅ |
148
- | `operativa/procesos/Tdc order stock/shared/index.ts` | `TdcOrderStockENTITY` | ✅ |
149
- | `operativa/procesos/TOA Claro order stock/shared/index.ts` | `TOAClaroOrderStockENTITY` | ✅ |
150
- | `operativa/procesos/TOA orden liquidacion/shared/index.ts` | `TOAOrdenLiquidacionENTITY` | ✅ |
151
- | `operativa/procesos/TOA orden liquidacion_db/shared/index.ts` | `TOAOrdenLiquidacionENTITYDB` | ✅ Línea 21 |
152
- | `operativa/procesos/TOA order stock/shared/index.ts` | `TOAOrderStockENTITY` | ✅ |
153
- | `operativa/procesos/toa_claro/shared/index.ts` | `ToaClaroENTITY` | ✅ |
154
- | `operativa/procesos/toa_movistar/shared/index.ts` | `Peru9112TOAENTITY` | ✅ Línea 30 |
155
- | `operativa/procesos/toa_movistar_db/shared/index.ts` | `Peru9112TOAENTITYDB` | ✅ Línea 27 |
156
- | `operativa/procesos/tuves/shared/index.ts` | `TuvesENTITY` | ✅ Línea 30 |
157
- | `operativa/procesos/tuves_order_stock/shared/index.ts` | `TuvesOrderStockENTITY` | ✅ |
158
- | `operativa/procesos/win_order/shared/index.ts` | `Peru9112WinENTITY` | ❌ `resource_id` (equivalente a `_id`) |
159
- | `operativa/procesos/win_order_db/shared/index.ts` | `Peru9112WinENTITYDB` | ❌ `resource_id` (equivalente a `_id`) |
160
-
161
- ---
162
-
163
- ## ❌ CARPETA 3: Estructura incorrecta general
164
-
165
- **Patrón actual incorrecto (la mayoría de carpetas):**
166
- ```
167
- carpeta-con-espacios/
168
- shared/
169
- index.ts ← contiene: Entity + DTOs + _id todo mezclado
170
- ```
171
-
172
- **Patrón correcto (patrón de referencia `navisionpreorden`):**
173
- ```
174
- carpeta-con-guiones/
175
- shared/
176
- dto/
177
- nombre-dto.ts
178
- otro-dto.ts
179
- nombre-entity.ts ← solo la Entity aquí
180
- index.ts ← solo: export * from './nombre-entity'
181
- ```
182
-
183
- ---
184
-
185
- ## 📋 Resumen de problemas por prioridad
186
-
187
- | Prioridad | Problema | Cantidad | Impacto |
188
- |---|---|---|---|
189
- | **P0** | `_id` en Entities | 23 carpetas | Error de validación MongoDB: `_id must be a string` |
190
- | **P0** | Entity + DTOs mezclados en `shared/index.ts` | 30 carpetas | Confusión de imports, violación de separación de responsabilidades |
191
- | **P1** | Nombres de carpetas con espacios (sin guiones) | 47 carpetas | Inconsistencia con patrón LatasOS, problemas de import en Windows |
192
- | **P2** | `shared/index.ts` sin carpeta `dto/` separada | 30 carpetas | DTOs no reutilizables, archivo index.ts inflado |
193
-
194
- ---
195
-
196
- ## 📐 Patrón correcto de referencia
197
-
198
- Archivo: `navisionpreorden/shared/navisionpreorden-entity.ts`
199
-
200
- ```typescript
201
- // ✅ Sin _id
202
- // ✅ Solo la Entity
203
- // ✅ DTOs en carpeta shared/dto/
204
- // ✅ Nombre de carpeta con guiones
205
- // ✅ ID principal como número (ID_NavisionpreordenEntity)
206
- ```
207
-
208
- ---
209
-
210
- ## 🔧 Acciones requeridas
211
-
212
- 1. **P0 — Eliminar `_id`** de 20 carpetas restantes (incluyendo `resource_id` y `line_id` como equivalentes) — 3 ya corregidas: `theme-config-country`, `theme-config-user`, `scraping-credential`
213
- 2. **P0 — Separar DTOs de Entities** en 27 carpetas restantes — 3 ya corregidas: `theme-config-country`, `theme-config-user`, `scraping-credential`
214
- 3. **P1 — Renombrar carpetas** de 44 carpetas restantes — 3 ya corregidas: `theme-config-country`, `theme-config-user`, `scraping-credential`
215
- 4. **P2 — Actualizar `shared/index.ts`** en 27 carpetas restantes — 3 ya corregidas
1
+ # Reporte — Estructura de sigo-entities
2
+
3
+ **Fecha:** 2026-08-31
4
+ **Autor:** Brayan Andrés Valero Pinzón — Hermes Agent (sigo-frontend-dev)
5
+ **Destinatario:** Ingeniero Josue — Repositorio `sigo-entities`
6
+
7
+ ---
8
+
9
+ ## Resumen
10
+
11
+ Se detectaron **47 carpetas con nombres incorrectos** (sin guiones), **30 archivos `shared/index.ts` con Entity + DTO + `_id` mezclados**, y **3 carpetas en configuracion que ya fueron corregidas**.
12
+
13
+ ---
14
+
15
+ ## ✅ CORREGIDAS (3 archivos)
16
+
17
+ Las siguientes 3 Entities fueron corregidas siguiendo el patrón correcto:
18
+
19
+ | Carpeta | Archivos creados | Cambios |
20
+ |---|---|---|
21
+ | `theme config country` | `shared/theme-config-country-entity.ts` | Eliminado `_id`, DTOs inline en entity.ts, `shared/index.ts` solo exporta entity |
22
+ | `theme config user` | `shared/dto/favorito-dto.ts` + `shared/theme-config-user-entity.ts` | Eliminado `_id`, DTOs separados en carpeta `dto/`, `shared/index.ts` solo exporta entity |
23
+ | `scraping credential` | `shared/scraping-credential-entity.ts` | Eliminado `_id`, `shared/index.ts` solo exporta entity |
24
+
25
+ **Patrón aplicado:**
26
+ ```
27
+ carpeta/
28
+ shared/
29
+ dto/
30
+ nombre-dto.ts ← DTOs aquí
31
+ nombre-entity.ts ← solo la Entity aquí
32
+ index.ts ← solo export * from './nombre-entity'
33
+ ```
34
+
35
+ ---
36
+
37
+ ## ❌ CARPETA 1: Carpetas con nombres SIN guiones (47 carpetas)
38
+
39
+ **Regla:** Nombres compuestos deben usar guiones (`-`) en lugar de espacios.
40
+
41
+ ### Configuración (10 carpetas)
42
+ | Actual | Debería ser |
43
+ |---|---|
44
+ | `cargo personal` | `cargo-personal` |
45
+ | `contrato ot` | `contrato-ot` |
46
+ | `opcion sistema` | `opcion-sistema` |
47
+ | ~~`scraping credential`~~ | ~~`scraping-credential`~~ ✅ renombrada |
48
+ | ~~`theme config country`~~ | ~~`theme-config-country`~~ ✅ renombrada |
49
+ | ~~`theme config user`~~ | ~~`theme-config-user`~~ ✅ renombrada |
50
+ | `tipo clave` | `tipo-clave` |
51
+ | `tipo especialidad mo` | `tipo-especialidad-mo` |
52
+ | `tipo opcion sistema` | `tipo-opcion-sistema` |
53
+ | `usuarios autoinventario` | `usuarios-autoinventario` |
54
+
55
+ ### Administración (8 carpetas)
56
+ | Actual | Debería ser |
57
+ |---|---|
58
+ | `chile 9512 paquetizado mano obra` | `chile-9512-paquetizado-mano-obra` |
59
+ | `chile 9512 paquetizado material` | `chile-9512-paquetizado-material` |
60
+ | `key integracion` | `key-integracion` |
61
+ | `mail structure` | `mail-structure` |
62
+ | `precio especialidad` | `precio-especialidad` |
63
+ | `precio material` | `precio-material` |
64
+ | `unidad obra material` | `unidad-obra-material` |
65
+ | `zona trabajo` | `zona-trabajo` |
66
+
67
+ ### Logística (17 carpetas)
68
+ | Actual | Debería ser |
69
+ |---|---|
70
+ | `almacen extra` | `almacen-extra` |
71
+ | `atencion ordenes liquidadas` | `atencion-ordenes-liquidadas` |
72
+ | `consumo material` | `consumo-material` |
73
+ | `consumos P117` | `consumos-P117` |
74
+ | `devolucion almacen` | `devolucion-almacen` |
75
+ | `gran familia item` | `gran-familia-item` |
76
+ | `ingreso almacen` | `ingreso-almacen` |
77
+ | `movimiento almacen` | `movimiento-almacen` |
78
+ | `salida almacen` | `salida-almacen` |
79
+ | `stock almacen` | `stock-almacen` |
80
+ | `stock almacen equipos` | `stock-almacen-equipos` |
81
+ | `stock personal` | `stock-personal` |
82
+ | `stock personal equipos` | `stock-personal-equipos` |
83
+ | `tipo almacen` | `tipo-almacen` |
84
+ | `tipo movimiento almacen` | `tipo-movimiento-almacen` |
85
+ | `tipo stock` | `tipo-stock` |
86
+ | `transaccion folios` | `transaccion-folios` |
87
+ | `unidad medida` | `unidad--medida` |
88
+
89
+ ### Programados (10 carpetas)
90
+ | Actual | Debería ser |
91
+ |---|---|
92
+ | `centro costos` | `centro-costos` |
93
+ | `mano obra global` | `mano-obra-global` |
94
+ | `rm actividad` | `rm-actividad` |
95
+ | `rm comuna` | `rm-comuna` |
96
+ | `rm mano obra` | `rm-mano-obra` |
97
+ | `rm paquetizado` | `rm-paquetizado` |
98
+ | `tipo actividad mo` | `tipo-actividad-mo` |
99
+ | `tipo obra` | `tipo-obra` |
100
+ | `model mo sql` | `model-mo-sql` |
101
+ | `model obra sql` | `model-obra-sql` |
102
+
103
+ ### Operativa (7 carpetas)
104
+ | Actual | Debería ser |
105
+ |---|---|
106
+ | `order stock` | `order-stock` |
107
+ | `order stock store` | `order-stock-store` |
108
+ | `request number TTL` | `request-number-TTL` |
109
+ | `Tdc order stock` | `Tdc-order-stock` |
110
+ | `TOA Claro order stock` | `TOA-Claro-order-stock` |
111
+ | `TOA orden liquidacion` | `TOA-orden-liquidacion` |
112
+ | `TOA order stock` | `TOA-order-stock` |
113
+
114
+ ---
115
+
116
+ ## ❌ CARPETA 2: `shared/index.ts` con Entity + DTO + `_id` mezclados (30 carpetas)
117
+
118
+ **Regla:** `shared/index.ts` debe contener SOLO la Entity. Los DTOs deben estar en `shared/dto/`.
119
+
120
+ ### Configuración (3 carpetas — ya corregidas)
121
+ | Carpeta | Entity | DTOs presentes | `_id` | Estado |
122
+ |---|---|---|---|---|
123
+ | `configuracion/ theme-config-country/shared/index.ts` | `ThemeConfigCountryENTITY` | `ImgLogoNavBarDTO`, `ThemeCountryManualDTO` | ✅ Línea 50 | ✅ CORREGIDA (carpeta renombrada, DTOs en `shared/dto/`, `_id` eliminado) |
124
+ | `configuracion/ theme-config-user/shared/index.ts` | `ThemeConfigUserENTITY` | `FavoritoDTO` | ✅ Línea 33 | ✅ CORREGIDA (carpeta renombrada, DTOs en `shared/dto/`, `_id` eliminado) |
125
+ | `configuracion/ scraping-credential/shared/index.ts` | `ScrapingCredentialENTITY` | `CodigoNombreDTO` | ✅ Línea 10 | ✅ CORREGIDA (carpeta renombrada, `_id` eliminado) |
126
+
127
+ ### Logística (2 carpetas)
128
+ | Carpeta | Entity | DTOs presentes | `_id` |
129
+ |---|---|---|---|
130
+ | `logistica/stock personal/shared/index.ts` | `StockPersonalENTITY` | Varios | ✅ |
131
+ | `logistica/stock personal equipos/shared/index.ts` | `StockPersonalEquiposENTITY` | Varios | ✅ |
132
+
133
+ ### Operativa/Procesos (25 carpetas)
134
+ | Carpeta | Entity | `_id` |
135
+ |---|---|---|
136
+ | `operativa/procesos/altas_nvt_order/shared/index.ts` | `AltasNVTOrderENTITY` | ✅ Línea 35 |
137
+ | `operativa/procesos/bantel/shared/index.ts` | `BantelENTITY` | ❌ `resource_id` (equivalente a `_id`) |
138
+ | `operativa/procesos/claro_peru9112/shared/index.ts` | `Peru9112ClaroENTITY` | ✅ Línea 32 |
139
+ | `operativa/procesos/cliente_waoo/shared/index.ts` | `ClienteWAOOENTITY` | ❌ `line_id` (equivalente a `_id`) |
140
+ | `operativa/procesos/fibramas_order/shared/index.ts` | `Peru9112FibramasENTITY` | ❌ `resource_id` (equivalente a `_id`) |
141
+ | `operativa/procesos/fibramas_order_db/shared/index.ts` | `Peru9112FibramasENTITYDB` | ❌ `resource_id` (equivalente a `_id`) |
142
+ | `operativa/procesos/mifibra_db/shared/index.ts` | `MiFibraENTITYDB` | ❌ `resource_id` (equivalente a `_id`) |
143
+ | `operativa/procesos/order stock/shared/index.ts` | `OrderStockENTITY` | ✅ |
144
+ | `operativa/procesos/order stock store/shared/index.ts` | `OrderStockStoreENTITY` | ✅ |
145
+ | `operativa/procesos/request number TTL/shared/index.ts` | `RequestNumberTTLENTITY` | ✅ Línea 14 |
146
+ | `operativa/procesos/somacyl_order/shared/index.ts` | `SomacylOrderENTITY` | ✅ Línea 32 |
147
+ | `operativa/procesos/stb_dth_toaperu/shared/index.ts` | `STB_DTH_ToaENTITY` | ✅ |
148
+ | `operativa/procesos/Tdc order stock/shared/index.ts` | `TdcOrderStockENTITY` | ✅ |
149
+ | `operativa/procesos/TOA Claro order stock/shared/index.ts` | `TOAClaroOrderStockENTITY` | ✅ |
150
+ | `operativa/procesos/TOA orden liquidacion/shared/index.ts` | `TOAOrdenLiquidacionENTITY` | ✅ |
151
+ | `operativa/procesos/TOA orden liquidacion_db/shared/index.ts` | `TOAOrdenLiquidacionENTITYDB` | ✅ Línea 21 |
152
+ | `operativa/procesos/TOA order stock/shared/index.ts` | `TOAOrderStockENTITY` | ✅ |
153
+ | `operativa/procesos/toa_claro/shared/index.ts` | `ToaClaroENTITY` | ✅ |
154
+ | `operativa/procesos/toa_movistar/shared/index.ts` | `Peru9112TOAENTITY` | ✅ Línea 30 |
155
+ | `operativa/procesos/toa_movistar_db/shared/index.ts` | `Peru9112TOAENTITYDB` | ✅ Línea 27 |
156
+ | `operativa/procesos/tuves/shared/index.ts` | `TuvesENTITY` | ✅ Línea 30 |
157
+ | `operativa/procesos/tuves_order_stock/shared/index.ts` | `TuvesOrderStockENTITY` | ✅ |
158
+ | `operativa/procesos/win_order/shared/index.ts` | `Peru9112WinENTITY` | ❌ `resource_id` (equivalente a `_id`) |
159
+ | `operativa/procesos/win_order_db/shared/index.ts` | `Peru9112WinENTITYDB` | ❌ `resource_id` (equivalente a `_id`) |
160
+
161
+ ---
162
+
163
+ ## ❌ CARPETA 3: Estructura incorrecta general
164
+
165
+ **Patrón actual incorrecto (la mayoría de carpetas):**
166
+ ```
167
+ carpeta-con-espacios/
168
+ shared/
169
+ index.ts ← contiene: Entity + DTOs + _id todo mezclado
170
+ ```
171
+
172
+ **Patrón correcto (patrón de referencia `navisionpreorden`):**
173
+ ```
174
+ carpeta-con-guiones/
175
+ shared/
176
+ dto/
177
+ nombre-dto.ts
178
+ otro-dto.ts
179
+ nombre-entity.ts ← solo la Entity aquí
180
+ index.ts ← solo: export * from './nombre-entity'
181
+ ```
182
+
183
+ ---
184
+
185
+ ## 📋 Resumen de problemas por prioridad
186
+
187
+ | Prioridad | Problema | Cantidad | Impacto |
188
+ |---|---|---|---|
189
+ | **P0** | `_id` en Entities | 23 carpetas | Error de validación MongoDB: `_id must be a string` |
190
+ | **P0** | Entity + DTOs mezclados en `shared/index.ts` | 30 carpetas | Confusión de imports, violación de separación de responsabilidades |
191
+ | **P1** | Nombres de carpetas con espacios (sin guiones) | 47 carpetas | Inconsistencia con patrón LatasOS, problemas de import en Windows |
192
+ | **P2** | `shared/index.ts` sin carpeta `dto/` separada | 30 carpetas | DTOs no reutilizables, archivo index.ts inflado |
193
+
194
+ ---
195
+
196
+ ## 📐 Patrón correcto de referencia
197
+
198
+ Archivo: `navisionpreorden/shared/navisionpreorden-entity.ts`
199
+
200
+ ```typescript
201
+ // ✅ Sin _id
202
+ // ✅ Solo la Entity
203
+ // ✅ DTOs en carpeta shared/dto/
204
+ // ✅ Nombre de carpeta con guiones
205
+ // ✅ ID principal como número (ID_NavisionpreordenEntity)
206
+ ```
207
+
208
+ ---
209
+
210
+ ## 🔧 Acciones requeridas
211
+
212
+ 1. **P0 — Eliminar `_id`** de 20 carpetas restantes (incluyendo `resource_id` y `line_id` como equivalentes) — 3 ya corregidas: `theme-config-country`, `theme-config-user`, `scraping-credential`
213
+ 2. **P0 — Separar DTOs de Entities** en 27 carpetas restantes — 3 ya corregidas: `theme-config-country`, `theme-config-user`, `scraping-credential`
214
+ 3. **P1 — Renombrar carpetas** de 44 carpetas restantes — 3 ya corregidas: `theme-config-country`, `theme-config-user`, `scraping-credential`
215
+ 4. **P2 — Actualizar `shared/index.ts`** en 27 carpetas restantes — 3 ya corregidas
@@ -0,0 +1,58 @@
1
+ // Ejecutar tras `npm run build`: npm test
2
+ import { test } from "node:test";
3
+ import assert from "node:assert/strict";
4
+ import {
5
+ validateAndFormatData,
6
+ AltasNVTOrderENTITY,
7
+ ReabrirAltasNVTDTO,
8
+ StateInternalOrderAltasNVT,
9
+ AddressClassification,
10
+ } from "../dist/index.mjs";
11
+
12
+ const ordenSinDocumentacionAdicional = () => {
13
+ const orden = Object.assign({}, new AltasNVTOrderENTITY(), {
14
+ _id: "2f1b8a7e-4c3d-4e5f-9a6b-7c8d9e0f1a2b",
15
+ classification: AddressClassification.UNIFAMILIAR,
16
+ documentation: [],
17
+ mo: [],
18
+ });
19
+ delete orden.documentacion_adicional;
20
+ return orden;
21
+ };
22
+
23
+ const reapertura = (overrides) => ({
24
+ numero_de_peticion: "AL04-26036",
25
+ estado_destino: StateInternalOrderAltasNVT.PENDIENTE,
26
+ id_recurso: "",
27
+ motivo: "Cliente volvió a solicitar la visita",
28
+ ...overrides,
29
+ });
30
+
31
+ test("AltasNVTOrderENTITY: orden existente sin documentacion_adicional sigue validando", async () => {
32
+ await assert.doesNotReject(validateAndFormatData(ordenSinDocumentacionAdicional(), AltasNVTOrderENTITY));
33
+ });
34
+
35
+ test("AltasNVTOrderENTITY: documentacion_adicional que no es arreglo se rechaza", async () => {
36
+ const orden = { ...ordenSinDocumentacionAdicional(), documentacion_adicional: "x" };
37
+ await assert.rejects(validateAndFormatData(orden, AltasNVTOrderENTITY));
38
+ });
39
+
40
+ test("ReabrirAltasNVTDTO: destino Pendiente no exige id_recurso", async () => {
41
+ await assert.doesNotReject(validateAndFormatData(reapertura(), ReabrirAltasNVTDTO));
42
+ });
43
+
44
+ test("ReabrirAltasNVTDTO: destino Asignado exige id_recurso", async () => {
45
+ const sinRecurso = reapertura({ estado_destino: StateInternalOrderAltasNVT.ASIGNADO });
46
+ const conRecurso = reapertura({ estado_destino: StateInternalOrderAltasNVT.ASIGNADO, id_recurso: "TEC01" });
47
+ await assert.rejects(validateAndFormatData(sinRecurso, ReabrirAltasNVTDTO));
48
+ await assert.doesNotReject(validateAndFormatData(conRecurso, ReabrirAltasNVTDTO));
49
+ });
50
+
51
+ test("ReabrirAltasNVTDTO: motivo de 5 caracteres se rechaza", async () => {
52
+ await assert.rejects(validateAndFormatData(reapertura({ motivo: "corto" }), ReabrirAltasNVTDTO));
53
+ });
54
+
55
+ test("ReabrirAltasNVTDTO: estado destino fuera de Pendiente/Asignado se rechaza", async () => {
56
+ const finalizada = reapertura({ estado_destino: StateInternalOrderAltasNVT.FINALIZADA });
57
+ await assert.rejects(validateAndFormatData(finalizada, ReabrirAltasNVTDTO));
58
+ });
@@ -0,0 +1,67 @@
1
+ // Ejecutar tras `npm run build`: npm test
2
+ import { test } from "node:test";
3
+ import assert from "node:assert/strict";
4
+ import {
5
+ toFechaKey,
6
+ mapAsistenciaToCuadrillaOrden,
7
+ validateAndFormatData,
8
+ CuadrillaBtAlpPluzOrder2DTO,
9
+ EstadoIntegranteCuadrilla,
10
+ OrigenIntegrante,
11
+ AttendanceStatus,
12
+ } from "../dist/index.mjs";
13
+
14
+ test("toFechaKey: 23:30 hora Lima no corre al día siguiente", () => {
15
+ assert.equal(toFechaKey(new Date("2026-10-04T23:30:00-05:00")), "2026-10-04");
16
+ });
17
+
18
+ test("toFechaKey: medianoche UTC es el día anterior en Lima", () => {
19
+ assert.equal(toFechaKey(new Date("2026-10-05T00:00:00Z")), "2026-10-04");
20
+ });
21
+
22
+ test("toFechaKey: fin de mes y fin de año", () => {
23
+ assert.equal(toFechaKey(new Date("2026-11-01T03:00:00Z")), "2026-10-31");
24
+ assert.equal(toFechaKey(new Date("2027-01-01T04:59:59Z")), "2026-12-31");
25
+ });
26
+
27
+ const integrante = (overrides) => ({
28
+ Identificacion: "", Apellidos: "AP", Nombres: "NOM", Cargo: "TECNICO", PesoPersonal: 1, IdRecurso: "",
29
+ EsJefeTitular: false, EsJefe: false, Origen: OrigenIntegrante.TITULAR,
30
+ Estado: EstadoIntegranteCuadrilla.PRESENTE, Motivo: "", Observacion: "",
31
+ ...overrides,
32
+ });
33
+
34
+ const asistencia = {
35
+ Cuadrilla: { ID_Cuadrilla: 12, Codigo: "CUA-012", Nombre: "Cuadrilla 12" },
36
+ Integrantes: [
37
+ integrante({ Identificacion: "1", Cargo: "JEFE DE CUADRILLA", EsJefeTitular: true, Estado: EstadoIntegranteCuadrilla.AUSENTE, Motivo: AttendanceStatus.DescansoMedico }),
38
+ integrante({ Identificacion: "2", EsJefe: true, IdRecurso: "R2" }),
39
+ integrante({ Identificacion: "3", Estado: EstadoIntegranteCuadrilla.CEDIDO, CuadrillaDestino: { ID_Cuadrilla: 20, Codigo: "CUA-020", Nombre: "" } }),
40
+ integrante({ Identificacion: "99", Origen: OrigenIntegrante.PRESTADO, CuadrillaOrigen: { ID_Cuadrilla: 7, Codigo: "CUA-007", Nombre: "" } }),
41
+ ],
42
+ };
43
+
44
+ test("mapAsistenciaToCuadrillaOrden: excluye AUSENTE y CEDIDO", () => {
45
+ const cuadrilla = mapAsistenciaToCuadrillaOrden(asistencia);
46
+ assert.deepEqual(cuadrilla.map((m) => m.Identificacion), ["2", "99"]);
47
+ assert.ok(cuadrilla.every((m) => m instanceof CuadrillaBtAlpPluzOrder2DTO));
48
+ });
49
+
50
+ test("mapAsistenciaToCuadrillaOrden: marca al suplente", () => {
51
+ const suplente = mapAsistenciaToCuadrillaOrden(asistencia).find((m) => m.Identificacion === "2");
52
+ assert.equal(suplente.EsJefe, true);
53
+ assert.equal(suplente.EsJefeSuplente, true);
54
+ assert.equal(suplente.IdRecurso, "R2");
55
+ });
56
+
57
+ test("mapAsistenciaToCuadrillaOrden: prestado lleva Codigo destino y CodigoCuadrillaOrigen", () => {
58
+ const prestado = mapAsistenciaToCuadrillaOrden(asistencia).find((m) => m.Identificacion === "99");
59
+ assert.equal(prestado.Codigo, "CUA-012");
60
+ assert.equal(prestado.CodigoCuadrillaOrigen, "CUA-007");
61
+ assert.equal(prestado.Origen, OrigenIntegrante.PRESTADO);
62
+ });
63
+
64
+ test("CuadrillaBtAlpPluzOrder2DTO: documento antiguo sin campos nuevos valida", async () => {
65
+ const antiguo = { Codigo: "CUA-1", Identificacion: "1", Apellidos: "A", Nombres: "N", Cargo: "TECNICO", PesoPersonal: 1 };
66
+ await assert.doesNotReject(validateAndFormatData(antiguo, CuadrillaBtAlpPluzOrder2DTO));
67
+ });
@@ -0,0 +1,89 @@
1
+ // Ejecutar tras `npm run build`: npm test
2
+ import { test } from "node:test";
3
+ import assert from "node:assert/strict";
4
+ import {
5
+ validateAndFormatData,
6
+ GridPreferenciaUsuarioEntity,
7
+ UpsertGridPreferenciaUsuarioDto,
8
+ FindGridPreferenciaUsuarioDto,
9
+ MAX_GRID_COLUMNAS,
10
+ } from "../dist/index.mjs";
11
+
12
+ const columnas = (overrides) => ({
13
+ order: ["Orden", "Fecha", "Distrito"],
14
+ hidden: ["Tecnico"],
15
+ widths: { Distrito: 160 },
16
+ ...overrides,
17
+ });
18
+
19
+ const documento = (overrides) => ({
20
+ ...new GridPreferenciaUsuarioEntity(),
21
+ _id: "2f1b8a7e-4c3d-4e5f-9a6b-7c8d9e0f1a2b",
22
+ ID_GridPreferencia: 1731400000000,
23
+ Identificacion: "123456AL01",
24
+ GridKey: "OperativaEnel.BT_ALP_PLUZ.principal",
25
+ Columnas: columnas(),
26
+ FechaRegistro: "2026-11-12T15:00:00Z",
27
+ FechaModificacion: "2026-11-12T15:00:00Z",
28
+ ...overrides,
29
+ });
30
+
31
+ const campos = (n) => Array.from({ length: n }, (_, i) => `c${i}`);
32
+
33
+ test("entidad: acepta un documento válido y convierte fechas", async () => {
34
+ const res = await validateAndFormatData(documento(), GridPreferenciaUsuarioEntity);
35
+ assert.deepEqual(res.Columnas.widths, { Distrito: 160 });
36
+ assert.ok(res.FechaRegistro instanceof Date);
37
+ });
38
+
39
+ test("entidad: rechaza widths no numérico", async () => {
40
+ const doc = documento({ Columnas: columnas({ widths: { Distrito: "160" } }) });
41
+ await assert.rejects(validateAndFormatData(doc, GridPreferenciaUsuarioEntity), /widths/);
42
+ });
43
+
44
+ test("upsert: acepta GridKey + Columnas", async () => {
45
+ const body = { GridKey: "OperativaEnel.BT_ALP_PLUZ.principal", Columnas: columnas() };
46
+ const res = await validateAndFormatData(body, UpsertGridPreferenciaUsuarioDto);
47
+ assert.deepEqual(res.Columnas.order, ["Orden", "Fecha", "Distrito"]);
48
+ });
49
+
50
+ test("upsert: no deja pasar Identificacion del body", async () => {
51
+ const body = { GridKey: "a.b.c", Columnas: columnas(), Identificacion: "OTRO" };
52
+ const res = await validateAndFormatData(body, UpsertGridPreferenciaUsuarioDto);
53
+ assert.equal(res.Identificacion, undefined);
54
+ });
55
+
56
+ test("upsert: rechaza widths con valor no numérico, negativo o NaN", async () => {
57
+ const invalidos = [{ a: "100" }, { a: -5 }, { a: 0 }, { a: null }, ["a"]];
58
+ const intentos = invalidos.map((widths) =>
59
+ assert.rejects(validateAndFormatData({ GridKey: "a.b.c", Columnas: columnas({ widths }) }, UpsertGridPreferenciaUsuarioDto)));
60
+ await Promise.all(intentos);
61
+ });
62
+
63
+ test(`upsert: rechaza más de ${MAX_GRID_COLUMNAS} columnas en order, hidden o widths`, async () => {
64
+ const muchas = campos(MAX_GRID_COLUMNAS + 1);
65
+ const anchos = Object.fromEntries(muchas.map((c) => [c, 100]));
66
+ const casos = [{ order: muchas }, { hidden: muchas }, { widths: anchos }];
67
+ const intentos = casos.map((c) =>
68
+ assert.rejects(validateAndFormatData({ GridKey: "a.b.c", Columnas: columnas(c) }, UpsertGridPreferenciaUsuarioDto), /200/));
69
+ await Promise.all(intentos);
70
+ });
71
+
72
+ test(`upsert: acepta exactamente ${MAX_GRID_COLUMNAS} columnas`, async () => {
73
+ const justas = campos(MAX_GRID_COLUMNAS);
74
+ const anchos = Object.fromEntries(justas.map((c) => [c, 100]));
75
+ const body = { GridKey: "a.b.c", Columnas: columnas({ order: justas, hidden: justas, widths: anchos }) };
76
+ const res = await validateAndFormatData(body, UpsertGridPreferenciaUsuarioDto);
77
+ assert.equal(res.Columnas.order.length, MAX_GRID_COLUMNAS);
78
+ });
79
+
80
+ test("upsert: rechaza order con elementos que no son texto", async () => {
81
+ const body = { GridKey: "a.b.c", Columnas: columnas({ order: ["Orden", 5] }) };
82
+ await assert.rejects(validateAndFormatData(body, UpsertGridPreferenciaUsuarioDto), /order/);
83
+ });
84
+
85
+ test("find: acepta lista de GridKeys y rechaza vacía", async () => {
86
+ const res = await validateAndFormatData({ GridKeys: ["a.b.c", "a.b.d"] }, FindGridPreferenciaUsuarioDto);
87
+ assert.equal(res.GridKeys.length, 2);
88
+ await assert.rejects(validateAndFormatData({ GridKeys: [] }, FindGridPreferenciaUsuarioDto));
89
+ });