# DOCUMENTACIÓN - ERP CORE

**Proyecto:** ERP Core (Base Reutilizable Multi-Proyecto + SaaS)
**Versión:** 3.0.0
**Fecha:** 2025-12-05
**Estado:** 📋 Fase 2 - Modelado en progreso

---

## 🎯 OBJETIVO DEL PROYECTO

Crear el **ERP Genérico** como base reutilizable (60-70%) para los 3 ERPs especializados:
- ERP Construcción (vivienda e INFONAVIT)
- ERP Vidrio Templado (producción de vidrio)
- ERP Mecánicas Diesel (laboratorios diesel)

---

## 📚 DOCUMENTOS PRINCIPALES

### 📋 Planificación
- **[PLAN-MAESTRO-MIGRACION-CONSOLIDACION.md](PLAN-MAESTRO-MIGRACION-CONSOLIDACION.md)** - Plan completo de 4 fases (9-12 semanas)
- [PLAN-DOCUMENTACION-ERP-GENERICO.md](PLAN-DOCUMENTACION-ERP-GENERICO.md) - Plan original (3 etapas)
- [INSTRUCCIONES-AGENTE-ARQUITECTURA.md](INSTRUCCIONES-AGENTE-ARQUITECTURA.md) - Instrucciones previas

### 🚀 Ejecución
- **[LANZAR-FASE-0.md](LANZAR-FASE-0.md)** - ⭐ Instrucciones para lanzar Fase 0 (USAR ESTE)

### 🔧 Recursos Técnicos
- [Prompt Architecture-Analyst Extendido]([RUTA-LEGACY-ELIMINADA]/shared/orchestration/prompts/PROMPT-ARCHITECTURE-ANALYST-EXTENDED.md)
- [Referencias Odoo]([RUTA-LEGACY-ELIMINADA]/shared/reference/ODOO-MODULES-ANALYSIS.md)
- [Referencias Gamilit]([RUTA-LEGACY-ELIMINADA]/shared/reference/gamilit/)
- [ERP Construcción]([RUTA-LEGACY-ELIMINADA]/projects/erp-construccion/docs/)

---

## 🗺️ METODOLOGÍA: 4 FASES

### ✅ **FASE 0: ANÁLISIS DE REFERENCIAS** (2 semanas) - **ACTUAL**
**Objetivo:** Analizar Odoo + Gamilit + ERP Construcción para fundamentar decisiones

**Entregables:** 38 archivos
- 14 análisis de módulos Odoo
- 7 análisis de Gamilit
- 5 validaciones con ERP Construcción
- 10 ADRs (Architecture Decision Records)
- 1 mapeo de componentes genéricos
- 1 resumen ejecutivo

**👉 [LANZAR FASE 0](LANZAR-FASE-0.md)**

---

### 📌 **FASE 1: ANÁLISIS Y RETROALIMENTACIÓN** (2-3 semanas)
**Objetivo:** Migrar componentes genéricos del ERP Construcción

**Entregables:** 48-58 archivos
- Definición de módulos MGN-001 a MGN-014
- Extracción de 30-40 RF genéricos
- Gap analysis por módulo
- Retroalimentación a ERP Construcción

---

### 📌 **FASE 2: MODELADO DE REQUERIMIENTOS Y BD** (3-4 semanas)
**Objetivo:** Crear RF, ET, diseño de BD para ERP Genérico

**Entregables:** 244 archivos
- 8 modelos de dominio
- 12 schemas de BD (DDL)
- 70 RF (Requerimientos Funcionales)
- 70 ET backend
- 70 ET frontend
- 14 matrices de trazabilidad

---

### 📌 **FASE 3: DOCUMENTACIÓN DETALLADA** (2-3 semanas)
**Objetivo:** US, inventarios, planes de pruebas, docs transversales

**Entregables:** 246 archivos
- 140 US (Historias de Usuario)
- 28 README + _MAP (por módulo)
- 42 inventarios YAML
- 28 planes de pruebas
- 8 documentos transversales

---

## 📦 MÓDULOS DEL ERP GENÉRICO

### Fase Core (8 módulos - Prioridad P0)

| Código | Nombre | Referencia Odoo |
|--------|--------|-----------------|
| **MGN-001** | Fundamentos | base, auth_signup |
| **MGN-002** | Empresas y Organizaciones | base (res.company) |
| **MGN-003** | Catálogos Maestros | base, product |
| **MGN-004** | Financiero Básico | account |
| **MGN-005** | Inventario Básico | stock |
| **MGN-006** | Compras Básico | purchase |
| **MGN-007** | Ventas Básico | sale |
| **MGN-008** | Contabilidad Analítica | analytic |

### Fase Complementaria (6 módulos - Prioridad P1)

| Código | Nombre | Referencia Odoo |
|--------|--------|-----------------|
| **MGN-009** | CRM Básico | crm |
| **MGN-010** | Recursos Humanos Básico | hr |
| **MGN-011** | Proyectos Genéricos | project |
| **MGN-012** | Reportes y Analytics | reporting |
| **MGN-013** | Portal de Usuarios | portal |
| **MGN-014** | Mensajería y Notificaciones | mail |

### Fase SaaS Platform (4 módulos - Prioridad P3)

| Código | Nombre | Descripción |
|--------|--------|-------------|
| **MGN-016** | Billing SaaS | Per-seat pricing, suscripciones, feature flags |
| **MGN-017** | Payments POS | MercadoPago, Clip, terminales de pago |
| **MGN-018** | WhatsApp Business | Cloud API, chatbots, campañas |
| **MGN-019** | AI Agents | RAG, pgvector, knowledge bases, tools |

**Total:** 19 módulos (14 core + 1 projects + 4 SaaS)

---

## ESTRUCTURA DE DOCUMENTACION (v4.0 - Filosofia GAMILIT)

**Reestructurado:** 2025-12-05
**Filosofia:** Documentacion modular con trazabilidad completa

### Principios

1. **Modulos autocontenidos:** Todo lo de un modulo esta junto
2. **Trazabilidad completa:** RF -> ET -> US -> Codigo
3. **Inventarios globales:** Previenen duplicacion de objetos
4. **_MAP.md por modulo:** Indice con metricas y estado

### Estructura Nueva (Recomendada)

```
erp-suite/apps/erp-core/
│
├── docs/
│   ├── 01-fase-foundation/                      # Modulos base
│   │   ├── README.md                            # Resumen de fase
│   │   ├── MGN-001-auth/                        # MODULO AUTOCONTENIDO
│   │   │   ├── _MAP.md                          # Indice con metricas
│   │   │   ├── README.md                        # Descripcion
│   │   │   ├── requerimientos/                  # RF del modulo
│   │   │   │   ├── RF-AUTH-001.md
│   │   │   │   └── RF-AUTH-002.md
│   │   │   ├── especificaciones/                # ET del modulo
│   │   │   │   ├── ET-AUTH-001-backend.md
│   │   │   │   └── ET-AUTH-002-frontend.md
│   │   │   ├── historias-usuario/               # US del modulo
│   │   │   │   ├── US-MGN001-001.md
│   │   │   │   └── US-MGN001-002.md
│   │   │   └── implementacion/
│   │   │       └── TRACEABILITY.yml             # RF -> ET -> US -> Codigo
│   │   │
│   │   ├── MGN-002-users/                       # Mismo patron
│   │   ├── MGN-003-roles/
│   │   └── MGN-004-tenants/
│   │
│   ├── 02-fase-core-business/                   # Modulos de negocio
│   │   ├── MGN-005-catalogs/
│   │   ├── MGN-006-inventory/
│   │   ├── MGN-007-sales/
│   │   ├── MGN-008-purchases/
│   │   ├── MGN-009-reports/
│   │   └── MGN-010-accounting/
│   │
│   ├── 03-fase-extended/                        # Modulos extendidos
│   │   ├── MGN-011-hr/
│   │   ├── MGN-012-manufacturing/
│   │   ├── MGN-013-projects/
│   │   ├── MGN-014-crm/
│   │   └── MGN-015-assets/
│   │
│   ├── 04-fase-saas/                            # Modulos SaaS
│   │   ├── MGN-016-subscriptions/
│   │   ├── MGN-017-payments/
│   │   ├── MGN-018-whatsapp/
│   │   └── MGN-019-audit/
│   │
│   ├── 90-transversal/                          # Documentos compartidos
│   │   ├── templates/
│   │   └── guias/
│   │
│   └── 97-adr/                                  # Architecture Decision Records
│
└── orchestration/
    └── inventarios/                              # INVENTARIOS CANONICOS
        ├── README.md
        ├── MASTER_INVENTORY.yml                 # Resumen global
        ├── DATABASE_INVENTORY.yml               # Tablas, funciones, triggers
        ├── BACKEND_INVENTORY.yml                # Services, controllers, endpoints
        ├── FRONTEND_INVENTORY.yml               # Pages, components, stores
        ├── DEPENDENCY_GRAPH.yml                 # Grafo de dependencias
        └── TRACEABILITY_MATRIX.yml              # Matriz global RF->Codigo
```

### Beneficios

- **Localizacion rapida:** Todo de un modulo en una carpeta
- **Prevencion de duplicados:** Inventarios detectan colisiones
- **Trazabilidad completa:** Cualquier linea de codigo tiene traza a RF
- **Metricas precisas:** Story points, coverage, bugs por modulo

### Estructura Legacy (En Migracion)

```
docs/
├── 00-vision-general/                           # Vision del proyecto
├── 01-analisis-referencias/                     # Analisis Odoo/Gamilit
├── 02-definicion-modulos/                       # Definiciones de modulos
├── 03-requerimientos/                           # RF dispersos por tipo
├── 04-modelado/                                 # ET y DDL dispersos
├── 05-user-stories/                             # US dispersas
├── 06-test-plans/                               # Planes de prueba
├── 07-devops/                                   # CI/CD
├── 08-epicas/                                   # Epicas
├── 90-transversal/                              # Transversal
├── 95-guias-desarrollo/                         # Guias
└── 97-adr/                                      # ADRs
```

---

## 🚀 CÓMO EMPEZAR

### 1. Revisar el Plan Maestro
Lee [PLAN-MAESTRO-MIGRACION-CONSOLIDACION.md](PLAN-MAESTRO-MIGRACION-CONSOLIDACION.md) completo

### 2. Lanzar Fase 0
Sigue las instrucciones en [LANZAR-FASE-0.md](LANZAR-FASE-0.md)

### 3. Validar Entregables Fase 0
Al completar, revisar:
- 38 archivos creados
- 10 ADRs fundamentados
- Mapeo de componentes completo
- Resumen ejecutivo consolidado

### 4. Aprobar antes de Fase 1
No avanzar a Fase 1 sin aprobar Fase 0

---

## 📊 MÉTRICAS DEL PROYECTO

### Duración Total
- **9-12 semanas** (Fase 0-3)

### Archivos a Crear
- **576-586 archivos** de documentación completa

### Distribución de Trabajo
- **Architecture-Analyst (coordinador):** 19% trabajo directo
- **Agentes delegados:** 81% trabajo especializado

### Reutilización Esperada
- **60-70%** de componentes reutilizables en los 3 ERPs especializados

---

## 🎯 RESULTADO FINAL ESPERADO

Al completar las 4 fases:

✅ **14 módulos** completamente documentados (MGN-001 a MGN-014)
✅ **10 ADRs** que guían decisiones arquitectónicas
✅ **70 RF** validados contra Odoo
✅ **140 ET** (backend + frontend)
✅ **140 US** listas para desarrollo
✅ **12 schemas de BD** diseñados
✅ **Inventarios completos** de objetos a implementar
✅ **Planes de pruebas** por módulo
✅ **Retroalimentación** al ERP Construcción
✅ **Base reutilizable** para 3 proyectos especializados

---

## 📚 REFERENCIAS EXTERNAS

### Proyectos de Referencia
- [Odoo Community Edition](https://github.com/odoo/odoo) - Lógica de negocio ERP
- Análisis Odoo: `/shared/reference/ODOO-MODULES-ANALYSIS.md`
- Proyecto Gamilit: `/shared/reference/gamilit/` - Arquitectura moderna

### ERP Construcción
- Documentación: `/projects/erp-construccion/docs/`
- 18 módulos documentados (35% progreso)
- Fuente de componentes a migrar

### Directivas y Estándares
- Prompts de agentes: `/shared/orchestration/prompts/`
- Directivas: `/shared/orchestration/directivas/`

---

## ✅ CHECKLIST DE PROGRESO

### Fase 0 (Actual)
- [ ] 14 análisis Odoo completados
- [ ] 7 análisis Gamilit completados
- [ ] 5 validaciones construcción completadas
- [ ] 10 ADRs creados
- [ ] Mapeo de componentes completo
- [ ] Resumen ejecutivo consolidado
- [ ] **Total: 38 archivos** ✅

### Fase 1
- [ ] Módulos MGN definidos
- [ ] RF genéricos extraídos
- [ ] Gap analysis completado
- [ ] Retroalimentación generada

### Fase 2
- [ ] Modelos de dominio creados
- [ ] Schemas BD diseñados
- [ ] RF completos
- [ ] ET backend y frontend

### Fase 3
- [ ] US creadas
- [ ] Inventarios completos
- [ ] Planes de pruebas
- [ ] Docs transversales

---

## 🔗 NAVEGACIÓN RÁPIDA

| Documento | Propósito |
|-----------|-----------|
| [PLAN-MAESTRO](PLAN-MAESTRO-MIGRACION-CONSOLIDACION.md) | Plan completo 4 fases |
| [LANZAR-FASE-0](LANZAR-FASE-0.md) | ⭐ Ejecutar ahora |
| [Prompt Extendido](../../../shared/orchestration/prompts/PROMPT-ARCHITECTURE-ANALYST-EXTENDED.md) | Capacidades del agente |
| [Odoo Analysis](../../../shared/reference/ODOO-MODULES-ANALYSIS.md) | Referencia Odoo |
| [Gamilit](../../../shared/reference/gamilit/) | Referencia Gamilit |
| [ERP Construcción](../../erp-construccion/docs/) | Documentación a migrar |

---

## 📋 ESTRUCTURA ACTUALIZADA (v3.0)

La estructura de carpetas ha sido reorganizada el 2025-12-05 para eliminar numeración duplicada.

Ver directiva: `/workspace/core/orchestration/directivas/DIRECTIVA-ESTRUCTURA-DOCUMENTACION-PROYECTOS.md`

---

**Última actualización:** 2025-12-05
**Coordinador:** Architecture-Analyst
**Estado:** 📋 Fase 2 - Modelado en progreso
**Próximo paso:** Completar especificaciones técnicas de módulos SaaS
