75a489a5d8
- Create orchestration/BOOTLOADER.md with NEXUS v4.0 protocol - Define PROVIDER role (exports to erp-core, erp-suite) - Document SaaS canonical patterns propagation - Define token budgets and startup sequence Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
203 lines
7.7 KiB
Markdown
203 lines
7.7 KiB
Markdown
# BOOTLOADER - Template SaaS
|
|
|
|
**Sistema:** NEXUS v4.0 - Protocolo de Arranque Local
|
|
**Proyecto:** Template SaaS
|
|
**Tipo:** PROVIDER
|
|
**Version:** 1.0.0
|
|
**Fecha:** 2026-01-24
|
|
|
|
---
|
|
|
|
## 1. Proposito
|
|
|
|
Este BOOTLOADER define la secuencia de arranque especifica para Template SaaS.
|
|
Como proyecto PROVIDER, este template exporta patrones a otros proyectos.
|
|
|
|
---
|
|
|
|
## 2. Secuencia de Arranque (5 Pasos)
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────┐
|
|
│ BOOTLOADER TEMPLATE-SAAS - 5 PASOS │
|
|
├─────────────────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ PASO 1: Cargar L0 (Sistema - Workspace) │
|
|
│ ════════════════════════════════════════ │
|
|
│ ├── Leer workspace-v2/CLAUDE.md │
|
|
│ ├── Verificar aliases del workspace disponibles │
|
|
│ └── Tokens: ~4000 │
|
|
│ │ │
|
|
│ ▼ │
|
|
│ PASO 2: Cargar L1 (Proyecto - Template SaaS) │
|
|
│ ════════════════════════════════════════ │
|
|
│ ├── Leer .claude/README.md (instrucciones locales) │
|
|
│ ├── Leer orchestration/CONTEXT-MAP.yml (variables resueltas) │
|
|
│ ├── Leer orchestration/_inheritance.yml (modelo de herencia) │
|
|
│ └── Tokens: ~2500 │
|
|
│ │ │
|
|
│ ▼ │
|
|
│ PASO 3: Determinar Dominio │
|
|
│ ════════════════════════════════════════ │
|
|
│ ├── Clasificar tarea (DDL, Backend, Frontend, Docs) │
|
|
│ ├── Cargar SIMCO del dominio │
|
|
│ └── Cargar inventario del dominio │
|
|
│ │ │
|
|
│ ▼ │
|
|
│ PASO 4: Verificar Estado │
|
|
│ ════════════════════════════════════════ │
|
|
│ ├── git fetch origin && git status │
|
|
│ ├── Verificar si hay trabajo en progreso │
|
|
│ └── Verificar consumidores afectados (erp-core, erp-suite) │
|
|
│ │ │
|
|
│ ▼ │
|
|
│ PASO 5: Iniciar Tarea │
|
|
│ ════════════════════════════════════════ │
|
|
│ ├── Crear carpeta de tarea si no existe │
|
|
│ ├── Ejecutar FASE C de CAPVED │
|
|
│ └── Evaluar propagacion a consumidores │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## 3. Archivos a Cargar por Paso
|
|
|
|
### PASO 1: L0 Sistema (~4000 tokens)
|
|
```yaml
|
|
obligatorio:
|
|
- path: "../../CLAUDE.md"
|
|
proposito: "Instrucciones del workspace"
|
|
tokens: 4000
|
|
```
|
|
|
|
### PASO 2: L1 Proyecto (~2500 tokens)
|
|
```yaml
|
|
obligatorio:
|
|
- path: ".claude/README.md"
|
|
proposito: "Instrucciones locales Template SaaS"
|
|
tokens: 500
|
|
|
|
- path: ".claude/constants/CONSTANTS-PROJECT.yml"
|
|
proposito: "Constantes del proyecto"
|
|
tokens: 400
|
|
|
|
- path: "orchestration/CONTEXT-MAP.yml"
|
|
proposito: "Variables y aliases resueltos"
|
|
tokens: 800
|
|
|
|
- path: "orchestration/_inheritance.yml"
|
|
proposito: "Modelo de herencia PROVIDER"
|
|
tokens: 400
|
|
|
|
- path: "orchestration/inventarios/MASTER_INVENTORY.yml"
|
|
proposito: "Estado de artefactos"
|
|
tokens: 400
|
|
```
|
|
|
|
### PASO 3: L2 Operacion (variable, ~2500 tokens)
|
|
```yaml
|
|
por_dominio:
|
|
DDL:
|
|
- "workspace-v2/orchestration/directivas/simco/SIMCO-DDL.md"
|
|
- "orchestration/inventarios/DATABASE_INVENTORY.yml"
|
|
|
|
Backend:
|
|
- "workspace-v2/orchestration/directivas/simco/SIMCO-BACKEND.md"
|
|
- "orchestration/inventarios/BACKEND_INVENTORY.yml"
|
|
|
|
Frontend:
|
|
- "workspace-v2/orchestration/directivas/simco/SIMCO-FRONTEND.md"
|
|
- "orchestration/inventarios/FRONTEND_INVENTORY.yml"
|
|
```
|
|
|
|
---
|
|
|
|
## 4. Rol PROVIDER
|
|
|
|
Template SaaS es un proyecto **PROVIDER**:
|
|
|
|
```yaml
|
|
exporta_a:
|
|
- erp-core # Hereda patrones SaaS base
|
|
- erp-suite # Hereda arquitectura multitenancy
|
|
|
|
patrones_canonicos:
|
|
- multitenancy (schema-per-tenant)
|
|
- feature_flags
|
|
- subscriptions
|
|
- rate_limiting
|
|
- audit_logging
|
|
|
|
regla_propagacion: |
|
|
Cambios en patrones SaaS DEBEN propagarse a consumidores.
|
|
Usar @PROPAGATE-CODE para codigo.
|
|
Usar @PROPAGATE-DOC para documentacion.
|
|
```
|
|
|
|
---
|
|
|
|
## 5. Variables Pre-Resueltas
|
|
|
|
```yaml
|
|
# Paths principales
|
|
PROJECT_ROOT: projects/template-saas
|
|
BACKEND_ROOT: projects/template-saas/backend
|
|
FRONTEND_ROOT: projects/template-saas/frontend
|
|
DATABASE_ROOT: projects/template-saas/database
|
|
|
|
# Base de datos
|
|
DB_NAME: template_saas_db
|
|
DB_USER: template_saas_user
|
|
DB_PASSWORD: saas_dev_2026
|
|
DB_PORT: 5432
|
|
|
|
# Schemas
|
|
SCHEMAS:
|
|
- public
|
|
- tenants
|
|
- subscriptions
|
|
```
|
|
|
|
---
|
|
|
|
## 6. Checklist de Arranque
|
|
|
|
### Al Iniciar Sesion en Template SaaS
|
|
|
|
- [ ] PASO 1: workspace-v2/CLAUDE.md leido
|
|
- [ ] PASO 2: .claude/README.md leido
|
|
- [ ] PASO 2: CONTEXT-MAP.yml cargado
|
|
- [ ] PASO 2: _inheritance.yml verificado
|
|
- [ ] PASO 3: Dominio identificado
|
|
- [ ] PASO 3: SIMCO del dominio cargado
|
|
- [ ] PASO 4: git fetch ejecutado
|
|
- [ ] PASO 4: Consumidores identificados
|
|
- [ ] PASO 5: Propagacion evaluada
|
|
|
|
### Presupuesto de Tokens
|
|
|
|
| Nivel | Tokens | Descripcion |
|
|
|-------|--------|-------------|
|
|
| L0 Sistema | 4,000 | Workspace CLAUDE.md |
|
|
| L1 Proyecto | 2,500 | Template SaaS local |
|
|
| L2 Operacion | 2,500 | SIMCO + inventario |
|
|
| L3 Tarea | 8,000 | Contexto especifico |
|
|
| **Total base** | **9,000** | Sin tarea |
|
|
| **Total maximo** | **17,000** | Con tarea |
|
|
|
|
---
|
|
|
|
## 7. Referencias
|
|
|
|
- **BOOTLOADER Global:** `workspace-v2/orchestration/directivas/simco/SIMCO-BOOTLOADER.md`
|
|
- **CONTEXT-MAP:** `orchestration/CONTEXT-MAP.yml`
|
|
- **Herencia:** `orchestration/_inheritance.yml`
|
|
- **README Local:** `.claude/README.md`
|
|
|
|
---
|
|
|
|
*BOOTLOADER Template SaaS v1.0.0 - Sistema NEXUS v4.0*
|
|
*Tipo: PROVIDER - Exporta a erp-core, erp-suite*
|