930c3bec75
- Add 01-CONTEXTO.md, 02-ANALISIS.md, 03-PLANEACION.md, 04-VALIDACION.md - Update _INDEX.yml with complete CAPVED file list - Update ET-PAY-005-frontend.md with new components section - Update TRACEABILITY.yml with frontend implementation status Full SIMCO compliance achieved for TASK-2026-01-25-OQI-005-PAYMENTS-ADVANCED Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
100 lines
2.5 KiB
Markdown
100 lines
2.5 KiB
Markdown
# 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
|