---
id: US-MKT-003
title: Agendar Sesion de Asesoria
type: user-story
status: Draft
priority: High
epic: OQI-009
project: trading-platform
version: 1.0.0
dates:
  created: 2026-01-04
  updated: 2026-01-04
tags:
  - marketplace
  - advisory
  - booking
  - user-story
story_points: 13
sprint: TBD
assignee: TBD
---

# US-MKT-003: Agendar Sesion de Asesoria

## Historia de Usuario

**Como** usuario que busca mejorar sus habilidades de trading
**Quiero** agendar sesiones 1:1 con asesores financieros certificados
**Para** recibir orientacion personalizada y resolver mis dudas especificas

## Descripcion

El usuario puede explorar asesores disponibles, seleccionar uno basado en especialidad y reviews, elegir duracion de sesion, agendar en un horario conveniente, y participar en una video llamada. Post-sesion recibe notas y seguimiento.

## Criterios de Aceptacion

### AC-001: Explorar Asesores
```gherkin
Given soy usuario autenticado
When accedo a la seccion de Asesoria
Then veo lista de asesores disponibles con:
  | campo         | ejemplo                    |
  | foto          | Avatar del asesor          |
  | nombre        | Maria Garcia, CFA          |
  | especialidad  | Crypto Trading, DeFi       |
  | experiencia   | 10 anos                    |
  | rating        | 4.9/5 (85 reviews)         |
  | precio_desde  | desde $49                  |
And puedo filtrar por especialidad
And puedo ordenar por rating o precio
```

### AC-002: Ver Perfil de Asesor
```gherkin
Given veo un asesor en la lista
When hago click en su perfil
Then veo:
  | seccion       | contenido                       |
  | Bio completa  | Experiencia y certificaciones   |
  | Especialidades| Lista detallada                 |
  | Idiomas       | Espanol, Ingles                 |
  | Reviews       | Comentarios de clientes         |
  | Disponibilidad| Proximos slots disponibles      |
And veo opciones de duracion de sesion
```

### AC-003: Seleccionar Duracion
```gherkin
Given estoy en el perfil de un asesor
When veo las opciones de sesion
Then veo:
  | duracion | precio | incluye                        |
  | 30 min   | $49    | Video + Notas                  |
  | 60 min   | $89    | Video + Notas + Plan accion    |
  | 90 min   | $119   | Video + Notas + Plan + Seguim. |
And puedo seleccionar la duracion deseada
```

### AC-004: Agendar con Calendario
```gherkin
Given he seleccionado sesion de 60 minutos
When veo el calendario de disponibilidad
Then veo slots disponibles del asesor
And los slots respetan mi zona horaria
And puedo navegar entre dias/semanas
When selecciono un slot (ej: Lunes 10:00 AM)
Then veo confirmacion del horario seleccionado
```

### AC-005: Confirmar y Pagar
```gherkin
Given he seleccionado fecha y hora
When procedo al checkout
Then veo resumen:
  | campo         | valor                    |
  | Asesor        | Maria Garcia, CFA        |
  | Duracion      | 60 minutos               |
  | Fecha         | Lunes 6 Enero, 10:00 AM  |
  | Precio        | $89.00 USD               |
And confirmo el pago
And la sesion se agenda
And recibo confirmacion por email
```

### AC-006: Recibir Recordatorios
```gherkin
Given tengo una sesion agendada
Then recibo recordatorios:
  | cuando          | canal      |
  | 24h antes       | email      |
  | 1h antes        | push + email|
  | 15min antes     | push       |
And cada recordatorio incluye link para unirse
```

### AC-007: Unirse a Video Llamada
```gherkin
Given mi sesion esta por comenzar
When hago click en "Unirse a sesion"
Then se abre la sala de video (Daily.co)
And veo mis controles de audio/video
And veo al asesor cuando se conecte
And tengo opciones de:
  | funcion            |
  | Silenciar micro    |
  | Apagar camara      |
  | Compartir pantalla |
  | Chat de texto      |
```

### AC-008: Recibir Notas Post-Sesion
```gherkin
Given mi sesion ha terminado
When el asesor publica las notas (hasta 48h)
Then recibo notificacion
And puedo ver:
  | seccion          | contenido               |
  | Resumen          | Puntos clave discutidos |
  | Recomendaciones  | Acciones sugeridas      |
  | Recursos         | Links y materiales      |
  | Proximos pasos   | Plan de seguimiento     |
And puedo descargar como PDF
```

### AC-009: Dejar Review
```gherkin
Given mi sesion fue completada
When accedo a "Dejar review"
Then puedo:
  | campo         | input                    |
  | Rating        | 1-5 estrellas            |
  | Comentario    | Texto libre              |
  | Publico       | Si/No                    |
And envio mi review
And aparece en el perfil del asesor
```

### AC-010: Reagendar Sesion
```gherkin
Given tengo una sesion agendada
And faltan mas de 24 horas
When selecciono "Reagendar"
Then veo el calendario con nuevos slots
And selecciono nueva fecha/hora
And se actualiza la reserva
And recibo confirmacion
And el asesor es notificado
```

### AC-011: Cancelar Sesion
```gherkin
Given tengo una sesion agendada
And faltan mas de 24 horas
When selecciono "Cancelar"
Then veo politica de cancelacion:
  | tiempo          | reembolso |
  | > 24h           | 100%      |
  | 12-24h          | 50%       |
  | < 12h           | 0%        |
And confirmo cancelacion
And recibo reembolso segun politica
And el slot se libera
```

## Mockups

### Lista de Asesores
```
+----------------------------------------------------------+
|  ASESORIA PERSONALIZADA                                   |
|  Conecta con expertos certificados en trading            |
+----------------------------------------------------------+
|  Filtrar: [Todas] [Crypto] [Forex] [Stocks] [DeFi]       |
|  Ordenar: [Rating v]                                      |
+----------------------------------------------------------+
|                                                           |
|  +------------------------------------------------------+ |
|  | [FOTO]  Maria Garcia, CFA                            | |
|  |         Crypto Trading & DeFi Expert                 | |
|  |         ***** 4.9 (85 reviews) | 10 anos exp.        | |
|  |         Desde $49 | Proxima disp: Manana 9:00       | |
|  |                                    [VER PERFIL]      | |
|  +------------------------------------------------------+ |
|                                                           |
|  +------------------------------------------------------+ |
|  | [FOTO]  Carlos Mendez, MBA                           | |
|  |         Technical Analysis & Risk Management         | |
|  |         **** 4.7 (62 reviews) | 8 anos exp.          | |
|  |         Desde $49 | Proxima disp: Hoy 15:00         | |
|  |                                    [VER PERFIL]      | |
|  +------------------------------------------------------+ |
|                                                           |
+----------------------------------------------------------+
```

### Perfil del Asesor
```
+----------------------------------------------------------+
|  < Volver                                                 |
+----------------------------------------------------------+
|  [FOTO GRANDE]                                            |
|                                                           |
|  MARIA GARCIA, CFA                                        |
|  Crypto Trading & DeFi Expert                             |
|  ***** 4.9 (85 reviews) | 10 anos experiencia            |
|                                                           |
|  SOBRE MI                                                 |
|  Analista certificada CFA con 10 anos de experiencia...  |
|                                                           |
|  ESPECIALIDADES                                           |
|  [Crypto] [DeFi] [Technical Analysis] [Risk Management]  |
|                                                           |
|  OPCIONES DE SESION                                       |
|  +----------------+  +----------------+  +----------------+
|  |    30 MIN     |  |    60 MIN     |  |    90 MIN     |
|  |     $49       |  |     $89       |  |    $119       |
|  | Video + Notas |  | + Plan accion |  | + Seguimiento |
|  |  [AGENDAR]    |  |  [AGENDAR]    |  |  [AGENDAR]    |
|  +----------------+  +----------------+  +----------------+
|                                                           |
|  REVIEWS RECIENTES                                        |
|  ***** "Excelente sesion, muy profesional" - Juan        |
|  ***** "Me ayudo mucho a entender DeFi" - Ana            |
|                                                           |
+----------------------------------------------------------+
```

### Calendario de Agendamiento
```
+----------------------------------------------------------+
|  AGENDAR SESION - 60 MIN CON MARIA GARCIA                |
+----------------------------------------------------------+
|                                                           |
|  Zona horaria: America/Mexico_City (GMT-6) [Cambiar]     |
|                                                           |
|  < Enero 2026 >                                           |
|  Lu   Ma   Mi   Ju   Vi   Sa   Do                        |
|  --   --   --   --   --   --   --                        |
|            1    2    3    4    5                         |
|  [6]  [7]  [8]  [9]  10   11   12                        |
|  13   14   15   16   17   18   19                        |
|                                                           |
|  Horarios disponibles para Lunes 6:                      |
|  [09:00] [10:00] [11:00] [14:00] [15:00] [16:00]        |
|                                                           |
|  Seleccionado: Lunes 6 Enero, 10:00 AM                   |
|                                                           |
|       [  CONFIRMAR Y PAGAR - $89  ]                      |
|                                                           |
+----------------------------------------------------------+
```

## Flujo de Usuario

```mermaid
flowchart TD
    A[Usuario en Marketplace] --> B[Ver Asesores]
    B --> C[Seleccionar Asesor]
    C --> D[Ver Perfil]
    D --> E[Elegir Duracion]
    E --> F[Ver Calendario]
    F --> G[Seleccionar Slot]
    G --> H[Confirmar y Pagar]
    H --> I{Pago OK?}
    I -->|No| H
    I -->|Si| J[Sesion Agendada]
    J --> K[Recordatorios]
    K --> L[Unirse a Video]
    L --> M[Sesion]
    M --> N[Notas Post-Sesion]
    N --> O[Review]
```

## Notas Tecnicas

### Integracion Cal.com
```typescript
// Crear reserva en Cal.com
interface CalBookingRequest {
  eventTypeId: number;
  start: string; // ISO 8601
  end: string;
  name: string;
  email: string;
  timeZone: string;
  metadata: {
    userId: string;
    sessionId: string;
  };
}

// Webhook de Cal.com
interface CalWebhookPayload {
  triggerEvent: 'BOOKING_CREATED' | 'BOOKING_CANCELLED' | 'BOOKING_RESCHEDULED';
  payload: {
    bookingId: string;
    startTime: string;
    endTime: string;
    attendees: Attendee[];
  };
}
```

### Integracion Daily.co
```typescript
// Crear sala de video
interface DailyRoomRequest {
  name: string;
  privacy: 'public' | 'private';
  properties: {
    start_video_off: boolean;
    start_audio_off: boolean;
    enable_recording: 'cloud' | 'local' | false;
    exp: number; // Unix timestamp expiracion
  };
}
```

### API Endpoints
- `GET /api/advisors` - Listar asesores
- `GET /api/advisors/:id` - Perfil de asesor
- `GET /api/advisors/:id/availability` - Disponibilidad
- `POST /api/advisory-sessions` - Crear sesion
- `PATCH /api/advisory-sessions/:id` - Reagendar
- `DELETE /api/advisory-sessions/:id` - Cancelar
- `POST /api/advisory-sessions/:id/notes` - Agregar notas
- `POST /api/advisory-sessions/:id/reviews` - Agregar review

## Definicion de Done

- [ ] Lista de asesores con filtros y ordenamiento
- [ ] Perfil de asesor completo
- [ ] Integracion Cal.com funcional
- [ ] Integracion Daily.co funcional
- [ ] Flujo de pago integrado
- [ ] Sistema de recordatorios
- [ ] Notas post-sesion
- [ ] Sistema de reviews
- [ ] Politicas de cancelacion automaticas
- [ ] Tests E2E del flujo completo

## Dependencias

- **RF-MKT-003**: Requerimiento de asesoria
- **OQI-004-payments**: Procesamiento de pagos
- **Cal.com API**: Agendamiento
- **Daily.co API**: Video llamadas

## Referencias

- [RF-MKT-003: Asesoria](../requerimientos/RF-MKT-003-asesoria.md)
- [ET-MKT-001: Database](../especificaciones/ET-MKT-001-database.md)
- [ET-MKT-002: API](../especificaciones/ET-MKT-002-api.md)
