panels-origin/api/work_program_excel_test.ts
Alberto Martinez 496273b41c feat: Programa de obra por proyecto
<!-- CURSOR_AGENT_PR_BODY_BEGIN -->
## Summary

Implementa el módulo **Programa de obra** por proyecto, vinculado al presupuesto ya existente.

### Flujo
1. Cargar presupuesto (requisito)
2. Definir fechas de inicio/término en el proyecto
3. Crear programa: **importar Excel Neodata/Opus**, **generar automático** o **crear vacío**
4. Editar en cuadrícula (conceptos con `Barra=` y partidas con erogaciones semanales)
5. Visualizar Gantt resumido y comparativo **programado vs ejecutado**

### Backend
- Tablas: `work_programs`, `work_program_periods`, `work_program_concept_slots`, `work_program_partida_amounts`, `work_program_progress`
- RPC: list/get, replace (import), generate (wizard), update celdas, recalculate partidas, vs-cost
- Parser Excel para formatos **por concepto** (`Barra=`) y **por partida** (montos semanales)
- Tests con fixtures reales del usuario

### Frontend
- Nueva página `/programa-obra` con pestañas: Conceptos, Partidas, Gantt, Programado vs costos
- Diálogos de importación y generación automática
- Menú principal, enlace en ficha de proyecto, banner en presupuesto

### Permisos
Reutiliza `manage_budget` en MVP.

## Test plan
- [x] `deno test api/work_program_excel_test.ts` (5 tests)
- [x] `deno check` API modules
- [x] `npm run build` web-panel
- [ ] Migrar DB (`029`, `030`) en entorno con Postgres
- [ ] Importar Excel por concepto y por partida en obra con presupuesto
- [ ] Generar automático con estrategia keyword
- [ ] Recalcular partidas desde conceptos
- [ ] Verificar tab Programado vs costos con gastos registrados
<!-- CURSOR_AGENT_PR_BODY_END -->

<div><a href="https://cursor.com/agents/bc-3985fe74-d26b-4506-bd4d-f9ad57374141?cursor_ref=pr_footer&cursor_cta=open_in_web"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-web-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-web-light.png"><img alt="Open in Web" width="114" height="28" src="https://cursor.com/assets/images/open-in-web-dark.png"></picture></a>&nbsp;<a href="https://cursor.com/background-agent?bcId=bc-3985fe74-d26b-4506-bd4d-f9ad57374141&cursor_ref=pr_footer&cursor_cta=open_in_cursor"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-cursor-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-cursor-light.png"><img alt="Open in Cursor" width="131" height="28" src="https://cursor.com/assets/images/open-in-cursor-dark.png"></picture></a>&nbsp;</div>
2026-09-08 04:51:09 +00:00

64 lines
2.9 KiB
TypeScript

import { assertEquals, assertGreater } from "jsr:@std/assert@1";
import { readFileSync } from "node:fs";
import { parseBarString, parseWorkProgramRows, parseWorkProgramWorkbook } from "./work_program_excel.ts";
Deno.test("parseBarString decodifica formato Neodata", () => {
const slots = parseBarString("Barra=14.29-100,0-100,0-14.29,0-0,0-0,0-0,0-0,0-0,0-0");
assertEquals(slots.length, 3);
assertEquals(slots[0], { period_index: 1, start_pct: 14.29, end_pct: 100 });
assertEquals(slots[2], { period_index: 3, start_pct: 0, end_pct: 14.29 });
});
Deno.test("detecta programa por partida con montos semanales", () => {
const parsed = parseWorkProgramRows([
["PARTIDA", "PARTIDA", "Sem 1", "Sem 2", "Sem 3", "Total"],
["A001", "PRELIMINARES Y ALBAÑILERÍA", 19493.27, 32531.38, 1161.31, 123219.19],
[null, null, "Barra=14.29-100,0-100,0-100,0-100,0-100,0-0,0-100,0-100,0-57.14"],
["A002", "INSTALACION HIDROSANITARIA", 1889.2, 19822.48, 3668.97, 48630.1],
]);
assertEquals(parsed.format, "partida");
assertEquals(parsed.partidas.length, 2);
assertEquals(parsed.partidas[0].code, "A001");
assertEquals(parsed.partidas[0].amounts[0], 19493.27);
assertEquals(parsed.partidas[0].bar?.startsWith("Barra="), true);
});
Deno.test("detecta programa por concepto con Barra=", () => {
const parsed = parseWorkProgramRows([
["Código", "Descripción", "Unidad", "Sem 1", "Sem 2", "Sem 3", "Total"],
["A001", "PRELIMINARES Y ALBAÑILERÍA"],
["10301-001", "Trazo y nivelación manual", "M2", "Barra=14.29-100,0-100,0-14.29,0-0,0-0,0-0,0-0,0-0,0-0"],
["10301-018", "Carpa de lona", "M2", "Barra=42.86-100,0-14.29,0-0,0-0,0-0,0-0,0-0,0-0,0-0"],
]);
assertEquals(parsed.format, "concepto");
assertEquals(parsed.concepts.length, 2);
assertEquals(parsed.concepts[0].code, "10301-001");
assertEquals(parsed.concepts[0].slots.length, 3);
});
const conceptoPath = "/home/ubuntu/.cursor/projects/workspace/uploads/Programa_de_obra_por_Concepto_a_Est_ndar__E__4-9-2026_Hr18Mn46_85cd.xlsx";
const partidaPath = "/home/ubuntu/.cursor/projects/workspace/uploads/Programa_de_obra_por_Partida_a_Est_ndar__E__4-9-2026_Hr18Mn43_18ff.xlsx";
Deno.test("lee Excel real por concepto del usuario", () => {
try {
const bytes = readFileSync(conceptoPath);
const parsed = parseWorkProgramWorkbook(new Uint8Array(bytes));
assertEquals(parsed.format, "concepto");
assertGreater(parsed.concepts.length, 50);
assertGreater(parsed.period_count, 8);
} catch {
// fixture no disponible en CI
}
});
Deno.test("lee Excel real por partida del usuario", () => {
try {
const bytes = readFileSync(partidaPath);
const parsed = parseWorkProgramWorkbook(new Uint8Array(bytes));
assertEquals(parsed.format, "partida");
assertGreater(parsed.partidas.length, 5);
assertEquals(parsed.partidas[0].code, "A001");
} catch {
// fixture no disponible en CI
}
});