rckrdmrd/michangarrito
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[TASK-2026-01-24-ESTANDAR-ORCHESTRATION] feat: Add missing orchestration files
Some checks are pending
CI/CD Pipeline / Backend CI (push) Waiting to run
Details
CI/CD Pipeline / Frontend CI (push) Waiting to run
Details
CI/CD Pipeline / WhatsApp Service CI (push) Waiting to run
Details
CI/CD Pipeline / Mobile CI (push) Waiting to run
Details
CI/CD Pipeline / Docker Build (./apps/backend, ./apps/backend/Dockerfile, backend) (push) Blocked by required conditions
Details
CI/CD Pipeline / Docker Build (./apps/frontend, ./apps/frontend/Dockerfile, frontend) (push) Blocked by required conditions
Details
CI/CD Pipeline / Docker Build (./apps/whatsapp-service, ./apps/whatsapp-service/Dockerfile, whatsapp-service) (push) Blocked by required conditions
Details
CI/CD Pipeline / Deploy to Production (push) Blocked by required conditions
Details

Browse Source 
- Add BOOTLOADER.md (NEXUS startup protocol)
- Add PROJECT-PROFILE.yml (project metadata)
- Add DEPENDENCY-GRAPH.yml (dependencies)
- Add TRACEABILITY.yml (version history)

Complies with SIMCO-ESTANDAR-ORCHESTRATION.md v1.0.0

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes 2026-01-24 09:28:12 -06:00
parent ba3abf8837
commit 2de6534b92
4 changed files with 765 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

171
orchestration/BOOTLOADER.md Normal file
View File

@ -0,0 +1,171 @@
# BOOTLOADER - MiChangarrito
**Sistema:** NEXUS v4.0 - Protocolo de Arranque Local
**Proyecto:** MiChangarrito
**Tipo:** CONSUMER (Integrates de template-saas)
**Version:** 1.0.0
**Fecha:** 2026-01-24
---
## 1. Propósito
Este BOOTLOADER define la secuencia de arranque específica para MiChangarrito.
Como proyecto CONSUMER que integra de template-saas, hereda patrones SaaS
adaptados para una plataforma POS de micro-negocios.
---
## 2. Cadena de Herencia
```
workspace-v2 (L0)
│
▼
template-saas (PROVIDER)
│
▼
michangarrito (CONSUMER) ◄── ESTE PROYECTO
```
---
## 3. Secuencia de Arranque (5 Pasos)
```
┌─────────────────────────────────────────────────────────────────────────┐
│ BOOTLOADER MICHANGARRITO - 5 PASOS │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ PASO 1: Cargar L0 (Sistema - Workspace) │
│ ════════════════════════════════════════ │
│ ├── Leer workspace-v2/CLAUDE.md │
│ └── Tokens: ~4000 │
│ │ │
│ ▼ │
│ PASO 2: Cargar L1 (Proyecto - MiChangarrito) │
│ ════════════════════════════════════════ │
│ ├── Leer orchestration/CONTEXT-MAP.yml │
│ ├── Leer orchestration/_inheritance.yml │
│ └── Tokens: ~2000 │
│ │ │
│ ▼ │
│ PASO 3: Determinar Dominio │
│ ════════════════════════════════════════ │
│ ├── Clasificar tarea (Backend, Frontend, Mobile, WhatsApp, MCP) │
│ ├── Cargar SIMCO del dominio │
│ └── Cargar inventario del dominio │
│ │ │
│ ▼ │
│ PASO 4: Verificar Estado y Sincronización │
│ ════════════════════════════════════════ │
│ ├── git fetch origin && git status │
│ ├── Verificar cambios heredados de template-saas │
│ └── Aplicar propagaciones pendientes │
│ │ │
│ ▼ │
│ PASO 5: Iniciar Tarea │
│ ════════════════════════════════════════ │
│ ├── Crear carpeta de tarea si no existe │
│ └── Ejecutar FASE C de CAPVED │
│ │
└─────────────────────────────────────────────────────────────────────────┘
```
---
## 4. Rol CONSUMER (Integrates)
MiChangarrito integra selectivamente de template-saas:
```yaml
hereda_de:
- workspace-v2/orchestration/ # Directivas globales
- projects/template-saas/ # Patrones SaaS
exporta_a: [] # No exporta a otros proyectos
modulos_integrados:
- auth # OTP + JWT + PIN + Biométrico
- tenants # Multi-tenancy con RLS
- billing # Suscripciones y tokens IA
- notifications
modulos_propios:
- catalogo-productos # CRUD productos
- punto-venta # POS completo
- mcp-server # Gateway LLM
- whatsapp-service # Meta Cloud API
- modo-offline # SQLite + sync
regla_sincronizacion: |
Recibir cambios de template-saas según SLA definido.
Security fixes: Aplicar en 24h.
Bug fixes: Aplicar en 72h.
Features: Evaluar adaptación.
```
---
## 5. Variables Pre-Resueltas
```yaml
PROJECT_ROOT: projects/michangarrito
BACKEND_ROOT: projects/michangarrito/apps/backend
FRONTEND_ROOT: projects/michangarrito/apps/frontend
MOBILE_ROOT: projects/michangarrito/apps/mobile
DATABASE_ROOT: projects/michangarrito/apps/database
MCP_ROOT: projects/michangarrito/apps/mcp-server
WHATSAPP_ROOT: projects/michangarrito/apps/whatsapp-service
PUERTOS:
backend: 3141
frontend: 3140
mobile: 8081
mcp_server: 3142
whatsapp_service: 3143
DATABASE:
nombre: michangarrito_dev
usuario: michangarrito_dev
puerto: 5432
```
---
## 6. Dominios del Proyecto
| Dominio | Path | Descripción |
|---------|------|-------------|
| Backend | apps/backend/ | API NestJS principal |
| Frontend | apps/frontend/ | React Web App |
| Mobile | apps/mobile/ | React Native + Expo |
| MCP Server | apps/mcp-server/ | Gateway LLM agnóstico |
| WhatsApp | apps/whatsapp-service/ | Meta Cloud API |
| Database | apps/database/ | DDL PostgreSQL |
---
## 7. Checklist de Arranque
- [ ] PASO 1: workspace-v2/CLAUDE.md leído
- [ ] PASO 2: CONTEXT-MAP.yml cargado
- [ ] PASO 2: _inheritance.yml verificado
- [ ] PASO 3: Dominio identificado
- [ ] PASO 4: git fetch ejecutado
- [ ] PASO 4: Cambios de template-saas verificados
- [ ] PASO 5: Tarea iniciada
---
## 8. Referencias
- **BOOTLOADER Global:** `workspace-v2/orchestration/directivas/simco/SIMCO-BOOTLOADER.md`
- **Template SaaS:** `../template-saas/orchestration/BOOTLOADER.md`
- **CONTEXT-MAP:** `orchestration/CONTEXT-MAP.yml`
- **Herencia:** `orchestration/_inheritance.yml`
---
*BOOTLOADER MiChangarrito v1.0.0 - Sistema NEXUS v4.0*
*Tipo: CONSUMER - Integra de template-saas*

204
orchestration/DEPENDENCY-GRAPH.yml Normal file
View File

@ -0,0 +1,204 @@
# ═══════════════════════════════════════════════════════════════════════════════
# DEPENDENCY-GRAPH.yml - MiChangarrito
# ═══════════════════════════════════════════════════════════════════════════════
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Propósito: Grafo de dependencias del proyecto
# Fecha: 2026-01-24
#
# ═══════════════════════════════════════════════════════════════════════════════
version: "1.0.0"
proyecto: "michangarrito"
tipo: "CONSUMER"
fecha_actualizacion: "2026-01-24"
# ─────────────────────────────────────────────────────────────────────────────
# DEPENDENCIAS ENTRANTES
# ─────────────────────────────────────────────────────────────────────────────
depende_de:
workspace:
- ruta: "orchestration/directivas/simco/"
tipo: "directivas"
descripcion: "Directivas SIMCO del workspace"
template_saas:
- modulo: "auth"
tipo: "patron"
adaptacion: "OTP + JWT + PIN + Biométrico"
- modulo: "tenants"
tipo: "patron"
adaptacion: "Multi-tenancy con RLS"
- modulo: "billing"
tipo: "patron"
adaptacion: "Planes de suscripción"
- modulo: "notifications"
tipo: "patron"
adaptacion: "Push, WhatsApp, Email"
externos:
- nombre: "PostgreSQL"
version: "16+"
tipo: "database"
- nombre: "Redis"
version: "7+"
tipo: "cache"
- nombre: "Node.js"
version: "20+"
tipo: "runtime"
- nombre: "Meta Cloud API"
tipo: "external_api"
descripcion: "WhatsApp Business"
- nombre: "Stripe"
tipo: "external_api"
descripcion: "Pagos con tarjeta"
- nombre: "MercadoPago"
tipo: "external_api"
descripcion: "Pagos LATAM"
- nombre: "OpenAI/Anthropic"
tipo: "external_api"
descripcion: "LLM providers"
# ─────────────────────────────────────────────────────────────────────────────
# DEPENDENCIAS SALIENTES
# ─────────────────────────────────────────────────────────────────────────────
consumidores:
nota: "MiChangarrito es aplicación final, no tiene consumidores de código"
proyectos: []
# ─────────────────────────────────────────────────────────────────────────────
# DEPENDENCIAS INTERNAS
# ─────────────────────────────────────────────────────────────────────────────
dependencias_internas:
apps:
backend:
depende_de:
- "database (DDL)"
- "Redis (cache)"
consumidores:
- "frontend"
- "mobile"
- "mcp-server"
- "whatsapp-service"
frontend:
depende_de:
- "backend (API)"
consumidores: []
mobile:
depende_de:
- "backend (API)"
- "SQLite (offline)"
consumidores: []
mcp_server:
depende_de:
- "backend (API)"
- "OpenAI/Anthropic (LLM)"
consumidores:
- "whatsapp-service"
whatsapp_service:
depende_de:
- "backend (API)"
- "mcp-server"
- "Meta Cloud API"
consumidores: []
# ─────────────────────────────────────────────────────────────────────────────
# GRAFO VISUAL
# ─────────────────────────────────────────────────────────────────────────────
grafo_visual: |
workspace-v2/orchestration/ (directivas)
│
▼
template-saas (PROVIDER)
│
▼ (integración selectiva)
┌─────────────────────────────────────────────────────────────────────────┐
│ michangarrito (CONSUMER) │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ DATABASE (PostgreSQL) │ │
│ │ public │ auth │ catalog │ sales │ inventory │ messaging │ ... │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ ▲ │
│ │ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ BACKEND (NestJS) │ │
│ │ │ │
│ │ ┌──────┐ ┌─────────┐ ┌─────────┐ ┌──────────┐ ┌────────────┐ │ │
│ │ │ auth │ │ catalog │ │ sales │ │ tenants │ │ billing │ │ │
│ │ └──────┘ └─────────┘ └─────────┘ └──────────┘ └────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ ▲ ▲ ▲ │
│ │ │ │ │
│ ┌─────┴─────┐ ┌────┴────┐ ┌────┴────┐ │
│ │ │ │ │ │ │ │
│ ┌──────┐ ┌────────┐ ┌────────────┐ ┌───────────────────┐ │
│ │ Web │ │ Mobile │ │ MCP Server │ │ WhatsApp Service │ │
│ │React │ │ Expo │ │ (LLM GW) │ │ (Meta Cloud) │ │
│ └──────┘ └────────┘ └────────────┘ └───────────────────┘ │
│ │ │ │
│ ▼ │ │
│ ┌─────────────┐ │ │
│ │ OpenAI/ │◄───────────┘ │
│ │ Anthropic │ │
│ └─────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
│
▼
Usuarios finales (Micro-negocios mexicanos)
# ─────────────────────────────────────────────────────────────────────────────
# IMPACTO DE CAMBIOS
# ─────────────────────────────────────────────────────────────────────────────
impacto_cambios:
alto:
- modulo: "backend/auth"
razon: "Todos los servicios dependen de autenticación"
- modulo: "backend/tenants"
razon: "Multi-tenancy afecta todos los datos"
- modulo: "database/schemas"
razon: "Cambios DDL requieren migraciones"
medio:
- modulo: "mcp-server"
razon: "WhatsApp service depende de él"
- modulo: "billing"
razon: "Afecta suscripciones y tokens IA"
bajo:
- modulo: "frontend"
razon: "UI independiente"
- modulo: "mobile"
razon: "Tiene modo offline"
# ─────────────────────────────────────────────────────────────────────────────
# NOTAS
# ─────────────────────────────────────────────────────────────────────────────
notas:
- "MiChangarrito es aplicación final sin consumidores de código"
- "Integra selectivamente patrones de template-saas"
- "6 aplicaciones en monorepo con dependencias claras"
- "Backend es el núcleo del que dependen todos los servicios"

193
orchestration/PROJECT-PROFILE.yml Normal file
View File

@ -0,0 +1,193 @@
# ═══════════════════════════════════════════════════════════════════════════════
# PROJECT-PROFILE.yml - MiChangarrito
# ═══════════════════════════════════════════════════════════════════════════════
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Propósito: Perfil y metadata del proyecto
# Fecha: 2026-01-24
#
# ═══════════════════════════════════════════════════════════════════════════════
# ─────────────────────────────────────────────────────────────────────────────
# IDENTIFICACIÓN
# ─────────────────────────────────────────────────────────────────────────────
proyecto:
nombre: "MiChangarrito"
codigo: "michangarrito"
tipo: "CONSUMER"
subtipo: "INTEGRATES"
nivel: "2A"
version: "2.0.0"
descripcion: |
Plataforma POS inteligente multi-tenant para micro-negocios mexicanos.
Incluye asistente IA vía WhatsApp, facturación CFDI 4.0 y marketplace B2B.
Público objetivo: Tiendas de abarrotes, fondas, puestos, micro-negocios.
Características principales:
- Punto de venta móvil-first
- Onboarding vía WhatsApp con IA
- Modo offline con sincronización
- Multi-tenant con RLS
- Integración MercadoPago/Stripe/Clip
# ─────────────────────────────────────────────────────────────────────────────
# STACK TECNOLÓGICO
# ─────────────────────────────────────────────────────────────────────────────
stack:
backend:
framework: "NestJS"
version: "^10.3.0"
lenguaje: "TypeScript"
orm: "TypeORM"
auth: "JWT + OTP + PIN + Biométrico"
frontend:
framework: "React"
version: "^19.2.0"
lenguaje: "TypeScript"
ui: "Tailwind CSS"
build: "Vite"
mobile:
framework: "React Native"
sdk: "Expo"
offline: "SQLite + WatermelonDB"
services:
mcp_server:
descripcion: "Gateway LLM agnóstico"
lenguaje: "TypeScript"
puerto: 3142
whatsapp_service:
descripcion: "Meta Cloud API"
framework: "NestJS"
puerto: 3143
database:
motor: "PostgreSQL"
version: "16+"
schemas: 11
rls: true
infraestructura:
contenedores: "Docker"
orquestacion: "docker-compose"
cache: "Redis 7"
region: "LATAM (México)"
# ─────────────────────────────────────────────────────────────────────────────
# RUTAS DEL PROYECTO
# ─────────────────────────────────────────────────────────────────────────────
rutas:
proyecto: "projects/michangarrito"
backend: "projects/michangarrito/apps/backend"
frontend: "projects/michangarrito/apps/frontend"
mobile: "projects/michangarrito/apps/mobile"
database: "projects/michangarrito/apps/database"
mcp_server: "projects/michangarrito/apps/mcp-server"
whatsapp_service: "projects/michangarrito/apps/whatsapp-service"
docs: "projects/michangarrito/docs"
orchestration: "projects/michangarrito/orchestration"
# ─────────────────────────────────────────────────────────────────────────────
# PUERTOS
# ─────────────────────────────────────────────────────────────────────────────
puertos:
backend: 3141
frontend: 3140
mobile: 8081
mcp_server: 3142
whatsapp_service: 3143
postgres: 5432
redis: 6379
# ─────────────────────────────────────────────────────────────────────────────
# MÓDULOS
# ─────────────────────────────────────────────────────────────────────────────
modulos:
integrados_de_template_saas:
- nombre: "auth"
estado: "activo"
adaptacion: "OTP + JWT + PIN + Biométrico"
- nombre: "tenants"
estado: "activo"
adaptacion: "Cada negocio = 1 tenant"
- nombre: "billing"
estado: "activo"
adaptacion: "Plan Changarrito $99, Plan Tiendita $199"
- nombre: "notifications"
estado: "activo"
adaptacion: "Push, WhatsApp, Email"
propios:
- nombre: "catalogo-productos"
id: "MCH-003"
estado: "completado"
descripcion: "CRUD productos, categorías, templates"
- nombre: "punto-venta"
id: "MCH-004"
estado: "completado"
descripcion: "POS completo con carrito y tickets"
- nombre: "mcp-server"
id: "MCH-010"
estado: "completado"
descripcion: "Gateway LLM agnóstico con 15 herramientas"
- nombre: "whatsapp-service"
id: "MCH-011"
estado: "completado"
descripcion: "Meta Cloud API multi-tenant"
- nombre: "modo-offline"
id: "MCH-022"
estado: "completado"
descripcion: "SQLite + sync + resolución conflictos"
# ─────────────────────────────────────────────────────────────────────────────
# ESTADO
# ─────────────────────────────────────────────────────────────────────────────
estado:
general: "activo"
madurez: "pre-producción"
mvp: "95%"
en_produccion: false
bloqueos_produccion:
- "Cuenta Meta Business verificada (WhatsApp)"
- "API keys Stripe producción"
- "API keys LLM producción"
# ─────────────────────────────────────────────────────────────────────────────
# EQUIPO
# ─────────────────────────────────────────────────────────────────────────────
equipo:
owner: "ISEM Development"
agentes_principales:
- "Claude Code"
- "Trae"
- "Windsurf"
# ─────────────────────────────────────────────────────────────────────────────
# NOTAS
# ─────────────────────────────────────────────────────────────────────────────
notas:
- "Proyecto CONSUMER que integra selectivamente de template-saas"
- "Enfocado en micro-negocios mexicanos"
- "MVP 95% completado, pendiente configuración producción"
- "6 aplicaciones en monorepo (backend, frontend, mobile, mcp, whatsapp, database)"

197
orchestration/TRACEABILITY.yml Normal file
View File

@ -0,0 +1,197 @@
# ═══════════════════════════════════════════════════════════════════════════════
# TRACEABILITY.yml - MiChangarrito
# ═══════════════════════════════════════════════════════════════════════════════
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Propósito: Trazabilidad del proyecto
# Fecha: 2026-01-24
#
# ═══════════════════════════════════════════════════════════════════════════════
version: "1.0.0"
proyecto: "michangarrito"
tipo: "CONSUMER"
fecha_actualizacion: "2026-01-24"
# ─────────────────────────────────────────────────────────────────────────────
# HISTORIAL DE VERSIONES
# ─────────────────────────────────────────────────────────────────────────────
versiones:
- version: "2.0.0"
fecha: "2026-01-24"
descripcion: "Estandarización orchestration/ según SIMCO v4.3.0"
cambios:
- "Agregado BOOTLOADER.md"
- "Agregado PROJECT-PROFILE.yml"
- "Agregado DEPENDENCY-GRAPH.yml"
- "Agregado TRACEABILITY.yml"
- version: "1.9.0"
fecha: "2026-01-17"
descripcion: "Validación documental y actualización _inheritance.yml"
cambios:
- "Actualizado _inheritance.yml a v2.0.0"
- "Documentación de módulos integrados"
- "Validación de inventarios"
- version: "1.8.0"
fecha: "2026-01-15"
descripcion: "MVP 95% - Modo offline completado"
cambios:
- "MCH-022: Modo offline con SQLite"
- "Sincronización y resolución de conflictos"
- version: "1.5.0"
fecha: "2026-01-10"
descripcion: "Integración WhatsApp y MCP Server"
cambios:
- "MCH-010: MCP Server con 15 herramientas"
- "MCH-011: WhatsApp Service con Meta Cloud API"
- version: "1.0.0"
fecha: "2025-12-01"
descripcion: "MVP inicial"
cambios:
- "Infraestructura base"
- "Autenticación multi-método"
- "Catálogo de productos"
- "Punto de venta básico"
# ─────────────────────────────────────────────────────────────────────────────
# INTEGRACIONES DE TEMPLATE-SAAS
# ─────────────────────────────────────────────────────────────────────────────
integraciones:
- modulo: "auth"
fecha: "2025-12-01"
origen: "template-saas/auth"
adaptacion: "Agregado OTP, PIN, Biométrico"
estado: "activo"
- modulo: "tenants"
fecha: "2025-12-01"
origen: "template-saas/tenants"
adaptacion: "Cada negocio = 1 tenant"
estado: "activo"
- modulo: "billing"
fecha: "2025-12-15"
origen: "template-saas/billing"
adaptacion: "Planes Changarrito/Tiendita + tokens IA"
estado: "activo"
- modulo: "notifications"
fecha: "2026-01-05"
origen: "template-saas/notifications"
adaptacion: "Push, WhatsApp, Email"
estado: "activo"
# ─────────────────────────────────────────────────────────────────────────────
# ÉPICAS COMPLETADAS
# ─────────────────────────────────────────────────────────────────────────────
epicas_completadas:
- id: "MCH-001"
titulo: "Infraestructura Base"
estado: "completado"
fecha: "2025-11"
- id: "MCH-002"
titulo: "Autenticación Multi-método"
estado: "completado"
fecha: "2025-12"
- id: "MCH-003"
titulo: "Catálogo de Productos"
estado: "completado"
fecha: "2025-12"
- id: "MCH-004"
titulo: "Punto de Venta"
estado: "completado"
fecha: "2025-12"
- id: "MCH-005"
titulo: "Integraciones de Pago"
estado: "completado"
fecha: "2026-01"
- id: "MCH-010"
titulo: "MCP Server (Gateway LLM)"
estado: "completado"
fecha: "2026-01"
- id: "MCH-011"
titulo: "WhatsApp Service"
estado: "completado"
fecha: "2026-01"
- id: "MCH-018"
titulo: "Planes y Suscripciones"
estado: "completado"
fecha: "2026-01"
- id: "MCH-022"
titulo: "Modo Offline"
estado: "completado"
fecha: "2026-01"
# ─────────────────────────────────────────────────────────────────────────────
# VALIDACIONES
# ─────────────────────────────────────────────────────────────────────────────
validaciones:
ultima_validacion: "2026-01-24"
resultado: "passed"
archivos_obligatorios:
_MAP.md: true
_inheritance.yml: true
BOOTLOADER.md: true
CONTEXT-MAP.yml: true
PROJECT-PROFILE.yml: true
PROJECT-STATUS.md: true
PROXIMA-ACCION.md: true
DEPENDENCY-GRAPH.yml: true
TRACEABILITY.yml: true
MAPA-DOCUMENTACION.yml: true
estado_mvp: "95%"
apps_operativos:
backend: true
frontend: true
mobile: true
mcp_server: true
whatsapp_service: true
# ─────────────────────────────────────────────────────────────────────────────
# PENDIENTES PARA PRODUCCIÓN
# ─────────────────────────────────────────────────────────────────────────────
pendientes_produccion:
- item: "Cuenta Meta Business verificada"
tipo: "externo"
bloqueante: true
- item: "API keys Stripe producción"
tipo: "configuracion"
bloqueante: true
- item: "API keys LLM producción"
tipo: "configuracion"
bloqueante: true
- item: "Configuración de deployment"
tipo: "infraestructura"
bloqueante: false
# ─────────────────────────────────────────────────────────────────────────────
# NOTAS
# ─────────────────────────────────────────────────────────────────────────────
notas:
- "MVP 95% completado - pendiente configuración producción"
- "6 aplicaciones en monorepo funcionando"
- "Integración selectiva de template-saas exitosa"
- "Bloqueos de producción son externos (cuentas API)"