rckrdmrd/workspace-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
d6c684611f
workspace-v1/projects/erp-construccion/docs/02-definicion-modulos/MAI-005-control-obra/implementacion/TRACEABILITY.yml
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

270 lines
10 KiB
YAML
Raw Blame History

# TRACEABILITY - MAI-005: Control de Obra
metadata:
modulo: MAI-005
nombre: Control de Obra
version: 1.0.0
fecha: 2025-12-06
reutilizacion_core: 0%
descripcion: Trazabilidad completa del módulo de Control de Obra
app_movil: MOB-003
app_movil_nombre: Supervisor
requerimientos:
- id: RF-OBRA-001
titulo: Registro de Avances Físicos
descripcion: Sistema para registrar y controlar el progreso físico de las obras
especificaciones:
- ET-OBRA-database
- ET-OBRA-backend
- ET-OBRA-frontend
- ET-OBRA-mobile
historias_usuario:
- HU-OBRA-001: Como supervisor, quiero registrar el avance físico de las partidas
- HU-OBRA-002: Como jefe de obra, quiero visualizar el progreso de las actividades
- HU-OBRA-003: Como director, quiero generar reportes de avance físico
- HU-OBRA-004: Como supervisor, quiero adjuntar fotografías del avance
tablas:
- construction_management.avances
- construction_management.avance_fotos
- construction_management.avance_partidas
- construction_management.avance_actividades
- construction_management.avance_historial
endpoints:
- POST /api/v1/obras/{obraId}/avances
- GET /api/v1/obras/{obraId}/avances
- GET /api/v1/obras/{obraId}/avances/{avanceId}
- PUT /api/v1/obras/{obraId}/avances/{avanceId}
- DELETE /api/v1/obras/{obraId}/avances/{avanceId}
- POST /api/v1/obras/{obraId}/avances/{avanceId}/fotos
- GET /api/v1/obras/{obraId}/avances/reporte
- GET /api/v1/obras/{obraId}/avances/progreso
componentes_ui:
- AvanceForm
- ProgressBar
- AvancesList
- AvanceDetail
- FotoGallery
- ProgressChart
- AvanceReportGenerator
app_movil: MOB-003
funcionalidad_movil:
- Registro de avances en campo
- Captura de fotografías
- Firma digital del supervisor
- Sincronización offline
estado: pendiente
prioridad: alta
dependencias:
- MAI-001 # Gestión de Proyectos
- MAI-002 # Planificación de Obras
- id: RF-OBRA-002
titulo: Control de Avances Financieros
descripcion: Sistema para controlar el progreso financiero y facturación de las obras
especificaciones:
- ET-OBRA-database
- ET-OBRA-backend
- ET-OBRA-frontend
- ET-OBRA-mobile
historias_usuario:
- HU-OBRA-005: Como administrador de obra, quiero registrar el avance financiero
- HU-OBRA-006: Como director financiero, quiero visualizar el flujo de efectivo
- HU-OBRA-007: Como contador, quiero generar estimaciones de obra
- HU-OBRA-008: Como gerente, quiero comparar avance físico vs financiero
tablas:
- construction_management.avances_financieros
- construction_management.estimaciones
- construction_management.estimacion_partidas
- construction_management.facturacion_obra
- construction_management.pagos_estimaciones
- construction_management.retenciones
endpoints:
- POST /api/v1/obras/{obraId}/avances-financieros
- GET /api/v1/obras/{obraId}/avances-financieros
- GET /api/v1/obras/{obraId}/avances-financieros/{avanceId}
- PUT /api/v1/obras/{obraId}/avances-financieros/{avanceId}
- POST /api/v1/obras/{obraId}/estimaciones
- GET /api/v1/obras/{obraId}/estimaciones
- GET /api/v1/obras/{obraId}/estimaciones/{estimacionId}
- POST /api/v1/obras/{obraId}/estimaciones/{estimacionId}/generar-pdf
- GET /api/v1/obras/{obraId}/flujo-efectivo
- GET /api/v1/obras/{obraId}/comparativa-fisico-financiero
componentes_ui:
- AvanceFinancieroForm
- EstimacionGenerator
- EstimacionList
- EstimacionDetail
- FlujoCajaChart
- ComparativaChart
- FacturacionPanel
- RetencionesTable
app_movil: MOB-003
funcionalidad_movil:
- Consulta de avances financieros
- Visualización de estimaciones
- Aprobación de estimaciones
estado: pendiente
prioridad: alta
dependencias:
- MAI-001 # Gestión de Proyectos
- MAI-002 # Planificación de Obras
- RF-OBRA-001 # Avances Físicos
- id: RF-OBRA-003
titulo: Gestión de Recursos en Obra
descripcion: Sistema para controlar el uso de recursos humanos, materiales y equipos
especificaciones:
- ET-OBRA-database
- ET-OBRA-backend
- ET-OBRA-frontend
- ET-OBRA-mobile
historias_usuario:
- HU-OBRA-009: Como supervisor, quiero registrar el personal asignado diariamente
- HU-OBRA-010: Como almacenista, quiero controlar el consumo de materiales
- HU-OBRA-011: Como jefe de maquinaria, quiero registrar el uso de equipos
- HU-OBRA-012: Como administrador, quiero optimizar la asignación de recursos
tablas:
- construction_management.recursos_obra
- construction_management.asignacion_personal
- construction_management.asistencia_personal
- construction_management.consumo_materiales
- construction_management.uso_equipos
- construction_management.control_inventario_obra
- construction_management.solicitudes_material
endpoints:
- POST /api/v1/obras/{obraId}/recursos/personal
- GET /api/v1/obras/{obraId}/recursos/personal
- POST /api/v1/obras/{obraId}/recursos/asistencia
- GET /api/v1/obras/{obraId}/recursos/asistencia
- POST /api/v1/obras/{obraId}/recursos/materiales
- GET /api/v1/obras/{obraId}/recursos/materiales
- POST /api/v1/obras/{obraId}/recursos/equipos
- GET /api/v1/obras/{obraId}/recursos/equipos
- POST /api/v1/obras/{obraId}/recursos/solicitudes
- GET /api/v1/obras/{obraId}/recursos/inventario
- GET /api/v1/obras/{obraId}/recursos/reporte-consumo
componentes_ui:
- AsignacionPersonalForm
- AsistenciaTable
- ConsumoMaterialesForm
- UsoEquiposForm
- InventarioObraList
- SolicitudMaterialForm
- ReporteConsumoChart
- RecursosOverview
app_movil: MOB-003
funcionalidad_movil:
- Registro de asistencia de personal
- Registro de consumo de materiales
- Registro de uso de equipos
- Solicitud de materiales
- Verificación de inventario
estado: pendiente
prioridad: media
dependencias:
- MAI-001 # Gestión de Proyectos
- MAI-003 # Gestión de Recursos
- id: RF-OBRA-004
titulo: Bitácora Digital de Obra
descripcion: Sistema digital para registro diario de eventos, incidencias y actividades
especificaciones:
- ET-OBRA-database
- ET-OBRA-backend
- ET-OBRA-frontend
- ET-OBRA-mobile
historias_usuario:
- HU-OBRA-013: Como supervisor, quiero registrar eventos diarios en la bitácora
- HU-OBRA-014: Como residente, quiero documentar incidencias con fotografías
- HU-OBRA-015: Como cliente, quiero consultar la bitácora de obra
- HU-OBRA-016: Como director, quiero generar reportes de incidencias
tablas:
- construction_management.bitacora
- construction_management.bitacora_entradas
- construction_management.bitacora_fotos
- construction_management.incidencias
- construction_management.clima_diario
- construction_management.visitas_obra
- construction_management.bitacora_firmas
endpoints:
- POST /api/v1/obras/{obraId}/bitacora/entradas
- GET /api/v1/obras/{obraId}/bitacora/entradas
- GET /api/v1/obras/{obraId}/bitacora/entradas/{entradaId}
- PUT /api/v1/obras/{obraId}/bitacora/entradas/{entradaId}
- DELETE /api/v1/obras/{obraId}/bitacora/entradas/{entradaId}
- POST /api/v1/obras/{obraId}/bitacora/entradas/{entradaId}/fotos
- POST /api/v1/obras/{obraId}/bitacora/incidencias
- GET /api/v1/obras/{obraId}/bitacora/incidencias
- POST /api/v1/obras/{obraId}/bitacora/clima
- POST /api/v1/obras/{obraId}/bitacora/visitas
- POST /api/v1/obras/{obraId}/bitacora/entradas/{entradaId}/firmar
- GET /api/v1/obras/{obraId}/bitacora/reporte
componentes_ui:
- BitacoraEntryForm
- BitacoraTimeline
- BitacoraDetail
- IncidenciaForm
- IncidenciasList
- ClimaWidget
- VisitaForm
- FirmaDigital
- BitacoraReportGenerator
- BitacoraCalendar
app_movil: MOB-003
funcionalidad_movil:
- Registro de entradas de bitácora
- Captura de fotografías
- Registro de incidencias
- Registro de clima
- Firma digital
- Consulta de bitácora histórica
- Modo offline con sincronización
estado: pendiente
prioridad: alta
dependencias:
- MAI-001 # Gestión de Proyectos
integraciones:
core:
- MGN-001: Gestión de Usuarios (autenticación y autorización)
- MGN-002: RBAC (control de permisos por rol)
- MGN-003: Multi-tenancy (aislamiento de datos por empresa)
- MGN-005: Catálogos (tipos de incidencias, categorías, etc.)
- MGN-007: Auditoría (registro de cambios)
- MGN-008: Notificaciones (alertas de incidencias y aprobaciones)
verticales:
- MAI-001: Gestión de Proyectos (datos de proyectos)
- MAI-002: Planificación de Obras (presupuestos y cronogramas)
- MAI-003: Gestión de Recursos (personal, materiales, equipos)
apps_moviles:
- MOB-003: App Supervisor
descripcion: Aplicación móvil para supervisores de obra
funcionalidades:
- Registro de avances físicos en campo
- Control de recursos (personal, materiales, equipos)
- Bitácora digital con captura de fotos
- Registro de incidencias
- Firma digital
- Modo offline con sincronización automática
metricas:
cobertura_pruebas: 0%
documentacion: 0%
endpoints_implementados: 0/42
componentes_implementados: 0/38
tablas_creadas: 0/21
notas_implementacion:
- Implementar primero RF-OBRA-001 (Avances Físicos) como base
- RF-OBRA-002 depende de RF-OBRA-001 para comparativas
- La app móvil MOB-003 debe soportar modo offline robusto
- Implementar sistema de sincronización de datos móvil-servidor
- Las fotografías deben comprimirse antes de enviar desde móvil
- Implementar firma digital con certificado de tiempo
- Considerar geolocalización en registros móviles
- Sistema de aprobación multinivel para estimaciones
- Dashboard ejecutivo con KPIs de avance físico y financiero
- Alertas automáticas por desviaciones presupuestarias
Reference in New Issue View Git Blame Copy Permalink