erp-core/docs

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 completo de 4 fases (9-12 semanas)
• PLAN-DOCUMENTACION-ERP-GENERICO.md - Plan original (3 etapas)
• INSTRUCCIONES-AGENTE-ARQUITECTURA.md - Instrucciones previas

🚀 Ejecución

• LANZAR-FASE-0.md - ⭐ Instrucciones para lanzar Fase 0 (USAR ESTE)

🔧 Recursos Técnicos

• Prompt Architecture-Analyst Extendido
• Referencias Odoo
• Referencias Gamilit
• ERP Construcción

---

🗺️ 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

---

📌 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 completo

2. Lanzar Fase 0

Sigue las instrucciones en 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 - 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 completo 4 fases
LANZAR-FASE-0	⭐ Ejecutar ahora
Prompt Extendido	Capacidades del agente
Odoo Analysis	Referencia Odoo
Gamilit	Referencia Gamilit
ERP Construcción	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