workspace-v1/projects/erp-construccion/docs/02-definicion-modulos/MAI-008-estimaciones-facturacion/historias-usuario/US-EST-001-crear-estimacion-cliente.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

2.3 KiB

US-EST-001: Crear Estimación a Cliente

ID: US-EST-001
Módulo: MAI-008
Story Points: 5


Historia de Usuario

Como Ingeniero de Proyecto
Quiero crear una estimación a cliente desde avances de obra verificados
Para cobrar por el trabajo ejecutado en el periodo


Criterios de Aceptación

  1. Seleccionar proyecto y periodo → Sistema carga avances verificados
  2. Sistema identifica viviendas/conceptos 100% terminados
  3. Calcula automáticamente: monto bruto, amortización, retenciones, neto
  4. Muestra desglose detallado con previsualización
  5. Validaciones: no exceder contrato, no duplicar conceptos, avances verificados
  6. Guarda borrador editable hasta enviar a autorización

Mockup

┌────────────────────────────────────────┐
│ Nueva Estimación a Cliente          [X]│
├────────────────────────────────────────┤
│ Proyecto: [v] Desarrollo 100 Viviendas│
│ Contrato: CONT-2025-001 ($50M)        │
│ Periodo: [01/11/2025] a [30/11/2025]  │
│                                        │
│ AVANCES VERIFICADOS EN EL PERIODO:     │
│ ☑️ 25 viviendas terminadas (100%)     │
│                                        │
│ CÁLCULO AUTOMÁTICO:                    │
│ Monto bruto:        $12,500,000.00    │
│ Amortización 25%:  -$ 2,500,000.00    │
│ Retención 5%:      -$   500,000.00    │
│ ─────────────────────────────────────  │
│ MONTO NETO:         $ 9,500,000.00    │
│                                        │
│ [Cancelar] [Guardar Borrador] [Enviar]│
└────────────────────────────────────────┘

Casos de Prueba

CP-001: Crear estimación exitosa

  • 25 viviendas verificadas → Calcula $9.5M neto → Guarda borrador

CP-002: Validar límite de contrato

  • Intenta estimar más del contrato → Error

CP-003: Evitar duplicados

  • Vivienda ya estimada → Alerta y bloquea

Generado: 2025-11-20