rckrdmrd
a7cca885f0
Changes include: - Updated architecture documentation - Enhanced module definitions (OQI-001 to OQI-008) - ML integration documentation updates - Trading strategies documentation - Orchestration and inventory updates - Docker configuration updates 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
319 lines
11 KiB
Markdown
319 lines
11 KiB
Markdown
---
|
|
id: "ANALISIS-SAAS-WALLET-MARKETPLACE"
|
|
title: "Analisis de Gaps - Wallet Completo y Marketplace"
|
|
type: "Analysis"
|
|
status: "Draft"
|
|
project: "trading-platform"
|
|
version: "1.0.0"
|
|
created_date: "2026-01-04"
|
|
updated_date: "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
|
|
|
|
```sql
|
|
-- 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
|
|
|
|
```sql
|
|
-- 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
|