template-saas/docs/99-referencias/MATRIZ-TRAZABILIDAD.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

7.4 KiB

Matriz de Trazabilidad RF/RNF - Template SaaS

Proyecto: template-saas Tipo: PROVIDER (L1A) Fecha: 2026-02-03 Sistema: SIMCO v4.0.0


1. Resumen de Cobertura

Categoría Total RF/RNF Implementados Cobertura
RF-AUTH 3 3 100%
RF-USER 3 3 100%
RF-TENANT 2 2 100%
RF-AUDIT 2 2 100%
RF-NOTIF 2 2 100%
RF-SEARCH 3 3 100%
RF-EXPORT 2 2 100%
RNF-SEC 5 5 100%
RNF-PERF 4 4 100%
RNF-AVAIL 3 3 100%
RNF-SCALE 2 2 100%
RNF-UX 3 2 67%
RNF-MAINT 3 3 100%
Total 37 36 97%

2. Requerimientos Funcionales (RF)

2.1 RF-AUTH: Autenticación y Autorización

RF Descripción Módulo SAAS Estado
RF-AUTH-001 Autenticación JWT SAAS-001-auth Implementado
RF-AUTH-002 Control de Acceso RBAC SAAS-001-auth, rbac Implementado
RF-AUTH-003 Gestión de Sesiones SAAS-001-auth Implementado

Implementación:

  • Backend: backend/src/modules/auth/
  • Entities: session.entity.ts, token.entity.ts, refresh-token.entity.ts
  • DDL: database/ddl/auth/

2.2 RF-USER: Gestión de Usuarios

RF Descripción Módulo SAAS Estado
RF-USER-001 CRUD de Usuarios SAAS-003-users Implementado
RF-USER-002 Perfiles de Usuario SAAS-003-users Implementado
RF-USER-003 Recuperación de Contraseña SAAS-001-auth Implementado

Implementación:

  • Backend: backend/src/modules/users/
  • Frontend: frontend/src/pages/admin/users/

2.3 RF-TENANT: Multi-Tenancy

RF Descripción Módulo SAAS Estado
RF-TENANT-001 Aislamiento de Datos SAAS-002-tenants Implementado (RLS)
RF-TENANT-002 Configuración por Tenant SAAS-002-tenants Implementado

Implementación:

  • Backend: backend/src/modules/tenants/
  • RLS: Todas las tablas con tenant_id tienen policies
  • DDL: database/ddl/tenants/

2.4 RF-AUDIT: Auditoría

RF Descripción Módulo SAAS Estado
RF-AUDIT-001 Registro de Cambios SAAS-008-audit-logs Implementado
RF-AUDIT-002 Acciones de Usuario SAAS-008-audit-logs Implementado

Implementación:

  • Backend: backend/src/modules/audit/
  • Frontend: frontend/src/pages/admin/audit/
  • DDL: database/ddl/audit/

2.5 RF-NOTIF: Notificaciones

RF Descripción Módulo SAAS Estado
RF-NOTIF-001 Notificaciones en App SAAS-007-notifications Implementado
RF-NOTIF-002 Notificaciones por Email SAAS-013-email Implementado

Implementación:

  • Backend: backend/src/modules/notifications/, backend/src/modules/email/
  • WebSocket: NotificationsGateway
  • Push: Web Push API

2.6 RF-SEARCH: Búsqueda y Filtrado

RF Descripción Módulo SAAS Estado
RF-SEARCH-001 Búsqueda Global CRUD Base Implementado
RF-SEARCH-002 Filtros CRUD Base Implementado
RF-SEARCH-003 Ordenamiento CRUD Base Implementado

Implementación:

  • Todos los listados soportan filtros, paginación y ordenamiento
  • Patrón reutilizable en todos los módulos

2.7 RF-EXPORT: Exportación

RF Descripción Módulo SAAS Estado
RF-EXPORT-001 Exportar a CSV SAAS-017-reports Implementado
RF-EXPORT-002 Exportar a PDF SAAS-017-reports Implementado

Implementación:

  • Backend: backend/src/modules/reports/
  • Soporta CSV, Excel, PDF

3. Requerimientos No Funcionales (RNF)

3.1 RNF-SEC: Seguridad (P0 - Crítico)

RNF Descripción Implementación Estado
RNF-SEC-001 Autenticación Segura bcrypt cost 10, JWT HS256
RNF-SEC-002 Protección de Datos HTTPS, secrets en .env
RNF-SEC-003 Inyección SQL TypeORM parameterized queries
RNF-SEC-004 XSS/CSRF React escape, CSRF tokens
RNF-SEC-005 Headers de Seguridad Helmet middleware

Verificación: TASK-RNF-SEC-VALIDATION (APROBADO)


3.2 RNF-PERF: Performance (P1)

RNF Descripción Objetivo Estado
RNF-PERF-001 Tiempos de Respuesta < 500ms
RNF-PERF-002 Base de Datos Índices, paginación
RNF-PERF-003 Frontend Bundle < 500KB ⚠️ Verificar
RNF-PERF-004 Caching Redis cache

Verificación: TASK-RNF-PERF-VALIDATION (APROBADO)


3.3 RNF-AVAIL: Disponibilidad (P1)

RNF Descripción Objetivo Estado
RNF-AVAIL-001 Uptime 99.5% Diseñado
RNF-AVAIL-002 Recuperación RTO < 4h, RPO < 1h Diseñado
RNF-AVAIL-003 Monitoreo Health checks

Verificación: TASK-RNF-AVAIL-VALIDATION (APROBADO)


3.4 RNF-SCALE: Escalabilidad (P2)

RNF Descripción Objetivo Estado
RNF-SCALE-001 Usuarios Concurrentes 100/instancia
RNF-SCALE-002 Datos 1M+ registros Paginación

Verificación: TASK-RNF-SCALE-VALIDATION (APROBADO)


3.5 RNF-UX: Usabilidad (P2)

RNF Descripción Objetivo Estado
RNF-UX-001 Responsividad Mobile-first
RNF-UX-002 Accesibilidad WCAG 2.1 A ⚠️ Parcial
RNF-UX-003 Feedback Loading, errores

Gap: Mejoras de accesibilidad pendientes (WCAG 2.1 AA)


3.6 RNF-MAINT: Mantenibilidad (P1)

RNF Descripción Objetivo Estado
RNF-MAINT-001 Código Lint sin errores
RNF-MAINT-002 Logs Estructurados
RNF-MAINT-003 Configuración .env

4. Matriz de Trazabilidad Cruzada

Módulos SAAS → RF

Módulo RF Implementados
SAAS-001-auth RF-AUTH-001, RF-AUTH-002, RF-AUTH-003, RF-USER-003
SAAS-002-tenants RF-TENANT-001, RF-TENANT-002
SAAS-003-users RF-USER-001, RF-USER-002
SAAS-007-notifications RF-NOTIF-001
SAAS-008-audit-logs RF-AUDIT-001, RF-AUDIT-002
SAAS-013-email RF-NOTIF-002
SAAS-017-reports RF-EXPORT-001, RF-EXPORT-002

Módulos SAAS → RNF

Módulo RNF Implementados
SAAS-001-auth RNF-SEC-001, RNF-SEC-002
health module RNF-AVAIL-003
Todos los módulos RNF-SEC-003, RNF-PERF-001

5. Gaps de Cobertura

Gap ID Tipo Descripción Prioridad Módulo Afectado
GAP-UX-001 RNF Accesibilidad WCAG 2.1 AA P2 Frontend

6. Referencias

Documento Ubicación
RF del Workspace workspace-v2/docs/50-requerimientos/REQUERIMIENTOS-FUNCIONALES.md
RNF del Workspace workspace-v2/docs/50-requerimientos/REQUERIMIENTOS-NO-FUNCIONALES.md
Módulos SAAS template-saas/docs/01-modulos/
Inventarios template-saas/orchestration/inventarios/

Última actualización: 2026-02-03 Actualizado por: Claude Opus 4.5 (TASK-2026-02-03-HOMOLOGACION)