# 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.2.0
**Actualizado:** 2026-02-03
**Homologación:** TASK-2026-02-03-HOMOLOGACION-TEMPLATE-SAAS

---

## 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 (23)

| 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 |
| sales | Pipeline de ventas (SAAS-018) |
| portfolio | Catálogo de productos (SAAS-019) |
| commissions | Comisiones (SAAS-020) |
| mlm | Marketing multinivel (SAAS-021) |
| goals | Metas y objetivos (SAAS-022) |

---

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

---

## REFERENCIAS RÁPIDAS

| Documento | Ubicación | Descripción |
|-----------|-----------|-------------|
| Estándares Aplicados | `docs/99-referencias/ESTANDARES-APLICADOS.md` | 14 estándares, 98% cumplimiento |
| Matriz Trazabilidad | `docs/99-referencias/MATRIZ-TRAZABILIDAD.md` | 37 RF/RNF, 97% cobertura |
| Directivas Locales | `.claude/directivas/DIRECTIVAS-LOCALES.md` | Extensiones de directivas SIMCO |
| CONTEXT-MAP | `orchestration/CONTEXT-MAP.yml` | Mapeo de contexto NEXUS |
| Inventarios | `orchestration/inventarios/` | Estado de artefactos |

---

*Template SaaS v1.2.0 - Sistema SIMCO v4.0.0*