erp-core/orchestration/analisis/FASE-2-ANALISIS-DETALLADO-SAAS-IA.md
rckrdmrd 0086695b4c
Some checks failed
ERP Core CI / Backend Lint (push) Has been cancelled
ERP Core CI / Backend Unit Tests (push) Has been cancelled
ERP Core CI / Backend Integration Tests (push) Has been cancelled
ERP Core CI / Frontend Lint (push) Has been cancelled
ERP Core CI / Frontend Unit Tests (push) Has been cancelled
ERP Core CI / Frontend E2E Tests (push) Has been cancelled
ERP Core CI / Database DDL Validation (push) Has been cancelled
ERP Core CI / Backend Build (push) Has been cancelled
ERP Core CI / Frontend Build (push) Has been cancelled
ERP Core CI / CI Success (push) Has been cancelled
Performance Tests / Lighthouse CI (push) Has been cancelled
Performance Tests / Bundle Size Analysis (push) Has been cancelled
Performance Tests / k6 Load Tests (push) Has been cancelled
Performance Tests / Performance Summary (push) Has been cancelled
[SIMCO-V38] feat: Actualizar a SIMCO v3.8.0 + cambios backend
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8
- Actualizaciones en modulos CRM y OpenAPI

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 08:53:05 -06:00

25 KiB

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

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