Alcance Técnico del MVP

6 capacidades

Detalle de las 6 capacidades críticas del MVP con sus componentes técnicos, rutas API y modelos de datos.

1

Alta de Proyectos

CAP-01

Crear, editar y visualizar proyectos de construcción con datos generales: nombre, cliente, ubicación, fecha inicio/fin estimada, responsable y estado.

Componentes Técnicos

  • ProyectoForm (componente formulario)
  • ProyectoCard (tarjeta resumen)
  • ProyectoList (listado con filtros)
  • API /api/proyectos (CRUD)
  • useProyectos (hook de estado)

Rutas API

  • GET /api/proyectos
  • POST /api/proyectos
  • PUT /api/proyectos/[id]
  • DELETE /api/proyectos/[id]

Modelos de Datos

  • Proyecto { id, nombre, cliente, ubicacion, fechaInicio, fechaFin, responsable, estado, creadoEn }
2

Carga por Partidas

CAP-02

Definir la estructura de partidas (líneas de trabajo) dentro de un proyecto: código, descripción, unidad de medida, cantidad y precio unitario. Soportar agrupación por categorías.

Componentes Técnicos

  • PartidaForm (alta/edición de partida)
  • PartidaTable (tabla editable)
  • CategoriaGroup (agrupador visual)
  • API /api/proyectos/[id]/partidas (CRUD)
  • usePartidas (hook de estado)

Rutas API

  • GET /api/proyectos/[id]/partidas
  • POST /api/proyectos/[id]/partidas
  • PUT /api/proyectos/[id]/partidas/[pid]
  • DELETE /api/proyectos/[id]/partidas/[pid]

Modelos de Datos

  • Partida { id, proyectoId, categoria, codigo, descripcion, unidad, cantidad, precioUnitario, total }
3

Presupuesto Inicial

CAP-03

Consolidar automáticamente el presupuesto del proyecto sumando todas las partidas. Mostrar totales por categoría y total general. Permitir versionar el presupuesto.

Componentes Técnicos

  • PresupuestoResumen (dashboard de totales)
  • PresupuestoPorCategoria (desglose)
  • PresupuestoExport (exportar a CSV)
  • API /api/proyectos/[id]/presupuesto
  • usePresupuesto (hook calculado)

Rutas API

  • GET /api/proyectos/[id]/presupuesto
  • POST /api/proyectos/[id]/presupuesto/version

Modelos de Datos

  • Presupuesto { id, proyectoId, version, totalGeneral, fechaCreacion, partidas[] }
  • ResumenCategoria { categoria, subtotal, porcentaje }
4

Registro de Ejecutado

CAP-04

Registrar avances de ejecución por partida: cantidad ejecutada, monto ejecutado, fecha de registro y observaciones. Calcular porcentaje de avance automáticamente.

Componentes Técnicos

  • EjecutadoForm (registro de avance)
  • EjecutadoTimeline (historial de registros)
  • AvanceIndicator (barra de progreso)
  • API /api/proyectos/[id]/ejecutado
  • useEjecutado (hook de estado)

Rutas API

  • GET /api/proyectos/[id]/ejecutado
  • POST /api/proyectos/[id]/ejecutado
  • PUT /api/proyectos/[id]/ejecutado/[eid]

Modelos de Datos

  • RegistroEjecutado { id, partidaId, cantidadEjecutada, montoEjecutado, fecha, observaciones }
5

Tablero Planeado vs Real

CAP-05

Dashboard comparativo que muestra presupuesto planeado vs ejecutado real por partida y por categoría. Incluir indicadores de desviación, alertas por sobrecosto y gráficos de barras.

Componentes Técnicos

  • TableroComparativo (vista principal)
  • GraficoBarras (planeado vs real)
  • IndicadorDesviacion (semáforo)
  • AlertaSobrecosto (notificación)
  • API /api/proyectos/[id]/comparativo
  • useComparativo (hook calculado)

Rutas API

  • GET /api/proyectos/[id]/comparativo

Modelos de Datos

  • Comparativo { partidaId, planeado, ejecutado, desviacion, porcentajeDesviacion, alerta }
6

Cronograma Simple

CAP-06

Línea de tiempo visual tipo Gantt simplificado para mostrar fases y partidas del proyecto con fechas de inicio y fin planificadas vs reales. Permitir arrastrar para ajustar fechas.

Componentes Técnicos

  • CronogramaGantt (vista Gantt simplificada)
  • CronogramaBarras (barras de tiempo)
  • FaseRow (fila de fase)
  • API /api/proyectos/[id]/cronograma
  • useCronograma (hook de estado)

Rutas API

  • GET /api/proyectos/[id]/cronograma
  • PUT /api/proyectos/[id]/cronograma

Modelos de Datos

  • ItemCronograma { id, partidaId, fase, fechaInicioPlan, fechaFinPlan, fechaInicioReal, fechaFinReal, progreso }

Resumen de Mapeo Técnico

CapacidadComponentesEndpointsModelos
Alta de Proyectos541
Carga por Partidas541
Presupuesto Inicial522
Registro de Ejecutado531
Tablero Planeado vs Real611
Cronograma Simple521
Total31167