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