# Análisis de Alineación del Workspace
**Fecha:** 2025-12-08
**Versión Sistema:** NEXUS v3.2 + SIMCO + CAPVED

---

## RESUMEN EJECUTIVO

Este documento presenta el análisis exhaustivo de alineación entre el sistema de orquestación central (`core/orchestration/`) y su implementación en todos los proyectos del workspace.

### Hallazgos Clave

| Área | Estado | Acción Requerida |
|------|--------|------------------|
| Sistema SIMCO/CAPVED | Completo (20+ directivas) | Base sólida |
| ERP-Core | 100% docs, 0% código | Implementar |
| Verticales | Parcialmente alineadas | Propagar estándares |
| SaaS Layer | 0% (vacío) | Crear desde cero |
| Proyectos Standalone | Variable | Homologar |

---

## 1. SISTEMA DE ORQUESTACIÓN (CORE)

### 1.1 Componentes Implementados

| Componente | Ubicación | Archivos | Estado |
|------------|-----------|----------|--------|
| Directivas SIMCO | `core/orchestration/directivas/simco/` | 17 archivos | Completo |
| Principios | `core/orchestration/directivas/principios/` | 5 archivos | Completo |
| Perfiles Agentes | `core/orchestration/agents/perfiles/` | 12 archivos | Completo |
| Templates | `core/orchestration/templates/` | 14 archivos | Completo |
| Checklists | `core/orchestration/checklists/` | 3 archivos | Completo |
| Catálogo | `core/catalog/` | 8 funcionalidades | Documentado |

### 1.2 Directivas SIMCO Disponibles

```
SIMCO-TAREA.md          # Ciclo CAPVED (obligatorio)
SIMCO-CREAR.md          # Crear archivos nuevos
SIMCO-MODIFICAR.md      # Modificar existentes
SIMCO-VALIDAR.md        # Validación obligatoria
SIMCO-DOCUMENTAR.md     # Documentación
SIMCO-DELEGACION.md     # Delegar a subagentes
SIMCO-BUSCAR.md         # Exploración
SIMCO-REUTILIZAR.md     # Uso del catálogo
SIMCO-DDL.md            # Base de datos
SIMCO-BACKEND.md        # NestJS/TypeORM
SIMCO-FRONTEND.md       # React/TypeScript
SIMCO-NIVELES.md        # Jerarquía de proyectos
SIMCO-PROPAGACION.md    # Propagación de cambios
SIMCO-ML.md             # Machine Learning
SIMCO-MOBILE.md         # Aplicaciones móviles
SIMCO-ALINEACION.md     # Alineación entre capas
SIMCO-DECISION-MATRIZ.md # Matriz de decisiones
```

### 1.3 Principios Fundamentales (5)

1. **PRINCIPIO-CAPVED** - Ciclo obligatorio: Contexto→Análisis→Planeación→Validación→Ejecución→Documentación
2. **PRINCIPIO-DOC-PRIMERO** - Documentar antes de implementar
3. **PRINCIPIO-ANTI-DUPLICACION** - Verificar catálogo/inventarios antes de crear
4. **PRINCIPIO-VALIDACION-OBLIGATORIA** - Build+Lint+Tests deben pasar
5. **PRINCIPIO-ECONOMIA-TOKENS** - Desglosar tareas grandes

### 1.4 Catálogo de Funcionalidades Reutilizables

| Funcionalidad | Ubicación | Estado |
|---------------|-----------|--------|
| auth | `core/catalog/auth/` | Documentado |
| session-management | `core/catalog/session-management/` | Documentado |
| rate-limiting | `core/catalog/rate-limiting/` | Documentado |
| notifications | `core/catalog/notifications/` | Documentado |
| multi-tenancy | `core/catalog/multi-tenancy/` | Documentado |
| feature-flags | `core/catalog/feature-flags/` | Documentado |
| websocket | `core/catalog/websocket/` | Documentado |
| payments | `core/catalog/payments/` | Documentado |

---

## 2. ANÁLISIS POR PROYECTO

### 2.1 ERP-SUITE

#### Estado General
| Componente | Documentación | Código | BD | Orquestación |
|------------|---------------|--------|-----|--------------|
| ERP-Core | 100% (827 MD) | 0% | 0% | 100% |
| Construcción | 100% (449 MD) | 25% | 0% | 100% |
| Mecánicas Diesel | 95% (75 MD) | 0% | 0% | 100% |
| Vidrio Templado | 0% | 0% | 0% | 50% |
| Retail | 0% | 0% | 0% | 50% |
| Clínicas | 0% | 0% | 0% | 50% |
| SaaS Layer | 10% | 0% | 0% | 0% |

#### Gaps Identificados en ERP-Suite

| ID | Gap | Severidad | Ubicación |
|----|-----|-----------|-----------|
| GAP-ERP-001 | SaaS layer vacío | CRÍTICO | `apps/saas/` |
| GAP-ERP-002 | shared-libs vacío | ALTO | `apps/shared-libs/` |
| GAP-ERP-003 | Verticales sin HERENCIA-ERP-CORE.md | MEDIO | 3 de 5 verticales |
| GAP-ERP-004 | Inventarios desactualizados | MEDIO | Varios |
| GAP-ERP-005 | No existe POS básico minimalista | CRÍTICO | No existe |

### 2.2 Otros Proyectos

| Proyecto | Estado | Docs | Código | Alineación |
|----------|--------|------|--------|------------|
| Gamilit | Producción | 470 MD | Completo | Alta |
| Trading-Platform | Desarrollo | 259 MD | 70% | Alta |
| Betting-Analytics | Planificación | 1 MD | 0% | Parcial |
| Inmobiliaria-Analytics | Planificación | 1 MD | 0% | Parcial |

---

## 3. GAPS DE ALINEACIÓN CRÍTICOS

### 3.1 Gaps Estructurales

| # | Descripción | Proyectos Afectados | Impacto |
|---|-------------|---------------------|---------|
| 1 | Falta estructura SaaS multi-tier | erp-suite | Bloqueante para comercialización |
| 2 | Falta POS minimalista (100 MXN) | erp-suite | Mercado desatendido |
| 3 | Inventarios no propagados | Todos | Trazabilidad incompleta |
| 4 | HERENCIA-DIRECTIVAS inconsistente | Verticales | Duplicación de esfuerzo |

### 3.2 Gaps de Documentación

| # | Descripción | Ubicación |
|---|-------------|-----------|
| 1 | ERP-Core sin README actualizado con arquitectura SaaS | `erp-suite/apps/erp-core/` |
| 2 | Verticales sin docs de herencia | 3 verticales |
| 3 | Catálogo sin código de referencia | `core/catalog/*/` |
| 4 | betting/inmobiliaria sin documentación | 2 proyectos |

### 3.3 Gaps de Implementación

| # | Descripción | Prioridad |
|---|-------------|-----------|
| 1 | ERP-Core 0% código con 100% docs | P0 |
| 2 | SaaS Layer inexistente | P0 |
| 3 | POS Básico no existe | P0 |
| 4 | Mecánicas Diesel 0% código | P1 |

---

## 4. PROPUESTA: ARQUITECTURA SAAS MULTI-TIER

### 4.1 Estructura Propuesta

```
erp-suite/
├── apps/
│   ├── erp-core/                 # Base compartida (EXISTENTE)
│   │   ├── backend/              # API Core
│   │   ├── frontend/             # UI Core (componentes base)
│   │   └── database/             # Schemas compartidos
│   │
│   ├── saas/                     # Capa SaaS (CREAR)
│   │   ├── billing/              # Facturación y suscripciones
│   │   ├── portal/               # Portal de clientes
│   │   ├── admin/                # Admin multi-tenant
│   │   └── onboarding/           # Autoregistro
│   │
│   ├── products/                 # Productos SaaS (CREAR)
│   │   │
│   │   ├── erp-basico/           # ERP SaaS Mediano (~300-500 MXN/mes)
│   │   │   ├── backend/          # Hereda erp-core + módulos seleccionados
│   │   │   ├── frontend/         # UI simplificada
│   │   │   └── config/           # Feature flags para módulos
│   │   │
│   │   └── pos-micro/            # POS Ultra Básico (~100 MXN/mes)
│   │       ├── backend/          # Mínimo: ventas, inventario básico, reportes
│   │       ├── frontend/         # UI ultra simple (móvil-first)
│   │       ├── pwa/              # Progressive Web App
│   │       └── whatsapp/         # Integración WhatsApp Business
│   │
│   └── verticales/               # Extensiones por industria (EXISTENTE)
│       ├── construccion/
│       ├── mecanicas-diesel/
│       ├── vidrio-templado/
│       ├── retail/
│       └── clinicas/
```

### 4.2 Producto: ERP SaaS Mediano

**Target:** PyMEs que necesitan ERP integral pero económico
**Precio:** ~300-500 MXN/mes
**Características:**

| Módulo | Incluido | Descripción |
|--------|----------|-------------|
| Auth | Obligatorio | Login, roles básicos |
| Usuarios | Obligatorio | Gestión de usuarios |
| Multi-tenant | Obligatorio | Aislamiento por empresa |
| Inventario | Incluido | Control de stock básico |
| Ventas | Incluido | Cotizaciones, pedidos, facturas |
| Compras | Incluido | Órdenes de compra básicas |
| Clientes/Proveedores | Incluido | CRM básico |
| Reportes | Incluido | Reportes esenciales |
| Contabilidad | Opcional | +100 MXN/mes |
| RRHH | Opcional | +100 MXN/mes |
| WhatsApp Bot | Opcional | Por consumo de tokens |

### 4.3 Producto: POS Micro (Ultra Básico)

**Target:** Mercado informal mexicano
- Puestos de calle
- Tiendas de abarrotes/misceláneas
- Puestos de comida
- Pequeños locales

**Precio:** ~100 MXN/mes
**Modelo:** SaaS + consumo de IA

**Características MÍNIMAS:**

| Característica | Descripción |
|----------------|-------------|
| Punto de Venta | Vender productos, calcular cambio |
| Inventario Básico | Agregar productos, ver stock |
| Catálogo Simple | Lista de productos con precio |
| Corte de Caja | Resumen diario de ventas |
| Reportes Básicos | Ventas del día/semana/mes |
| WhatsApp Bot | Consultas de precio, stock, ventas |
| PWA Offline | Funciona sin internet (sincroniza después) |

**Arquitectura Minimalista:**

```
pos-micro/
├── backend/
│   ├── src/
│   │   ├── modules/
│   │   │   ├── auth/           # Login simple (email/WhatsApp)
│   │   │   ├── products/       # CRUD productos
│   │   │   ├── sales/          # Registrar ventas
│   │   │   ├── inventory/      # Stock básico
│   │   │   └── reports/        # Reportes simples
│   │   └── shared/
│   │       ├── tenant/         # Multi-tenant básico
│   │       └── whatsapp/       # Integración WA Business
├── frontend/
│   ├── pwa/                    # Progressive Web App
│   │   ├── pages/
│   │   │   ├── pos/            # Pantalla de venta
│   │   │   ├── products/       # Gestión productos
│   │   │   ├── reports/        # Ver reportes
│   │   │   └── settings/       # Configuración
│   │   └── offline/            # Service Worker
└── database/
    └── schemas/
        └── pos_micro/          # ~10 tablas máximo
```

**Base de Datos Minimalista (~10 tablas):**

```sql
-- Schema: pos_micro
CREATE TABLE tenants (id, name, whatsapp_number, plan, created_at);
CREATE TABLE users (id, tenant_id, email, password_hash, role);
CREATE TABLE products (id, tenant_id, name, price, stock, barcode);
CREATE TABLE sales (id, tenant_id, user_id, total, payment_method, created_at);
CREATE TABLE sale_items (id, sale_id, product_id, quantity, price);
CREATE TABLE inventory_movements (id, tenant_id, product_id, quantity, type, created_at);
CREATE TABLE daily_closures (id, tenant_id, date, total_sales, total_cash);
CREATE TABLE whatsapp_sessions (id, tenant_id, phone, token, expires_at);
CREATE TABLE ai_usage (id, tenant_id, tokens_used, model, created_at);
CREATE TABLE subscriptions (id, tenant_id, plan, amount, status, next_billing);
```

### 4.4 Integración WhatsApp Business

```
Flujo Usuario POS Micro:
1. Usuario envía "hola" a número de WhatsApp
2. Bot responde: "Hola! Soy tu asistente. Puedo ayudarte con:
   - Ver ventas del día
   - Consultar stock de producto
   - Agregar producto
   - Ver reporte semanal"
3. Usuario: "ventas del día"
4. Bot: "Ventas hoy: $2,450 MXN (23 tickets)"
5. Usuario: "stock de coca cola"
6. Bot: "Coca Cola 600ml: 45 unidades en stock"

Costo: Tokens consumidos por consulta (~0.01-0.05 USD por consulta)
```

---

## 5. PLAN DE IMPLEMENTACIÓN

### Fase 1: Preparación (Inmediato)

| Tarea | Descripción | Prioridad |
|-------|-------------|-----------|
| 1.1 | Actualizar HERENCIA-ERP-CORE.md en todas las verticales | P0 |
| 1.2 | Crear estructura `apps/products/` | P0 |
| 1.3 | Crear documentación base para pos-micro | P0 |
| 1.4 | Crear documentación base para erp-basico | P0 |
| 1.5 | Actualizar SaaS layer con billing básico | P0 |

### Fase 2: POS Micro (Prioridad Alta)

| Tarea | Descripción | Estimación |
|-------|-------------|------------|
| 2.1 | Diseñar schema BD (~10 tablas) | 2h |
| 2.2 | Implementar backend mínimo | 8h |
| 2.3 | Implementar PWA frontend | 8h |
| 2.4 | Integrar WhatsApp Business API | 4h |
| 2.5 | Implementar offline-first | 4h |
| 2.6 | Testing y validación | 4h |

### Fase 3: ERP Básico SaaS

| Tarea | Descripción | Estimación |
|-------|-------------|------------|
| 3.1 | Definir módulos incluidos vs opcionales | 2h |
| 3.2 | Configurar feature flags | 4h |
| 3.3 | Implementar billing/suscripciones | 8h |
| 3.4 | Portal de onboarding | 8h |
| 3.5 | Testing multi-tenant | 4h |

### Fase 4: Propagación

| Tarea | Descripción |
|-------|-------------|
| 4.1 | Actualizar inventarios en todos los proyectos |
| 4.2 | Verificar HERENCIA-DIRECTIVAS en cada vertical |
| 4.3 | Ejecutar CHECKLIST-PROPAGACION en todos los niveles |
| 4.4 | Documentar dependencias entre productos |

---

## 6. MÉTRICAS DE ALINEACIÓN

### 6.1 Checklist de Alineación por Proyecto

```yaml
Proyecto Alineado:
  Estructura:
    [ ] apps/backend/ existe
    [ ] apps/frontend/ existe
    [ ] apps/database/ existe
    [ ] docs/ con estructura estándar
    [ ] orchestration/ con estructura NEXUS

  Orchestration:
    [ ] 00-guidelines/CONTEXTO-PROYECTO.md
    [ ] PROXIMA-ACCION.md
    [ ] inventarios/MASTER_INVENTORY.yml
    [ ] trazas/ con archivos por capa
    [ ] HERENCIA-DIRECTIVAS.md

  Documentación:
    [ ] README.md actualizado
    [ ] Épicas documentadas
    [ ] Historias de usuario
    [ ] Especificaciones técnicas
    [ ] Schemas de BD

  Código:
    [ ] Sigue estándares de nomenclatura
    [ ] Entities alineadas con DDL
    [ ] DTOs con validaciones
    [ ] Tests implementados
    [ ] Build + Lint pasan
```

### 6.2 Estado Actual de Alineación

| Proyecto | Estructura | Orchestration | Docs | Código | TOTAL |
|----------|------------|---------------|------|--------|-------|
| Gamilit | 100% | 100% | 100% | 90% | **97%** |
| Trading | 100% | 90% | 95% | 70% | **89%** |
| ERP-Core | 100% | 100% | 100% | 0% | **75%** |
| Construcción | 100% | 100% | 100% | 25% | **81%** |
| Mecánicas Diesel | 100% | 100% | 95% | 0% | **74%** |
| Vidrio Templado | 80% | 50% | 0% | 0% | **33%** |
| Retail | 80% | 50% | 0% | 0% | **33%** |
| Clínicas | 80% | 50% | 0% | 0% | **33%** |
| Betting | 80% | 40% | 5% | 0% | **31%** |
| Inmobiliaria | 80% | 40% | 5% | 0% | **31%** |

---

## 7. ACCIONES INMEDIATAS

### 7.1 Crear Productos SaaS

```bash
# Crear estructura de productos
mkdir -p projects/erp-suite/apps/products/erp-basico/{backend,frontend,database,docs,orchestration}
mkdir -p projects/erp-suite/apps/products/pos-micro/{backend,frontend,pwa,database,docs,orchestration}
```

### 7.2 Propagar HERENCIA-ERP-CORE.md

Verticales que necesitan el archivo:
- [ ] vidrio-templado
- [ ] retail
- [ ] clinicas

### 7.3 Actualizar SaaS Layer

```bash
mkdir -p projects/erp-suite/apps/saas/{billing,portal,admin,onboarding}
```

---

## 8. CONCLUSIONES

1. **El sistema de orquestación está completo** - SIMCO, CAPVED, perfiles y catálogo bien definidos

2. **La documentación es excelente** - ERP-Core tiene 827 MD, gap analysis completo vs Odoo

3. **Falta implementación de código** - 0% en ERP-Core a pesar de 100% documentación

4. **Falta capa SaaS** - Crítico para comercialización

5. **Falta producto POS minimalista** - Oportunidad de mercado desatendida (100 MXN/mes)

6. **Verticales parcialmente alineadas** - 3 de 5 sin HERENCIA-ERP-CORE.md

7. **Proyectos standalone bien alineados** - Gamilit y Trading-Platform son ejemplos a seguir

---

*Documento generado: 2025-12-08*
*Sistema: NEXUS v3.2 + SIMCO + CAPVED*
