rckrdmrd c1b5081208 feat(ml): Complete FASE 11 - BTCUSD update and comprehensive documentation alignment

ML Engine Updates:
- Updated BTCUSD with Polygon API data (2024-2025): 215,699 new records
- Re-trained all ML models: Attention (R²: 0.223), Base, Metamodel (87.3% confidence)
- Backtest results: +176.71R profit with aggressive_filter strategy

Documentation Consolidation:
- Created docs/99-analisis/_MAP.md index with 13 new analysis documents
- Consolidated inventories: removed duplicates from orchestration/inventarios/
- Updated ML_INVENTORY.yml with BTCUSD metrics and training results
- Added execution reports: FASE11-BTCUSD, correction issues, alignment validation

Architecture & Integration:
- Updated all module documentation with NEXUS v3.4 frontmatter
- Fixed _MAP.md indexes across all folders
- Updated orchestration plans and traces

Files: 229 changed, 5064 insertions(+), 1872 deletions(-)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-07 09:31:29 -06:00

14 KiB

Raw Blame History

id	title	type	status	priority	epic	project	story_points	created_date	updated_date
US-PAY-002	Suscribirse a Plan	User Story	Done	Media	OQI-005	trading-platform	3	2025-12-05	2026-01-04

US-PAY-002: Suscribirse a Plan

Version: 1.0.0 Fecha: 2025-12-05 Estado: ✅ Implementado Story Points: 5 Prioridad: P0 (Crítica) Épica: OQI-005

Historia de Usuario

Como usuario registrado de Trading Platform Quiero suscribirme a un plan de pago (Basic, Pro o Premium) Para acceder a funcionalidades premium y mejorar mi experiencia de trading

Criterios de Aceptación

AC-001: Selección de Plan

Dado que estoy en la página de pricing Cuando hago click en "Suscribirme" en un plan (Basic/Pro/Premium) Entonces debería:

Ser redirigido a página de checkout
Ver el plan seleccionado claramente destacado
Ver el precio mensual y total del primer mes
Ver nota de trial de 7 días (si aplica para Pro/Premium)

AC-002: Formulario de Pago

Dado que estoy en la página de checkout de suscripción Cuando veo el formulario Entonces debería ver:

Resumen del plan seleccionado
Stripe Elements para ingresar tarjeta
- Número de tarjeta
- Fecha de expiración (MM/YY)
- CVC
- Nombre del titular
Detección automática de marca de tarjeta (Visa, MC, Amex)
Checkbox "Acepto los términos del servicio y política de reembolso"
Botón "Comenzar Trial de 7 Días" (Pro/Premium) o "Suscribirme" (Basic)

AC-003: Trial Period (Pro/Premium)

Dado que me estoy suscribiendo a Pro o Premium Cuando completo el checkout Entonces debería:

NO ser cobrado inmediatamente
Ver confirmación: "Trial iniciado. No se te cobrará hasta el DD/MM/YYYY"
Tener acceso completo al plan durante 7 días
Poder cancelar durante trial sin cargo

AC-004: Pago Inmediato (Basic)

Dado que me estoy suscribiendo a Basic Cuando completo el checkout Entonces debería:

Ser cobrado $19 USD inmediatamente
Ver confirmación: "Suscripción activada. Próximo cobro: DD/MM/YYYY"
Tener acceso completo al plan Basic

AC-005: Validación de Tarjeta

Dado que estoy ingresando datos de tarjeta Cuando ingreso información inválida Entonces debería ver mensajes de error específicos:

"Número de tarjeta inválido"
"Fecha de expiración inválida"
"Código de seguridad inválido"
"Nombre del titular requerido"

AC-006: Procesamiento 3D Secure

Dado que mi tarjeta requiere autenticación 3DS Cuando confirmo la suscripción Entonces debería:

Ver modal/iframe del banco para autenticar
Completar autenticación (SMS, app bancaria, etc.)
Recibir confirmación después de autenticación exitosa
Ver error si autenticación falla

AC-007: Confirmación de Suscripción

Dado que completé el pago exitosamente Cuando se confirma la suscripción Entonces debería:

Ver página de confirmación con mensaje de éxito
Recibir email de confirmación con:
- Detalles del plan
- Fecha de primer cobro (o cobro inmediato)
- Link para gestionar suscripción
- Factura adjunta (si fue cobro inmediato)
Ver badge del plan en mi perfil
Tener acceso a funcionalidades premium

AC-008: Ya Tiene Suscripción Activa

Dado que ya tengo una suscripción activa Cuando intento suscribirme a otro plan Entonces debería:

Ver mensaje: "Ya tienes una suscripción activa a {plan}"
Ver opción "Cambiar Plan" en lugar de "Suscribirse"
Ser redirigido a página de gestión de suscripción

AC-009: Error de Pago

Dado que mi tarjeta es rechazada Cuando intento completar la suscripción Entonces debería:

Ver mensaje de error específico:
- "Tu tarjeta fue rechazada. Intenta con otra tarjeta."
- "Fondos insuficientes. Verifica tu saldo."
- "Tarjeta expirada. Usa una tarjeta vigente."
Permanecer en página de checkout
Poder editar datos de tarjeta e intentar de nuevo
NO crear suscripción en estado incompleto

AC-010: Abandono de Checkout

Dado que estoy en checkout pero no completo el pago Cuando cierro la página Entonces debería:

NO ser cobrado
NO tener suscripción creada
Recibir email recordatorio después de 24h (opcional)

Mockup

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│                      Suscripción a Plan Pro                 │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  Plan Pro                                    $49/mes│   │
│  │  ───────────────────────────────────────────────────│   │
│  │  ✅ Predicciones avanzadas con IA                   │   │
│  │  ✅ Todos los cursos                                │   │
│  │  ✅ Indicadores técnicos premium                    │   │
│  │  ✅ Alertas personalizadas                          │   │
│  │                                                     │   │
│  │  🎉 7 días gratis - Luego $49/mes                   │   │
│  │     Cancela cuando quieras                          │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  Método de Pago                                     │   │
│  │                                                     │   │
│  │  Número de tarjeta                                  │   │
│  │  ┌───────────────────────────────────────────────┐ │   │
│  │  │ 4242 4242 4242 4242                   [Visa] │ │   │
│  │  └───────────────────────────────────────────────┘ │   │
│  │                                                     │   │
│  │  ┌──────────────────────┐ ┌──────────────────────┐ │   │
│  │  │ Vencimiento          │ │ CVC                  │ │   │
│  │  │ ┌──────────────────┐ │ │ ┌──────────────────┐ │ │   │
│  │  │ │ 12 / 25          │ │ │ │ 123              │ │ │   │
│  │  │ └──────────────────┘ │ │ └──────────────────┘ │ │   │
│  │  └──────────────────────┘ └──────────────────────┘ │   │
│  │                                                     │   │
│  │  Nombre del titular                                 │   │
│  │  ┌───────────────────────────────────────────────┐ │   │
│  │  │ Juan Pérez                                    │ │   │
│  │  └───────────────────────────────────────────────┘ │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                             │
│  ☑ Acepto los términos del servicio y política de          │
│    reembolso                                                │
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │         Comenzar Trial de 7 Días - Gratis           │   │
│  │                                                     │   │
│  │  No se te cobrará hasta el 12/12/2025               │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                             │
│  🔒 Pago seguro procesado por Stripe                        │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Flujo de Suscripción (Gherkin)

Feature: Suscripción a Plan Pro

  Scenario: Suscripción exitosa con trial de 7 días
    Given que soy usuario registrado con email "juan@example.com"
    And estoy logueado
    And NO tengo suscripción activa
    When navego a la página de pricing
    And hago click en "Suscribirme" en el plan Pro
    Then debería ver la página de checkout con plan "Pro" seleccionado
    And debería ver el mensaje "7 días gratis - Luego $49/mes"

    When ingreso número de tarjeta "4242 4242 4242 4242"
    And ingreso fecha de vencimiento "12/25"
    And ingreso CVC "123"
    And ingreso nombre "Juan Pérez"
    And marco checkbox de términos
    And hago click en "Comenzar Trial de 7 Días"
    Then debería ver indicador de procesamiento
    And después de 2-5 segundos debería ver página de confirmación
    And debería ver mensaje "¡Trial iniciado! No se te cobrará hasta el 12/12/2025"

    And debería recibir email con asunto "Bienvenido a Trading Platform Pro"
    And mi perfil debería mostrar badge "Pro"
    And debería tener acceso a predicciones avanzadas
    And debería tener acceso a todos los cursos

  Scenario: Tarjeta rechazada
    Given que estoy en checkout de plan Pro
    When ingreso tarjeta "4000 0000 0000 0002" (rechazada)
    And completo formulario y confirmo
    Then debería ver error "Tu tarjeta fue rechazada. Intenta con otra."
    And debería permanecer en página de checkout
    And NO debería tener suscripción creada

  Scenario: Usuario ya tiene suscripción
    Given que tengo suscripción activa a "Basic"
    When intento suscribirme a "Pro"
    Then debería ver mensaje "Ya tienes una suscripción activa a Basic"
    And debería ver botón "Cambiar a Pro" en lugar de "Suscribirme"

Notas Técnicas

Frontend

Componente: apps/frontend/src/pages/SubscriptionCheckout.tsx
Cargar Stripe.js: @stripe/stripe-js
Elementos: @stripe/react-stripe-js
Pasos:
1. Fetch plan details
2. Inicializar Stripe Elements
3. Recopilar datos de tarjeta
4. Llamar backend para crear suscripción
5. Confirmar pago con stripe.confirmCardPayment() si requiere

Backend

Endpoint: POST /api/v1/payments/subscriptions
Request:

{
  "plan": "pro",
  "paymentMethodId": "pm_xxx",
  "trial": true
}

Response (Success):

{
  "subscription": {
    "id": "uuid",
    "plan": "pro",
    "status": "trialing",
    "trialEnd": "2025-12-12T00:00:00Z",
    "currentPeriodEnd": "2025-12-12T00:00:00Z"
  }
}

Response (Requires Action - 3DS):

{
  "requiresAction": true,
  "clientSecret": "seti_xxx_secret_yyy",
  "subscriptionId": "sub_xxx"
}

Database

Crear registro en billing.subscriptions
Actualizar users.subscription_plan
Crear billing.payments si hay cobro inmediato

Email Templates

Subject: Bienvenido a Trading Platform Pro

Hola Juan,

¡Bienvenido a Trading Platform Pro! 🎉

Tu trial de 7 días ha comenzado. Tienes acceso completo a:
✅ Predicciones avanzadas con IA
✅ Todos los cursos
✅ Indicadores técnicos premium
✅ Alertas personalizadas

Tu primer cobro será el 12/12/2025 por $49 USD.

Puedes cancelar en cualquier momento desde:
[Gestionar Suscripción]

¿Preguntas? Escríbenos a support@trading.com

Saludos,
El equipo de Trading Platform

Dependencias

Requerimientos Relacionados

Tareas Técnicas

Frontend

Crear página SubscriptionCheckout.tsx
Integrar Stripe Elements (CardElement)
Implementar flujo de confirmación 3DS
Agregar validación de formulario
Página de confirmación exitosa
Manejo de errores con mensajes claros

Backend

Endpoint POST /api/v1/payments/subscriptions
Validar que usuario no tenga suscripción activa
Crear Customer en Stripe si no existe
Adjuntar PaymentMethod a Customer
Crear Subscription con trial si aplica
Guardar en BD (subscriptions)
Enviar email de bienvenida
Webhook customer.subscription.created

Testing

Test: Suscripción con trial exitosa (Pro/Premium)
Test: Suscripción sin trial exitosa (Basic)
Test: Tarjeta rechazada muestra error
Test: 3DS funciona correctamente
Test: Usuario con suscripción activa no puede crear otra
Test: Email de bienvenida se envía
Test: Acceso premium se otorga inmediatamente

14 KiB Raw Blame History

US-PAY-002: Suscribirse a Plan

Historia de Usuario

Criterios de Aceptación

AC-001: Selección de Plan

AC-002: Formulario de Pago

AC-003: Trial Period (Pro/Premium)

AC-004: Pago Inmediato (Basic)

AC-005: Validación de Tarjeta

AC-006: Procesamiento 3D Secure

AC-007: Confirmación de Suscripción

AC-008: Ya Tiene Suscripción Activa

AC-009: Error de Pago

AC-010: Abandono de Checkout

Mockup

Flujo de Suscripción (Gherkin)

Notas Técnicas

Frontend

Backend

Database

Email Templates

Dependencias

Requerimientos Relacionados

Tareas Técnicas

Frontend

Backend

Testing

14 KiB

Raw Blame History