trading-platform/orchestration/tareas/2026-01-30/TASK-2026-01-30-ANALISIS-INTEGRACION/TEMPLATE-SAAS-INTEGRATION-MATRIX.md
Adrian Flores Cortes 3c2d98707c [TASK-2026-01-30-ANALISIS-INTEGRACION] chore: Sprint 3 - Purga y limpieza
- Archivados 5 análisis obsoletos a _archive/2026-01-25/
- MASTER-ANALYSIS-PLAN marcada SUPERSEDIDA
- FRONTEND-COMPREHENSIVE-AUDIT marcada COMPLETADA (7+ entregables)
- FRONTEND-MODULE-DOCS marcada CANCELADA (P3, sin progreso)
- BLOCKER-001-TOKEN-REFRESH marcada POSTERGADA
- Actualizado PROJECT-STATUS.md y _INDEX.yml

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 15:26:40 -06:00

216 lines
7.7 KiB
Markdown

# Matriz de Integración: Template-SaaS → Trading-Platform
**Subtarea:** 1.2
**Fecha:** 2026-01-30
**Agente:** Claude Code (Opus 4.5)
---
## 1. RESUMEN EJECUTIVO
| Categoría | Módulos | Integrados | Parcialmente | No Integrados |
|-----------|---------|------------|--------------|---------------|
| Core (SAAS-001 a 005) | 5 | 2 | 2 | 1 |
| Platform (SAAS-006 a 014) | 9 | 3 | 2 | 4 |
| Extended (SAAS-015 a 022) | 5 | 1 | 1 | 3 |
| **TOTAL** | **19** | **6 (32%)** | **5 (26%)** | **8 (42%)** |
**Nota:** Trading-platform es STANDALONE. Los módulos se "copian/adaptan", no se heredan.
---
## 2. MATRIZ DETALLADA
### 2.1 Core SaaS (SAAS-001 a SAAS-005)
| ID | Template-SaaS | Trading Equiv. | Estado | Acción |
|----|---------------|----------------|--------|--------|
| SAAS-001 | Auth (JWT, OAuth, MFA) | OQI-001 (85%) | **PARCIAL** | Evaluar MFA y OAuth de template |
| SAAS-002 | Tenants (Multi-tenancy) | N/A | **NO APLICA** | Trading es single-tenant por diseño |
| SAAS-003 | Users (RBAC) | users module (backend) | **INTEGRADO** | Ya tiene RBAC básico |
| SAAS-004 | Billing (Stripe) | OQI-005 (65%) | **PARCIAL** | Adoptar webhooks y refunds |
| SAAS-005 | Plans (Límites) | subscription.service | **INTEGRADO** | Ya maneja planes |
### 2.2 Platform Features (SAAS-006 a SAAS-014)
| ID | Template-SaaS | Trading Equiv. | Estado | Acción |
|----|---------------|----------------|--------|--------|
| SAAS-006 | AI Integration | OQI-007 (45%) | **PARCIAL** | Diferente enfoque (trading vs chat) |
| SAAS-007 | Notifications | notifications module | **INTEGRADO** | Multi-canal implementado |
| SAAS-008 | Audit Logs | audit schema (DDL) | **PARCIAL** | Solo DDL, falta backend service |
| SAAS-009 | Feature Flags | N/A | **NO INTEGRADO** | Evaluar adopción |
| SAAS-010 | Webhooks | N/A | **NO INTEGRADO** | Útil para trading events |
| SAAS-011 | Storage | storage.service | **INTEGRADO** | S3/R2 ya implementado |
| SAAS-012 | CRUD Base | N/A | **NO APLICA** | Solo documentación |
| SAAS-013 | Email | email.service (auth) | **INTEGRADO** | Básico implementado |
| SAAS-014 | WhatsApp | N/A | **NO INTEGRADO** | Baja prioridad para trading |
### 2.3 Extended Features (SAAS-015 a SAAS-022)
| ID | Template-SaaS | Trading Equiv. | Estado | Acción |
|----|---------------|----------------|--------|--------|
| SAAS-015 | OAuth 2.0 | oauth.service | **INTEGRADO** | Google, Facebook, GitHub, Apple |
| SAAS-018 | Sales | N/A | **NO INTEGRADO** | No aplica a trading |
| SAAS-019 | Portfolio (Catálogo) | OQI-008 (45%) | **PARCIAL** | Adaptar para Trading Pairs |
| SAAS-020 | Commissions | N/A | **NO INTEGRADO** | Adaptar para Trading Fees |
| SAAS-021 | MLM | N/A | **NO INTEGRADO** | Adaptar para Affiliate Program |
| SAAS-022 | Goals | N/A | **NO INTEGRADO** | Adaptar para Trading Targets |
---
## 3. ANÁLISIS POR REUTILIZABILIDAD
### 3.1 Alta Reutilizabilidad (>80%)
| Módulo | Razón | Esfuerzo Estimado |
|--------|-------|-------------------|
| SAAS-007 Notifications | Ya implementado, solo mejorar | Bajo |
| SAAS-008 Audit Logs | Patrón estándar, útil para compliance | Medio |
| SAAS-009 Feature Flags | Toggle de features en trading | Medio |
| SAAS-010 Webhooks | Eventos de trading hacia externos | Medio |
### 3.2 Media Reutilizabilidad (50-80%)
| Módulo | Razón | Esfuerzo Estimado |
|--------|-------|-------------------|
| SAAS-001 Auth | MFA y OAuth más robusto | Medio |
| SAAS-004 Billing | Refunds, invoices, subscription lifecycle | Medio |
| SAAS-019 Portfolio | Adaptar catálogo → Trading Pairs | Alto |
| SAAS-022 Goals | Adaptar metas → Trading Targets | Medio |
### 3.3 Baja Reutilizabilidad (<50%)
| Módulo | Razón | Recomendación |
|--------|-------|---------------|
| SAAS-002 Tenants | Trading es single-tenant | NO ADOPTAR |
| SAAS-006 AI | Diferente enfoque (chat vs trading) | MANTENER PROPIO |
| SAAS-014 WhatsApp | No prioritario | POSPONER |
| SAAS-018 Sales | No aplica a trading | NO ADOPTAR |
| SAAS-020 Commissions | Muy diferente (ventas vs trading) | EVALUAR |
| SAAS-021 MLM | Complejo, baja prioridad | POSPONER |
---
## 4. GAPS IDENTIFICADOS
### 4.1 Gaps de Alta Prioridad (P0-P1)
| Gap | Módulo Template | Impacto Trading | Prioridad |
|-----|-----------------|-----------------|-----------|
| G-TS-001 | SAAS-008 Audit Logs | Compliance, debugging | P1 |
| G-TS-002 | SAAS-009 Feature Flags | Feature rollout controlado | P1 |
| G-TS-003 | SAAS-001 MFA | Seguridad de cuentas | P1 |
### 4.2 Gaps de Media Prioridad (P2)
| Gap | Módulo Template | Impacto Trading | Prioridad |
|-----|-----------------|-----------------|-----------|
| G-TS-004 | SAAS-010 Webhooks | Integración con externos | P2 |
| G-TS-005 | SAAS-004 Refunds | Gestión de devoluciones | P2 |
| G-TS-006 | SAAS-022 Goals | Trading targets | P2 |
### 4.3 Gaps de Baja Prioridad (P3)
| Gap | Módulo Template | Impacto Trading | Prioridad |
|-----|-----------------|-----------------|-----------|
| G-TS-007 | SAAS-019 Portfolio | Trading pairs catalog | P3 |
| G-TS-008 | SAAS-021 MLM | Affiliate program | P3 |
---
## 5. RECOMENDACIONES DE ADOPCIÓN
### 5.1 Adoptar Inmediatamente (Copiar código)
1. **SAAS-008 Audit Logs** - Copiar patrón completo
- DDL ya existe en trading, falta backend service
- Copiar de template-saas: audit.service.ts, audit.module.ts
2. **SAAS-009 Feature Flags** - Adoptar módulo completo
- Útil para rollout de features ML
- Copiar módulo completo de template-saas
### 5.2 Evaluar y Adaptar
3. **SAAS-001 MFA** - Evaluar implementación
- Trading requiere alta seguridad
- Adaptar de template-saas: mfa.service.ts, twofa.controller.ts
4. **SAAS-010 Webhooks** - Adaptar para eventos de trading
- Copiar infraestructura BullMQ
- Adaptar eventos: trade_executed, signal_generated, etc.
### 5.3 No Adoptar / Posponer
5. **SAAS-002 Tenants** - No aplica (single-tenant)
6. **SAAS-014 WhatsApp** - Baja prioridad
7. **SAAS-018 Sales** - No aplica
8. **SAAS-021 MLM** - Complejidad alta, evaluar después
---
## 6. ARQUITECTURA COMPARADA
### Template-SaaS (NestJS)
```
backend/src/modules/
├── auth/
│ ├── auth.module.ts
│ ├── auth.service.ts
│ ├── auth.controller.ts
│ ├── strategies/
│ └── guards/
├── notifications/
│ ├── notifications.module.ts
│ ├── notifications.service.ts
│ └── gateway/
│ └── notifications.gateway.ts (WebSocket)
└── webhooks/
├── webhooks.module.ts
├── webhooks.service.ts
└── processors/
└── webhook.processor.ts (BullMQ)
```
### Trading-Platform (Express.js)
```
apps/backend/src/modules/
├── auth/
│ ├── token.service.ts
│ ├── oauth.service.ts
│ ├── twofa.service.ts
│ └── auth.routes.ts
├── notifications/
│ ├── notification.service.ts
│ ├── notification.controller.ts
│ └── notification.routes.ts
└── [webhooks no existe]
```
**Diferencia arquitectónica:** Template usa NestJS (decorators, DI), Trading usa Express (functional).
**Implicación:** Adaptar código, no copiar directamente.
---
## 7. CONCLUSIÓN
| Métrica | Valor |
|---------|-------|
| Módulos template-saas | 19 (sin contar SAAS-012 y tenants) |
| Ya integrados | 6 (32%) |
| Parcialmente integrados | 5 (26%) |
| No integrados (candidatos) | 8 (42%) |
| Recomendados para adopción | 4 (SAAS-008, 009, MFA, 010) |
**Próxima acción:** Crear tareas específicas para adopción de:
1. SAAS-008 Audit Logs (P1)
2. SAAS-009 Feature Flags (P1)
3. MFA de SAAS-001 (P1)
4. SAAS-010 Webhooks (P2)
---
**Subtarea completada:** 1.2 Auditar integración template-saas → trading-platform
**Estado:** COMPLETADA
**Siguiente:** 1.3 Auditar documentación workspace vs proyecto