[SEMANA-2-AGENTES] feat: Add IDE configurations (L3)

- Add CLAUDE.md with project-specific instructions - Add .trae/rules/ and AGENT-CAPABILITIES.md - Add .windsurf/rules/ and AGENT-CAPABILITIES.md - Add .gemini/antigravity/README.md - Stack: NestJS 11.1.8, React 19.0.0, PostgreSQL 15+ - Type: PROVIDER (propagates to erp-core) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 17:31:34 -06:00 · 2026-01-24 17:31:34 -06:00 · db27093ba2
commit db27093ba2
parent 2f9c15e740
6 changed files with 590 additions and 0 deletions
--- a/.gemini/antigravity/README.md
+++ b/.gemini/antigravity/README.md
@ -0,0 +1,96 @@
+# Gemini Agent Configuration - Template SaaS
+
+**Proyecto:** template-saas
+**Tipo:** PROVIDER
+**Sistema:** SIMCO v4.0.0 + NEXUS v4.0
+
+---
+
+## Herencia
+
+Este proyecto hereda configuraciones de:
+- `workspace-v2/.gemini/antigravity/`
+- `workspace-v2/orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml`
+- `workspace-v2/orchestration/agents/configs/SHARED-PROJECT-REGISTRY.yml`
+
+---
+
+## Identificación del Proyecto
+
+```yaml
+aliases: ["template-saas", "template", "saas"]
+root: "projects/template-saas/"
+type: "PROVIDER"
+nivel_nexus: "L2"
+```
+
+---
+
+## Stack Tecnológico
+
+| Componente | Tecnología |
+|------------|------------|
+| Backend | NestJS 11.1.8 |
+| Frontend | React 19.0.0 |
+| Database | PostgreSQL 15+ |
+| ORM | TypeORM 0.3.22 |
+| Cache | Redis |
+
+---
+
+## Credenciales BD
+
+```yaml
+db_name: template_saas_dev
+db_user: template_saas_user
+db_pass: saas_dev_2026
+db_port: 5432
+```
+
+---
+
+## Boot Sequence
+
+Al trabajar en este proyecto:
+
+1. Cargar `workspace-v2/CLAUDE.md`
+2. Cargar `projects/template-saas/CLAUDE.md`
+3. Cargar `orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml`
+4. Cargar contexto específico según tarea
+
+---
+
+## Módulos Disponibles (19)
+
+```
+auth, tenants, users, billing, plans, ai, notifications,
+email, whatsapp, audit, feature-flags, webhooks, storage,
+analytics, reports, health, onboarding, rbac, superadmin
+```
+
+---
+
+## Paths de Trabajo
+
+```
+Backend:    projects/template-saas/backend/src/
+Frontend:   projects/template-saas/frontend/src/
+DDL:        projects/template-saas/database/ddl/
+Docs:       projects/template-saas/docs/
+```
+
+---
+
+## Propagación
+
+Como PROVIDER, evaluar propagación a:
+- erp-core (INTERMEDIATE)
+- Verticales ERP (via erp-core)
+
+---
+
+## Referencias
+
+- CLAUDE.md: `projects/template-saas/CLAUDE.md`
+- Inventarios: `projects/template-saas/orchestration/inventarios/`
+- Docs: `projects/template-saas/docs/`
--- a/.trae/AGENT-CAPABILITIES.md
+++ b/.trae/AGENT-CAPABILITIES.md
@ -0,0 +1,69 @@
+# Agent Capabilities - Trae IDE (Template SaaS)
+
+**Proyecto:** template-saas
+**Versión:** 1.0.0
+**Sistema:** SIMCO v4.0.0
+
+---
+
+## Herencia
+
+Este archivo extiende:
+- `workspace-v2/.trae/rules.md`
+- `workspace-v2/orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml`
+
+---
+
+## Capacidades en este Proyecto
+
+### Operaciones Permitidas
+
+| Operación | Status | Notas |
+|-----------|--------|-------|
+| Crear módulos backend | ✅ | Siguiendo estructura NestJS |
+| Crear componentes frontend | ✅ | Siguiendo estructura React |
+| Modificar DDL | ✅ | Con validación de coherencia |
+| Escribir tests | ✅ | Jest + Vitest |
+| Git operations | ✅ | Commit, push, pull |
+
+### Limitaciones Específicas
+
+1. **NO modificar** archivos de configuración Stripe sin revisión
+2. **NO cambiar** estructura de tenants sin plan aprobado
+3. **NO eliminar** módulos sin verificar dependencias
+
+---
+
+## Validaciones Requeridas
+
+Antes de marcar tarea como completada:
+
+```bash
+# Backend
+cd projects/template-saas/backend
+npm run build
+npm run lint
+npm run test
+
+# Frontend
+cd projects/template-saas/frontend
+npm run build
+npm run lint
+```
+
+---
+
+## Contexto del Proyecto
+
+- **19 módulos** backend activos
+- **3 portales** frontend (user, admin, superadmin)
+- **24 tablas** DDL definidas
+- **Multi-tenant** con RLS
+
+---
+
+## Quick Reference
+
+- CLAUDE.md: `projects/template-saas/CLAUDE.md`
+- Rules: `projects/template-saas/.trae/rules/project_rules.md`
+- Docs: `projects/template-saas/docs/`
--- a/.trae/rules/project_rules.md
+++ b/.trae/rules/project_rules.md
@ -0,0 +1,96 @@
+# Project Rules - Template SaaS (Trae IDE)
+
+**Proyecto:** template-saas
+**Tipo:** PROVIDER
+**Sistema:** SIMCO v4.0.0
+
+---
+
+## Reglas Heredadas
+
+Este proyecto hereda TODAS las reglas de:
+- `workspace-v2/CLAUDE.md`
+- `workspace-v2/.trae/rules.md`
+
+Las reglas aquí son EXTENSIONES específicas del proyecto.
+
+---
+
+## Stack
+
+- **Backend:** NestJS 11.1.8
+- **Frontend:** React 19.0.0 + Vite 6.0.6
+- **Database:** PostgreSQL 15+ con TypeORM
+- **Cache:** Redis (ioredis)
+
+---
+
+## Credenciales BD
+
+```
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=template_saas_dev
+DB_USER=template_saas_user
+DB_PASS=saas_dev_2026
+```
+
+---
+
+## Reglas Específicas
+
+### 1. Multi-Tenancy Obligatorio
+
+Todo endpoint y query debe:
+- Incluir `tenant_id` en el contexto
+- Usar Row Level Security (RLS)
+- Validar que el usuario pertenece al tenant
+
+### 2. Validación Stripe
+
+Los webhooks de Stripe deben:
+- Validar firma con `stripe-signature`
+- Usar `constructEvent()` de Stripe SDK
+- Manejar errores de validación
+
+### 3. Módulos Disponibles (19)
+
+```
+auth, tenants, users, billing, plans, ai, notifications,
+email, whatsapp, audit, feature-flags, webhooks, storage,
+analytics, reports, health, onboarding, rbac, superadmin
+```
+
+### 4. Tests
+
+Cobertura mínima: 70% para nuevos módulos
+Comando: `npm run test`
+
+---
+
+## Paths de Trabajo
+
+```
+Backend:    projects/template-saas/backend/src/
+Frontend:   projects/template-saas/frontend/src/
+DDL:        projects/template-saas/database/ddl/
+Docs:       projects/template-saas/docs/
+```
+
+---
+
+## Propagación
+
+Como PROVIDER, cambios aquí pueden propagarse a:
+- erp-core
+- Verticales ERP (via erp-core)
+
+**Siempre evaluar propagación después de completar tarea.**
+
+---
+
+## Referencias
+
+- CLAUDE.md local: `projects/template-saas/CLAUDE.md`
+- Constantes: `projects/template-saas/.claude/constants/CONSTANTS-PROJECT.yml`
+- Inventarios: `projects/template-saas/orchestration/inventarios/`
--- a/.windsurf/AGENT-CAPABILITIES.md
+++ b/.windsurf/AGENT-CAPABILITIES.md
@ -0,0 +1,72 @@
+# Agent Capabilities - Windsurf IDE (Template SaaS)
+
+**Proyecto:** template-saas
+**Versión:** 1.0.0
+**Modelo:** Cascade AI (NO-RAZONADOR)
+
+---
+
+## Paradigma NO-RAZONADOR
+
+Windsurf NO toma decisiones autónomas.
+Ejecuta instrucciones LITERALES únicamente.
+
+---
+
+## Capacidades
+
+| Capacidad | Status |
+|-----------|--------|
+| Edición de archivos | ✅ |
+| Creación de archivos | ✅ |
+| Ejecución de comandos | ✅ |
+| Git operations | ✅ |
+| Decisiones autónomas | ❌ |
+| Resolución de ambigüedad | ❌ |
+
+---
+
+## Limitaciones Críticas
+
+1. **NO puede** interpretar instrucciones vagas
+2. **NO puede** elegir entre alternativas
+3. **NO puede** modificar plan sin aprobación
+4. **Max 50 líneas** por operación
+
+---
+
+## Formato de Tarea Atómica
+
+```yaml
+tarea:
+  id: "TASK-XXX-T01"
+  archivo: "path/to/file.ts"
+  operacion: "EDITAR"
+  lineas_desde: 45
+  lineas_hasta: 52
+  codigo_actual: |
+    // código exacto actual
+  codigo_nuevo: |
+    // código exacto nuevo
+  validacion:
+    - "npm run build"
+    - "npm run lint"
+```
+
+---
+
+## Protocolo de Bloqueo
+
+Si hay ambigüedad:
+1. DETENER inmediatamente
+2. NO intentar resolver
+3. Reportar en BLOCKED-TASKS.yml
+4. Esperar resolución de agente superior
+
+---
+
+## Referencias
+
+- Shared configs: `orchestration/agents/configs/`
+- Platform config: `orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml`
+- Project rules: `.windsurf/rules/project_rules.md`
--- a/.windsurf/rules/project_rules.md
+++ b/.windsurf/rules/project_rules.md
@ -0,0 +1,102 @@
+# Project Rules - Template SaaS (Windsurf IDE)
+
+**Proyecto:** template-saas
+**Tipo:** PROVIDER
+**Sistema:** SIMCO v4.0.0
+
+---
+
+## IMPORTANTE: Windsurf es NO-RAZONADOR
+
+Windsurf con Cascade NO razona autónomamente.
+Sigue instrucciones LITERALMENTE.
+
+Si hay ambigüedad:
+1. DETENER
+2. Reportar en orchestration/trazas/BLOCKED-TASKS.yml
+3. Esperar resolución
+
+---
+
+## Reglas Heredadas
+
+Hereda TODAS las reglas de:
+- `workspace-v2/CLAUDE.md`
+- `workspace-v2/.windsurf/rules.md`
+
+---
+
+## Stack del Proyecto
+
+```yaml
+backend: NestJS 11.1.8
+frontend: React 19.0.0 + Vite
+database: PostgreSQL 15+ + TypeORM
+cache: Redis (ioredis)
+```
+
+---
+
+## Credenciales BD
+
+```
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=template_saas_dev
+DB_USER=template_saas_user
+DB_PASS=saas_dev_2026
+```
+
+---
+
+## Paths Absolutos
+
+```
+Backend:    C:\Empresas\ISEM\workspace-v2\projects\template-saas\backend\src\
+Frontend:   C:\Empresas\ISEM\workspace-v2\projects\template-saas\frontend\src\
+DDL:        C:\Empresas\ISEM\workspace-v2\projects\template-saas\database\ddl\
+```
+
+---
+
+## Reglas de Edición
+
+1. **Max 50 líneas** por cambio
+2. **NO usar placeholders** (// ... resto del código)
+3. **Código LITERAL** siempre
+4. **Verificar** archivo existe antes de editar
+
+---
+
+## Validaciones Post-Cambio
+
+```cmd
+cd C:\Empresas\ISEM\workspace-v2\projects\template-saas\backend
+npm run build
+npm run lint
+
+cd C:\Empresas\ISEM\workspace-v2\projects\template-saas\frontend
+npm run build
+npm run lint
+```
+
+---
+
+## Módulos Backend (19)
+
+```
+auth, tenants, users, billing, plans, ai, notifications,
+email, whatsapp, audit, feature-flags, webhooks, storage,
+analytics, reports, health, onboarding, rbac, superadmin
+```
+
+---
+
+## Bloqueos
+
+Si encuentras:
+- Ambigüedad en instrucciones → BLOQUEAR
+- Archivo no existe → BLOQUEAR
+- Conflicto con otro módulo → BLOQUEAR
+
+Reportar en: `orchestration/trazas/BLOCKED-TASKS.yml`
--- a/CLAUDE.md
+++ b/CLAUDE.md
@ -0,0 +1,155 @@
+# CLAUDE.md - Template SaaS
+
+**Hereda de:** workspace-v2/CLAUDE.md
+**Sistema:** SIMCO v4.0.0 + NEXUS v4.0
+**Proyecto:** template-saas
+**Tipo:** PROVIDER (L1A)
+**Versión:** 1.1.0
+**Actualizado:** 2026-01-24
+
+---
+
+## EXTENSIONES LOCALES
+
+Este archivo EXTIENDE (no reemplaza) las reglas del workspace.
+Para reglas base, ver: `../../CLAUDE.md`
+
+---
+
+## STACK TECNOLÓGICO
+
+| Capa | Tecnología | Versión |
+|------|------------|---------|
+| Backend | NestJS | 11.1.8 |
+| Frontend | React | 19.0.0 |
+| Build Tool | Vite | 6.0.6 |
+| Base de Datos | PostgreSQL | 15+ |
+| ORM | TypeORM | 0.3.22 |
+| Cache | Redis (ioredis) | 5.9.0 |
+| Queue | BullMQ | 5.66.4 |
+| Payments | Stripe | 17.5.0 |
+| State Mgmt | Zustand | 5.0.2 |
+| UI Framework | Tailwind CSS | 3.4.17 |
+
+---
+
+## CREDENCIALES BD
+
+```
+Database: template_saas_dev
+User: template_saas_user
+Password: saas_dev_2026
+Port: 5432
+Host: localhost
+```
+
+---
+
+## DIRECTORIOS CLAVE
+
+```
+backend/           → Backend NestJS (19 módulos)
+frontend/          → Frontend React (3 portales)
+database/ddl/      → DDL PostgreSQL (24 tablas)
+docs/              → Documentación técnica
+orchestration/     → Sistema SIMCO local
+.claude/           → Instrucciones Claude Code
+```
+
+---
+
+## HERENCIA
+
+### Este proyecto hereda de:
+- `workspace-v2/orchestration/` → Directivas globales, triggers, modos
+- `workspace-v2/shared/catalog/` → Funcionalidades reutilizables
+
+### Este proyecto exporta a:
+- `erp-core` → Patrones base SaaS, auth, multi-tenancy
+- Verticales ERP → Via erp-core (herencia transitiva)
+
+---
+
+## MÓDULOS BACKEND (19)
+
+| Módulo | Descripción |
+|--------|-------------|
+| auth | JWT, OAuth ready, MFA |
+| tenants | Multi-tenancy con RLS |
+| users | Gestión de usuarios |
+| billing | Integración Stripe |
+| plans | Límites y suscripciones |
+| ai | Wrapper multi-LLM |
+| notifications | Email, push, in-app, WebSocket |
+| email | SendGrid, SES, SMTP |
+| whatsapp | WhatsApp Business API |
+| audit | Auditoría de acciones |
+| feature-flags | Toggles dinámicos |
+| webhooks | Outbound con BullMQ |
+| storage | S3, R2, MinIO |
+| analytics | Reportes analíticos |
+| reports | Generación de reportes |
+| health | Health checks |
+| onboarding | Wizard para nuevos tenants |
+| rbac | Control de acceso |
+| superadmin | Portal super admin |
+
+---
+
+## VALIDACIONES ADICIONALES
+
+Además de las validaciones del workspace:
+
+1. **Multi-Tenancy:** Todo endpoint debe respetar tenant_id
+2. **RLS:** Las queries deben usar Row Level Security
+3. **Stripe:** Los webhooks deben validar firma
+4. **Tests:** Cobertura mínima 70% para nuevos módulos
+
+---
+
+## ALIASES LOCALES
+
+- `@BACKEND` → backend/src/modules/
+- `@FRONTEND` → frontend/src/
+- `@DDL` → database/ddl/
+- `@DOCS` → docs/
+- `@INVENTARIOS` → orchestration/inventarios/
+- `@CONSTANTS` → .claude/constants/CONSTANTS-PROJECT.yml
+
+---
+
+## ANTES DE IMPLEMENTAR
+
+1. Verificar en `docs/` que existe especificación
+2. Si no existe → DETENER y preguntar
+3. Revisar `orchestration/inventarios/` para estado actual
+4. Validar que no duplica funcionalidad existente
+
+---
+
+## DESPUÉS DE IMPLEMENTAR
+
+1. Actualizar inventarios (BACKEND_INVENTORY.yml, etc.)
+2. Actualizar documentación afectada
+3. Commit y push siguiendo SIMCO-GIT
+4. Evaluar propagación a erp-core
+
+---
+
+## PROPAGACIÓN
+
+Como proyecto PROVIDER, los cambios en template-saas pueden propagarse a:
+
+```
+template-saas (PROVIDER)
+    ↓
+erp-core (INTERMEDIATE)
+    ↓
+erp-construccion, erp-clinicas, erp-retail, etc. (CONSUMERS)
+```
+
+**Regla:** Security fixes se propagan INMEDIATAMENTE.
+
+---
+
+*Template SaaS v1.1.0 - Sistema SIMCO v4.0.0*