​

Planes y Suscripciones

​

Comparación de Planes

​

Enforcement de Límites

​

Funciones de Validación

# Verifica límite de proyectos al crear
await check_project_limit(db, org_id)

# Verifica límite de CLI tools al configurar
await check_cli_tools_limit(db, org_id, project_id, new_count)

# Verifica límite de miembros al invitar
await check_member_limit(db, org_id)

# Verifica acceso a skills premium
await check_premium_skill(db, org_id, is_premium_skill=True)

​

Dónde se Aplican

​

Plan Enterprise

# En plan_enforcement.py
PLAN_LIMITS = {
    "free": {"max_projects": 3, "max_cli_tools": 5, "max_members": 1, ...},
    "premium": {"max_projects": 100, "max_cli_tools": 999999, "max_members": 50, ...},
    "enterprise": {"max_projects": 999999, "max_cli_tools": 999999, "max_members": 999999, ...},
}

​

Flujo de Upgrade (Stripe)

Usuario Free → Click "Hacer Upgrade" → Stripe Checkout → Confirmar → Plan Premium activo

​

Pasos Técnicos

1. Frontend: Click en “Hacer Upgrade” llama api.createCheckout()
2. Backend: POST /billing/create-checkout crea sesión de Stripe Checkout
3. Stripe: Redirige al usuario al formulario de pago
4. Callback: Stripe redirige a /dashboard/billing?session_id=...
5. Backend: POST /billing/confirm-subscription verifica pago y actualiza plan
6. DB: organization.plan = "premium", user.plan = "premium"

​

Variables de Entorno Requeridas

STRIPE_SECRET_KEY=sk_live_...       # API key de Stripe (server-side)
STRIPE_PUBLISHABLE_KEY=pk_live_...  # API key de Stripe (client-side)
STRIPE_WEBHOOK_SECRET=whsec_...     # Para validar webhooks (opcional)

​

Script-Runners (Hooks)

​

Configuración en nexus.yaml

environments:
  development:
    branch: develop
    env:
      NODE_ENV: development
    hooks:
      - name: "Instalar dependencias"
        command: "npm install"
        phase: pre          # Se ejecuta ANTES del switch
        timeout: 120        # Segundos (default: 30)
      - name: "Iniciar dev server"
        command: "npm run dev &"
        phase: post         # Se ejecuta DESPUÉS del switch
        timeout: 10
      - name: "Run migrations"
        command: "npx prisma migrate deploy"
        phase: post
        timeout: 60

​

Fases de Ejecución

PRE hooks → Skills (env vars, git, CLI profiles) → CLI profile switching → POST hooks

​

Comportamiento

• Timeout: Default 30s. Si un hook excede el timeout, se marca como failed
• Directorio: Los scripts se ejecutan desde project.root_path si está definido
• Shell: Ejecutados via sh -c en Linux/macOS
• Output: La salida del script se captura y registra en el audit log
• Errores: Un hook fallido no detiene la ejecución de los siguientes hooks ni de los skills

​

API Schema

{
  "hooks": [
    {
      "name": "Run migrations",
      "command": "npm run migrate",
      "phase": "post",
      "timeout": 30
    }
  ]
}

• POST /projects/{slug}/environments (crear entorno con hooks)
• PUT /projects/{slug}/environments/{name} (actualizar hooks de un entorno)

​

Seed de Skills

​

Skills Incluidos (Free)

1. Branch Switcher — Cambia a la rama Git del entorno
2. CLI Profiler — Configura CLIs según el perfil activo
3. Context Snapshot — Guarda snapshot del estado antes de cambiar
4. Env Injector — Inyecta variables de entorno
5. Git Context — Detecta rama, último commit y working tree

​

Skills Premium

1. Auto Documentation — Genera docs automáticas del proyecto
2. Cloud Audit Sync — Sincroniza audit log con la nube
3. Parallel Switch — Cambia múltiples servicios en paralelo
4. Sandbox Environments — Crea entornos efímeros aislados
5. Script Runner — Ejecuta scripts pre/post switch
6. Dependency Checker — Verifica dependencias del proyecto
7. Secret Rotator — Audita y rota secrets expirados