Saltar al contenido principal

SOL-006 Solicitudes Masivas (Fase 3)

· 2 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

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)​

  1. Una fila = una solicitud con un producto (ideal contratación).
  2. Parcial: se crean las válidas, errores por fila para corrección.
  3. Tolerante: oficina por nombre o ID, producto por SKU o ID.
  4. 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 --noEmit EXIT 0 (api + web).
  • migration:run → 020 aplicada (cargas_masivas + detalle_carga_masiva).
  • npm test cargas-masivas → 2/2 verdes.