# ERP Construccion - Vertical INFONAVIT

## Descripcion

Vertical especializada del ERP Suite para empresas de construccion con integracion INFONAVIT. **Extiende erp-core** con modulos especificos para gestion de proyectos de construccion, presupuestos, control de obra, y cumplimiento normativo.

| Campo | Valor |
|-------|-------|
| **Estado** | En desarrollo (35%) |
| **Version** | 0.1.0 |
| **Base** | Extiende erp-core (61% reutilizacion) |
| **Modulos** | 18 (14 Fase 1 + 3 Fase 2 + 1 Fase 3) |
| **RF** | 79 |
| **ET** | 78 |
| **US** | 139 |
| **ADRs** | 12 |

---

## Estructura del Proyecto

```
construccion/
+-- backend/                    # Extensiones backend especificas
|   +-- src/
|       +-- server.ts
|       +-- shared/database/
+-- frontend/
|   +-- web/                   # App web de gestion (React + Vite)
|   +-- mobile/                # App movil para campo (React Native)
+-- database/                   # DDL y migrations especificos
|   +-- ddl/
|   +-- scripts/
+-- docs/                       # Documentacion completa (407+ archivos)
|   +-- 00-overview/           # Vision general
|   +-- 01-analisis-referencias/ # Mapeo a erp-core
|   +-- 02-definicion-modulos/ # 18 modulos MAI/MAE/MAA
|   +-- 03-requerimientos/     # Indice consolidado RF (79)
|   +-- 04-modelado/           # Domain models + DDL
|   +-- 05-user-stories/       # Indice consolidado US (139)
|   +-- 06-frontend-specs/     # Especificaciones UI
|   +-- 06-test-plans/         # Planes de prueba
|   +-- 07-devops/             # DevOps y deployment
|   +-- 08-epicas/             # Epicas consolidadas
|   +-- 90-transversal/        # Documentacion cruzada
|   +-- 97-adr/                # 12 ADRs
+-- orchestration/              # Sistema de agentes NEXUS
    +-- 00-guidelines/
    +-- directivas/
    +-- prompts/
    +-- trazas/
    +-- estados/
```

---

## Modulos por Fase

### Fase 1: Alcance Inicial (14 modulos, ~670 SP)

| Codigo | Modulo | RF | US | Estado |
|--------|--------|---:|---:|--------|
| MAI-001 | Fundamentos y Seguridad | 3 | 8 | Documentado |
| MAI-002 | Proyectos y Estructura | 4 | 9 | Documentado |
| MAI-003 | Presupuestos y Costos | 4 | 8 | Documentado |
| MAI-004 | Compras e Inventarios | 4 | 8 | Documentado |
| MAI-005 | Control de Obra | 4 | 8 | Documentado |
| MAI-006 | Reportes y Analytics | 4 | 8 | Documentado |
| MAI-007 | RRHH y Asistencias | 6 | 8 | Documentado |
| MAI-008 | Estimaciones y Facturacion | 5 | 8 | Documentado |
| MAI-009 | Calidad y Postventa | 5 | 8 | Documentado |
| MAI-010 | CRM Derechohabientes | 5 | 8 | Documentado |
| MAI-011 | INFONAVIT | 5 | 8 | Documentado |
| MAI-012 | Contratos y Subcontratos | 5 | 8 | Documentado |
| MAI-013 | Administracion | 5 | 8 | Documentado |
| MAI-018 | Preconstruccion | 5 | 8 | Documentado |

### Fase 2: Enterprise (3 modulos, 210 SP)

| Codigo | Modulo | RF | US | Estado |
|--------|--------|---:|---:|--------|
| MAE-014 | Finanzas y Controlling | 5 | 11 | Documentado |
| MAE-015 | Activos y Maquinaria | 5 | 8 | Documentado |
| MAE-016 | Gestion Documental (DMS) | 5 | 7 | Documentado |

### Fase 3: Avanzada

| Codigo | Modulo | Estado |
|--------|--------|--------|
| MAA-017 | Seguridad HSE | Por documentar |

---

## Schemas de Base de Datos

| Schema | Descripcion |
|--------|-------------|
| `project_management` | Proyectos, desarrollos, fases, viviendas |
| `financial_management` | Presupuestos, partidas, estimaciones |
| `purchasing_management` | Compras, proveedores, inventarios |
| `construction_management` | Avances, recursos, materiales |
| `quality_management` | Inspecciones, pruebas, no conformidades |
| `infonavit_management` | Integracion INFONAVIT |
| `hr_management` | Personal, cuadrillas, asistencias |
| `crm_management` | Prospectos, derechohabientes |
| `contract_management` | Contratos, subcontratos |
| `assets_management` | Activos, maquinaria, mantenimiento |
| `documents_management` | DMS, versionado, workflows |

---

## Documentacion

| Documento | Ubicacion |
|-----------|-----------|
| **Indice principal** | `docs/README.md` |
| **Requerimientos (79 RF)** | `docs/03-requerimientos/README.md` |
| **User Stories (139 US)** | `docs/05-user-stories/README.md` |
| **Modulos (18)** | `docs/02-definicion-modulos/_MAP.md` |
| **ADRs (12)** | `docs/97-adr/README.md` |
| **Contexto proyecto** | `orchestration/00-guidelines/CONTEXTO-PROYECTO.md` |
| **Proxima accion** | `orchestration/PROXIMA-ACCION.md` |
| **Schemas SQL** | `docs/04-modelado/database-design/schemas/` |

---

## Reutilizacion de ERP Core

| Capa | Reutilizacion |
|------|---------------|
| Infraestructura (Auth, RLS, RBAC) | 90% |
| Backend (Patrones, Servicios) | 60-80% |
| Frontend (UI, Hooks, Stores) | 50-70% |
| Database (Schemas, Funciones) | 70% |
| **Total** | **61%** |

---

## Comandos Utiles

```bash
# Ver documentacion
ls docs/

# Ver modulos
ls docs/02-definicion-modulos/

# Contar archivos
find docs/ -name "*.md" | wc -l  # ~407 archivos

# Ver indice de RF
cat docs/03-requerimientos/README.md

# Ver indice de US
cat docs/05-user-stories/README.md
```

---

## Dependencias

- **Requiere:** erp-core (auth, users, tenants, catalogs)
- **Extiende:** Schemas y modulos base de erp-core
- **Stack:** Node.js, Express, TypeORM, React, Vite, PostgreSQL

---

*Proyecto parte de ERP Suite - Fabrica de Software con Agentes IA*
**Ultima actualizacion:** 2025-12-05