trading-platform/docs/02-definicion-modulos/OQI-009-marketplace/requerimientos/RF-MKT-003-asesoria.md
rckrdmrd a7cca885f0 feat: Major platform documentation and architecture updates
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>
2026-01-07 05:33:35 -06:00

8.2 KiB

id title type status priority epic project version dates tags
RF-MKT-003 Sesiones de Asesoria requirement Draft High OQI-009 trading-platform 1.0.0
created updated
2026-01-04 2026-01-04
marketplace
advisory
consulting
video

RF-MKT-003: Sesiones de Asesoria

Descripcion

El modulo de Asesoria permite a los usuarios agendar y participar en sesiones 1:1 con asesores financieros certificados. Incluye agendamiento integrado, video llamadas y seguimiento post-sesion.

Objetivo

Proveer un servicio de consultoria personalizada que agregue valor premium a los usuarios, conectandolos con expertos certificados en trading y finanzas.

Tiers de Sesiones

Sesion 30 minutos

Caracteristica Valor
Duracion 30 minutos
Precio $49 USD
Tipo One-time
Incluye Video llamada + Notas

Sesion 60 minutos

Caracteristica Valor
Duracion 60 minutos
Precio $89 USD
Tipo One-time
Incluye Video + Notas + Plan accion

Sesion 90 minutos

Caracteristica Valor
Duracion 90 minutos
Precio $119 USD
Tipo One-time
Incluye Video + Notas + Plan + Seguimiento

Funcionalidades

Seleccion de Asesor

Feature: Seleccion de Asesor

  Scenario: Ver asesores disponibles
    Given soy usuario autenticado
    When accedo a la seccion de asesoria
    Then veo lista de asesores con:
      | campo         | ejemplo                    |
      | nombre        | Juan Garcia, CFA           |
      | especialidad  | Crypto Trading             |
      | rating        | 4.8/5 (120 reviews)        |
      | experiencia   | 8 anos                     |
      | precio_base   | desde $49                  |

  Scenario: Ver perfil de asesor
    Given veo un asesor en la lista
    When hago click en su perfil
    Then veo biografia completa
    And veo calendario de disponibilidad
    And veo reviews de otros usuarios

Agendamiento (Cal.com)

Feature: Agendamiento de Sesiones

  Scenario: Agendar sesion
    Given he seleccionado un asesor
    And he elegido sesion de 60 minutos
    When selecciono fecha y hora disponible
    And confirmo el pago de $89
    Then la sesion se agenda
    And recibo confirmacion por email
    And se agrega a mi calendario

  Scenario: Reagendar sesion
    Given tengo una sesion agendada
    And faltan mas de 24 horas
    When solicito reagendar
    Then veo calendario con nuevas opciones
    And puedo seleccionar nueva fecha
    And se notifica al asesor

  Scenario: Cancelar sesion
    Given tengo una sesion agendada
    And faltan mas de 24 horas
    When cancelo la sesion
    Then recibo reembolso completo
    And se libera el slot del asesor

Video Llamada (Daily.co)

Feature: Video Llamada

  Scenario: Unirse a sesion
    Given tengo sesion agendada para ahora
    When hago click en "Unirse"
    Then se abre sala de video Daily.co
    And veo al asesor (si ya se unio)
    And tengo controles de audio/video

  Scenario: Funciones durante llamada
    Given estoy en una video llamada
    Then puedo:
      | funcion            |
      | Compartir pantalla |
      | Chat de texto      |
      | Grabar sesion      |
      | Silenciar micro    |

  Scenario: Problemas tecnicos
    Given estoy en llamada
    When hay problemas de conexion
    Then veo indicador de calidad
    And puedo cambiar a solo audio
    And hay boton de reconectar

Notas y Seguimiento

Feature: Notas Post-Sesion

  Scenario: Asesor agrega notas
    Given la sesion ha terminado
    When el asesor accede al panel
    Then puede agregar:
      | seccion          | contenido                |
      | resumen          | Puntos clave discutidos  |
      | recomendaciones  | Acciones sugeridas       |
      | recursos         | Links y materiales       |
      | seguimiento      | Proximos pasos           |

  Scenario: Usuario ve notas
    Given mi sesion tiene notas
    When accedo a mi historial
    Then veo notas completas
    And puedo descargar como PDF
    And veo recursos adjuntos

Integraciones

Cal.com (Agendamiento)

integration: cal.com
features:
  - Calendario de disponibilidad
  - Reserva automatica
  - Sincronizacion con Google/Outlook
  - Recordatorios automaticos
  - Manejo de zonas horarias
  - Politicas de cancelacion

Daily.co (Video)

integration: daily.co
features:
  - Video HD
  - Compartir pantalla
  - Grabacion de sesiones
  - Chat en tiempo real
  - Salas privadas
  - Transcripcion automatica

Modelo de Datos

Tabla: advisors

Campo Tipo Descripcion
id UUID Identificador unico
user_id UUID FK a users (perfil base)
display_name VARCHAR(255) Nombre profesional
title VARCHAR(100) Titulo (CFA, MBA, etc)
bio TEXT Biografia completa
short_bio VARCHAR(500) Bio corta
specialties JSONB Lista de especialidades
experience_years INT Anos de experiencia
hourly_rate DECIMAL(10,2) Tarifa base por hora
cal_username VARCHAR(100) Usuario en Cal.com
rating DECIMAL(3,2) Rating promedio
review_count INT Numero de reviews
is_active BOOLEAN Disponible
created_at TIMESTAMP Fecha registro

Tabla: advisory_sessions

Campo Tipo Descripcion
id UUID Identificador unico
user_id UUID FK a users (cliente)
advisor_id UUID FK a advisors
product_id UUID FK a products
purchase_id UUID FK a purchases
duration_minutes INT Duracion en minutos
scheduled_at TIMESTAMP Fecha/hora agendada
status ENUM scheduled, completed, cancelled, no_show
cal_event_id VARCHAR(255) ID evento Cal.com
daily_room_url VARCHAR(500) URL sala Daily.co
recording_url VARCHAR(500) URL grabacion
cancelled_at TIMESTAMP Fecha cancelacion
cancellation_reason TEXT Motivo cancelacion
created_at TIMESTAMP Fecha creacion

Tabla: session_notes

Campo Tipo Descripcion
id UUID Identificador unico
session_id UUID FK a advisory_sessions
advisor_id UUID FK a advisors
summary TEXT Resumen de la sesion
recommendations JSONB Lista de recomendaciones
resources JSONB Links y materiales
follow_up_actions JSONB Acciones de seguimiento
private_notes TEXT Notas privadas (solo asesor)
created_at TIMESTAMP Fecha creacion
updated_at TIMESTAMP Fecha actualizacion

Tabla: advisor_reviews

Campo Tipo Descripcion
id UUID Identificador unico
session_id UUID FK a advisory_sessions
user_id UUID FK a users
advisor_id UUID FK a advisors
rating INT 1-5 estrellas
comment TEXT Comentario
is_public BOOLEAN Visible publicamente
created_at TIMESTAMP Fecha creacion

Reglas de Negocio

  1. RN-001: Cancelacion gratis hasta 24h antes
  2. RN-002: Cancelacion < 24h: 50% reembolso
  3. RN-003: No-show del cliente: sin reembolso
  4. RN-004: No-show del asesor: reembolso completo + credito
  5. RN-005: Sesiones se graban solo con consentimiento
  6. RN-006: Notas disponibles hasta 48h post-sesion
  7. RN-007: Review posible solo despues de sesion completada

Flujo de Comisiones

Precio sesion: $89
├── Asesor: 85% = $75.65
├── Plataforma: 15% = $13.35
└── Procesador pago: ~3% (del total)

Criterios de Aceptacion

  • Listado de asesores con filtros
  • Perfil detallado de asesor
  • Integracion Cal.com para agendamiento
  • Integracion Daily.co para video
  • Sistema de notas post-sesion
  • Reviews y ratings
  • Politicas de cancelacion automaticas
  • Notificaciones y recordatorios

Dependencias

  • OQI-004-payments: Procesamiento de pagos
  • OQI-007-notifications: Recordatorios
  • Cal.com API: Agendamiento
  • Daily.co API: Video llamadas

Referencias