rckrdmrd/template-saas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[TASK-2026-01-24-REESTRUCTURACION] feat: Add BOOTLOADER protocol
Some checks are pending
CI / Backend CI (push) Waiting to run
Details
CI / Frontend CI (push) Waiting to run
Details
CI / Security Scan (push) Waiting to run
Details
CI / CI Summary (push) Blocked by required conditions
Details

Browse Source 
- 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>
This commit is contained in:
Adrian Flores Cortes 2026-01-24 07:44:36 -06:00
parent 50a821a415
commit 75a489a5d8
1 changed files with 202 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

202
orchestration/BOOTLOADER.md Normal file
View File

@ -0,0 +1,202 @@
# 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*