trading-platform/docs/99-analisis/ANALISIS-SAAS-WALLET-MARKETPLACE.md

id	title	type	status	project	version	created_date	updated_date
ANALISIS-SAAS-WALLET-MARKETPLACE	Analisis de Gaps - Wallet Completo y Marketplace	Analysis	Draft	trading-platform	1.0.0	2026-01-04	2026-01-04

Analisis de Gaps: Wallet Completo y Marketplace

Fecha: 2026-01-04 Objetivo: Identificar gaps en documentacion para implementar Wallet completo y Marketplace de productos

---

1. Estado Actual del Wallet

1.1 Funcionalidades Existentes (RF-PAY-003)

Funcionalidad	Estado	Documento
Creacion automatica de wallet	✅ Definido	RF-PAY-003.1
Recarga con tarjeta ($10-$500)	✅ Definido	RF-PAY-003.2
Pago con wallet	✅ Definido	RF-PAY-003.3
Pago combinado (wallet + tarjeta)	✅ Definido	RF-PAY-003.4
Historial de transacciones	✅ Definido	RF-PAY-003.5
Retiro a banco (con KYC)	✅ Definido	RF-PAY-003.6
Creditos promocionales	✅ Definido	RF-PAY-003.7

1.2 Funcionalidades Faltantes (Gaps)

Funcionalidad	Estado	Prioridad	Justificacion
Depositos crypto (BTC, ETH, USDT)	❌ No existe	Alta	Usuario solicito wallet completo
Retiros a wallet crypto	❌ No existe	Alta	Complemento de depositos crypto
Transferencias P2P	❌ No existe	Media	Usuario solicito transferencias entre usuarios
Depositos SPEI (Mexico)	❌ No existe	Alta	Metodo de pago principal en Mexico
Rendimientos automaticos de MM	⚠️ Parcial	Alta	Falta flujo explicito wallet ↔ inversiones

---

2. Estado Actual de Productos Comprables

2.1 Lo que YA existe

Producto	Estado	Documento
Suscripciones (Free, Basic, Pro, Premium)	✅ Definido	RF-PAY-001
Compra de cursos	✅ Parcial	US-PAY-005

2.2 Lo que FALTA (Marketplace)

Producto	Estado	Prioridad	Descripcion
Modulo Marketplace completo	❌ No existe	Alta	Catalogo central de productos
Senales ML Premium	❌ No existe	Alta	Paquetes de senales adicionales
Asesoria financiera	❌ No existe	Media	Sesiones 1:1 con expertos
Visualizacion Premium	❌ No existe	Alta	Indicadores ML tipo TradingView
Productos digitales varios	❌ No existe	Baja	Templates, ebooks, etc.

---

3. Plan de Documentacion

3.1 Archivos a MODIFICAR

Archivo	Cambios Requeridos
00-vision-general/VISION-PRODUCTO.md	Agregar seccion "Wallet Completo" y "Marketplace"
02-definicion-modulos/OQI-005-payments-stripe/_MAP.md	Agregar nuevos RFs (007-009)

3.2 Archivos a CREAR

Modulo OQI-005 (Payments) - Extensiones:

Archivo	Contenido
RF-PAY-007-crypto.md	Sistema de depositos/retiros crypto
RF-PAY-008-spei.md	Integracion SPEI para Mexico
RF-PAY-009-p2p.md	Transferencias entre usuarios
US-PAY-011-depositar-crypto.md	Historia: depositar con crypto
US-PAY-012-retirar-crypto.md	Historia: retirar a wallet crypto
US-PAY-013-transferir-p2p.md	Historia: transferir a otro usuario
ET-PAY-007-crypto-integration.md	Especificacion tecnica crypto

Nuevo Modulo OQI-009 (Marketplace):

Archivo	Contenido
README.md	Vision general del modulo
_MAP.md	Indice de documentos
RF-MKT-001-catalogo.md	Catalogo de productos
RF-MKT-002-senales-premium.md	Senales ML como producto
RF-MKT-003-asesoria.md	Servicio de asesoria
RF-MKT-004-visualizacion.md	Modulo visualizacion premium
US-MKT-001-explorar-catalogo.md	Historia: ver productos
US-MKT-002-comprar-senales.md	Historia: comprar senales
US-MKT-003-agendar-asesoria.md	Historia: agendar sesion
US-MKT-004-activar-premium.md	Historia: activar visualizacion
ET-MKT-001-database.md	Modelo de datos marketplace
ET-MKT-002-api.md	Endpoints del marketplace

---

4. Dependencias Identificadas

4.1 Dependencias Internas

OQI-009-marketplace
├── Depende de: OQI-005-payments (procesamiento de pagos)
├── Depende de: OQI-001-auth (autenticacion)
├── Depende de: OQI-006-ml-signals (contenido de senales)
└── Depende de: OQI-003-trading-charts (visualizacion)

RF-PAY-007-crypto
├── Depende de: RF-PAY-003-wallet (balance management)
├── Depende de: RF-PAY-005-webhooks (notificaciones)
└── Requiere: Integracion con provider crypto (Coinbase Commerce, etc.)

RF-PAY-008-spei
├── Depende de: RF-PAY-003-wallet (balance management)
└── Requiere: Integracion con agregador (Stripe Mexico, OpenPay, etc.)

4.2 Dependencias Externas

Servicio	Proposito	Proveedor Sugerido
Pagos Crypto	Depositos/retiros crypto	Coinbase Commerce, BitPay
SPEI	Transferencias bancarias Mexico	Stripe MX, OpenPay, Conekta
Calendarios	Agendamiento de asesorias	Cal.com, Calendly API
Video	Sesiones de asesoria	Daily.co, Zoom API

---

5. Modelo de Datos Propuesto

5.1 Extensiones al Wallet

-- Nuevos tipos de transaccion
ALTER TYPE transaction_type ADD VALUE 'crypto_deposit';
ALTER TYPE transaction_type ADD VALUE 'crypto_withdrawal';
ALTER TYPE transaction_type ADD VALUE 'spei_deposit';
ALTER TYPE transaction_type ADD VALUE 'p2p_transfer_in';
ALTER TYPE transaction_type ADD VALUE 'p2p_transfer_out';

-- Tabla para direcciones crypto
CREATE TABLE wallet_crypto_addresses (
  id UUID PRIMARY KEY,
  wallet_id UUID REFERENCES wallets(id),
  currency VARCHAR(10), -- BTC, ETH, USDT
  network VARCHAR(20),  -- ethereum, bitcoin, polygon
  address VARCHAR(100),
  is_active BOOLEAN DEFAULT true,
  created_at TIMESTAMP
);

-- Tabla para transferencias P2P
CREATE TABLE p2p_transfers (
  id UUID PRIMARY KEY,
  from_wallet_id UUID REFERENCES wallets(id),
  to_wallet_id UUID REFERENCES wallets(id),
  amount DECIMAL(15,2),
  currency VARCHAR(3),
  message TEXT,
  status VARCHAR(20),
  created_at TIMESTAMP
);

5.2 Tablas del Marketplace

-- Schema: marketplace
CREATE SCHEMA marketplace;

-- Catalogo de productos
CREATE TABLE marketplace.products (
  id UUID PRIMARY KEY,
  type VARCHAR(50), -- signal_pack, advisory, visualization, course
  name VARCHAR(100),
  description TEXT,
  price DECIMAL(10,2),
  currency VARCHAR(3) DEFAULT 'USD',
  is_subscription BOOLEAN DEFAULT false,
  subscription_interval VARCHAR(20), -- monthly, yearly
  features JSONB,
  is_active BOOLEAN DEFAULT true,
  created_at TIMESTAMP,
  updated_at TIMESTAMP
);

-- Compras de productos
CREATE TABLE marketplace.purchases (
  id UUID PRIMARY KEY,
  user_id UUID REFERENCES users(id),
  product_id UUID REFERENCES marketplace.products(id),
  payment_id UUID, -- Referencia a payments
  amount DECIMAL(10,2),
  status VARCHAR(20),
  valid_until TIMESTAMP, -- Para suscripciones
  created_at TIMESTAMP
);

-- Sesiones de asesoria
CREATE TABLE marketplace.advisory_sessions (
  id UUID PRIMARY KEY,
  purchase_id UUID REFERENCES marketplace.purchases(id),
  advisor_id UUID REFERENCES users(id),
  scheduled_at TIMESTAMP,
  duration_minutes INT DEFAULT 60,
  meeting_url VARCHAR(500),
  status VARCHAR(20), -- scheduled, completed, cancelled, no_show
  notes TEXT,
  created_at TIMESTAMP
);

---

6. Validacion vs Requisitos del Usuario

Requisito Usuario	Cubierto	Archivo/Seccion
Wallet completo para fondear MM	✅	RF-PAY-003 existente + extensiones
Depositos tarjeta/transferencia	✅	RF-PAY-001/003 existente
Depositos crypto (BTC, ETH, USDT)	🔜	RF-PAY-007-crypto (nuevo)
Retiros a banco	✅	RF-PAY-003.6 existente
Retiros a crypto	🔜	RF-PAY-007-crypto (nuevo)
Transferencias P2P	🔜	RF-PAY-009-p2p (nuevo)
Comprar cursos premium	✅	US-PAY-005 existente
Comprar senales ML premium	🔜	RF-MKT-002 (nuevo)
Comprar asesoria	🔜	RF-MKT-003 (nuevo)
Visualizacion tipo TradingView	🔜	RF-MKT-004 (nuevo)
Rendimientos de MM al wallet	⚠️	Necesita documentar flujo explicito
Cuentas gestionadas por agentes	✅	OQI-004 existente (Atlas, Orion, Nova)

---

7. Resumen Ejecutivo

Trabajo Completado (Fase 1-4)

• ✅ Analisis de documentacion existente
• ✅ Identificacion de 12 gaps funcionales
• ✅ Mapeo de 19 archivos a crear
• ✅ Definicion de dependencias
• ✅ Propuesta de modelo de datos
• ✅ Validacion contra requisitos del usuario

Pendiente (Fase 5-8)

• Crear archivos de requerimientos crypto/SPEI/P2P
• Crear modulo OQI-009-marketplace completo
• Actualizar VISION-PRODUCTO.md
• Actualizar _MAP.md con nuevas referencias
• Validacion final de consistencia

---

Estado: ✅ COMPLETADO

---

8. Ejecucion Completada (Fases 5-8)

8.1 Archivos Creados

OQI-005 Extensiones de Payments (3 archivos)

Archivo	Lineas	Contenido
RF-PAY-007-crypto.md	~400	Depositos/retiros crypto
RF-PAY-008-spei.md	~320	Transferencias SPEI Mexico
RF-PAY-009-p2p.md	~350	Transferencias P2P

OQI-009 Marketplace (12 archivos)

Archivo	Tipo	Contenido
README.md	Vision	Vision del modulo
_MAP.md	Index	Indice de documentos
RF-MKT-001-catalogo.md	RF	Catalogo de productos
RF-MKT-002-senales-premium.md	RF	Paquetes de senales
RF-MKT-003-asesoria.md	RF	Sesiones de asesoria
RF-MKT-004-visualizacion.md	RF	Visualizacion premium
US-MKT-001-explorar-catalogo.md	US	Historia explorar
US-MKT-002-comprar-senales.md	US	Historia comprar senales
US-MKT-003-agendar-asesoria.md	US	Historia agendar
US-MKT-004-activar-visualizacion.md	US	Historia activar
ET-MKT-001-database.md	ET	Schema de BD
ET-MKT-002-api.md	ET	Endpoints API

8.2 Archivos Modificados

Archivo	Cambios
VISION-PRODUCTO.md	+80 lineas (Wallet y Marketplace)

8.3 Validacion Final

Requisito	Estado	Archivo
Wallet completo	✅	RF-PAY-003 + extensiones
Depositos crypto	✅	RF-PAY-007-crypto.md
Retiros crypto	✅	RF-PAY-007-crypto.md
SPEI Mexico	✅	RF-PAY-008-spei.md
Transferencias P2P	✅	RF-PAY-009-p2p.md
Marketplace	✅	OQI-009 completo
Senales premium	✅	RF-MKT-002
Asesoria	✅	RF-MKT-003
Visualizacion	✅	RF-MKT-004

Total archivos nuevos: 15 Total archivos modificados: 2 YAML front-matter: 100% Estado general: COMPLETADO