workspace/orchestration/ANALISIS-ALINEACION-WORKSPACE-2025-12-08.md

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

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

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

# 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

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