# 01-CONTEXTO.md - OQI-005 Payments Advanced Components

## Identificacion

| Campo | Valor |
|-------|-------|
| ID Tarea | TASK-2026-01-25-OQI-005-PAYMENTS-ADVANCED |
| Epic | OQI-005 Pagos y Stripe |
| Proyecto | trading-platform |
| Tipo | FEATURE |
| Prioridad | ALTA |

---

## Contexto del Proyecto

### Trading Platform
Plataforma de trading con módulos de inversión, educación, señales ML y gestión de portafolios. El módulo de pagos (OQI-005) maneja:
- Suscripciones y billing
- Wallet con depósitos/retiros
- Integración con Stripe
- Gestión de reembolsos

### Estado Previo del Módulo
- **Progreso anterior:** 50%
- **Componentes existentes:** 15
- **Gaps identificados:** PCI-DSS compliance, gestión de reembolsos

---

## Vinculacion con Epic

### OQI-005: Pagos y Stripe

**Objetivo:** Implementar sistema completo de pagos con Stripe incluyendo:
- Suscripciones mensuales/anuales
- Wallet para trading
- Facturación automática
- Cumplimiento PCI-DSS
- Gestión de reembolsos

**Requerimientos Relacionados:**
- REQ-PAY-001: Integración Stripe Elements
- REQ-PAY-002: Preview de factura pre-checkout
- REQ-PAY-003: Solicitud de reembolsos
- REQ-PAY-004: Historial de reembolsos

---

## Justificacion de la Tarea

### Problema Identificado
1. **PaymentMethodForm** enviaba datos de tarjeta en texto plano (violación PCI-DSS)
2. No existía preview de factura antes del checkout
3. No había flujo de reembolsos implementado

### Solucion Propuesta
Crear 4 componentes avanzados:
1. **StripeElementsWrapper** - Foundation para PCI-DSS compliance
2. **InvoicePreview** - Vista previa de factura
3. **RefundRequestModal** - Solicitud de reembolsos
4. **RefundList** - Historial de reembolsos

---

## Alcance

### Incluido
- Componentes frontend React/TypeScript
- Integración con Stripe.js
- Exportación de tipos TypeScript
- Actualización de inventarios

### Excluido
- Backend endpoints (existentes)
- Webhooks de Stripe
- Tests unitarios
- Migración de PaymentMethodForm existente

---

## Stakeholders

| Rol | Responsabilidad |
|-----|-----------------|
| Product Owner | Definición de requerimientos de pagos |
| Tech Lead | Arquitectura de integración Stripe |
| Frontend Dev | Implementación de componentes |
| Security | Validación PCI-DSS compliance |

---

## Referencias

- [Stripe Elements Documentation](https://stripe.com/docs/stripe-js)
- [PCI-DSS Compliance Guide](https://stripe.com/docs/security/guide)
- OQI-005 Module Definition: `docs/02-definicion-modulos/OQI-005-pagos-stripe/`
- FRONTEND_INVENTORY.yml
- MASTER_INVENTORY.yml
