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>
This commit is contained in:
2026-04-27 14:04:06 -04:00
parent 7a2afce796
commit f4cddf7345
12 changed files with 1002 additions and 5 deletions
@@ -433,6 +433,25 @@ export default function CourseOutlinePage({ params }: { params: { id: string } }
</div>
)}
{/* Salas de Estudio BBB */}
<div className="mb-8">
<Link
href={`/courses/${params.id}/study-rooms`}
className="flex items-center justify-between rounded-2xl border border-black/10 dark:border-white/10 bg-white dark:bg-zinc-900 px-5 py-4 hover:border-blue-400/50 dark:hover:border-blue-500/40 transition-colors group"
>
<div className="flex items-center gap-3">
<div className="w-9 h-9 rounded-xl bg-blue-500/10 flex items-center justify-center text-blue-600 dark:text-blue-400">
<Video size={16} />
</div>
<div>
<p className="text-sm font-semibold text-gray-900 dark:text-white">Salas de Estudio</p>
<p className="text-[11px] text-gray-500 dark:text-gray-400">Sesiones grupales con BigBlueButton</p>
</div>
</div>
<ExternalLink size={14} className="text-gray-400 group-hover:text-blue-500 transition-colors" />
</Link>
</div>
{/* Announcements Section */}
<div className="mb-16">
<AnnouncementsList courseId={params.id} isInstructor={user?.role === 'instructor' || user?.role === 'admin'} />
@@ -0,0 +1,180 @@
"use client";
import { useCallback, useEffect, useState } from "react";
import { useParams, useRouter } from "next/navigation";
import { lmsApi, StudyRoom } from "@/lib/api";
import { Video, Users, Clock, ExternalLink, ArrowLeft, RefreshCw } from "lucide-react";
const STATUS_LABEL: Record<string, string> = {
pending: "Programada",
active: "En curso",
ended: "Finalizada",
};
const STATUS_COLOR: Record<string, string> = {
pending: "bg-yellow-100 text-yellow-800 dark:bg-yellow-900/30 dark:text-yellow-300",
active: "bg-green-100 text-green-800 dark:bg-green-900/30 dark:text-green-300",
ended: "bg-gray-100 text-gray-500 dark:bg-white/10 dark:text-white/40",
};
export default function StudyRoomsPage() {
const { id } = useParams() as { id: string };
const router = useRouter();
const [rooms, setRooms] = useState<StudyRoom[]>([]);
const [loading, setLoading] = useState(true);
const [joiningId, setJoiningId] = useState<string | null>(null);
const [error, setError] = useState<string | null>(null);
const loadRooms = useCallback(async () => {
setLoading(true);
setError(null);
try {
const data = await lmsApi.listCourseStudyRooms(id);
setRooms(data);
} catch (e) {
setError(e instanceof Error ? e.message : "No se pudieron cargar las salas");
} finally {
setLoading(false);
}
}, [id]);
useEffect(() => {
void loadRooms();
}, [loadRooms]);
const join = async (room: StudyRoom) => {
setJoiningId(room.id);
setError(null);
try {
const result = await lmsApi.joinStudyRoom(id, room.id);
window.open(result.join_url, "_blank", "noopener,noreferrer");
void loadRooms();
} catch (e) {
setError(e instanceof Error ? e.message : "No se pudo unir a la sala");
} finally {
setJoiningId(null);
}
};
const activeRooms = rooms.filter((r) => r.status !== "ended");
const endedRooms = rooms.filter((r) => r.status === "ended");
return (
<main className="min-h-screen bg-gray-50 dark:bg-zinc-950 px-4 py-8 max-w-3xl mx-auto">
<div className="flex items-center gap-3 mb-6">
<button
onClick={() => router.back()}
className="p-2 rounded-lg hover:bg-black/5 dark:hover:bg-white/10"
>
<ArrowLeft className="w-4 h-4" />
</button>
<div>
<h1 className="text-lg font-black flex items-center gap-2">
<Video className="w-5 h-5" /> Salas de Estudio
</h1>
<p className="text-xs text-black/50 dark:text-white/50">Únete a sesiones en vivo con tu grupo</p>
</div>
<button
onClick={() => void loadRooms()}
className="ml-auto p-2 rounded-lg hover:bg-black/5 dark:hover:bg-white/10"
title="Recargar"
>
<RefreshCw className={`w-4 h-4 ${loading ? "animate-spin" : ""}`} />
</button>
</div>
{error && (
<div className="mb-4 rounded-xl bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-700 px-4 py-3 text-sm text-red-700 dark:text-red-300">
{error}
</div>
)}
{loading && rooms.length === 0 && (
<div className="flex justify-center py-12">
<div className="h-6 w-6 animate-spin rounded-full border-2 border-black/20 border-t-black dark:border-white/20 dark:border-t-white" />
</div>
)}
{!loading && rooms.length === 0 && (
<div className="text-center py-16 text-black/40 dark:text-white/40">
<Video className="w-10 h-10 mx-auto mb-3 opacity-40" />
<p className="text-sm">No hay salas de estudio activas para este curso.</p>
</div>
)}
{activeRooms.length > 0 && (
<section className="space-y-3 mb-6">
<h2 className="text-xs font-black uppercase tracking-wider text-black/40 dark:text-white/40">
Salas disponibles
</h2>
{activeRooms.map((room) => (
<div
key={room.id}
className="rounded-2xl border border-black/10 dark:border-white/10 bg-white dark:bg-zinc-900 p-5 flex flex-wrap items-center justify-between gap-4"
>
<div className="min-w-0 flex-1">
<div className="flex items-center gap-2 flex-wrap mb-1">
<span className="font-semibold text-sm">{room.title}</span>
<span className={`rounded-full px-2 py-0.5 text-[11px] font-semibold ${STATUS_COLOR[room.status]}`}>
{STATUS_LABEL[room.status]}
</span>
</div>
{room.description && (
<p className="text-xs text-black/50 dark:text-white/50 mb-2">{room.description}</p>
)}
<div className="flex items-center gap-3 text-[11px] text-black/40 dark:text-white/40">
<span className="flex items-center gap-1">
<Users className="w-3 h-3" /> Máx. {room.max_participants} participantes
</span>
{room.started_at && (
<span className="flex items-center gap-1">
<Clock className="w-3 h-3" />
{new Date(room.started_at).toLocaleString()}
</span>
)}
</div>
</div>
<button
onClick={() => void join(room)}
disabled={joiningId === room.id}
className="inline-flex items-center gap-2 px-4 py-2 rounded-xl bg-blue-600 text-white text-sm font-semibold hover:bg-blue-700 disabled:opacity-60 transition-colors"
>
{joiningId === room.id ? (
<div className="h-4 w-4 animate-spin rounded-full border-2 border-white/30 border-t-white" />
) : (
<ExternalLink className="w-4 h-4" />
)}
{joiningId === room.id ? "Conectando..." : "Unirse"}
</button>
</div>
))}
</section>
)}
{endedRooms.length > 0 && (
<section className="space-y-2">
<h2 className="text-xs font-black uppercase tracking-wider text-black/30 dark:text-white/30">
Salas finalizadas
</h2>
{endedRooms.map((room) => (
<div
key={room.id}
className="rounded-xl border border-black/5 dark:border-white/5 bg-white/50 dark:bg-white/5 px-4 py-3 flex items-center justify-between gap-3 opacity-60"
>
<div>
<span className="text-sm font-medium">{room.title}</span>
{room.ended_at && (
<span className="ml-2 text-[11px] text-black/40 dark:text-white/40">
Finalizada {new Date(room.ended_at).toLocaleDateString()}
</span>
)}
</div>
<span className={`rounded-full px-2 py-0.5 text-[11px] font-semibold ${STATUS_COLOR.ended}`}>
{STATUS_LABEL.ended}
</span>
</div>
))}
</section>
)}
</main>
);
}
+26
View File
@@ -1339,4 +1339,30 @@ export const lmsApi = {
getEnabledPlugins(): Promise<OrgPlugin[]> {
return apiFetch('/plugins/enabled', {}, true);
},
listCourseStudyRooms(courseId: string): Promise<StudyRoom[]> {
return apiFetch(`/courses/${courseId}/study-rooms`);
},
joinStudyRoom(courseId: string, roomId: string): Promise<{ room_id: string; join_url: string }> {
return apiFetch(`/courses/${courseId}/study-rooms/${roomId}/join`, { method: 'POST' });
},
};
export interface StudyRoom {
id: string;
organization_id: string;
course_id: string;
created_by: string;
title: string;
description?: string;
status: 'pending' | 'active' | 'ended';
bbb_meeting_id?: string;
join_url?: string;
scheduled_at?: string;
started_at?: string;
ended_at?: string;
max_participants: number;
created_at: string;
updated_at: string;
}
@@ -0,0 +1,270 @@
"use client";
import { useCallback, useEffect, useState } from "react";
import { useParams } from "next/navigation";
import CourseEditorLayout from "@/components/CourseEditorLayout";
import { lmsApi, StudyRoom, CreateStudyRoomPayload } from "@/lib/api";
import {
Video,
Plus,
RefreshCw,
Trash2,
Play,
Square,
Clock,
Users,
ExternalLink,
} from "lucide-react";
const STATUS_LABEL: Record<string, string> = {
pending: "Programada",
active: "En curso",
ended: "Finalizada",
};
const STATUS_COLOR: Record<string, string> = {
pending: "bg-yellow-100 text-yellow-800 dark:bg-yellow-900/30 dark:text-yellow-300",
active: "bg-green-100 text-green-800 dark:bg-green-900/30 dark:text-green-300",
ended: "bg-gray-100 text-gray-600 dark:bg-white/10 dark:text-white/50",
};
export default function CourseStudyRoomsPage() {
const { id } = useParams() as { id: string };
const [rooms, setRooms] = useState<StudyRoom[]>([]);
const [loading, setLoading] = useState(true);
const [saving, setSaving] = useState(false);
const [error, setError] = useState<string | null>(null);
const [form, setForm] = useState<CreateStudyRoomPayload>({
title: "",
description: "",
max_participants: 50,
});
const loadRooms = useCallback(async () => {
setLoading(true);
setError(null);
try {
const data = await lmsApi.listCourseStudyRooms(id);
setRooms(data);
} catch (e) {
setError(e instanceof Error ? e.message : "No se pudieron cargar las salas");
} finally {
setLoading(false);
}
}, [id]);
useEffect(() => {
void loadRooms();
}, [loadRooms]);
const createRoom = async () => {
if (!form.title.trim()) {
setError("El título es requerido.");
return;
}
setSaving(true);
setError(null);
try {
const created = await lmsApi.createStudyRoom(id, form);
setRooms((prev) => [created, ...prev]);
setForm({ title: "", description: "", max_participants: 50 });
} catch (e) {
setError(e instanceof Error ? e.message : "No se pudo crear la sala");
} finally {
setSaving(false);
}
};
const joinRoom = async (room: StudyRoom) => {
try {
const result = await lmsApi.joinStudyRoom(id, room.id);
window.open(result.join_url, "_blank", "noopener,noreferrer");
// Refrescar para mostrar estado activo
void loadRooms();
} catch (e) {
setError(e instanceof Error ? e.message : "No se pudo unir a la sala");
}
};
const endRoom = async (room: StudyRoom) => {
const ok = confirm(`¿Finalizar la sala "${room.title}"? Los participantes serán desconectados.`);
if (!ok) return;
try {
await lmsApi.endStudyRoom(id, room.id);
setRooms((prev) => prev.map((r) => r.id === room.id ? { ...r, status: "ended" as const } : r));
} catch (e) {
setError(e instanceof Error ? e.message : "No se pudo finalizar la sala");
}
};
const deleteRoom = async (room: StudyRoom) => {
const ok = confirm(`¿Eliminar la sala "${room.title}"?`);
if (!ok) return;
try {
await lmsApi.deleteStudyRoom(id, room.id);
setRooms((prev) => prev.filter((r) => r.id !== room.id));
} catch (e) {
setError(e instanceof Error ? e.message : "No se pudo eliminar la sala");
}
};
return (
<CourseEditorLayout
activeTab="study-rooms"
pageTitle="Salas de Estudio"
pageDescription="Crea y gestiona salas de video grupales con BigBlueButton."
>
<div className="space-y-6">
{/* Formulario nueva sala */}
<section className="rounded-2xl border border-black/10 dark:border-white/10 bg-white/60 dark:bg-white/5 p-5">
<h2 className="text-sm font-semibold flex items-center gap-2 mb-4">
<Plus className="w-4 h-4" />
Nueva Sala de Estudio
</h2>
<div className="grid grid-cols-1 md:grid-cols-3 gap-3">
<input
className="rounded-lg border border-black/10 dark:border-white/10 bg-transparent px-3 py-2 text-sm"
placeholder="Título (ej: Resolución de dudas cap. 3)"
value={form.title}
onChange={(e) => setForm((f) => ({ ...f, title: e.target.value }))}
/>
<input
className="rounded-lg border border-black/10 dark:border-white/10 bg-transparent px-3 py-2 text-sm"
placeholder="Descripción (opcional)"
value={form.description ?? ""}
onChange={(e) => setForm((f) => ({ ...f, description: e.target.value }))}
/>
<input
type="number"
min={2}
max={200}
className="rounded-lg border border-black/10 dark:border-white/10 bg-transparent px-3 py-2 text-sm"
placeholder="Máx. participantes"
value={form.max_participants ?? 50}
onChange={(e) => setForm((f) => ({ ...f, max_participants: parseInt(e.target.value) || 50 }))}
/>
</div>
{error && (
<p className="mt-2 text-xs text-red-600 dark:text-red-400">{error}</p>
)}
<div className="mt-3">
<button
onClick={() => void createRoom()}
disabled={saving}
className="px-4 py-2 rounded-lg bg-black text-white dark:bg-white dark:text-black text-sm font-semibold disabled:opacity-50"
>
{saving ? "Creando..." : "Crear sala"}
</button>
</div>
</section>
{/* Lista de salas */}
<section className="rounded-2xl border border-black/10 dark:border-white/10 bg-white/60 dark:bg-white/5 p-5">
<div className="flex items-center justify-between mb-4">
<h2 className="text-sm font-semibold flex items-center gap-2">
<Video className="w-4 h-4" />
Salas ({rooms.length})
</h2>
<button
onClick={() => void loadRooms()}
className="p-2 rounded-lg hover:bg-black/5 dark:hover:bg-white/10"
title="Recargar"
>
<RefreshCw className={`w-4 h-4 ${loading ? "animate-spin" : ""}`} />
</button>
</div>
<div className="space-y-3">
{rooms.map((room) => (
<div
key={room.id}
className="rounded-xl border border-black/10 dark:border-white/10 px-4 py-3 flex flex-wrap items-center justify-between gap-3"
>
<div className="min-w-0 flex-1">
<div className="flex items-center gap-2 flex-wrap">
<span className="text-sm font-semibold truncate">{room.title}</span>
<span className={`rounded-full px-2 py-0.5 text-[11px] font-semibold ${STATUS_COLOR[room.status]}`}>
{STATUS_LABEL[room.status]}
</span>
</div>
{room.description && (
<p className="text-xs text-black/50 dark:text-white/50 mt-0.5 truncate">{room.description}</p>
)}
<div className="mt-1 flex items-center gap-3 text-[11px] text-black/40 dark:text-white/40">
<span className="flex items-center gap-1">
<Users className="w-3 h-3" /> Máx. {room.max_participants}
</span>
{room.started_at && (
<span className="flex items-center gap-1">
<Clock className="w-3 h-3" />
Inicio: {new Date(room.started_at).toLocaleString()}
</span>
)}
<span className="font-mono opacity-60">ID: {room.id.slice(0, 8)}</span>
</div>
</div>
<div className="flex items-center gap-2">
{room.status !== "ended" && (
<button
onClick={() => void joinRoom(room)}
className="inline-flex items-center gap-1 px-3 py-1.5 rounded-lg bg-blue-600 text-white text-xs font-semibold hover:bg-blue-700"
>
<ExternalLink className="w-3 h-3" /> Unirse (BBB)
</button>
)}
{room.status === "active" && (
<button
onClick={() => void endRoom(room)}
className="inline-flex items-center gap-1 px-3 py-1.5 rounded-lg border border-orange-300 bg-orange-50 dark:bg-orange-900/20 text-orange-700 dark:text-orange-300 text-xs font-semibold hover:bg-orange-100"
>
<Square className="w-3 h-3" /> Finalizar
</button>
)}
{room.status === "pending" && (
<button
onClick={() => void joinRoom(room)}
className="inline-flex items-center gap-1 px-3 py-1.5 rounded-lg border border-green-300 bg-green-50 dark:bg-green-900/20 text-green-700 dark:text-green-300 text-xs font-semibold hover:bg-green-100"
>
<Play className="w-3 h-3" /> Iniciar
</button>
)}
{room.status === "ended" && (
<button
onClick={() => void deleteRoom(room)}
className="p-2 rounded-lg hover:bg-red-50 dark:hover:bg-red-900/20"
title="Eliminar"
>
<Trash2 className="w-4 h-4 text-red-600" />
</button>
)}
</div>
</div>
))}
{!loading && rooms.length === 0 && (
<p className="text-sm text-black/50 dark:text-white/50">No hay salas creadas para este curso.</p>
)}
</div>
</section>
{/* Instrucciones de configuración BBB */}
<section className="rounded-2xl border border-blue-200 dark:border-blue-700 bg-blue-50 dark:bg-blue-900/20 p-5">
<h3 className="text-xs font-black text-blue-800 dark:text-blue-300 mb-2">Configuración de BigBlueButton</h3>
<p className="text-xs text-blue-700 dark:text-blue-400 mb-3">
Para conectar con tu servidor BBB, define las siguientes variables de entorno en el backend:
</p>
<div className="space-y-1">
<code className="block text-xs font-mono bg-white dark:bg-black/30 rounded px-3 py-1.5 border border-blue-200 dark:border-blue-700">
BBB_URL=https://tu-servidor-bbb.com/bigbluebutton/api
</code>
<code className="block text-xs font-mono bg-white dark:bg-black/30 rounded px-3 py-1.5 border border-blue-200 dark:border-blue-700">
BBB_SECRET=tu_shared_secret_bbb
</code>
</div>
<p className="text-[11px] text-blue-600 dark:text-blue-400 mt-2">
Puedes obtener estos valores desde la consola de tu servidor BBB con: <code className="font-mono">bbb-conf --secret</code>
</p>
</section>
</div>
</CourseEditorLayout>
);
}
@@ -26,7 +26,8 @@ type TabKey =
| "students"
| "sessions"
| "pedagogical"
| "lti-tools";
| "lti-tools"
| "study-rooms";
interface CourseEditorLayoutProps {
children: React.ReactNode;
@@ -79,6 +80,7 @@ export default function CourseEditorLayout({
{ key: "marketing", label: "Marketing", icon: Megaphone, href: `/courses/${id}/marketing` },
{ key: "files", label: "Archivos", icon: Folder, href: `/courses/${id}/files` },
{ key: "sessions", label: "Sesiones en Vivo", icon: Video, href: `/courses/${id}/sessions` },
{ key: "study-rooms", label: "Salas de Estudio", icon: Video, href: `/courses/${id}/study-rooms` },
],
},
{
+35
View File
@@ -1843,8 +1843,43 @@ export const lmsApi = {
apiFetch(`/courses/${courseId}/lti-tools/${toolId}`, { method: 'DELETE' }, true),
rotateCourseLtiToolSecret: (courseId: string, toolId: string): Promise<{ tool_id: string; new_secret: string; rotated_at: string }> =>
apiFetch(`/courses/${courseId}/lti-tools/${toolId}/rotate-secret`, { method: 'POST' }, true),
listCourseStudyRooms: (courseId: string): Promise<StudyRoom[]> =>
apiFetch(`/courses/${courseId}/study-rooms`, {}, true),
createStudyRoom: (courseId: string, payload: CreateStudyRoomPayload): Promise<StudyRoom> =>
apiFetch(`/courses/${courseId}/study-rooms`, { method: 'POST', body: JSON.stringify(payload) }, true),
joinStudyRoom: (courseId: string, roomId: string): Promise<{ room_id: string; join_url: string }> =>
apiFetch(`/courses/${courseId}/study-rooms/${roomId}/join`, { method: 'POST' }, true),
endStudyRoom: (courseId: string, roomId: string): Promise<{ room_id: string; ended_at: string }> =>
apiFetch(`/courses/${courseId}/study-rooms/${roomId}/end`, { method: 'POST' }, true),
deleteStudyRoom: (courseId: string, roomId: string): Promise<void> =>
apiFetch(`/courses/${courseId}/study-rooms/${roomId}`, { method: 'DELETE' }, true),
};
export interface StudyRoom {
id: string;
organization_id: string;
course_id: string;
created_by: string;
title: string;
description?: string;
status: 'pending' | 'active' | 'ended';
bbb_meeting_id?: string;
join_url?: string;
scheduled_at?: string;
started_at?: string;
ended_at?: string;
max_participants: number;
created_at: string;
updated_at: string;
}
export interface CreateStudyRoomPayload {
title: string;
description?: string;
scheduled_at?: string;
max_participants?: number;
}
export interface Meeting {
id: string;
course_id: string;
File diff suppressed because one or more lines are too long