# FASE 2: ANALISIS DETALLADO
# Contenido Propuesto para Integracion SaaS e IA

**Version:** 1.0.0
**Fecha:** 2026-01-10
**Estado:** EN PROGRESO
**Fase Anterior:** FASE-1-ANALISIS-INICIAL-SAAS-IA.md

---

## RESUMEN EJECUTIVO

Este documento presenta el analisis detallado de cada archivo a modificar/crear, incluyendo:
- Contenido propuesto seccion por seccion
- Cambios especificos requeridos
- Analisis de impacto en dependencias

---

## 1. ARCHIVO PRINCIPAL: VISION-ERP-CORE.md

### 1.1 Estructura Actual vs Propuesta

| Seccion Actual | Lineas | Estado | Seccion Propuesta |
|----------------|--------|--------|-------------------|
| Resumen Ejecutivo | 1-8 | MODIFICAR | Ampliar con SaaS/IA |
| Proposito | 9-30 | MODIFICAR | Agregar alcance SaaS/IA |
| Objetivos | 31-48 | MODIFICAR | Incluir objetivos SaaS/IA |
| Arquitectura | 49-89 | MODIFICAR | Expandir con capas SaaS/IA |
| Modulos Core | 90-112 | MODIFICAR | Agregar MGN-016 a MGN-022 |
| Stack Tecnologico | 113-147 | MODIFICAR | Agregar nuevas tecnologias |
| Principios de Diseno | 148-166 | MODIFICAR | Agregar principios SaaS/IA |
| Entregables por Fase | 167-193 | MODIFICAR | Agregar Fase 4 y 5 |
| Referencias | 194-203 | MANTENER | Sin cambios |
| Metricas de Exito | 204-217 | MODIFICAR | Agregar metricas SaaS/IA |
| --- | --- | CREAR | Alcance SaaS (nueva seccion) |
| --- | --- | CREAR | Alcance IA (nueva seccion) |
| --- | --- | CREAR | Integraciones Externas (nueva) |

### 1.2 CONTENIDO PROPUESTO PARA VISION-ERP-CORE.md

```markdown
---
id: VISION-ERP-CORE
title: Vision General - ERP Core
type: Vision
status: Published
priority: P0
version: 2.0.0
created_date: 2025-12-01
updated_date: 2026-01-10
---

# Vision General: ERP Core

## Resumen Ejecutivo

ERP Core es la **base generica reutilizable** que proporciona el 60-70% del codigo compartido para todas las verticales del ERP Suite. Es una adaptacion de los patrones de Odoo al stack TypeScript/Node.js/React.

**Capacidades Core:**
- Multi-tenancy con Row-Level Security (RLS)
- Autenticacion/Autorizacion avanzada (JWT, OAuth, RBAC)
- Modulos de negocio genericos (Inventario, Ventas, Compras, CRM)

**Capacidades SaaS (Plataforma):**
- Billing y suscripciones con Stripe
- Planes con feature gating y limites
- Notificaciones multicanal (Email, Push, WhatsApp)
- Webhooks outbound con firma HMAC
- Feature flags por tenant/usuario

**Capacidades IA (Inteligencia):**
- Integracion LLM multi-proveedor (OpenRouter)
- MCP Server para herramientas de negocio
- WhatsApp Business con IA conversacional
- Prediccion de inventario y demanda
- Asistente de negocio inteligente

---

## Proposito

### Problema que Resuelve

Desarrollar ERPs verticales desde cero es costoso y repetitivo. El 60-70% de la funcionalidad es comun:
- Autenticacion y usuarios
- Multi-tenancy
- Catalogos maestros
- Partners (clientes/proveedores)
- Productos e inventario
- Ventas y compras
- Contabilidad basica

**Ademas, las plataformas modernas requieren:**
- Modelo de negocio SaaS con suscripciones
- Inteligencia artificial integrada
- Comunicacion omnicanal con clientes

### Solucion

ERP Core provee esta funcionalidad comun de forma:
- **Modular:** Cada modulo es independiente
- **Extensible:** Las verticales pueden extender sin modificar
- **Multi-tenant:** Aislamiento por tenant desde el diseno
- **Documentado:** Documentacion antes de desarrollo
- **SaaS-Ready:** Billing, planes y self-service incluidos
- **AI-First:** IA integrada en flujos de negocio

---

## Objetivos

### Corto Plazo (3 meses)
1. Completar modulos core: Auth, Users, Roles, Tenants
2. Implementar Partners y Products
3. Establecer patrones de extension para verticales
4. **Integrar Billing y Plans (Stripe)**
5. **Implementar Feature Flags**

### Mediano Plazo (6 meses)
1. Completar Sales, Purchases, Inventory
2. Implementar Financial basico
3. Primera vertical (Construccion) usando el core
4. **Integrar Notificaciones multicanal**
5. **Implementar Webhooks outbound**
6. **Integrar MCP Server y LLM**

### Largo Plazo (12 meses)
1. Todas las verticales usando el core
2. **SaaS layer completo para autocontratacion**
3. Marketplace de extensiones
4. **WhatsApp Business con IA integrada**
5. **Prediccion de inventario y demanda**
6. **Asistente de negocio inteligente**

---

## Arquitectura

### Modelo de Capas

```
+------------------------------------------------------------------+
|                        CLIENTES                                   |
|  +----------+ +----------+ +----------+ +----------+             |
|  | Web App  | |Mobile App| | WhatsApp | | API Rest |             |
|  | React 18 | | Expo 51  | | Meta API | | Swagger  |             |
|  +----------+ +----------+ +----------+ +----------+             |
+------------------------------------------------------------------+
|                        CAPA IA                                    |
|  +----------------------------------------------------------+    |
|  |                    MCP SERVER                             |    |
|  |  (Model Context Protocol - Herramientas de Negocio)      |    |
|  +----------------------------------------------------------+    |
|  |                 LLM GATEWAY (OpenRouter)                  |    |
|  |  Claude | GPT-4 | Gemini | Mistral | Llama               |    |
|  +----------------------------------------------------------+    |
+------------------------------------------------------------------+
|                        API GATEWAY                                |
|  +----------------------------------------------------------+    |
|  | Express.js + TypeScript + Swagger                         |    |
|  | Middleware: Auth | Tenant | Rate Limit | Validation      |    |
|  +----------------------------------------------------------+    |
+------------------------------------------------------------------+
|                    SERVICIOS BACKEND                              |
|  +-------+ +-------+ +-------+ +-------+ +-------+ +-------+    |
|  | Auth  | | Users | |Tenants| |Billing| | Plans | |Webhooks|   |
|  +-------+ +-------+ +-------+ +-------+ +-------+ +-------+    |
|  +-------+ +-------+ +-------+ +-------+ +-------+ +-------+    |
|  |Notif  | |Storage| | Audit | |FFlags | |  AI   | |WhatsApp|   |
|  +-------+ +-------+ +-------+ +-------+ +-------+ +-------+    |
|  +-------+ +-------+ +-------+ +-------+ +-------+ +-------+    |
|  |Catalog| |Invntry| | Sales | |Purchas| | CRM   | |Projects|   |
|  +-------+ +-------+ +-------+ +-------+ +-------+ +-------+    |
+------------------------------------------------------------------+
|                     BASE DE DATOS                                 |
|  +----------------------------------------------------------+    |
|  | PostgreSQL 16+ con RLS (Row-Level Security)              |    |
|  | Schemas: auth | users | tenants | billing | plans | ai   |    |
|  |          notifications | webhooks | storage | audit      |    |
|  |          core_catalog | core_inventory | core_sales      |    |
|  +----------------------------------------------------------+    |
+------------------------------------------------------------------+
|                  SERVICIOS EXTERNOS                               |
|  +--------+ +--------+ +--------+ +--------+ +--------+          |
|  | Stripe | |SendGrid| | S3/R2  | | Redis  | |OpenRouter|        |
|  +--------+ +--------+ +--------+ +--------+ +--------+          |
|  +--------+ +--------+                                            |
|  |WhatsApp| | Vision |                                            |
|  +--------+ +--------+                                            |
+------------------------------------------------------------------+
```

### Modelo de Extension

```
+------------------------------------------------------------------+
|                        ERP CORE                                   |
|  Modulos Genericos (MGN-001 a MGN-022)                           |
|  60-70% funcionalidad comun                                      |
|                                                                   |
|  +-- Core Business: auth, users, tenants, catalog, inventory     |
|  +-- SaaS Layer: billing, plans, webhooks, feature-flags         |
|  +-- IA Layer: ai-integration, whatsapp, mcp-server             |
+------------------------------------------------------------------+
                         | EXTIENDE
        +----------------+----------------+
        ↓                ↓                ↓
+---------------+ +---------------+ +---------------+
| Construccion  | |Vidrio Templado| |    Retail     |
|   (MAI-*)     | |    (MVT-*)    | |    (MRT-*)    |
| 30-40% extra  | | 30-40% extra  | | 30-40% extra  |
+---------------+ +---------------+ +---------------+
```

---

## Modulos Core (MGN-*)

### Fase Foundation (P0)

| Codigo | Modulo | Descripcion | Prioridad | Estado |
|--------|--------|-------------|-----------|--------|
| MGN-001 | auth | Autenticacion JWT, OAuth, sessions | P0 | En desarrollo |
| MGN-002 | users | Gestion de usuarios CRUD | P0 | En desarrollo |
| MGN-003 | roles | Roles y permisos (RBAC) | P0 | Planificado |
| MGN-004 | tenants | Multi-tenancy, aislamiento RLS | P0 | Planificado |

### Fase Core Business (P1)

| Codigo | Modulo | Descripcion | Prioridad | Estado |
|--------|--------|-------------|-----------|--------|
| MGN-005 | catalogs | Catalogos maestros genericos | P1 | Planificado |
| MGN-006 | settings | Configuracion del sistema | P1 | Planificado |
| MGN-007 | audit | Auditoria y logs | P1 | Planificado |
| MGN-008 | notifications | Sistema de notificaciones multicanal | P1 | Planificado |
| MGN-009 | reports | Reportes genericos | P2 | Planificado |
| MGN-010 | financial | Contabilidad basica | P1 | Planificado |
| MGN-011 | inventory | Inventario basico | P1 | Planificado |
| MGN-012 | purchasing | Compras basicas | P1 | Planificado |
| MGN-013 | sales | Ventas basicas | P1 | Planificado |
| MGN-014 | crm | CRM basico | P2 | Planificado |
| MGN-015 | projects | Proyectos genericos | P2 | Planificado |

### Fase SaaS Platform (P3)

| Codigo | Modulo | Descripcion | Prioridad | Estado |
|--------|--------|-------------|-----------|--------|
| MGN-016 | billing | Suscripciones y pagos (Stripe) | P3 | Planificado |
| MGN-017 | plans | Planes, limites y feature gating | P3 | Planificado |
| MGN-018 | webhooks | Webhooks outbound con firma HMAC | P3 | Planificado |
| MGN-019 | feature-flags | Feature flags por tenant/usuario | P3 | Planificado |

### Fase IA Intelligence (P3)

| Codigo | Modulo | Descripcion | Prioridad | Estado |
|--------|--------|-------------|-----------|--------|
| MGN-020 | ai-integration | Gateway LLM multi-proveedor | P3 | Planificado |
| MGN-021 | whatsapp-business | WhatsApp Business con IA | P3 | Planificado |
| MGN-022 | mcp-server | MCP Server para herramientas | P3 | Planificado |

---

## Alcance SaaS (Plataforma)

### Billing y Suscripciones (MGN-016)

**Proveedor:** Stripe

**Caracteristicas:**
- Suscripciones recurrentes (mensual/anual)
- Trial gratuito configurable
- Upgrade/downgrade con prorateo automatico
- Facturas y recibos
- Webhooks Stripe sincronizados
- Portal de cliente Stripe integrado

**Estados de Suscripcion:**
```
trialing -> active -> past_due -> cancelled
```

### Planes y Limites (MGN-017)

**Planes Propuestos:**

| Plan | Precio | Usuarios | Storage | Features |
|------|--------|----------|---------|----------|
| Free | $0/mes | 1 | 100MB | Core basico |
| Starter | $29/mes | 5 | 1GB | + API access |
| Pro | $79/mes | 20 | 10GB | + AI assistant + Webhooks |
| Enterprise | $199/mes | Unlimited | Unlimited | + Custom branding + SLA |

**Feature Gating:**
- Verificacion en runtime
- Limites numericos por plan (-1 = unlimited)
- Features booleanas por plan

### Notificaciones Multicanal (MGN-008 extendido)

**Canales:**
- Email (SendGrid, AWS SES, SMTP)
- Push Web (Web Push API con VAPID)
- In-App (WebSocket real-time)
- WhatsApp Business (Meta Cloud API)

**Caracteristicas:**
- Templates personalizables (MJML)
- Cola asincrona (BullMQ + Redis)
- Reintentos automaticos
- Preferencias por usuario

### Webhooks Outbound (MGN-018)

**Eventos Disponibles:**
- user.created/updated/deleted
- subscription.created/updated/cancelled
- invoice.paid/failed
- file.uploaded/deleted
- tenant.updated

**Seguridad:**
- Firma HMAC-SHA256 de payloads
- Reintentos exponenciales (6 intentos)
- Logs de entregas detallados

### Feature Flags (MGN-019)

**Caracteristicas:**
- Flags por tenant
- Flags por usuario
- Rollout gradual
- A/B testing
- Evaluaciones por contexto

---

## Alcance IA (Inteligencia)

### Gateway LLM (MGN-020)

**Gateway:** OpenRouter (acceso a 50+ modelos)

**Modelos Soportados:**

| Modelo | ID | Costo/1M | Uso Recomendado |
|--------|----|---------:|-----------------|
| Claude 3 Haiku | anthropic/claude-3-haiku | $0.25 | Default (rapido, economico) |
| Claude 3 Sonnet | anthropic/claude-3-sonnet | $3.00 | Premium (alta calidad) |
| GPT-4o-mini | openai/gpt-4o-mini | $0.15 | Fallback economico |
| GPT-3.5 Turbo | openai/gpt-3.5-turbo | $0.50 | Fallback |
| Mistral 7B | mistralai/mistral-7b | $0.06 | Ultra-economico |
| Llama 3 | meta-llama/llama-3-8b | $0.20 | Open source |

**Caracteristicas:**
- Cambio de modelo sin modificar codigo
- Fallback automatico entre modelos
- Rate limiting inteligente
- Token tracking por tenant
- Cost estimation en USD
- Configuracion por tenant

### MCP Server (MGN-022)

**Protocolo:** Model Context Protocol (Anthropic)

**Herramientas de Negocio:**

```yaml
productos:
  - list_products: Lista productos filtrados
  - get_product_details: Detalles completos
  - check_product_availability: Verifica stock

inventario:
  - check_stock: Estado actual
  - get_low_stock_products: Productos bajo minimo
  - record_inventory_movement: Registra entrada/salida
  - get_inventory_value: Calcula valor total

ventas:
  - create_order: Crear nuevo pedido
  - get_order_status: Consultar estado
  - update_order_status: Cambiar estado

clientes:
  - search_customers: Busqueda de clientes
  - get_customer_balance: Saldo actual
```

### WhatsApp Business (MGN-021)

**Proveedor:** Meta Cloud API

**Caracteristicas:**
- Recepcion de mensajes (texto, audio, imagen, ubicacion)
- Envio de respuestas con IA
- Templates pre-aprobados
- Tracking de estado de entrega
- Historial de conversacion
- Rate limiting por tenant

**Flujo de Mensaje:**
```
Cliente -> WhatsApp -> Meta API -> Webhook
    -> LLM Service -> MCP Server -> Response
    -> WhatsApp Service -> Cliente
```

### Prediccion de Inventario

**Algoritmos:**

1. **Prediccion de Demanda:**
   - Promedio movil ponderado (4 semanas)
   - Pesos: 40%, 30%, 20%, 10%

2. **Punto de Reorden:**
   - Formula: (Demanda_diaria x Lead_time) + Stock_seguridad
   - Lead time default: 3 dias

3. **Dias de Inventario:**
   - Formula: Stock_actual / Demanda_diaria

**Funcionalidades:**
- Alertas automaticas de stock bajo
- Sugerencias de reabastecimiento
- Deteccion de productos sin movimiento
- Reportes automaticos via WhatsApp

---

## Integraciones Externas

### Pagos y Billing

| Integracion | Proveedor | Modulo | Caracteristicas |
|-------------|-----------|--------|-----------------|
| Billing | Stripe | MGN-016 | Suscripciones, facturas, pagos |

### Comunicaciones

| Integracion | Proveedor | Modulo | Caracteristicas |
|-------------|-----------|--------|-----------------|
| Email | SendGrid/SES | MGN-008 | Email transaccional |
| Push | Web Push API | MGN-008 | Notificaciones push |
| WhatsApp | Meta Cloud API | MGN-021 | Mensajeria con IA |

### Infraestructura

| Integracion | Proveedor | Modulo | Caracteristicas |
|-------------|-----------|--------|-----------------|
| Storage | S3/R2/MinIO | N/A | Almacenamiento de archivos |
| Cache/Queue | Redis/BullMQ | N/A | Cache y colas |

### Inteligencia Artificial

| Integracion | Proveedor | Modulo | Caracteristicas |
|-------------|-----------|--------|-----------------|
| LLM Gateway | OpenRouter | MGN-020 | Acceso a 50+ modelos |
| Transcripcion | OpenAI Whisper | MGN-021 | Voz a texto |
| Vision/OCR | Google Vision | MGN-021 | Reconocimiento de productos |

---

## Stack Tecnologico

### Backend

| Tecnologia | Version | Proposito |
|------------|---------|-----------|
| Node.js | 20+ | Runtime |
| Express.js | 4.x | Framework HTTP |
| TypeScript | 5.3+ | Lenguaje |
| TypeORM | 0.3.17 | ORM |
| JWT + bcryptjs | - | Autenticacion |
| Zod, class-validator | - | Validacion |
| Swagger | 3.x | Documentacion API |
| Jest | 29.x | Testing |
| **BullMQ** | 5.x | Colas asincronas |
| **Socket.io** | 4.x | WebSocket real-time |
| **Stripe SDK** | Latest | Billing |
| **OpenRouter Client** | Latest | LLM Gateway |

### Frontend

| Tecnologia | Version | Proposito |
|------------|---------|-----------|
| React | 18.x | Framework UI |
| Vite | 5.x | Build tool |
| TypeScript | 5.3+ | Lenguaje |
| Zustand | 4.x | State management |
| Tailwind CSS | 4.x | Styling |
| React Query | 5.x | Data fetching |
| React Hook Form | 7.x | Formularios |
| **Socket.io-client** | 4.x | WebSocket |

### Database

| Tecnologia | Version | Proposito |
|------------|---------|-----------|
| PostgreSQL | 16+ | Motor BD |
| RLS | - | Row-Level Security |
| uuid-ossp | - | Generacion UUIDs |
| pg_trgm | - | Busqueda fuzzy |
| **Redis** | 7.x | Cache y colas |

---

## Principios de Diseno

### 1. Multi-Tenancy First
Toda tabla tiene `tenant_id`. Todo query filtra por tenant via RLS.

### 2. Documentation Driven
Documentar antes de desarrollar. La documentacion es el contrato.

### 3. Extension over Modification
Las verticales extienden, nunca modifican el core.

### 4. Patterns from Odoo
Adaptar patrones probados de Odoo al stack TypeScript.

### 5. Single Source of Truth
Un lugar para cada dato. Sincronizacion automatica.

### 6. SaaS by Design
Billing, planes y self-service desde el inicio.

### 7. AI-First Architecture
IA integrada en flujos de negocio, no como addon.

### 8. Event-Driven Communication
Webhooks y eventos para comunicacion entre sistemas.

---

## Entregables por Fase

### Fase 1: Foundation (En progreso)
- [ ] MGN-001 Auth completo
- [ ] MGN-002 Users completo
- [ ] MGN-003 Roles completo
- [ ] MGN-004 Tenants completo
- [ ] Documentacion de todos los modulos

### Fase 2: Core Business
- [ ] MGN-005 Catalogs
- [ ] MGN-010 Financial basico
- [ ] MGN-011 Inventory
- [ ] MGN-012 Purchasing
- [ ] MGN-013 Sales

### Fase 3: Extended
- [ ] MGN-006 Settings
- [ ] MGN-007 Audit
- [ ] MGN-008 Notifications (multicanal)
- [ ] MGN-009 Reports
- [ ] MGN-014 CRM
- [ ] MGN-015 Projects

### Fase 4: SaaS Platform
- [ ] MGN-016 Billing (Stripe)
- [ ] MGN-017 Plans
- [ ] MGN-018 Webhooks
- [ ] MGN-019 Feature Flags
- [ ] Portal de autocontratacion

### Fase 5: IA Intelligence
- [ ] MGN-020 AI Integration (OpenRouter)
- [ ] MGN-021 WhatsApp Business
- [ ] MGN-022 MCP Server
- [ ] Prediccion de inventario
- [ ] Asistente de negocio inteligente

---

## Referencias

| Recurso | Path |
|---------|------|
| Directivas | `orchestration/directivas/` |
| Patrones Odoo | `orchestration/directivas/DIRECTIVA-PATRONES-ODOO.md` |
| Templates | `orchestration/templates/` |
| Catalogo central | `shared/catalog/` |
| **Template SaaS** | `projects/template-saas/` |
| **MiChangarrito** | `projects/michangarrito/` |

---

## Metricas de Exito

### Metricas Core

| Metrica | Objetivo |
|---------|----------|
| Cobertura de tests | >80% |
| Documentacion | 100% antes de desarrollo |
| Reutilizacion en verticales | >60% |
| Tiempo de setup nueva vertical | <1 semana |

### Metricas SaaS

| Metrica | Objetivo |
|---------|----------|
| Tiempo de onboarding self-service | <5 minutos |
| Conversion trial a paid | >10% |
| Churn mensual | <5% |
| Uptime SLA | >99.5% |

### Metricas IA

| Metrica | Objetivo |
|---------|----------|
| Precision de respuestas IA | >85% |
| Latencia promedio LLM | <2 segundos |
| Adopcion de chat IA | >50% usuarios activos |
| Precision prediccion inventario | >70% |

---

*Ultima actualizacion: Enero 2026*
```

---

## 2. ARCHIVOS NUEVOS A CREAR

### 2.1 _MAP.md (vision-general)

**Ubicacion:** `/docs/00-vision-general/_MAP.md`
**Proposito:** Indice de navegacion de vision-general

```markdown
---
id: MAP-VISION-GENERAL
title: Indice - Vision General
type: Index
status: Published
---

# Vision General - Indice de Navegacion

## Contenido

| Archivo | Descripcion | Estado |
|---------|-------------|--------|
| [VISION-ERP-CORE.md](VISION-ERP-CORE.md) | Vision general, alcances y arquitectura | Activo |
| [ARQUITECTURA-SAAS.md](ARQUITECTURA-SAAS.md) | Arquitectura de plataforma SaaS | Activo |
| [ARQUITECTURA-IA.md](ARQUITECTURA-IA.md) | Arquitectura de inteligencia artificial | Activo |
| [INTEGRACIONES-EXTERNAS.md](INTEGRACIONES-EXTERNAS.md) | Integraciones con servicios externos | Activo |
| [STACK-TECNOLOGICO.md](STACK-TECNOLOGICO.md) | Stack tecnologico detallado | Activo |

## Navegacion

- **Padre:** [docs/](../)
- **Siguiente:** [Arquitectura](../01-arquitectura/)

---

*Actualizado: 2026-01-10*
```

### 2.2 ARQUITECTURA-SAAS.md

**Ubicacion:** `/docs/00-vision-general/ARQUITECTURA-SAAS.md`
**Proposito:** Detalle de arquitectura SaaS

**Contenido propuesto:**
- Diagrama de arquitectura multi-tenant
- Explicacion de RLS (Row-Level Security)
- Flujos de billing y suscripciones
- Flujos de feature gating
- Flujos de webhooks
- Patrones de extension SaaS

### 2.3 ARQUITECTURA-IA.md

**Ubicacion:** `/docs/00-vision-general/ARQUITECTURA-IA.md`
**Proposito:** Detalle de arquitectura de IA

**Contenido propuesto:**
- Diagrama de arquitectura IA
- Flujo de MCP Server
- Flujo de LLM Gateway
- Flujo de WhatsApp con IA
- Algoritmos de prediccion
- Patrones de extension IA

### 2.4 INTEGRACIONES-EXTERNAS.md

**Ubicacion:** `/docs/00-vision-general/INTEGRACIONES-EXTERNAS.md`
**Proposito:** Catalogo de integraciones externas

**Contenido propuesto:**
- Tabla de todas las integraciones
- Configuracion por integracion
- Credenciales requeridas
- Limites y rate limiting
- Guias de setup

### 2.5 STACK-TECNOLOGICO.md

**Ubicacion:** `/docs/00-vision-general/STACK-TECNOLOGICO.md`
**Proposito:** Detalle completo del stack

**Contenido propuesto:**
- Stack backend detallado
- Stack frontend detallado
- Stack database detallado
- Stack servicios externos
- Versiones y compatibilidad
- Guia de setup de desarrollo

---

## 3. ARCHIVOS A MODIFICAR EN OTRAS UBICACIONES

### 3.1 docs/_MAP.md

**Cambios requeridos:**
- Actualizar seccion de vision-general con nuevos archivos
- Agregar referencias a arquitectura SaaS e IA

### 3.2 docs/02-definicion-modulos/INDICE-MODULOS.md

**Cambios requeridos:**
- Agregar MGN-016 a MGN-022
- Crear nueva seccion "Fase SaaS Platform"
- Crear nueva seccion "Fase IA Intelligence"

---

## 4. ANALISIS DE IMPACTO

### 4.1 Impacto en Documentacion Existente

| Archivo | Impacto | Accion |
|---------|---------|--------|
| VISION-ERP-CORE.md | Alto | Reescritura significativa |
| docs/_MAP.md | Bajo | Agregar enlaces |
| INDICE-MODULOS.md | Medio | Agregar modulos nuevos |
| CONTEXTO-PROYECTO.md | Bajo | Actualizar version |

### 4.2 Impacto en Estructura

| Directorio | Impacto | Accion |
|------------|---------|--------|
| 00-vision-general/ | Alto | 5 archivos nuevos |
| 02-definicion-modulos/ | Medio | 7 carpetas nuevas (futuro) |
| orchestration/inventarios/ | Alto | Crear maestros YAML |

### 4.3 Dependencias de Contenido

```
VISION-ERP-CORE.md (actualizado)
    |
    +-- Referencia ARQUITECTURA-SAAS.md
    +-- Referencia ARQUITECTURA-IA.md
    +-- Referencia INTEGRACIONES-EXTERNAS.md
    +-- Referencia STACK-TECNOLOGICO.md
    |
    +-- Referenciado desde docs/_MAP.md
    +-- Referenciado desde CONTEXTO-PROYECTO.md
```

---

## 5. VALIDACIONES REQUERIDAS

### 5.1 Validaciones Pre-Ejecucion

- [ ] Verificar que todos los archivos fuente existen
- [ ] Verificar que no hay conflictos con trabajo en progreso
- [ ] Validar que el plan cubre todos los gaps identificados

### 5.2 Validaciones Post-Ejecucion

- [ ] Todos los archivos tienen frontmatter SIMCO
- [ ] Todos los enlaces internos funcionan
- [ ] Todos los diagramas renderizan correctamente
- [ ] Contenido es consistente entre archivos
- [ ] No hay informacion duplicada
- [ ] Terminologia es consistente

---

## 6. RESUMEN DE CAMBIOS

### 6.1 Archivos a Crear (5)

1. `/docs/00-vision-general/_MAP.md`
2. `/docs/00-vision-general/ARQUITECTURA-SAAS.md`
3. `/docs/00-vision-general/ARQUITECTURA-IA.md`
4. `/docs/00-vision-general/INTEGRACIONES-EXTERNAS.md`
5. `/docs/00-vision-general/STACK-TECNOLOGICO.md`

### 6.2 Archivos a Modificar (3)

1. `/docs/00-vision-general/VISION-ERP-CORE.md` (reescritura mayor)
2. `/docs/_MAP.md` (agregar enlaces)
3. `/docs/02-definicion-modulos/INDICE-MODULOS.md` (agregar modulos)

### 6.3 Lineas Estimadas de Cambio

| Archivo | Lineas Actuales | Lineas Propuestas | Delta |
|---------|----------------|-------------------|-------|
| VISION-ERP-CORE.md | 218 | ~550 | +332 |
| _MAP.md (nuevo) | 0 | ~35 | +35 |
| ARQUITECTURA-SAAS.md (nuevo) | 0 | ~200 | +200 |
| ARQUITECTURA-IA.md (nuevo) | 0 | ~200 | +200 |
| INTEGRACIONES-EXTERNAS.md (nuevo) | 0 | ~150 | +150 |
| STACK-TECNOLOGICO.md (nuevo) | 0 | ~100 | +100 |
| **TOTAL** | **218** | **~1235** | **+1017** |

---

**Documento generado:** 2026-01-10
**Fase:** 2 de 8 (Analisis Detallado)
**Estado:** COMPLETADO
**Siguiente fase:** Planeacion Basada en Analisis
