trading-platform/orchestration/analisis/coherencia/AUDIT-BACKEND-FRONTEND.md

AUDIT-BACKEND-FRONTEND.md

Auditoría de Coherencia Backend ↔ Frontend

Fecha: 2026-01-28 Proyecto: trading-platform Auditor: Claude Code (Opus 4.5) Fase: F0.3.2

---

RESUMEN EJECUTIVO

Métrica	Valor	Target	Gap
Coherencia Backend-Frontend	72%	85%	-13pp
Endpoints totales	208+	-	-
Endpoints con consumidor	147	208	61 faltantes
Services frontend	15	26	11 faltantes
Stores Zustand	8	17	9 faltantes

---

MAPEO DE MÓDULOS

Módulo	Endpoints	Service FE	Store	Cobertura	Estado
auth	27	✅	✅ (implícito)	100%	COMPLETO
users	6	✅	✅ (implícito)	100%	COMPLETO
trading	47	✅	✅ tradingStore	95%	INCOMPLETO
portfolio	12	✅	✅ portfolioStore	100%	COMPLETO
investment	13	✅	❌ NO	50%	INCOMPLETO
education	45	✅	✅ educationStore	98%	INCOMPLETO
payments	20	✅	✅ paymentStore	95%	INCOMPLETO
agents	16	✅	✅ agentsStore	85%	INCOMPLETO
notifications	9	✅	✅ notificationStore	100%	COMPLETO
market-data	4	⚠️ PARCIAL	❌ NO	50%	INCOMPLETO
ml	19	⚠️ limitado	❌ NO	60%	INCOMPLETO
llm	6	⚠️ parcial	❌ NO	50%	INCOMPLETO
currency	4	❌ NO	❌ NO	0%	ÓRFANO
audit	8	❌ NO	❌ NO	0%	ÓRFANO
admin	8	✅	❌ NO	50%	INCOMPLETO
risk	7	❌ NO	❌ NO	0%	ÓRFANO
proxy	20	⚠️ indirecto	❌ NO	30%	INCOMPLETO

---

GAPS CRÍTICOS

1. Endpoints Sin Consumo Frontend (HIGH PRIORITY)

GAP-BF-001: Trading Alerts (6 endpoints)

• Rutas: POST/GET/PATCH/DELETE /api/v1/trading/alerts*
• Estado: Backend ✅ | Frontend ❌
• Impacto: CRÍTICO - Feature de alertas NO funcional
• Acción: Crear alertsService.ts

GAP-BF-002: Investment Withdrawals (1 endpoint)

• Ruta: GET /api/v1/investment/withdrawals
• Estado: Backend ✅ | Frontend ❌
• Impacto: ALTO - Historial NO visible
• Acción: Agregar a investment.service.ts

GAP-BF-003: Currency Module (4 endpoints)

• Rutas: GET /api/v1/currency/rates*
• Estado: Backend ✅ | Frontend ❌
• Impacto: MEDIO - Conversión NO integrada
• Acción: Crear currencyService.ts

GAP-BF-004: Risk Module (7 endpoints)

• Rutas: GET/POST /api/v1/risk/*
• Estado: Backend ✅ | Frontend ❌
• Impacto: ALTO - Cuestionario NO visible
• Acción: Crear riskAssessment.service.ts

---

2. Stores Faltantes

Store	Módulo	Prioridad	Esfuerzo
investmentStore	investment	P0	4h
mlStore	ml	P1	5h
llmStore	llm	P1	5h
currencyStore	currency	P2	2h
riskStore	risk	P1	3h
adminStore	admin	P2	3h
marketDataStore	market-data	P2	4h

---

ANÁLISIS POR EPIC

OQI-001 (fundamentos-auth) - 85% ✅

• Gaps: 2FA flow UI incompleto
• Acción: Completar flujo verificación

OQI-002 (educativo) - 55% ⚠️

• Gaps: Quiz history, video processing status
• Acción: Refactorizar educationStore

OQI-003 (trading-charts) - 60% ⚠️

• Gaps: Price alerts (SIN servicio)
• Acción: Crear alertsService URGENTE

OQI-004 (cuentas-inversion) - 55% ⚠️

• Gaps: investmentStore NO EXISTE
• Acción: Crear store + expandir service

OQI-005 (pagos-stripe) - 65% ⚠️

• Gaps: Refund history
• Acción: Agregar a paymentStore

OQI-006 (senales-ml) - 75% ⚠️

• Gaps: Signal caching, mlStore
• Acción: Crear mlStore

OQI-007 (llm-strategy-agent) - 45% ⚠️

• Gaps: Session management, llmStore
• Acción: Crear llmStore

OQI-008 (portfolio-manager) - 45% ✅

• Estado: Bueno, mejoras menores

---

BAD PRACTICES DETECTADAS

Resultado: ✅ CERO HALLAZGOS CRÍTICOS

• ✅ Cero llamadas directas axios/fetch en componentes
• ✅ Todos usan apiClient centralizado
• ✅ Token auto-refresh implementado

FORTALEZA: Arquitectura de servicios bien estructurada.

---

RECOMENDACIONES PRIORIZADAS

FASE 1 - CRÍTICA (Semana 1)

P1.1 Crear alertsService.ts + integrar en tradingStore

• Endpoints: 6
• Esfuerzo: 3-4 horas

P1.2 Expandir investment.service.ts

• Métodos: getWithdrawals, closeAccount, getDistributions
• Esfuerzo: 2 horas

P1.3 Crear investmentStore.ts

• Esfuerzo: 4 horas

FASE 2 - ALTA (Semana 2)

P2.1 Crear mlStore.ts

• Esfuerzo: 5 horas

P2.2 Refactorizar mlService.ts (type safety)

• Esfuerzo: 3 horas

P2.3 Crear riskAssessmentService.ts

• Esfuerzo: 4 horas

FASE 3 - MEDIA (Semana 3)

P3.1 Crear currencyService.ts (si necesario) P3.2 Crear llmStore.ts P3.3 Documentar market-data vs trading endpoints

---

CHECKLIST DE COHERENCIA

Para cada nuevo módulo/endpoint:

□ Backend:
  □ Ruta en [module].routes.ts
  □ Controller implementado
  □ Service implementado
  □ Tests

□ Frontend Service:
  □ Servicio en services/[module].service.ts
  □ Tipos importados
  □ Error handling

□ Frontend Store:
  □ Store Zustand si hay estado global
  □ Actions CRUD
  □ Tests

□ Coherencia:
  □ Validar con este audit
  □ Cobertura > 90%

---

Generado: 2026-01-28 | Sistema SIMCO v4.0.0