[TASK-2026-01-24-ESTANDAR-ORCHESTRATION] feat: Add missing orchestration files
Some checks are pending
CI/CD Pipeline / Backend CI (push) Waiting to run
CI/CD Pipeline / Frontend CI (push) Waiting to run
CI/CD Pipeline / WhatsApp Service CI (push) Waiting to run
CI/CD Pipeline / Mobile CI (push) Waiting to run
CI/CD Pipeline / Docker Build (./apps/backend, ./apps/backend/Dockerfile, backend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/frontend, ./apps/frontend/Dockerfile, frontend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/whatsapp-service, ./apps/whatsapp-service/Dockerfile, whatsapp-service) (push) Blocked by required conditions
CI/CD Pipeline / Deploy to Production (push) Blocked by required conditions
Some checks are pending
CI/CD Pipeline / Backend CI (push) Waiting to run
CI/CD Pipeline / Frontend CI (push) Waiting to run
CI/CD Pipeline / WhatsApp Service CI (push) Waiting to run
CI/CD Pipeline / Mobile CI (push) Waiting to run
CI/CD Pipeline / Docker Build (./apps/backend, ./apps/backend/Dockerfile, backend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/frontend, ./apps/frontend/Dockerfile, frontend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/whatsapp-service, ./apps/whatsapp-service/Dockerfile, whatsapp-service) (push) Blocked by required conditions
CI/CD Pipeline / Deploy to Production (push) Blocked by required conditions
- 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
parent
ba3abf8837
commit
2de6534b92
171
orchestration/BOOTLOADER.md
Normal file
171
orchestration/BOOTLOADER.md
Normal 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
204
orchestration/DEPENDENCY-GRAPH.yml
Normal 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
193
orchestration/PROJECT-PROFILE.yml
Normal 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
197
orchestration/TRACEABILITY.yml
Normal 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)"
|
||||||
Loading…
Reference in New Issue
Block a user