template-saas/.claude/directivas/DIRECTIVAS-LOCALES.md
Adrian Flores Cortes 0e23f048a0
Some checks are pending
CI / Backend CI (push) Waiting to run
CI / Frontend CI (push) Waiting to run
CI / Security Scan (push) Waiting to run
CI / CI Summary (push) Blocked by required conditions
[HOMOLOG] docs: Complete homologation with workspace-v2 standards
- 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>
2026-02-03 02:55:31 -06:00

3.5 KiB

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:

  • La directiva no contradice las del workspace
  • Esta documentada con ejemplos claros
  • Esta indexada en _MAP.md
  • 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