rckrdmrd/template-saas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
e7767e03be
template-saas/orchestration/BOOTLOADER.md
Adrian Flores Cortes 75a489a5d8
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
[TASK-2026-01-24-REESTRUCTURACION] feat: Add BOOTLOADER protocol 
- 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>
2026-01-24 07:44:36 -06:00

7.7 KiB
Raw Blame History

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)

obligatorio:
  - path: "../../CLAUDE.md"
    proposito: "Instrucciones del workspace"
    tokens: 4000

PASO 2: L1 Proyecto (~2500 tokens)

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)

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:

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

# 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