0e23f048a0
- Add docs/99-referencias/ section: - ESTANDARES-APLICADOS.md (14 standards, 98% compliance) - MATRIZ-TRAZABILIDAD.md (37 RF/RNF, 97% coverage) - ONBOARDING.md (developer guide) - _INDEX.md (section index) - Update CLAUDE.md v1.2.0: - Add 4 new modules (sales, portfolio, commissions, mlm, goals) - Add quick references section - Update DIRECTIVAS-LOCALES.md v1.1: - Add SIMCO directives table - Add principles inheritance table - Fix CONTEXT-MAP.yml v2.1.0: - Correct paths from apps/* to L2 submodules structure - Update orchestration files: - PROJECT-STATUS.md with homologation note - PROXIMA-ACCION.md with task reference - _INDEX.yml to v1.4.0 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
174 lines
4.4 KiB
Markdown
174 lines
4.4 KiB
Markdown
# 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*
|