diff --git a/docs/00-vision-general/SRS-DOCUMENTO-REQUERIMIENTOS.md b/docs/00-vision-general/SRS-DOCUMENTO-REQUERIMIENTOS.md new file mode 100644 index 0000000..9502177 --- /dev/null +++ b/docs/00-vision-general/SRS-DOCUMENTO-REQUERIMIENTOS.md @@ -0,0 +1,570 @@ +# SRS - Especificacion de Requerimientos de Software + +**Proyecto:** Trading Platform +**Version:** 1.0.0 +**Fecha:** 2026-01-25 +**Estado:** Aprobado +**Clasificacion:** Interno + +--- + +## Control de Versiones + +| Version | Fecha | Autor | Cambios | +|---------|-------|-------|---------| +| 1.0.0 | 2026-01-25 | Sistema SIMCO | Documento inicial consolidado | + +--- + +## Tabla de Contenidos + +1. [Introduccion](#1-introduccion) +2. [Vision General](#2-vision-general) +3. [Stakeholders y Usuarios](#3-stakeholders-y-usuarios) +4. [Requerimientos Funcionales](#4-requerimientos-funcionales) +5. [Requerimientos No Funcionales](#5-requerimientos-no-funcionales) +6. [Restricciones y Supuestos](#6-restricciones-y-supuestos) +7. [Matriz de Dependencias](#7-matriz-de-dependencias) +8. [Priorizacion](#8-priorizacion) +9. [Glosario](#9-glosario) + +--- + +## 1. Introduccion + +### 1.1 Proposito + +Este documento especifica los requerimientos funcionales y no funcionales del sistema **Trading Platform**, una plataforma SaaS de trading e inversion que integra educacion financiera, agentes de inversion IA, senales de machine learning y trading social. + +### 1.2 Alcance + +Trading Platform es una solucion integral que permite a usuarios de todos los niveles: +- Aprender sobre trading e inversiones +- Invertir de forma automatizada mediante agentes IA +- Realizar trading manual con herramientas profesionales +- Acceder a predicciones basadas en machine learning +- Participar en una comunidad de trading social + +### 1.3 Audiencia + +- Product Owners +- Desarrolladores +- QA Engineers +- Stakeholders de negocio +- Equipos de operaciones + +### 1.4 Referencias + +| Documento | Ubicacion | +|-----------|-----------| +| Vision del Producto | docs/00-vision-general/VISION-PRODUCTO.md | +| Arquitectura General | docs/00-vision-general/ARQUITECTURA-GENERAL.md | +| Stack Tecnologico | docs/00-vision-general/STACK-TECNOLOGICO.md | +| Definiciones de Modulos | docs/02-definicion-modulos/ | + +--- + +## 2. Vision General + +### 2.1 Vision + +> Ser la plataforma de trading e inversion mas accesible y educativa de Latinoamerica, democratizando el acceso a herramientas profesionales de inversion mediante inteligencia artificial. + +### 2.2 Mision + +> Empoderar a personas de todos los niveles de experiencia para que puedan invertir de manera inteligente, segura y rentable, combinando educacion financiera de calidad con tecnologia de punta en machine learning. + +### 2.3 Objetivos de Negocio + +| ID | Objetivo | KPI | Meta Q4 | +|----|----------|-----|---------| +| OBJ-01 | Adquisicion de usuarios | Usuarios registrados | 10,000 | +| OBJ-02 | Engagement | MAU (Monthly Active Users) | 5,000 | +| OBJ-03 | Monetizacion | MRR (Monthly Recurring Revenue) | $500,000 MXN | +| OBJ-04 | Retencion | Churn mensual | <5% | +| OBJ-05 | Satisfaccion | NPS | >50 | + +### 2.4 Propuesta de Valor + +| Beneficio | Descripcion | +|-----------|-------------| +| Aprende mientras inviertes | Cursos integrados que se adaptan a tu nivel | +| Invierte sin ser experto | Agentes IA que operan por ti con diferentes perfiles de riesgo | +| Transparencia total | Entiende cada decision con explicaciones claras | +| Sin sorpresas | Comisiones claras y sin costos ocultos | +| Soporte en espanol | Plataforma 100% en espanol para LATAM | + +--- + +## 3. Stakeholders y Usuarios + +### 3.1 Stakeholders + +| Rol | Responsabilidad | Contacto | +|-----|-----------------|----------| +| Product Owner | Definicion de roadmap y prioridades | - | +| Tech Lead | Decisiones arquitectonicas | - | +| ML Engineer | Modelos de prediccion | - | +| UX Designer | Experiencia de usuario | - | + +### 3.2 Perfiles de Usuario + +| Perfil | Descripcion | Necesidades | Plan Sugerido | +|--------|-------------|-------------|---------------| +| **Principiante** | Nuevo en trading, busca aprender | Educacion, simulacion | Free / Basic | +| **Intermedio** | Conoce trading, quiere automatizar | Agentes IA, senales | Pro | +| **Avanzado** | Trader activo, busca ventaja competitiva | ML signals, API | Pro / Enterprise | +| **Inversor Pasivo** | Quiere invertir sin operar | Money Manager | Pro | + +### 3.3 Roles del Sistema + +| Rol | Codigo | Permisos | +|-----|--------|----------| +| Inversor | `investor` | Ver cursos, trading, invertir en agentes | +| Trader | `trader` | Todo de investor + crear bots, senales | +| Estudiante | `student` | Solo modulo educativo | +| Administrador | `admin` | Gestion de usuarios y contenido | +| Super Admin | `superadmin` | Configuracion del sistema | + +--- + +## 4. Requerimientos Funcionales + +### 4.1 Modulo: Autenticacion (OQI-001) + +**Descripcion:** Sistema de autenticacion multi-proveedor robusto y flexible. + +| ID | Requerimiento | Prioridad | Estado | +|----|---------------|-----------|--------| +| RF-AUTH-001 | El sistema debe permitir registro via email con verificacion | Alta | Implementado | +| RF-AUTH-002 | El sistema debe soportar OAuth 2.0 con Google | Alta | Implementado | +| RF-AUTH-003 | El sistema debe soportar OAuth 2.0 con Facebook | Alta | Implementado | +| RF-AUTH-004 | El sistema debe soportar OAuth 2.0 con X (Twitter) | Media | Implementado | +| RF-AUTH-005 | El sistema debe soportar OAuth 2.0 con Apple | Media | Implementado | +| RF-AUTH-006 | El sistema debe soportar OAuth 2.0 con GitHub | Baja | Implementado | +| RF-AUTH-007 | El sistema debe permitir login via SMS OTP (Twilio) | Alta | Implementado | +| RF-AUTH-008 | El sistema debe permitir login via WhatsApp OTP | Media | Implementado | +| RF-AUTH-009 | El sistema debe soportar 2FA con TOTP | Alta | Implementado | +| RF-AUTH-010 | El sistema debe generar backup codes para 2FA | Alta | Implementado | +| RF-AUTH-011 | El sistema debe usar JWT con access token (15min) y refresh token (7d) | Alta | Implementado | +| RF-AUTH-012 | El sistema debe permitir gestion de sesiones activas | Media | Pendiente | +| RF-AUTH-013 | El sistema debe permitir logout global de todos los dispositivos | Media | Pendiente | +| RF-AUTH-014 | El sistema debe permitir gestion de dispositivos conectados | Baja | Pendiente | +| RF-AUTH-015 | El sistema debe implementar recuperacion de contrasena via email | Alta | Implementado | + +**Progreso:** 70% + +--- + +### 4.2 Modulo: Educacion (OQI-002) + +**Descripcion:** Sistema de cursos educativos con gamificacion y seguimiento de progreso. + +| ID | Requerimiento | Prioridad | Estado | +|----|---------------|-----------|--------| +| RF-EDU-001 | El sistema debe mostrar catalogo de cursos con filtros | Alta | Implementado | +| RF-EDU-002 | El sistema debe organizar cursos por niveles (beginner, intermediate, advanced, expert) | Alta | Implementado | +| RF-EDU-003 | El sistema debe soportar lecciones multimedia (video, articulo, quiz, ejercicio) | Alta | Implementado | +| RF-EDU-004 | El sistema debe trackear progreso del usuario por leccion | Alta | Implementado | +| RF-EDU-005 | El sistema debe implementar sistema de XP y niveles | Media | Implementado | +| RF-EDU-006 | El sistema debe otorgar badges por logros | Media | Implementado | +| RF-EDU-007 | El sistema debe generar certificados de finalizacion | Media | Pendiente | +| RF-EDU-008 | El sistema debe mostrar leaderboard de estudiantes | Baja | Implementado | +| RF-EDU-009 | El sistema debe soportar quizzes con multiples tipos de pregunta | Alta | Implementado | +| RF-EDU-010 | El sistema debe trackear streak de dias consecutivos | Baja | Pendiente | + +**Progreso:** 100% (Core implementado) + +--- + +### 4.3 Modulo: Trading y Charts (OQI-003) + +**Descripcion:** Plataforma de trading con charts profesionales y paper trading. + +| ID | Requerimiento | Prioridad | Estado | +|----|---------------|-----------|--------| +| RF-TRD-001 | El sistema debe mostrar charts de precios en tiempo real | Alta | Parcial | +| RF-TRD-002 | El sistema debe soportar 7 timeframes (1m, 5m, 15m, 1h, 4h, 1D, 1W) | Alta | Implementado | +| RF-TRD-003 | El sistema debe incluir indicadores tecnicos (SMA, EMA, RSI, MACD, BB) | Alta | Implementado | +| RF-TRD-004 | El sistema debe permitir crear watchlists personalizadas | Media | Implementado | +| RF-TRD-005 | El sistema debe soportar paper trading con balance virtual $10,000 | Alta | Implementado | +| RF-TRD-006 | El sistema debe permitir ordenes market y limit | Alta | Implementado | +| RF-TRD-007 | El sistema debe calcular y mostrar P&L en tiempo real | Alta | Implementado | +| RF-TRD-008 | El sistema debe mostrar historial de trades | Alta | Implementado | +| RF-TRD-009 | El sistema debe calcular metricas (Win rate, Sharpe ratio) | Media | Pendiente | +| RF-TRD-010 | El sistema debe permitir configurar TP/SL en ordenes | Alta | Pendiente | +| RF-TRD-011 | El sistema debe soportar alertas de precio | Media | Pendiente | +| RF-TRD-012 | El sistema debe mostrar overlay de senales ML en chart | Alta | Pendiente | +| RF-TRD-013 | El sistema debe mostrar zonas AMD detectadas | Media | Pendiente | +| RF-TRD-014 | El sistema debe permitir exportar historial de trades | Baja | Pendiente | +| RF-TRD-015 | El sistema debe permitir reset de balance en paper trading | Baja | Implementado | + +**Story Points:** 55 SP | **Progreso:** 40% + +--- + +### 4.4 Modulo: Cuentas de Inversion (OQI-004) + +**Descripcion:** Sistema de inversion gestionado por agentes IA con diferentes perfiles de riesgo. + +| ID | Requerimiento | Prioridad | Estado | +|----|---------------|-----------|--------| +| RF-INV-001 | El sistema debe ofrecer 3 productos de inversion (Atlas, Orion, Nova) | Alta | Diseño | +| RF-INV-002 | Atlas debe tener target 3-5% mensual con max drawdown 5% | Alta | Diseño | +| RF-INV-003 | Orion debe tener target 5-10% mensual con max drawdown 10% | Alta | Diseño | +| RF-INV-004 | Nova debe tener target 10%+ mensual con max drawdown 20% | Alta | Diseño | +| RF-INV-005 | El sistema debe permitir apertura de cuenta con KYC basico | Alta | Pendiente | +| RF-INV-006 | El sistema debe permitir depositos via Stripe | Alta | Pendiente | +| RF-INV-007 | El sistema debe permitir depositos via crypto | Media | Pendiente | +| RF-INV-008 | El sistema debe procesar retiros en 72h | Alta | Pendiente | +| RF-INV-009 | El sistema debe mostrar dashboard de portfolio en tiempo real | Alta | Pendiente | +| RF-INV-010 | El sistema debe distribuir automaticamente las utilidades | Alta | Pendiente | +| RF-INV-011 | El sistema debe generar reportes de rendimiento | Media | Pendiente | +| RF-INV-012 | El sistema debe enviar notificaciones de transacciones | Media | Pendiente | + +**Story Points:** 50 SP | **Progreso:** 35% + +--- + +### 4.5 Modulo: Pagos Stripe (OQI-005) + +**Descripcion:** Integracion completa con Stripe para pagos y suscripciones. + +| ID | Requerimiento | Prioridad | Estado | +|----|---------------|-----------|--------| +| RF-PAY-001 | El sistema debe soportar pagos unicos para cursos | Alta | Implementado | +| RF-PAY-002 | El sistema debe ofrecer plan Basic ($19/mes) | Alta | Implementado | +| RF-PAY-003 | El sistema debe ofrecer plan Pro ($49/mes) | Alta | Implementado | +| RF-PAY-004 | El sistema debe ofrecer plan Premium ($99/mes) | Alta | Implementado | +| RF-PAY-005 | El sistema debe procesar webhooks de Stripe | Alta | Implementado | +| RF-PAY-006 | El sistema debe mostrar historial de transacciones | Alta | Implementado | +| RF-PAY-007 | El sistema debe permitir agregar multiples metodos de pago | Media | Pendiente | +| RF-PAY-008 | El sistema debe procesar refunds | Media | Implementado | +| RF-PAY-009 | El sistema debe generar facturas PDF | Baja | Pendiente | +| RF-PAY-010 | El sistema debe soportar modo sandbox para desarrollo | Alta | Implementado | + +**Progreso:** 100% (Core implementado) + +--- + +### 4.6 Modulo: Senales ML (OQI-006) + +**Descripcion:** Sistema de prediccion de precios basado en machine learning. + +| ID | Requerimiento | Prioridad | Estado | +|----|---------------|-----------|--------| +| RF-ML-001 | El sistema debe predecir rango de precio (max/min) | Alta | Implementado | +| RF-ML-002 | El sistema debe usar modelo XGBoost con 30+ features | Alta | Implementado | +| RF-ML-003 | El sistema debe soportar 4 horizontes de prediccion | Alta | Implementado | +| RF-ML-004 | El sistema debe calcular indicadores tecnicos automaticamente | Alta | Implementado | +| RF-ML-005 | El sistema debe mostrar confianza de la prediccion | Alta | Implementado | +| RF-ML-006 | El sistema debe transmitir predicciones via WebSocket | Alta | Parcial | +| RF-ML-007 | El sistema debe mantener historial de senales | Alta | Implementado | +| RF-ML-008 | El sistema debe mostrar senal ensemble de multiples modelos | Media | Pendiente | +| RF-ML-009 | El sistema debe mostrar analisis ICT (zonas de liquidez, FVG, OB) | Media | Pendiente | +| RF-ML-010 | El sistema debe permitir scan multi-simbolo | Baja | Pendiente | +| RF-ML-011 | El sistema debe soportar BTCUSDT y ETHUSDT inicialmente | Alta | Implementado | +| RF-ML-012 | El sistema debe lograr MAE <2% en predicciones | Alta | Implementado | + +**Progreso:** 100% (Core implementado) + +--- + +### 4.7 Modulo: LLM Strategy Agent (OQI-007) + +**Descripcion:** Copiloto de trading inteligente que interpreta senales ML en lenguaje natural. + +| ID | Requerimiento | Prioridad | Estado | +|----|---------------|-----------|--------| +| RF-LLM-001 | El sistema debe interpretar senales ML en lenguaje natural | Alta | Parcial | +| RF-LLM-002 | El sistema debe sugerir estrategias contextuales | Alta | Pendiente | +| RF-LLM-003 | El sistema debe explicar decisiones y razonamientos | Alta | Parcial | +| RF-LLM-004 | El sistema debe proporcionar asistencia educativa | Media | Parcial | +| RF-LLM-005 | El sistema debe soportar modo chat conversacional | Alta | Implementado | +| RF-LLM-006 | El sistema debe soportar modo comando directo | Media | Pendiente | +| RF-LLM-007 | El sistema debe enviar alertas proactivas | Media | Pendiente | +| RF-LLM-008 | El sistema debe analizar confluencia entre indicadores | Media | Pendiente | +| RF-LLM-009 | El sistema debe limitar mensajes segun plan de suscripcion | Alta | Pendiente | +| RF-LLM-010 | El sistema debe ejecutar trades desde el chat (paper trading) | Baja | Pendiente | +| RF-LLM-011 | El sistema debe ejecutar trades desde el chat (real) | Baja | Pendiente | + +**Story Points:** 55 SP | **Progreso:** 25% + +--- + +### 4.8 Modulo: Portfolio Manager (OQI-008) + +**Descripcion:** Sistema profesional de gestion de carteras con rebalanceo automatico. + +| ID | Requerimiento | Prioridad | Estado | +|----|---------------|-----------|--------| +| RF-PFM-001 | El sistema debe mostrar resumen de portfolio | Alta | Pendiente | +| RF-PFM-002 | El sistema debe calcular metricas profesionales (Sharpe, Sortino, etc.) | Alta | Pendiente | +| RF-PFM-003 | El sistema debe soportar 5 perfiles de riesgo predefinidos | Alta | Diseño | +| RF-PFM-004 | El sistema debe realizar onboarding de perfil via cuestionario | Media | Pendiente | +| RF-PFM-005 | El sistema debe ejecutar rebalanceo automatico | Alta | Pendiente | +| RF-PFM-006 | El sistema debe detectar drift de asignacion | Alta | Pendiente | +| RF-PFM-007 | El sistema debe mostrar proyecciones Monte Carlo | Media | Pendiente | +| RF-PFM-008 | El sistema debe permitir definir metas de inversion | Media | Pendiente | +| RF-PFM-009 | El sistema debe comparar rendimiento con benchmarks | Media | Pendiente | +| RF-PFM-010 | El sistema debe ejecutar stress tests | Baja | Pendiente | +| RF-PFM-011 | El sistema debe generar reportes fiscales | Media | Pendiente | +| RF-PFM-012 | El sistema debe distribuir rendimientos (80% reinversion, 20% usuario) | Alta | Pendiente | +| RF-PFM-013 | El sistema debe enviar alertas de rebalanceo | Media | Pendiente | +| RF-PFM-014 | El sistema debe generar reportes PDF del portfolio | Media | Pendiente | + +**Story Points:** 65 SP | **Progreso:** 20% + +--- + +### 4.9 Modulo: Marketplace (OQI-009) + +**Descripcion:** Centro comercial de productos y servicios premium. + +| ID | Requerimiento | Prioridad | Estado | +|----|---------------|-----------|--------| +| RF-MKT-001 | El sistema debe mostrar catalogo de productos | Alta | Pendiente | +| RF-MKT-002 | El sistema debe ofrecer paquetes de senales (Basic $9, Pro $29, Unlimited $49) | Alta | Diseño | +| RF-MKT-003 | El sistema debe permitir reservar sesiones de asesoria | Media | Diseño | +| RF-MKT-004 | El sistema debe ofrecer visualizacion premium ($19/mes) | Media | Diseño | +| RF-MKT-005 | El sistema debe integrar con Cal.com para agendamiento | Media | Pendiente | +| RF-MKT-006 | El sistema debe integrar con Daily.co para videollamadas | Media | Pendiente | +| RF-MKT-007 | El sistema debe procesar comisiones de asesores (15%) | Media | Pendiente | +| RF-MKT-008 | El sistema debe mostrar reseñas de productos | Baja | Pendiente | + +**Progreso:** 0% (En planificacion) + +--- + +### 4.10 Modulo: LLM Trading Integration (OQI-010) + +**Descripcion:** Integracion avanzada de LLM con trading autonomo y gestion de riesgo. + +| ID | Requerimiento | Prioridad | Estado | +|----|---------------|-----------|--------| +| RF-LTI-001 | El sistema debe fine-tunear LLM con estrategias (AMD, ICT/SMC) | Alta | Pendiente | +| RF-LTI-002 | El sistema debe integrar MCP Binance Connector | Alta | Pendiente | +| RF-LTI-003 | El sistema debe implementar position sizing automatico | Alta | Pendiente | +| RF-LTI-004 | El sistema debe monitorear drawdown en tiempo real | Alta | Pendiente | +| RF-LTI-005 | El sistema debe implementar circuit breaker automatico | Alta | Pendiente | +| RF-LTI-006 | El sistema debe persistir predicciones en PostgreSQL | Alta | Pendiente | +| RF-LTI-007 | El sistema debe calcular accuracy de predicciones | Alta | Pendiente | +| RF-LTI-008 | El sistema debe mostrar dashboard de precision | Media | Pendiente | +| RF-LTI-009 | El sistema debe enviar alertas proactivas de oportunidades | Media | Pendiente | + +**Story Points:** 89 SP | **Progreso:** 0% (En planificacion) + +--- + +## 5. Requerimientos No Funcionales + +### 5.1 Rendimiento (RNF-PERF) + +| ID | Requerimiento | Metrica | Target | +|----|---------------|---------|--------| +| RNF-PERF-001 | Tiempo de respuesta API | p95 latency | <200ms | +| RNF-PERF-002 | Tiempo de carga inicial | First Contentful Paint | <2s | +| RNF-PERF-003 | Throughput API | Requests/segundo | >1000 | +| RNF-PERF-004 | Latencia WebSocket | Tiempo de entrega | <100ms | +| RNF-PERF-005 | Tiempo de prediccion ML | Tiempo de inferencia | <500ms | + +### 5.2 Disponibilidad (RNF-AVAIL) + +| ID | Requerimiento | Metrica | Target | +|----|---------------|---------|--------| +| RNF-AVAIL-001 | Uptime del sistema | Disponibilidad | 99.9% | +| RNF-AVAIL-002 | RTO (Recovery Time Objective) | Tiempo de recuperacion | <15min | +| RNF-AVAIL-003 | RPO (Recovery Point Objective) | Perdida de datos maxima | <5min | + +### 5.3 Seguridad (RNF-SEC) + +| ID | Requerimiento | Descripcion | +|----|---------------|-------------| +| RNF-SEC-001 | Encriptacion en transito | TLS 1.3 obligatorio | +| RNF-SEC-002 | Encriptacion en reposo | AES-256 para datos sensibles | +| RNF-SEC-003 | Passwords | bcrypt con salt, min 8 caracteres | +| RNF-SEC-004 | Rate Limiting | 100 req/min general, 5 req/15min auth | +| RNF-SEC-005 | CORS | Solo origenes permitidos | +| RNF-SEC-006 | Audit Logging | Todas las acciones criticas | +| RNF-SEC-007 | Proteccion OWASP | Top 10 vulnerabilidades cubiertas | + +### 5.4 Escalabilidad (RNF-SCALE) + +| ID | Requerimiento | Descripcion | +|----|---------------|-------------| +| RNF-SCALE-001 | Usuarios concurrentes | Soportar 10,000 usuarios simultaneos | +| RNF-SCALE-002 | Escalado horizontal | Backend stateless para load balancing | +| RNF-SCALE-003 | Base de datos | Read replicas para escalado de lectura | +| RNF-SCALE-004 | Cache | Redis cluster para sesiones y datos calientes | + +### 5.5 Usabilidad (RNF-UX) + +| ID | Requerimiento | Descripcion | +|----|---------------|-------------| +| RNF-UX-001 | Responsive | Funcional en dispositivos 320px - 4K | +| RNF-UX-002 | Accesibilidad | WCAG 2.1 nivel AA | +| RNF-UX-003 | Idioma | Espanol (LATAM) como idioma principal | +| RNF-UX-004 | Onboarding | Flujo guiado para nuevos usuarios | +| RNF-UX-005 | Feedback | Mensajes de error claros y accionables | + +### 5.6 Mantenibilidad (RNF-MAINT) + +| ID | Requerimiento | Descripcion | +|----|---------------|-------------| +| RNF-MAINT-001 | Cobertura de tests | >80% en codigo critico | +| RNF-MAINT-002 | Documentacion | API documentada con Swagger/OpenAPI | +| RNF-MAINT-003 | Logging | Logs estructurados (JSON) | +| RNF-MAINT-004 | Monitoreo | Metricas expuestas para Prometheus | +| RNF-MAINT-005 | CI/CD | Pipeline automatizado de despliegue | + +--- + +## 6. Restricciones y Supuestos + +### 6.1 Restricciones Tecnicas + +| ID | Restriccion | +|----|-------------| +| RES-001 | El sistema debe usar PostgreSQL 16+ como base de datos principal | +| RES-002 | El backend debe desarrollarse en TypeScript con Express.js | +| RES-003 | El frontend debe desarrollarse en React 18+ con TypeScript | +| RES-004 | Los servicios ML deben desarrollarse en Python 3.11+ con FastAPI | +| RES-005 | El sistema debe desplegarse en contenedores Docker | + +### 6.2 Restricciones de Negocio + +| ID | Restriccion | +|----|-------------| +| RES-006 | El sistema debe cumplir con regulaciones de proteccion de datos (LFPDPPP Mexico) | +| RES-007 | Los pagos deben procesarse exclusivamente via Stripe | +| RES-008 | El sistema no debe ejecutar trades reales sin confirmacion explicita del usuario | +| RES-009 | Los fondos de usuarios deben estar segregados de fondos operativos | + +### 6.3 Supuestos + +| ID | Supuesto | +|----|----------| +| SUP-001 | Los usuarios tendran acceso a internet estable | +| SUP-002 | Los datos de mercado estaran disponibles via APIs externas | +| SUP-003 | Stripe mantendra su disponibilidad de servicio | +| SUP-004 | Los modelos ML seran reentrenados mensualmente | + +--- + +## 7. Matriz de Dependencias + +``` +OQI-001 (Auth) [FUNDACION] + | + +---> OQI-002 (Educacion) + | + +---> OQI-003 (Trading) -----> OQI-006 (ML Signals) + | | | + | | v + | +---------------> OQI-007 (LLM Agent) + | | + | v + | OQI-010 (LLM Integration) + | + +---> OQI-004 (Investment) -----> OQI-008 (Portfolio Manager) + | | + | v + +---> OQI-005 (Pagos) -----------> OQI-009 (Marketplace) +``` + +### Orden de Implementacion Recomendado + +| Fase | Modulos | Dependencias | +|------|---------|--------------| +| 1 | OQI-001, OQI-005, OQI-006 | Ninguna (fundacionales) | +| 2 | OQI-002, OQI-003 | OQI-001 | +| 3 | OQI-004, OQI-007 | OQI-001, OQI-003, OQI-006 | +| 4 | OQI-008 | OQI-004, OQI-005 | +| 5 | OQI-009, OQI-010 | Todos los anteriores | + +--- + +## 8. Priorizacion + +### 8.1 Resumen de Estado por Modulo + +| Modulo | Progreso | Story Points | Prioridad | +|--------|----------|--------------|-----------| +| OQI-001 Auth | 70% | - | P0 | +| OQI-002 Educacion | 100% | - | P1 | +| OQI-003 Trading | 40% | 55 | P1 | +| OQI-004 Investment | 35% | 50 | P1 | +| OQI-005 Pagos | 100% | - | P0 | +| OQI-006 ML Signals | 100% | - | P0 | +| OQI-007 LLM Agent | 25% | 55 | P2 | +| OQI-008 Portfolio | 20% | 65 | P2 | +| OQI-009 Marketplace | 0% | - | P3 | +| OQI-010 LLM Integration | 0% | 89 | P3 | +| **TOTAL** | | **314+ SP** | | + +### 8.2 Criterios de Priorizacion + +- **P0 (Critico):** Funcionalidad core sin la cual el sistema no opera +- **P1 (Alto):** Funcionalidad importante para MVP +- **P2 (Medio):** Funcionalidad diferenciadora para fase Growth +- **P3 (Bajo):** Funcionalidad avanzada para fase Enterprise + +--- + +## 9. Glosario + +| Termino | Definicion | +|---------|------------| +| **AMD** | Accumulation-Manipulation-Distribution - Patron de mercado | +| **ATR** | Average True Range - Indicador de volatilidad | +| **Drawdown** | Caida maxima desde un pico de capital | +| **FVG** | Fair Value Gap - Brecha de valor justo en el precio | +| **ICT** | Inner Circle Trader - Metodologia de trading | +| **JWT** | JSON Web Token - Formato de token de autenticacion | +| **KYC** | Know Your Customer - Verificacion de identidad | +| **LLM** | Large Language Model - Modelo de lenguaje | +| **MACD** | Moving Average Convergence Divergence - Indicador | +| **MAE** | Mean Absolute Error - Metrica de precision | +| **MCP** | Model Context Protocol - Protocolo de comunicacion | +| **ML** | Machine Learning - Aprendizaje automatico | +| **NPS** | Net Promoter Score - Metrica de satisfaccion | +| **OB** | Order Block - Zona de ordenes institucionales | +| **OHLCV** | Open-High-Low-Close-Volume - Datos de precio | +| **Paper Trading** | Trading simulado sin dinero real | +| **P&L** | Profit and Loss - Ganancia/Perdida | +| **RBAC** | Role-Based Access Control - Control de acceso por rol | +| **RLS** | Row Level Security - Seguridad a nivel de fila | +| **RSI** | Relative Strength Index - Indicador de momentum | +| **SMA** | Simple Moving Average - Media movil simple | +| **SMC** | Smart Money Concepts - Conceptos de dinero institucional | +| **SP** | Story Points - Puntos de historia para estimacion | +| **TOTP** | Time-based One-Time Password - Contrasena temporal | +| **TWR** | Time-Weighted Return - Retorno ponderado por tiempo | +| **XP** | Experience Points - Puntos de experiencia (gamificacion) | + +--- + +## Apendices + +### A. Historias de Usuario por Modulo + +Total de historias de usuario documentadas: **90+** + +Ubicacion: `docs/02-definicion-modulos/OQI-*/historias-usuario/` + +### B. Especificaciones Tecnicas + +Ubicacion: `docs/02-definicion-modulos/OQI-*/especificaciones/` + +### C. Diagramas de Arquitectura + +Ubicacion: `docs/01-arquitectura/` + +### D. ADRs (Architecture Decision Records) + +Ubicacion: `docs/97-adr/` + +--- + +*Documento generado: 2026-01-25 | Sistema: SIMCO v4.0.0* +*Trading Platform v1.0.0* diff --git a/docs/00-vision-general/_MAP.md b/docs/00-vision-general/_MAP.md index 7ed2279..4acd6f3 100644 --- a/docs/00-vision-general/_MAP.md +++ b/docs/00-vision-general/_MAP.md @@ -8,7 +8,7 @@ updated_date: "2026-01-04" # _MAP: Vision General -**Ultima actualizacion:** 2025-12-05 +**Ultima actualizacion:** 2026-01-25 **Estado:** ✅ Completado **Version:** 1.0.0 **Proposito:** Documentacion de alto nivel del proyecto Trading Platform @@ -26,6 +26,7 @@ Esta carpeta contiene la vision general, arquitectura y definiciones fundamental | Archivo | Descripcion | Estado | |---------|-------------|--------| | `_MAP.md` | Este indice | ✅ | +| `SRS-DOCUMENTO-REQUERIMIENTOS.md` | **Especificacion de Requerimientos (SRS)** | ✅ NEW | | `VISION-PRODUCTO.md` | Vision, mision, propuesta de valor | ✅ | | `ARQUITECTURA-GENERAL.md` | Arquitectura de alto nivel | ✅ | | `STACK-TECNOLOGICO.md` | Stack completo del proyecto | ✅ |