workspace-v1/projects/trading-platform/docs/02-definicion-modulos/OQI-007-llm-agent/requerimientos/RF-LLM-001-chat-interface.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

6.3 KiB

RF-LLM-001: Interfaz de Chat con LLM

Épica: OQI-007 - LLM Strategy Agent Versión: 1.0 Fecha: 2025-12-05 Estado: Planificado Prioridad: P0 - Crítico


Descripción

El sistema debe proporcionar una interfaz de chat conversacional que permita a los usuarios interactuar con un agente LLM especializado en trading. El chat debe soportar streaming de respuestas, mantener contexto de conversación y permitir múltiples conversaciones.


Requisitos Funcionales

RF-LLM-001.1: Envío de Mensajes

  • El usuario debe poder enviar mensajes de texto al agente LLM
  • El sistema debe validar que el mensaje no esté vacío
  • El sistema debe limitar la longitud del mensaje según el plan del usuario
  • El mensaje debe incluir contexto de mercado actual automáticamente

RF-LLM-001.2: Streaming de Respuestas

  • Las respuestas del LLM deben mostrarse en tiempo real (streaming)
  • El usuario debe ver el texto aparecer palabra por palabra
  • Debe existir indicador visual de que el agente está "pensando"
  • El usuario debe poder cancelar una respuesta en progreso

RF-LLM-001.3: Gestión de Conversaciones

  • El usuario debe poder crear nuevas conversaciones
  • El usuario debe poder ver historial de conversaciones anteriores
  • El usuario debe poder eliminar conversaciones
  • El usuario debe poder renombrar conversaciones
  • Las conversaciones deben persistir entre sesiones

RF-LLM-001.4: Contexto de Conversación

  • El sistema debe mantener contexto de los últimos N mensajes
  • El contexto debe incluir información de mercado relevante
  • El contexto debe incluir posiciones/watchlist del usuario
  • El sistema debe resumir conversaciones largas automáticamente

RF-LLM-001.5: Feedback de Respuestas

  • El usuario debe poder marcar respuestas como útiles/no útiles
  • El usuario debe poder reportar respuestas incorrectas
  • El sistema debe usar feedback para mejorar respuestas futuras

Criterios de Aceptación

Feature: Chat Interface con LLM

Scenario: Enviar mensaje y recibir respuesta
  Given estoy autenticado como usuario con plan Pro
  And estoy en la página del Copilot
  When escribo "¿Cuál es tu análisis de AAPL?" en el input
  And presiono Enter o el botón enviar
  Then veo mi mensaje en el chat
  And veo indicador de "Analizando..."
  And las palabras de la respuesta aparecen progresivamente
  And la respuesta incluye análisis técnico de AAPL

Scenario: Crear nueva conversación
  Given tengo una conversación activa con mensajes
  When hago clic en "Nueva conversación"
  Then se crea una nueva conversación vacía
  And la conversación anterior se guarda en el historial
  And puedo acceder a la conversación anterior

Scenario: Límite de mensajes por plan
  Given soy usuario con plan Free
  And he enviado 10 mensajes hoy
  When intento enviar otro mensaje
  Then veo mensaje "Has alcanzado el límite diario"
  And veo opción para upgrade a plan Pro

Reglas de Negocio

Regla Descripción
RN-001 Mensajes vacíos no se envían
RN-002 Límite de caracteres: Free=500, Pro=2000, Premium=4000
RN-003 Límite diario: Free=10, Pro=100, Premium=ilimitado
RN-004 Contexto máximo: últimos 20 mensajes
RN-005 Conversaciones se auto-eliminan después de 90 días de inactividad
RN-006 Respuestas con contenido financiero incluyen disclaimer

Dependencias

Épicas Requeridas

  • OQI-001: Autenticación (usuarios autenticados)

APIs Externas

  • OpenAI GPT-4 / Claude API
  • WebSocket para streaming

Mockups/Wireframes

┌─────────────────────────────────────────────────────────────┐
│ OrbiQuant Copilot                              [Nueva] [⚙️] │
├─────────────────────────────────────────────────────────────┤
│ ┌─────────────┐ ┌─────────────────────────────────────────┐ │
│ │ Historial   │ │                                         │ │
│ │             │ │  🤖 ¡Hola! Soy tu asistente de trading. │ │
│ │ > Análisis  │ │     ¿En qué puedo ayudarte hoy?         │ │
│ │   AAPL      │ │                                         │ │
│ │             │ │  👤 ¿Cuál es tu análisis de AAPL?       │ │
│ │   Estrategia│ │                                         │ │
│ │   BTC       │ │  🤖 Analizando AAPL...                  │ │
│ │             │ │     ████████░░ 80%                      │ │
│ │   Portfolio │ │                                         │ │
│ │             │ │                                         │ │
│ └─────────────┘ └─────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────────┤
│ [📎] Escribe tu mensaje...                         [Enviar] │
└─────────────────────────────────────────────────────────────┘

Especificaciones Técnicas Relacionadas


Historias de Usuario Relacionadas

  • US-LLM-001: Enviar mensaje al copilot
  • US-LLM-002: Ver historial de conversaciones

Notas Técnicas

  • Usar WebSocket para streaming bidireccional
  • Implementar reconnection automática
  • Cache de respuestas frecuentes
  • Rate limiting por usuario

Documento de requerimientos - Sistema NEXUS OrbiQuant IA Trading Platform