# ERP Construccion - Documentacion

**Proyecto:** Sistema de Administracion de Obra e INFONAVIT
**Version:** 3.0.0
**Fecha:** 2025-12-05
**Alineado con:** ERP Core (erp-core) - GAMILIT v4.0

---

## Introduccion

Sistema ERP especializado para la industria de construccion de vivienda, con integracion INFONAVIT. El proyecto extiende erp-core reutilizando el **61%** de sus componentes y extendiendo funcionalidades especificas del dominio.

---

## Metricas del Proyecto

| Metrica | Valor |
|---------|-------|
| **Modulos** | 18 |
| **Requerimientos (RF)** | 79 |
| **Especificaciones (ET)** | 78 |
| **User Stories (US)** | 139 |
| **Story Points** | ~650 SP |
| **ADRs** | 12 |
| **Archivos Markdown** | 407+ |
| **Reutilizacion GAMILIT** | 61% |

---

## Estructura de Documentacion

```
docs/
+-- README.md                            # Este archivo
+-- ESTRUCTURA-COMPLETA.md               # Estructura detallada de modulos
+-- RLS-POLICIES-TODOS-LOS-MODULOS.md    # Politicas de seguridad por modulo
|
+-- 00-overview/                         # Vision general
|   +-- MVP-APP.md                       # Definicion del MVP
|   +-- ARQUITECTURA-SAAS.md             # Arquitectura SaaS multi-tenant
|   +-- GLOSARIO.md                      # Terminos de construccion
|
+-- 01-analisis-referencias/             # Analisis de sistemas externos
|   +-- README.md
|   +-- MAPEO-MAI-TO-MGN.md              # Mapeo construccion -> erp-core (61%)
|   +-- odoo/
|   +-- gamilit/
|   +-- erp-generico/
|
+-- 02-definicion-modulos/               # Modulos MAI + MAE (18 modulos)
|   +-- _MAP.md                          # Indice maestro de modulos
|   +-- MAI-001-fundamentos/             # Fase 1
|   +-- MAI-002-proyectos-estructura/
|   +-- ...
|   +-- MAI-018-preconstruccion-licitaciones/
|   +-- MAE-014-finanzas-controlling/    # Fase 2
|   +-- MAE-015-activos-maquinaria/
|   +-- MAE-016-gestion-documental/
|
+-- 03-requerimientos/                   # Indice consolidado de RF
|   +-- README.md                        # 79 RF indexados
|
+-- 04-modelado/                         # Modelado de datos
|   +-- domain-models/                   # 6 contextos de dominio
|   +-- database-design/                 # Schemas DDL (11+)
|       +-- schemas/
|       +-- trazabilidad/
|
+-- 05-user-stories/                     # Indice consolidado de US
|   +-- README.md                        # 139 US indexadas
|
+-- 06-frontend-specs/                   # Especificaciones Frontend
|
+-- 06-test-plans/                       # Planes de prueba
|
+-- 07-devops/                           # DevOps y deployment
|
+-- 08-epicas/                           # Epicas consolidadas
|   +-- README.md
|   +-- EPIC-MAI-001-fundamentos.md
|   +-- EPIC-MAI-002-proyectos.md
|   +-- ...
|
+-- 90-transversal/                      # Documentacion transversal
|
+-- 97-adr/                              # Architecture Decision Records
    +-- README.md
    +-- ADR-001 a ADR-012
```

---

## Modulos del Sistema

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

| Codigo | Modulo | RF | ET | US | SP | Reutilizacion |
|--------|--------|---:|---:|---:|---:|---------------|
| MAI-001 | Fundamentos | 3 | 3 | 8 | 50 | 100% Generico |
| MAI-002 | Proyectos y Estructura | 4 | 4 | 9 | 55 | 40% Generico |
| MAI-003 | Presupuestos y Costos | 4 | 4 | 8 | 60 | 0% Especifico |
| MAI-004 | Compras e Inventarios | 4 | 4 | 8 | 50 | 80% Generico |
| MAI-005 | Control de Obra | 4 | 4 | 8 | 60 | 0% Especifico |
| MAI-006 | Reportes y Analytics | 4 | 4 | 8 | 40 | 60% Generico |
| MAI-007 | RRHH y Asistencias | 6 | 6 | 8 | 45 | 50% Generico |
| MAI-008 | Estimaciones | 5 | 5 | 8 | 50 | 20% Generico |
| MAI-009 | Calidad y Postventa | 5 | 5 | 8 | 40 | 10% Generico |
| MAI-010 | CRM Derechohabientes | 5 | 5 | 8 | 45 | 40% Generico |
| MAI-011 | INFONAVIT | 5 | 5 | 8 | 45 | 0% Especifico |
| MAI-012 | Contratos | 5 | 5 | 8 | 45 | 20% Generico |
| MAI-013 | Administracion | 5 | 5 | 8 | 40 | 80% Generico |
| MAI-018 | Preconstruccion | 5 | 5 | 8 | 45 | 10% Generico |

**Subtotal Fase 1:** 64 RF | 64 ET | 113 US | ~670 SP

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

| Codigo | Modulo | RF | ET | US | SP | Reutilizacion |
|--------|--------|---:|---:|---:|---:|---------------|
| MAE-014 | Finanzas y Controlling | 5 | 5 | 11 | 80 | 70% Generico |
| MAE-015 | Activos y Maquinaria | 5 | 5 | 8 | 70 | 30% Generico |
| MAE-016 | Gestion Documental | 5 | 5 | 7 | 60 | 50% Generico |

**Subtotal Fase 2:** 15 RF | 15 ET | 26 US | 210 SP

### Fase 3: Avanzada (1 modulo, pendiente)

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

---

## Decisiones Arquitectonicas (ADRs)

| ADR | Titulo | Estado |
|-----|--------|--------|
| [ADR-001](./97-adr/ADR-001-stack-tecnologico.md) | Stack Tecnologico | Aceptada |
| [ADR-002](./97-adr/ADR-002-arquitectura-modular.md) | Arquitectura Modular | Aceptada |
| [ADR-003](./97-adr/ADR-003-multi-tenancy.md) | Multi-Tenancy | Aceptada |
| [ADR-004](./97-adr/ADR-004-sistema-constantes-ssot.md) | Sistema SSOT | Aceptada |
| [ADR-005](./97-adr/ADR-005-path-aliases.md) | Path Aliases | Aceptada |
| [ADR-006](./97-adr/ADR-006-rbac-sistema-permisos.md) | RBAC | Aceptada |
| [ADR-007](./97-adr/ADR-007-database-design.md) | Database Design | Aceptada |
| [ADR-008](./97-adr/ADR-008-api-design.md) | API Design | Aceptada |
| [ADR-009](./97-adr/ADR-009-frontend-architecture.md) | Frontend Architecture | Aceptada |
| [ADR-010](./97-adr/ADR-010-testing-strategy.md) | Testing Strategy | Aceptada |
| [ADR-011](./97-adr/ADR-011-database-clean-load-strategy.md) | Database Clean Load | Aceptada |
| [ADR-012](./97-adr/ADR-012-complete-traceability-policy.md) | Trazabilidad Completa | Aceptada |

---

## Indices Consolidados

| Indice | Ubicacion | Contenido |
|--------|-----------|-----------|
| Requerimientos | [03-requerimientos/README.md](./03-requerimientos/README.md) | 79 RF indexados |
| User Stories | [05-user-stories/README.md](./05-user-stories/README.md) | 139 US indexadas |
| Modulos | [02-definicion-modulos/_MAP.md](./02-definicion-modulos/_MAP.md) | 18 modulos |
| Domain Models | [04-modelado/domain-models/README.md](./04-modelado/domain-models/README.md) | 6 contextos |
| Database Schemas | [04-modelado/database-design/schemas/](./04-modelado/database-design/schemas/) | 11+ schemas |

---

## Alineacion con ERP Core (GAMILIT)

Este proyecto esta alineado con erp-core para maximizar reutilizacion:

| Metrica | Valor |
|---------|-------|
| **Reutilizacion total** | 61% |
| **Componentes genericos** | 88 de 138 |
| **Componentes especificos** | 50 de 138 |

### Por Capa

| Capa | Reutilizacion | Detalles |
|------|---------------|----------|
| Infraestructura | 90% | Auth JWT, RBAC, Multi-tenancy, RLS |
| Backend | 60-80% | Patrones, servicios base |
| Frontend | 50-70% | Componentes UI, hooks, stores |
| Database | 70% | Schemas modulares, funciones |
| API Design | 100% | RESTful patterns, DTOs |

Ver [MAPEO-MAI-TO-MGN.md](./01-analisis-referencias/MAPEO-MAI-TO-MGN.md) para detalles.

---

## Documentacion Tecnica (Desarrolladores)

| Documento | Descripcion |
|-----------|-------------|
| [ARCHITECTURE.md](./ARCHITECTURE.md) | Arquitectura tecnica, patrones, multi-tenant |
| [CONTRIBUTING.md](../CONTRIBUTING.md) | Guia de contribucion, convenciones, Git |
| [api/openapi.yaml](./api/openapi.yaml) | Especificacion OpenAPI 3.0.3 |
| [backend/API-REFERENCE.md](./backend/API-REFERENCE.md) | Referencia de endpoints con ejemplos |
| [backend/MODULES.md](./backend/MODULES.md) | Documentacion de modulos backend |

---

## Documentos Clave (Funcionales)

| Documento | Descripcion |
|-----------|-------------|
| [ESTRUCTURA-COMPLETA.md](./ESTRUCTURA-COMPLETA.md) | Estructura detallada de modulos |
| [ARQUITECTURA-SAAS.md](./00-vision-general/ARQUITECTURA-SAAS.md) | Arquitectura SaaS multi-tenant |
| [MVP-APP.md](./00-vision-general/MVP-APP.md) | Definicion del MVP |
| [GLOSARIO.md](./00-vision-general/GLOSARIO.md) | Terminos de construccion |
| [RLS-POLICIES-TODOS-LOS-MODULOS.md](./RLS-POLICIES-TODOS-LOS-MODULOS.md) | Politicas de seguridad |

---

## Estado de Completitud

### Documentacion

- [x] RF documentados para todos los modulos (79/79)
- [x] ET documentadas para todos los modulos (78/78)
- [x] US documentadas con criterios de aceptacion (139/139)
- [x] Indice consolidado de RF
- [x] Indice consolidado de US
- [x] ADRs documentados (12/12)
- [x] Domain models definidos (6/6)
- [x] Database schemas DDL (11+)
- [ ] TRACEABILITY.yml por modulo (post-implementacion)
- [ ] TEST-PLAN.md por modulo (post-implementacion)

### Implementacion

- [ ] Fase 1: En progreso (35%)
- [ ] Fase 2: Pendiente
- [ ] Fase 3: Pendiente

---

## Proximos Pasos

1. ~~**Documentar RF** para todos los modulos~~ COMPLETADO
2. ~~**Crear ET** para todos los modulos~~ COMPLETADO
3. ~~**Definir US** con criterios de aceptacion~~ COMPLETADO
4. ~~**Consolidar indices** RF y US~~ COMPLETADO
5. **Iniciar implementacion** Sprint 0
6. **Crear TRACEABILITY.yml** post-implementacion

---

## Referencias

- [ERP Core (erp-core)](../../../erp-core/)
- [GAMILIT Methodology](../../gamilit/)
- [Odoo Analysis](./01-analisis-referencias/odoo/)

---

## Changelog

### v3.0.0 (2025-12-05)
- Indices consolidados RF y US creados
- Metricas actualizadas
- Alineacion con GAMILIT v4.0

### v2.0.0 (2025-11-24)
- Agregados 12 ADRs alineados con ERP Core
- Creada estructura 01-analisis-referencias/
- Creado MAPEO-MAI-TO-MGN.md
- Plan de retroalimentacion iniciado

### v1.1.0 (2025-11-17)
- Estructura inicial de 18 modulos
- Documentacion de Fase 1

---

**Ultima actualizacion:** 2025-12-12
**Responsable:** Requirements-Analyst