workspace-v1/projects/erp-construccion/docs/08-epicas/EPIC-MAI-005-control-obra.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

3.4 KiB

EPICA: EPIC-MAI-005 - Control de Obra y Avances

Metadata

Campo Valor
ID EPIC-MAI-005
Nombre Control de Obra y Avances
Modulo control-obra-avances
Fase Fase 1 - Alcance Inicial
Prioridad P0 (Critico)
Estado Backlog
Story Points 55
Sprint(s) Sprint 5-7

Descripcion

Sistema de control de avance de obra que permite registrar progreso por concepto, generar estimaciones de avance, comparar programa vs real, y visualizar el estado de construccion de cada vivienda. Incluye bitacora de obra electronica y registro fotografico.


Objetivo de Negocio

Proveer control de obra que:

  • Registre avance diario/semanal por concepto
  • Compare programa vs avance real
  • Identifique retrasos automaticamente
  • Genere estimaciones para pago
  • Documente con evidencia fotografica
  • Facilite toma de decisiones

Historias de Usuario

ID Historia Prioridad SP Estado
US-MAI005-001 Como residente, quiero registrar avance diario por concepto P0 8 Backlog
US-MAI005-002 Como residente, quiero comparar programa vs avance real P0 8 Backlog
US-MAI005-003 Como residente, quiero registrar bitacora de obra P0 5 Backlog
US-MAI005-004 Como residente, quiero capturar evidencia fotografica de avances P0 5 Backlog
US-MAI005-005 Como superintendente, quiero generar estimacion de periodo P0 8 Backlog
US-MAI005-006 Como director, quiero ver curva S de avance P1 8 Backlog
US-MAI005-007 Como director, quiero ver dashboard de retrasos P1 5 Backlog
US-MAI005-008 Como residente, quiero registrar incidencias de obra P1 5 Backlog
US-MAI005-009 Como superintendente, quiero aprobar avances reportados P1 3 Backlog

Total Story Points: 55 SP


Criterios de Aceptacion de la Epica

Funcionales:

  • Registro de avance por concepto (% o cantidad)
  • Programa de obra con Gantt
  • Comparativo programa vs real
  • Curva S de avance
  • Bitacora electronica con firmas
  • Galeria de fotos por vivienda/concepto
  • Generacion de estimaciones

No Funcionales:

  • Captura desde app movil (offline)
  • Sincronizacion automatica al conectar

Dependencias

Esta epica depende de:

Epica/Modulo Estado Bloqueante
EPIC-MAI-002 Proyectos Backlog Si
EPIC-MAI-003 Presupuestos Backlog Si

Esta epica bloquea:

Epica/Modulo Razon
EPIC-MAI-008 Estimaciones Avance para facturar
EPIC-MAI-011 INFONAVIT Avance para reportar

Desglose Tecnico

Database:

  • Schema: progress_management
  • Tablas: 8 (progress_records, schedules, schedule_items, logbook, logbook_entries, photos, estimations, incidents)

Backend:

  • Modulo: progress
  • Entities: 8
  • Endpoints: 22+
  • Tests: 35+

Frontend:

  • Paginas: 7 (Progress, Schedule, Logbook, Photos, Estimations, CurveS, Dashboard)
  • Componentes: GanttChart, ProgressForm, PhotoGallery, CurveSChart
  • Stores: 1 (progressStore)

App Movil:

  • Screens: ProgressCapture, PhotoCapture, LogbookEntry
  • Offline: SQLite local, sync queue

Creada por: Requirements-Analyst Fecha: 2025-12-05