SOL-006 Solicitudes Masivas (Fase 3)
Implementación completa de solicitudes masivas: carga desde Excel/CSV (una fila = una solicitud), validación previa sin crear nada, modo parcial con errores por fila y soporte para procesos de contratación.
Qué cambió y por qué
Radicar decenas de solicitudes una por una frenaba la contratación. Ahora se diligencia una plantilla, se valida en seco y se procesa en parcial: las válidas se crean y las fallidas quedan reportadas para corrección sin bloquear el lote.
Decisiones (modo asistente 2026-10-01)
- Una fila = una solicitud con un producto (ideal contratación).
- Parcial: se crean las válidas, errores por fila para corrección.
- Tolerante: oficina por nombre o ID, producto por SKU o ID.
- Full: backend + frontend + wiki + ADR + migración ejecutada.
Archivos clave
- Backend:
src/domains/cargas-masivas/(entidades, servicio, controlador, módulo, spec),src/database/migrations/020-create-cargas-masivas.ts,app.module.ts. - Endpoints:
GET /api/cargas-masivas/plantilla,POST /api/cargas-masivas/validar,POST /api/cargas-masivas/procesar,GET /api/cargas-masivas,GET /api/cargas-masivas/:id,GET /api/cargas-masivas/:id/errores. - Frontend:
src/api/cargas-masivas.ts,src/pages/cargas-masivas.tsx,sidebar-option.ts(Solicitudes → Carga masiva). - Framework:
ARCHITECTURE.md(ADR-016),DATABASE_SCHEMA.md(§20, relaciones, reglas, migraciones). - Manual:
docs/manuales/solicitudes/carga-masiva.md.
Verificación
npx tsc --noEmitEXIT 0 (api + web).migration:run→020aplicada (cargas_masivas+detalle_carga_masiva).npm test cargas-masivas→ 2/2 verdes.