# 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`