feat: add study rooms feature with BigBlueButton integration

- Create database migrations for study_rooms table in both cms-service and lms-service. - Implement study room handlers in lms-service for listing, creating, joining, ending, and deleting study rooms. - Develop frontend components for managing study rooms in both experience and studio applications. - Add UI for creating new study rooms, displaying active and ended rooms, and joining sessions. - Include instructions for configuring BigBlueButton server settings. Co-authored-by: Copilot <copilot@github.com>
2026-04-27 14:04:06 -04:00
parent 7a2afce796
commit f4cddf7345
12 changed files with 1002 additions and 5 deletions
@@ -0,0 +1,24 @@
+-- Salas de Estudio (Fase 38) -----------------------------------------------
+CREATE TABLE IF NOT EXISTS study_rooms (
+    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    organization_id UUID NOT NULL,
+    course_id       UUID NOT NULL REFERENCES courses(id) ON DELETE CASCADE,
+    created_by      UUID NOT NULL,
+    title           VARCHAR(255) NOT NULL,
+    description     TEXT,
+    status          VARCHAR(32) NOT NULL DEFAULT 'pending',
+    bbb_meeting_id  VARCHAR(255),
+    bbb_internal_id VARCHAR(255),
+    attendee_pw     VARCHAR(128),
+    moderator_pw    VARCHAR(128),
+    join_url        TEXT,
+    scheduled_at    TIMESTAMPTZ,
+    started_at      TIMESTAMPTZ,
+    ended_at        TIMESTAMPTZ,
+    max_participants INT DEFAULT 50,
+    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_study_rooms_course ON study_rooms(course_id);
+CREATE INDEX IF NOT EXISTS idx_study_rooms_org ON study_rooms(organization_id);
@@ -0,0 +1,26 @@
+-- Salas de Estudio (Fase 38) -----------------------------------------------
+CREATE TABLE IF NOT EXISTS study_rooms (
+    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    organization_id UUID NOT NULL,
+    course_id       UUID NOT NULL REFERENCES courses(id) ON DELETE CASCADE,
+    created_by      UUID NOT NULL,  -- user_id del instructor
+    title           VARCHAR(255) NOT NULL,
+    description     TEXT,
+    -- Estado: pending | active | ended
+    status          VARCHAR(32) NOT NULL DEFAULT 'pending',
+    -- BBB
+    bbb_meeting_id  VARCHAR(255),
+    bbb_internal_id VARCHAR(255),
+    attendee_pw     VARCHAR(128),
+    moderator_pw    VARCHAR(128),
+    join_url        TEXT,
+    scheduled_at    TIMESTAMPTZ,
+    started_at      TIMESTAMPTZ,
+    ended_at        TIMESTAMPTZ,
+    max_participants INT DEFAULT 50,
+    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_study_rooms_course ON study_rooms(course_id);
+CREATE INDEX IF NOT EXISTS idx_study_rooms_org ON study_rooms(organization_id);
@@ -0,0 +1,390 @@
+/// Salas de Estudio con BigBlueButton (Fase 38)
+use axum::{
+    Json,
+    extract::{Path, State},
+    http::StatusCode,
+};
+use chrono::{DateTime, Utc};
+use common::{auth::Claims, middleware::Org};
+use serde::{Deserialize, Serialize};
+use sha2::{Digest, Sha256};
+use sqlx::{PgPool, Row};
+use uuid::Uuid;
+
+// ─── Helpers BBB ─────────────────────────────────────────────────────────────
+
+fn bbb_base_url() -> String {
+    std::env::var("BBB_URL").unwrap_or_else(|_| "https://bbb.example.com/bigbluebutton/api".to_string())
+}
+
+fn bbb_secret() -> String {
+    std::env::var("BBB_SECRET").unwrap_or_else(|_| "changeme".to_string())
+}
+
+/// Calcula el checksum BBB: SHA256(action + params_string + secret)
+fn bbb_checksum(action: &str, params: &str) -> String {
+    let input = format!("{}{}{}", action, params, bbb_secret());
+    let mut hasher = Sha256::new();
+    hasher.update(input.as_bytes());
+    format!("{:x}", hasher.finalize())
+}
+
+/// Construye URL BBB con checksum incluido
+fn bbb_url(action: &str, params: &str) -> String {
+    let checksum = bbb_checksum(action, params);
+    let base = bbb_base_url();
+    if params.is_empty() {
+        format!("{}/{}?checksum={}", base, action, checksum)
+    } else {
+        format!("{}/{}?{}&checksum={}", base, action, params, checksum)
+    }
+}
+
+// ─── Modelos ─────────────────────────────────────────────────────────────────
+
+#[derive(Debug, Serialize)]
+pub struct StudyRoom {
+    pub id: Uuid,
+    pub organization_id: Uuid,
+    pub course_id: Uuid,
+    pub created_by: Uuid,
+    pub title: String,
+    pub description: Option<String>,
+    pub status: String,
+    pub bbb_meeting_id: Option<String>,
+    pub join_url: Option<String>,
+    pub scheduled_at: Option<DateTime<Utc>>,
+    pub started_at: Option<DateTime<Utc>>,
+    pub ended_at: Option<DateTime<Utc>>,
+    pub max_participants: i32,
+    pub created_at: DateTime<Utc>,
+    pub updated_at: DateTime<Utc>,
+}
+
+#[derive(Debug, Deserialize)]
+pub struct CreateStudyRoomPayload {
+    pub title: String,
+    pub description: Option<String>,
+    pub scheduled_at: Option<DateTime<Utc>>,
+    pub max_participants: Option<i32>,
+}
+
+#[derive(Debug, Serialize)]
+pub struct JoinStudyRoomResponse {
+    pub room_id: Uuid,
+    pub join_url: String,
+}
+
+#[derive(Debug, Serialize)]
+pub struct EndStudyRoomResponse {
+    pub room_id: Uuid,
+    pub ended_at: DateTime<Utc>,
+}
+
+// ─── Handlers ────────────────────────────────────────────────────────────────
+
+pub async fn list_course_study_rooms(
+    Org(org_ctx): Org,
+    State(pool): State<PgPool>,
+    Path(course_id): Path<Uuid>,
+) -> Result<Json<Vec<StudyRoom>>, (StatusCode, String)> {
+    let rows = sqlx::query(
+        r#"
+        SELECT id, organization_id, course_id, created_by, title, description, status,
+               bbb_meeting_id, join_url, scheduled_at, started_at, ended_at,
+               max_participants, created_at, updated_at
+        FROM study_rooms
+        WHERE course_id = $1 AND organization_id = $2
+        ORDER BY created_at DESC
+        "#,
+    )
+    .bind(course_id)
+    .bind(org_ctx.id)
+    .fetch_all(&pool)
+    .await
+    .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
+
+    let rooms = rows
+        .into_iter()
+        .map(|r| StudyRoom {
+            id: r.get("id"),
+            organization_id: r.get("organization_id"),
+            course_id: r.get("course_id"),
+            created_by: r.get("created_by"),
+            title: r.get("title"),
+            description: r.get("description"),
+            status: r.get("status"),
+            bbb_meeting_id: r.get("bbb_meeting_id"),
+            join_url: r.get("join_url"),
+            scheduled_at: r.get("scheduled_at"),
+            started_at: r.get("started_at"),
+            ended_at: r.get("ended_at"),
+            max_participants: r.get("max_participants"),
+            created_at: r.get("created_at"),
+            updated_at: r.get("updated_at"),
+        })
+        .collect();
+
+    Ok(Json(rooms))
+}
+
+pub async fn create_study_room(
+    Org(org_ctx): Org,
+    claims: Claims,
+    State(pool): State<PgPool>,
+    Path(course_id): Path<Uuid>,
+    Json(payload): Json<CreateStudyRoomPayload>,
+) -> Result<(StatusCode, Json<StudyRoom>), (StatusCode, String)> {
+    if payload.title.trim().is_empty() {
+        return Err((StatusCode::UNPROCESSABLE_ENTITY, "El título es requerido".to_string()));
+    }
+
+    let meeting_id = Uuid::new_v4().to_string();
+
+    // Generar contraseñas aleatorias de 12 chars
+    use rand::Rng;
+    let attendee_pw: String = rand::thread_rng()
+        .sample_iter(&rand::distributions::Alphanumeric)
+        .take(12)
+        .map(char::from)
+        .collect();
+    let moderator_pw: String = rand::thread_rng()
+        .sample_iter(&rand::distributions::Alphanumeric)
+        .take(12)
+        .map(char::from)
+        .collect();
+
+    // Llamar a BBB create
+    let course_name_enc = urlencoding::encode(&payload.title).to_string();
+    let params = format!(
+        "meetingID={}&name={}&attendeePW={}&moderatorPW={}&record=false&autoStartRecording=false&allowStartStopRecording=false",
+        urlencoding::encode(&meeting_id),
+        course_name_enc,
+        urlencoding::encode(&attendee_pw),
+        urlencoding::encode(&moderator_pw),
+    );
+    let create_url = bbb_url("create", &params);
+
+    let bbb_internal_id: Option<String> = match reqwest::Client::new()
+        .get(&create_url)
+        .send()
+        .await
+    {
+        Ok(resp) => {
+            let body = resp.text().await.unwrap_or_default();
+            // Extraer internalMeetingID del XML de respuesta
+            body.split("<internalMeetingID>")
+                .nth(1)
+                .and_then(|s| s.split("</internalMeetingID>").next())
+                .map(|s| s.to_string())
+        }
+        Err(e) => {
+            tracing::warn!("create_study_room: BBB create failed (continuing): {}", e);
+            None
+        }
+    };
+
+    let now = Utc::now();
+    let row = sqlx::query(
+        r#"
+        INSERT INTO study_rooms (
+            organization_id, course_id, created_by, title, description,
+            status, bbb_meeting_id, bbb_internal_id, attendee_pw, moderator_pw,
+            scheduled_at, max_participants, created_at, updated_at
+        )
+        VALUES ($1, $2, $3, $4, $5, 'pending', $6, $7, $8, $9, $10, $11, $12, $12)
+        RETURNING id, organization_id, course_id, created_by, title, description, status,
+                  bbb_meeting_id, join_url, scheduled_at, started_at, ended_at,
+                  max_participants, created_at, updated_at
+        "#,
+    )
+    .bind(org_ctx.id)
+    .bind(course_id)
+    .bind(claims.sub)
+    .bind(&payload.title)
+    .bind(&payload.description)
+    .bind(&meeting_id)
+    .bind(&bbb_internal_id)
+    .bind(&attendee_pw)
+    .bind(&moderator_pw)
+    .bind(payload.scheduled_at)
+    .bind(payload.max_participants.unwrap_or(50))
+    .bind(now)
+    .fetch_one(&pool)
+    .await
+    .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
+
+    Ok((
+        StatusCode::CREATED,
+        Json(StudyRoom {
+            id: row.get("id"),
+            organization_id: row.get("organization_id"),
+            course_id: row.get("course_id"),
+            created_by: row.get("created_by"),
+            title: row.get("title"),
+            description: row.get("description"),
+            status: row.get("status"),
+            bbb_meeting_id: row.get("bbb_meeting_id"),
+            join_url: row.get("join_url"),
+            scheduled_at: row.get("scheduled_at"),
+            started_at: row.get("started_at"),
+            ended_at: row.get("ended_at"),
+            max_participants: row.get("max_participants"),
+            created_at: row.get("created_at"),
+            updated_at: row.get("updated_at"),
+        }),
+    ))
+}
+
+pub async fn join_study_room(
+    Org(org_ctx): Org,
+    claims: Claims,
+    State(pool): State<PgPool>,
+    Path((course_id, room_id)): Path<(Uuid, Uuid)>,
+) -> Result<Json<JoinStudyRoomResponse>, (StatusCode, String)> {
+    #[derive(sqlx::FromRow)]
+    struct RoomRow {
+        bbb_meeting_id: Option<String>,
+        attendee_pw: Option<String>,
+        moderator_pw: Option<String>,
+        status: String,
+        created_by: Uuid,
+    }
+
+    let room = sqlx::query_as::<_, RoomRow>(
+        "SELECT bbb_meeting_id, attendee_pw, moderator_pw, status, created_by FROM study_rooms WHERE id = $1 AND course_id = $2 AND organization_id = $3",
+    )
+    .bind(room_id)
+    .bind(course_id)
+    .bind(org_ctx.id)
+    .fetch_optional(&pool)
+    .await
+    .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?
+    .ok_or((StatusCode::NOT_FOUND, "Sala no encontrada".to_string()))?;
+
+    if room.status == "ended" {
+        return Err((StatusCode::GONE, "La sala ya ha finalizado".to_string()));
+    }
+
+    let meeting_id = room.bbb_meeting_id.as_deref().unwrap_or("");
+
+    // El creador entra como moderador; el resto como asistente
+    let is_moderator = claims.sub == room.created_by;
+    let password = if is_moderator {
+        room.moderator_pw.as_deref().unwrap_or("")
+    } else {
+        room.attendee_pw.as_deref().unwrap_or("")
+    };
+
+    let display_name = format!("Usuario {}", &claims.sub.to_string()[..8]);
+    let params = format!(
+        "meetingID={}&fullName={}&password={}&redirect=true",
+        urlencoding::encode(meeting_id),
+        urlencoding::encode(&display_name),
+        urlencoding::encode(password),
+    );
+    let join_url = bbb_url("join", &params);
+
+    // Marcar sala como activa en el primer join si estaba pending
+    if room.status == "pending" {
+        let _ = sqlx::query(
+            "UPDATE study_rooms SET status = 'active', started_at = NOW(), updated_at = NOW() WHERE id = $1",
+        )
+        .bind(room_id)
+        .execute(&pool)
+        .await;
+    }
+
+    Ok(Json(JoinStudyRoomResponse {
+        room_id,
+        join_url,
+    }))
+}
+
+pub async fn end_study_room(
+    Org(org_ctx): Org,
+    claims: Claims,
+    State(pool): State<PgPool>,
+    Path((course_id, room_id)): Path<(Uuid, Uuid)>,
+) -> Result<Json<EndStudyRoomResponse>, (StatusCode, String)> {
+    #[derive(sqlx::FromRow)]
+    struct RoomRow {
+        bbb_meeting_id: Option<String>,
+        moderator_pw: Option<String>,
+        created_by: Uuid,
+    }
+
+    let room = sqlx::query_as::<_, RoomRow>(
+        "SELECT bbb_meeting_id, moderator_pw, created_by FROM study_rooms WHERE id = $1 AND course_id = $2 AND organization_id = $3",
+    )
+    .bind(room_id)
+    .bind(course_id)
+    .bind(org_ctx.id)
+    .fetch_optional(&pool)
+    .await
+    .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?
+    .ok_or((StatusCode::NOT_FOUND, "Sala no encontrada".to_string()))?;
+
+    // Solo el creador puede terminar la sala
+    if claims.sub != room.created_by {
+        return Err((StatusCode::FORBIDDEN, "Solo el creador puede terminar la sala".to_string()));
+    }
+
+    // Llamar a BBB end
+    if let Some(meeting_id) = &room.bbb_meeting_id {
+        let params = format!(
+            "meetingID={}&password={}",
+            urlencoding::encode(meeting_id),
+            urlencoding::encode(room.moderator_pw.as_deref().unwrap_or("")),
+        );
+        let end_url = bbb_url("end", &params);
+        if let Err(e) = reqwest::Client::new().get(&end_url).send().await {
+            tracing::warn!("end_study_room: BBB end call failed (continuing): {}", e);
+        }
+    }
+
+    let now = Utc::now();
+    sqlx::query(
+        "UPDATE study_rooms SET status = 'ended', ended_at = $1, updated_at = $1 WHERE id = $2",
+    )
+    .bind(now)
+    .bind(room_id)
+    .execute(&pool)
+    .await
+    .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
+
+    Ok(Json(EndStudyRoomResponse {
+        room_id,
+        ended_at: now,
+    }))
+}
+
+pub async fn delete_study_room(
+    Org(org_ctx): Org,
+    claims: Claims,
+    State(pool): State<PgPool>,
+    Path((course_id, room_id)): Path<(Uuid, Uuid)>,
+) -> Result<StatusCode, (StatusCode, String)> {
+    let created_by = sqlx::query_scalar::<_, Uuid>(
+        "SELECT created_by FROM study_rooms WHERE id = $1 AND course_id = $2 AND organization_id = $3",
+    )
+    .bind(room_id)
+    .bind(course_id)
+    .bind(org_ctx.id)
+    .fetch_optional(&pool)
+    .await
+    .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?
+    .ok_or((StatusCode::NOT_FOUND, "Sala no encontrada".to_string()))?;
+
+    if claims.sub != created_by {
+        return Err((StatusCode::FORBIDDEN, "Solo el creador puede eliminar la sala".to_string()));
+    }
+
+    sqlx::query("DELETE FROM study_rooms WHERE id = $1")
+        .bind(room_id)
+        .execute(&pool)
+        .await
+        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
+
+    Ok(StatusCode::NO_CONTENT)
+}
@@ -3,6 +3,7 @@ mod handlers;
 mod handlers_announcements;
 mod handlers_pedagogical;
 mod handlers_lti_consumer;
+mod handlers_study_rooms;
 mod handlers_email;
 mod handlers_scorm;
 mod handlers_search;
@@ -218,6 +219,24 @@ async fn main() {
            "/courses/{id}/lti-tools/{tool_id}/rotate-secret",
            post(handlers_lti_consumer::rotate_lti_tool_secret),
        )
+        // Salas de Estudio con BBB (Fase 38)
+        .route(
+            "/courses/{id}/study-rooms",
+            get(handlers_study_rooms::list_course_study_rooms)
+                .post(handlers_study_rooms::create_study_room),
+        )
+        .route(
+            "/courses/{id}/study-rooms/{room_id}/join",
+            post(handlers_study_rooms::join_study_room),
+        )
+        .route(
+            "/courses/{id}/study-rooms/{room_id}/end",
+            post(handlers_study_rooms::end_study_room),
+        )
+        .route(
+            "/courses/{id}/study-rooms/{room_id}",
+            delete(handlers_study_rooms::delete_study_room),
+        )
        // Portafolio e insignias (Badges)
        .route("/profile/{user_id}", get(portfolio::get_public_profile))
        .route("/my/badges", get(portfolio::get_my_badges))