2de6534b92
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>
172 lines
6.9 KiB
Markdown
172 lines
6.9 KiB
Markdown
# 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*
|