rckrdmrd/template-saas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
9d54f832b4
template-saas/CLAUDE.md
Adrian Flores Cortes 0e23f048a0
Some checks are pending
CI / Backend CI (push) Waiting to run
Details
CI / Frontend CI (push) Waiting to run
Details
CI / Security Scan (push) Waiting to run
Details
CI / CI Summary (push) Blocked by required conditions
Details
[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

4.4 KiB
Raw Blame History

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