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>
132 lines
3.5 KiB
Markdown
132 lines
3.5 KiB
Markdown
# Directivas Locales - Template-SaaS
|
|
|
|
**Version:** 1.1
|
|
**Fecha:** 2026-02-03
|
|
**Tipo de proyecto:** PROVIDER (L1A)
|
|
|
|
---
|
|
|
|
## Proposito
|
|
|
|
Este documento define directivas especificas de Template-SaaS que **extienden** las directivas del workspace.
|
|
|
|
---
|
|
|
|
## Directivas Especificas del Proyecto
|
|
|
|
### DL-001: Propagacion Obligatoria a ERP-Core
|
|
|
|
**Descripcion:** Todo cambio en Template-SaaS debe evaluarse para propagacion a erp-core.
|
|
|
|
**Aplica a:** Todos los dominios (backend, frontend, database)
|
|
|
|
**Regla:**
|
|
```
|
|
1. Despues de completar cambio en template-saas
|
|
2. Evaluar si aplica a erp-core:
|
|
- Modulos core (auth, tenants, billing, etc.)
|
|
- Patterns base
|
|
- Security fixes
|
|
3. Si aplica: crear tarea de propagacion
|
|
4. Security fixes: propagar INMEDIATAMENTE
|
|
```
|
|
|
|
**Ejemplos:**
|
|
- Fix de autenticacion -> Propagar a erp-core
|
|
- Nueva utility generica -> Propagar a erp-core
|
|
- Feature muy especifica de SaaS -> Evaluar caso por caso
|
|
|
|
---
|
|
|
|
### DL-002: Multi-Tenancy con RLS
|
|
|
|
**Descripcion:** Todo acceso a datos debe respetar el contexto de tenant.
|
|
|
|
**Aplica a:** Backend, Database
|
|
|
|
**Regla:**
|
|
```
|
|
Toda tabla con datos de tenant DEBE:
|
|
1. Tener columna tenant_id NOT NULL
|
|
2. Tener RLS policy que filtre por tenant_id
|
|
3. Entity debe tener @Column tenant_id
|
|
4. Service debe usar TenantContext
|
|
|
|
NO SE PERMITE:
|
|
- Queries sin filtro de tenant
|
|
- Acceso directo a tablas sin RLS
|
|
- Bypassing del TenantContext
|
|
```
|
|
|
|
---
|
|
|
|
### DL-003: Estructura de Documentacion SaaS
|
|
|
|
**Descripcion:** Mapeo de paths de documentacion para DV-MASTER.
|
|
|
|
**Extiende:** DV-MASTER
|
|
|
|
**Mapeo de paths:**
|
|
|
|
| Convencion Global | Path en Template-SaaS |
|
|
|-------------------|----------------------|
|
|
| docs/modulos/ | docs/01-modulos/ |
|
|
| docs/integraciones/ | docs/02-integraciones/ |
|
|
| docs/vision/ | docs/00-vision-general/ |
|
|
| docs/adr/ | docs/architecture/adr/ |
|
|
|
|
---
|
|
|
|
## Checklist de Validacion
|
|
|
|
Al crear directivas locales, verificar:
|
|
|
|
- [x] La directiva no contradice las del workspace
|
|
- [x] Esta documentada con ejemplos claros
|
|
- [x] Esta indexada en _MAP.md
|
|
- [x] Los agentes pueden encontrarla facilmente
|
|
|
|
---
|
|
|
|
---
|
|
|
|
## Directivas del Workspace Aplicables
|
|
|
|
### Directivas SIMCO Principales (Heredadas)
|
|
|
|
| Directiva | Aplica | Descripción |
|
|
|-----------|--------|-------------|
|
|
| SIMCO-TAREA.md | ✅ | Ciclo CAPVED completo |
|
|
| SIMCO-CREAR.md | ✅ | Creación de artefactos |
|
|
| SIMCO-MODIFICAR.md | ✅ | Modificación de artefactos |
|
|
| SIMCO-VALIDAR.md | ✅ | Validación de coherencia |
|
|
| SIMCO-GIT.md | ✅ | Operaciones git |
|
|
| SIMCO-EDICION-SEGURA.md | ✅ | Edición sin placeholders |
|
|
| SIMCO-BACKEND.md | ✅ | Desarrollo backend NestJS |
|
|
| SIMCO-FRONTEND.md | ✅ | Desarrollo frontend React |
|
|
| SIMCO-DDL.md | ✅ | Base de datos PostgreSQL |
|
|
| SIMCO-SUBMODULOS.md | ✅ | Gestión de submodules L2 |
|
|
|
|
### Principios Fundamentales (Heredados)
|
|
|
|
| Principio | Aplica | Descripción |
|
|
|-----------|--------|-------------|
|
|
| PRINCIPIO-CAPVED.md | ✅ | Ciclo de vida de tareas |
|
|
| PRINCIPIO-DOC-PRIMERO.md | ✅ | Documentar antes de codificar |
|
|
| PRINCIPIO-ANTI-DUPLICACION.md | ✅ | Verificar catálogo |
|
|
| PRINCIPIO-VALIDACION-OBLIGATORIA.md | ✅ | Build/lint obligatorios |
|
|
| PRINCIPIO-ECONOMIA-TOKENS.md | ✅ | Gestión de contexto |
|
|
|
|
### Estándares Profesionales (Aplicados)
|
|
|
|
Ver: `docs/99-referencias/ESTANDARES-APLICADOS.md`
|
|
|
|
---
|
|
|
|
## Referencias
|
|
|
|
- Directivas globales: `workspace-v2/orchestration/directivas/`
|
|
- _MAP.md local: `.claude/directivas/_MAP.md`
|
|
- Estándares aplicados: `docs/99-referencias/ESTANDARES-APLICADOS.md`
|
|
- Matriz RF/RNF: `docs/99-referencias/MATRIZ-TRAZABILIDAD.md`
|