From db27093ba2e93ace9764b94c3dac2703b14409be Mon Sep 17 00:00:00 2001 From: Adrian Flores Cortes Date: Sat, 24 Jan 2026 17:31:34 -0600 Subject: [PATCH] [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 --- .gemini/antigravity/README.md | 96 +++++++++++++++++++ .trae/AGENT-CAPABILITIES.md | 69 ++++++++++++++ .trae/rules/project_rules.md | 96 +++++++++++++++++++ .windsurf/AGENT-CAPABILITIES.md | 72 ++++++++++++++ .windsurf/rules/project_rules.md | 102 ++++++++++++++++++++ CLAUDE.md | 155 +++++++++++++++++++++++++++++++ 6 files changed, 590 insertions(+) create mode 100644 .gemini/antigravity/README.md create mode 100644 .trae/AGENT-CAPABILITIES.md create mode 100644 .trae/rules/project_rules.md create mode 100644 .windsurf/AGENT-CAPABILITIES.md create mode 100644 .windsurf/rules/project_rules.md create mode 100644 CLAUDE.md diff --git a/.gemini/antigravity/README.md b/.gemini/antigravity/README.md new file mode 100644 index 00000000..df63c248 --- /dev/null +++ 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/` diff --git a/.trae/AGENT-CAPABILITIES.md b/.trae/AGENT-CAPABILITIES.md new file mode 100644 index 00000000..698117dc --- /dev/null +++ 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/` diff --git a/.trae/rules/project_rules.md b/.trae/rules/project_rules.md new file mode 100644 index 00000000..692df114 --- /dev/null +++ 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/` diff --git a/.windsurf/AGENT-CAPABILITIES.md b/.windsurf/AGENT-CAPABILITIES.md new file mode 100644 index 00000000..c878d953 --- /dev/null +++ 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` diff --git a/.windsurf/rules/project_rules.md b/.windsurf/rules/project_rules.md new file mode 100644 index 00000000..b057a7fe --- /dev/null +++ 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` diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 00000000..57208366 --- /dev/null +++ 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*