rckrdmrd/michangarrito
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
michangarrito/orchestration/BOOTLOADER.md
Adrian Flores Cortes 2de6534b92
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
[TASK-2026-01-24-ESTANDAR-ORCHESTRATION] feat: Add missing orchestration files 
- 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>
2026-01-24 09:28:12 -06:00

6.9 KiB
Raw Permalink Blame History

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:

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

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