# Project Rules - MiChangarrito (Windsurf IDE)

**Proyecto:** michangarrito
**Tipo:** CONSUMER
**Sistema:** SIMCO v4.3.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 10.3.0 + TypeScript
frontend_web: React 19.2.0 + Vite
mobile: React Native (Expo SDK 51)
database: PostgreSQL 16+
cache: Redis 7
```

---

## Credenciales BD

```
DB_HOST=localhost
DB_PORT=5432
DB_NAME=michangarrito_dev
DB_USER=michangarrito_dev
DB_PASS=mch_dev_2026
REDIS_PORT=6389
```

---

## Paths Absolutos

```
Backend:     C:\Empresas\ISEM\workspace-v2\projects\michangarrito\apps\backend\src\
Frontend:    C:\Empresas\ISEM\workspace-v2\projects\michangarrito\apps\frontend\src\
Mobile:      C:\Empresas\ISEM\workspace-v2\projects\michangarrito\apps\mobile\src\
WhatsApp:    C:\Empresas\ISEM\workspace-v2\projects\michangarrito\apps\whatsapp-service\
Database:    C:\Empresas\ISEM\workspace-v2\projects\michangarrito\apps\database\
```

---

## 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
5. **Verificar** que cambio funciona en web Y mobile

---

## Validaciones Post-Cambio

```cmd
cd C:\Empresas\ISEM\workspace-v2\projects\michangarrito\apps\backend
npm run build
npm run lint

cd C:\Empresas\ISEM\workspace-v2\projects\michangarrito\apps\frontend
npm run build
npm run lint
```

---

## Módulos Backend (23)

```
auth, billing, categories, codi-spei, customers,
delivery, exports, integrations, inventory, invoices,
marketplace, messaging, notifications, onboarding,
orders, payments, products, referrals, sales,
settings, subscriptions, templates, widgets
```

---

## Seguridad Multi-Tenant

**OBLIGATORIO:**
- Validar tenant_id en toda query
- Usar RLS de PostgreSQL
- NUNCA acceder a datos de otro changarrito

---

## Bloqueos

Si encuentras:
- Ambigüedad en instrucciones → BLOQUEAR
- Archivo no existe → BLOQUEAR
- Acceso a otro tenant → BLOQUEAR
- WhatsApp sin template → BLOQUEAR
- Solo funciona en web o solo en mobile → BLOQUEAR

Reportar en: `orchestration/trazas/BLOCKED-TASKS.yml`