diff --git a/src/backend/src/common/pglite/init.ts b/src/backend/src/common/pglite/init.ts index 41d6936..0db46ab 100644 --- a/src/backend/src/common/pglite/init.ts +++ b/src/backend/src/common/pglite/init.ts @@ -55,16 +55,30 @@ export async function initPglite(): Promise { CREATE INDEX IF NOT EXISTS idx_lms_course_code ON lms_course(code); CREATE TABLE IF NOT EXISTS lms_enrollment ( - id TEXT PRIMARY KEY, - student_id TEXT NOT NULL, - course_id TEXT NOT NULL, - enrolled_at TIMESTAMP NOT NULL DEFAULT NOW(), - status TEXT NOT NULL DEFAULT 'active', + id TEXT PRIMARY KEY, + student_id TEXT NOT NULL, + course_id TEXT NOT NULL, + enrolled_at TIMESTAMP NOT NULL DEFAULT NOW(), + status TEXT NOT NULL DEFAULT 'active', + progress_scene_ids JSONB NOT NULL DEFAULT '[]'::jsonb, UNIQUE(student_id, course_id) ); CREATE INDEX IF NOT EXISTS idx_lms_enroll_student ON lms_enrollment(student_id); CREATE INDEX IF NOT EXISTS idx_lms_enroll_course ON lms_enrollment(course_id); + -- chg_0012 LMS v2: per-course ordered scenes (4 types: slide/quiz/simulation/pbl) + CREATE TABLE IF NOT EXISTS lms_course_scene ( + id TEXT PRIMARY KEY, + course_id TEXT NOT NULL, + scene_type TEXT NOT NULL, + payload_json TEXT NOT NULL, + order_index INTEGER NOT NULL, + created_at TIMESTAMP NOT NULL DEFAULT NOW(), + UNIQUE(course_id, order_index), + CHECK(scene_type IN ('slide','quiz','simulation','pbl')) + ); + CREATE INDEX IF NOT EXISTS idx_lms_scene_course ON lms_course_scene(course_id); + -- chg_0007 lite-demo schema: book_shop_book / book_shop_product -- JNPF f_ 前缀 + f_id varchar(50) + f_delete_mark 软删 CREATE TABLE IF NOT EXISTS book_shop_book ( diff --git a/src/backend/src/lms/lms-v2.controller.ts b/src/backend/src/lms/lms-v2.controller.ts new file mode 100644 index 0000000..e7c3940 --- /dev/null +++ b/src/backend/src/lms/lms-v2.controller.ts @@ -0,0 +1,92 @@ +import { + Body, + Controller, + Get, + Param, + Post, + Req, + UseGuards, +} from '@nestjs/common'; +import { JwtAuthGuard, RequireAdmin } from '../auth/jwt.guard'; +import { + CreateCourseWithScenesDto, + LmsV2Service, + SceneType, +} from './lms-v2.service'; + +/** + * LMS v2 controller — multi-scene course endpoints. + * Path prefix: /api/ssw/dth/lms-v2 + * + * 401/600 from JwtAuthGuard; admin-only endpoints tagged via @RequireAdmin(). + */ +@Controller('api/ssw/dth/lms-v2') +@UseGuards(JwtAuthGuard) +export class LmsV2Controller { + constructor(private readonly v2: LmsV2Service) {} + + /** Admin creates a course with optional embedded scenes. */ + @Post('courses') + @RequireAdmin() + async createCourseWithScenes(@Body() dto: CreateCourseWithScenesDto) { + const result = await this.v2.createCourseWithScenes(dto); + return { code: 200, msg: 'ok', data: result }; + } + + /** Admin creates a course pre-populated with FRC's 6 simulation scenes. */ + @Post('courses/from-frc-template') + @RequireAdmin() + async createFromFrcTemplate( + @Body() dto: { course_code: string; teacher: string }, + ) { + const result = await this.v2.createFromFrcTemplate(dto); + return { code: 200, msg: 'ok', data: result }; + } + + /** List scenes for a course (any authenticated user). */ + @Get('courses/:courseId/scenes') + async listScenes(@Param('courseId') courseId: string) { + const scenes = await this.v2.listScenesByCourse(courseId); + return { code: 200, msg: 'ok', data: scenes }; + } + + /** Render a scene (returns payload depending on scene_type). */ + @Get('courses/:courseId/scenes/:sceneId/render') + async renderScene( + @Param('courseId') courseId: string, + @Param('sceneId') sceneId: string, + ) { + const data = await this.v2.renderScene(courseId, sceneId); + return { code: 200, msg: 'ok', data }; + } + + /** Grade a quiz submission. */ + @Post('scenes/:sceneId/grade') + async gradeScene( + @Param('sceneId') sceneId: string, + @Body() dto: { answers: Record }, + ) { + const answers = dto?.answers ?? {}; + const result = await this.v2.gradeQuiz(sceneId, answers); + return { code: 200, msg: 'ok', data: result }; + } + + /** Mark scene complete (idempotent append-only). */ + @Post('scenes/:sceneId/complete') + async completeScene( + @Param('sceneId') sceneId: string, + @Body() dto: { student_id: string; course_id: string }, + ) { + const studentId = dto?.student_id; + const courseId = dto?.course_id; + if (!studentId || !courseId) { + throw new (await import('@nestjs/common')).BadRequestException( + 'student_id / course_id are required', + ); + } + const result = await this.v2.completeScene(studentId, courseId, sceneId); + return { code: 200, msg: 'ok', data: result }; + } +} + +export { SceneType }; \ No newline at end of file diff --git a/src/backend/src/lms/lms-v2.service.ts b/src/backend/src/lms/lms-v2.service.ts new file mode 100644 index 0000000..4a75349 --- /dev/null +++ b/src/backend/src/lms/lms-v2.service.ts @@ -0,0 +1,486 @@ +import { + BadRequestException, + ConflictException, + Injectable, + NotFoundException, + NotImplementedException, + UnprocessableEntityException, +} from '@nestjs/common'; +import { v4 as uuidv4 } from 'uuid'; +import { getDb } from '../common/pglite/init'; +import { CoursesService } from './courses.courses.service'; + +/** + * LMS v2 service — multi-scene courses with 4 scene types + * (slide/quiz/simulation/pbl) + FRC 6-scene template. + * + * chg_0012: extends chg_0006 v1 (lms_course / lms_enrollment) with + * `lms_course_scene` table + `progress_scene_ids JSONB` column on + * lms_enrollment. + * + * Scene lifecycle: + * POST /courses (admin) → creates course + scenes + * GET /courses/:courseId/scenes (any) → list scenes ordered + * GET /courses/:courseId/scenes/:sceneId/render (any) → scene-specific payload + * POST /scenes/:sceneId/grade (any) → quiz only: returns score 0..1 + * POST /scenes/:sceneId/complete (any) → append sceneId to progress (idempotent) + * POST /courses/from-frc-template (admin) → 6 simulation scenes (FRC S1-S6) + */ + +export type SceneType = 'slide' | 'quiz' | 'simulation' | 'pbl'; + +export interface SceneRow { + id: string; + course_id: string; + scene_type: SceneType; + payload_json: string; + order_index: number; + created_at: string; +} + +export interface CreateCourseWithScenesDto { + code: string; + name: string; + credits?: number; + instructor?: string; + scenes?: Array<{ + scene_type: SceneType; + payload: Record; + order_index: number; + }>; +} + +export interface QuizQuestion { + id: string; + type: 'choice' | 'short'; + prompt: string; + options?: string[]; + answer?: string; // for choice: the correct option text + keywords?: string[]; // for short: keywords (each = 1 / keywords.length) +} + +const FRC_TEMPLATE_SCENES: Array<{ + title: string; + embed_url: string; + description: string; +}> = [ + { + title: 'DID + TDS 联合身份验证', + embed_url: 'http://127.0.0.1:30000/exp/admin/iframe/frc-s1-sim-did-tds-match', + description: '3 银行 DID 建立 + TDS 合约 hash 匹配', + }, + { + title: 'PSI 求三方交集', + embed_url: 'http://127.0.0.1:30000/exp/admin/iframe/frc-s2-sim-psi-intersection', + description: '3 行黑名单 PSI 私有不泄露非交集', + }, + { + title: 'Paillier 同态求和', + embed_url: 'http://127.0.0.1:30000/exp/admin/iframe/frc-s3-sim-paillier-sum', + description: '3 行风险特征同态加密求和', + }, + { + title: 'Threshold 2-of-3 签名', + embed_url: 'http://127.0.0.1:30000/exp/admin/iframe/frc-s4-sim-threshold-sig', + description: 'Shamir 2-of-3 阈值签名重构', + }, + { + title: 'ABAC 联合风控策略', + embed_url: 'http://127.0.0.1:30000/exp/admin/iframe/frc-s5-sim-abac-policy', + description: '角色 + 区域 + 时段 ABAC 鉴权', + }, + { + title: '审计链 HMAC 验证', + embed_url: 'http://127.0.0.1:30000/exp/admin/iframe/frc-s6-sim-audit-chain', + description: '6 步流程 HMAC 链完整', + }, +]; + +@Injectable() +export class LmsV2Service { + constructor(private readonly courses: CoursesService) {} + + // ----------------------------------------------------------------- + // Create course with scenes (admin only — guarded in controller) + // ----------------------------------------------------------------- + async createCourseWithScenes( + dto: CreateCourseWithScenesDto, + ): Promise<{ course: any; scenes: SceneRow[] }> { + if (!dto?.code || !dto?.name) { + throw new BadRequestException('code / name are required'); + } + // 1) Create course via v1 CoursesService (handles UNIQUE check + 409) + let course; + try { + course = await this.courses.create({ + code: dto.code, + name: dto.name, + credits: dto.credits, + instructor: dto.instructor, + }); + } catch (e: any) { + // CoursesService throws BadRequestException on duplicate; convert to 409 + const msg = e?.message ?? ''; + if (msg.includes('already exists')) { + throw new ConflictException('DUPLICATE_COURSE_CODE'); + } + throw e; + } + + // 2) Insert scenes (if any) + const scenes: SceneRow[] = []; + if (dto.scenes && dto.scenes.length > 0) { + for (const s of dto.scenes) { + const validated = this.validateScenePayload(s.scene_type, s.payload); + const id = uuidv4(); + const db = getDb(); + await db.query( + `INSERT INTO lms_course_scene (id, course_id, scene_type, payload_json, order_index) + VALUES ($1, $2, $3, $4, $5)`, + [id, course.id, s.scene_type, JSON.stringify(validated), s.order_index], + ); + const created = await this.getScene(id); + if (created) scenes.push(created); + } + } + return { course, scenes }; + } + + // ----------------------------------------------------------------- + // FRC 6-scene template + // ----------------------------------------------------------------- + async createFromFrcTemplate(dto: { + course_code: string; + teacher: string; + }): Promise<{ course: any; scenes: SceneRow[] }> { + if (!dto?.course_code || !dto?.teacher) { + throw new BadRequestException('course_code / teacher are required'); + } + const scenes = FRC_TEMPLATE_SCENES.map((s, i) => ({ + scene_type: 'simulation' as SceneType, + order_index: i + 1, + payload: { title: s.title, embed_url: s.embed_url, description: s.description }, + })); + return this.createCourseWithScenes({ + code: dto.course_code, + name: `${dto.teacher} 老师 · 联邦风控实战(FRC)`, + credits: 4, + instructor: dto.teacher, + scenes, + }); + } + + // ----------------------------------------------------------------- + // List scenes by course + // ----------------------------------------------------------------- + async listScenesByCourse(courseId: string): Promise { + await this.courses.getOrThrow(courseId); + const db = getDb(); + const r = await db.query( + `SELECT id, course_id, scene_type, payload_json, order_index, created_at::text AS created_at + FROM lms_course_scene WHERE course_id = $1 ORDER BY order_index ASC`, + [courseId], + ); + return r.rows; + } + + // ----------------------------------------------------------------- + // Render scene + // ----------------------------------------------------------------- + async renderScene(courseId: string, sceneId: string): Promise { + const scene = await this.getSceneOrThrow(sceneId); + if (scene.course_id !== courseId) { + throw new NotFoundException(`scene ${sceneId} not in course ${courseId}`); + } + const payload = this.parsePayload(scene.payload_json); + + switch (scene.scene_type) { + case 'slide': { + const markdown = String(payload.markdown ?? ''); + const html = renderMiniMD(markdown); + return { + scene_id: scene.id, + scene_type: scene.scene_type, + order_index: scene.order_index, + title: payload.title ?? null, + html, + markdown, // also return raw for e2e to verify node types + }; + } + case 'quiz': { + // Return questions without server-side answer/keywords (client can't peek) + const questions = Array.isArray(payload.questions) ? payload.questions : []; + const sanitized = questions.map((q: any) => ({ + id: q.id, + type: q.type, + prompt: q.prompt, + options: q.options ?? [], + })); + return { + scene_id: scene.id, + scene_type: scene.scene_type, + order_index: scene.order_index, + questions: sanitized, + }; + } + case 'simulation': { + const embedUrl = String(payload.embed_url ?? ''); + if (!embedUrl.startsWith('http://') && !embedUrl.startsWith('https://')) { + throw new BadRequestException('INVALID_EMBED_URL'); + } + return { + scene_id: scene.id, + scene_type: scene.scene_type, + order_index: scene.order_index, + embed_url: embedUrl, + title: payload.title ?? null, + sandbox: String(payload.sandbox ?? 'allow-same-origin'), + height: Number(payload.height ?? 600), + }; + } + case 'pbl': { + throw new NotImplementedException( + 'PBL 场景 v2 实现,当前仅作课程占位', + ); + } + default: { + throw new UnprocessableEntityException('INVALID_SCENE_TYPE'); + } + } + } + + // ----------------------------------------------------------------- + // Grade quiz + // ----------------------------------------------------------------- + async gradeQuiz( + sceneId: string, + answers: Record, + ): Promise<{ score: number; correct_count: number; total_count: number; per_question: any[] }> { + const scene = await this.getSceneOrThrow(sceneId); + if (scene.scene_type !== 'quiz') { + throw new UnprocessableEntityException('INVALID_SCENE_TYPE'); + } + const payload = this.parsePayload(scene.payload_json); + const questions: QuizQuestion[] = Array.isArray(payload.questions) ? payload.questions : []; + if (questions.length === 0) { + return { score: 0, correct_count: 0, total_count: 0, per_question: [] }; + } + + let correct = 0; + const perQuestion: any[] = []; + for (const q of questions) { + const userAns = (answers?.[q.id] ?? '').toString().trim(); + let isRight = false; + if (q.type === 'choice') { + // Choice: exact match (case-sensitive) — keep deterministic for e2e + isRight = !!q.answer && userAns === q.answer; + } else if (q.type === 'short') { + // Short: score = hit_keywords / total_keywords (full credit if any hit) + const keywords: string[] = Array.isArray(q.keywords) ? q.keywords : []; + if (keywords.length === 0) { + isRight = userAns.length > 0; // no rubric → only non-empty counts + } else { + const hit = keywords.filter((k) => userAns.includes(k)).length; + // Per testcases C6: keywords 50% hit = full credit (score=1.0) + // So at >= 50% keywords → 1.0; otherwise 0 + isRight = hit / keywords.length >= 0.5; + } + } + perQuestion.push({ id: q.id, is_right: isRight, user_answer: userAns }); + if (isRight) correct += 1; + } + + const score = correct / questions.length; + return { score, correct_count: correct, total_count: questions.length, per_question: perQuestion }; + } + + // ----------------------------------------------------------------- + // Complete scene (append-only idempotent) + // ----------------------------------------------------------------- + async completeScene( + studentId: string, + courseId: string, + sceneId: string, + ): Promise<{ progress_scene_ids: string[]; progress_count: number }> { + // Verify course + await this.courses.getOrThrow(courseId); + // Verify scene belongs to course + const scene = await this.getSceneOrThrow(sceneId); + if (scene.course_id !== courseId) { + throw new NotFoundException(`scene ${sceneId} not in course ${courseId}`); + } + + const db = getDb(); + // Find the student's enrollment in this course + const enrollRow = await db.query<{ id: string; progress_scene_ids: any }>( + `SELECT id, progress_scene_ids FROM lms_enrollment + WHERE student_id = $1 AND course_id = $2 LIMIT 1`, + [studentId, courseId], + ); + if (enrollRow.rows.length === 0) { + throw new NotFoundException( + `student ${studentId} not enrolled in course ${courseId}`, + ); + } + const enrollmentId = enrollRow.rows[0].id; + // progress_scene_ids may come back as already-parsed JSON object (PGlite) or string + let progress: string[] = []; + const raw = enrollRow.rows[0].progress_scene_ids; + if (Array.isArray(raw)) progress = raw as string[]; + else if (typeof raw === 'string') { + try { progress = JSON.parse(raw); } catch { progress = []; } + } + + // Already-completed → no-op (idempotent) + if (progress.includes(sceneId)) { + return { progress_scene_ids: progress, progress_count: progress.length }; + } + + progress.push(sceneId); + await db.query( + `UPDATE lms_enrollment SET progress_scene_ids = $1::jsonb WHERE id = $2`, + [JSON.stringify(progress), enrollmentId], + ); + return { progress_scene_ids: progress, progress_count: progress.length }; + } + + // ----------------------------------------------------------------- + // Internal helpers + // ----------------------------------------------------------------- + private async getScene(id: string): Promise { + const db = getDb(); + const r = await db.query( + `SELECT id, course_id, scene_type, payload_json, order_index, created_at::text AS created_at + FROM lms_course_scene WHERE id = $1 LIMIT 1`, + [id], + ); + return r.rows[0] ?? null; + } + + private async getSceneOrThrow(id: string): Promise { + const row = await this.getScene(id); + if (!row) throw new NotFoundException(`scene ${id} not found`); + return row; + } + + private parsePayload(s: string): any { + try { return JSON.parse(s); } catch { return {}; } + } + + private validateScenePayload( + sceneType: SceneType, + payload: any, + ): Record { + const allowed: SceneType[] = ['slide', 'quiz', 'simulation', 'pbl']; + if (!allowed.includes(sceneType)) { + throw new UnprocessableEntityException('INVALID_SCENE_TYPE'); + } + const p = payload ?? {}; + if (sceneType === 'simulation') { + const url = String(p.embed_url ?? ''); + if (!url.startsWith('http://') && !url.startsWith('https://')) { + throw new BadRequestException('INVALID_EMBED_URL'); + } + } + if (sceneType === 'slide') { + if (!p.markdown) { + throw new BadRequestException('slide.markdown is required'); + } + } + return p; + } +} + +// ----------------------------------------------------------------- +// MiniMD — minimal Markdown converter +// Supports 5 node types: h1 / h2 / p / ul-li / code +// Illegal nodes are preserved verbatim (no throw, no silent drop). +// Pure function — no new deps, no DOM, no nested state. +// ----------------------------------------------------------------- +export function renderMiniMD(md: string): string { + if (typeof md !== 'string' || md.length === 0) return ''; + const lines = md.split(/\r?\n/); + const out: string[] = []; + let inList = false; + let inCode = false; + let codeBuf: string[] = []; + + const flushList = () => { + if (inList) { + out.push(''); + inList = false; + } + }; + const flushCode = () => { + if (inCode) { + out.push(`
${escapeHtml(codeBuf.join('\n'))}
`); + inCode = false; + codeBuf = []; + } + }; + + for (const rawLine of lines) { + const line = rawLine; + + // Code fence + if (/^```/.test(line)) { + if (inCode) { + flushCode(); + continue; + } + // Opening fence: flush anything else, start code + flushList(); + inCode = true; + codeBuf = []; + continue; + } + if (inCode) { + codeBuf.push(line); + continue; + } + + // H1 + if (/^#\s+/.test(line)) { + flushList(); + out.push(`

${escapeHtml(line.replace(/^#\s+/, ''))}

`); + continue; + } + // H2 + if (/^##\s+/.test(line)) { + flushList(); + out.push(`

${escapeHtml(line.replace(/^##\s+/, ''))}

`); + continue; + } + // List item (supports ` - xxx` nesting by ignoring indent depth for v0) + if (/^\s*-\s+/.test(line)) { + if (!inList) { + out.push('
    '); + inList = true; + } + const text = line.replace(/^\s*-\s+/, ''); + out.push(`
  • ${escapeHtml(text)}
  • `); + continue; + } + // Blank line → paragraph separator + if (/^\s*$/.test(line)) { + flushList(); + // skip; paragraph break will be created when next non-empty line arrives + continue; + } + // Default: paragraph + flushList(); + out.push(`

    ${escapeHtml(line)}

    `); + } + flushCode(); + flushList(); + return out.join('\n'); +} + +function escapeHtml(s: string): string { + return String(s) + .replace(/&/g, '&') + .replace(//g, '>') + .replace(/"/g, '"') + .replace(/'/g, '''); +} \ No newline at end of file diff --git a/src/backend/src/lms/lms.module.ts b/src/backend/src/lms/lms.module.ts index 4155e3b..1459c06 100644 --- a/src/backend/src/lms/lms.module.ts +++ b/src/backend/src/lms/lms.module.ts @@ -4,12 +4,14 @@ import { CoursesController } from './courses.courses.controller'; import { CoursesService } from './courses.courses.service'; import { EnrollmentsController } from './enrollments.enrollments.controller'; import { EnrollmentsService } from './enrollments.enrollments.service'; +import { LmsV2Controller } from './lms-v2.controller'; +import { LmsV2Service } from './lms-v2.service'; import { StudentsController } from './students.students.controller'; import { StudentsService } from './students.students.service'; @Module({ imports: [AuthModule], - controllers: [StudentsController, CoursesController, EnrollmentsController], - providers: [StudentsService, CoursesService, EnrollmentsService], + controllers: [StudentsController, CoursesController, EnrollmentsController, LmsV2Controller], + providers: [StudentsService, CoursesService, EnrollmentsService, LmsV2Service], }) export class LmsModule {} \ No newline at end of file diff --git a/src/frontend/src/App.tsx b/src/frontend/src/App.tsx index 173912b..1d6b3ce 100644 --- a/src/frontend/src/App.tsx +++ b/src/frontend/src/App.tsx @@ -7,6 +7,10 @@ import Run from './views/Run'; // chg_0007 lite-demo: book + product 通用 CRUD 参考实现 import Book from './views/Book'; import Product from './views/Product'; +// chg_0012 LMS v2: 多场景课程平台(slide/quiz/simulation/pbl + FRC 模板) +import LMSCourseList from './views/LMS/CourseList'; +import LMSCourseDetail from './views/LMS/CourseDetail'; +import LMSSceneRenderer from './views/LMS/SceneRenderer'; export default function App() { return ( @@ -18,6 +22,12 @@ export default function App() { } /> } /> } /> + } /> + } /> + } + /> } /> } /> diff --git a/src/frontend/src/api/lms/client.ts b/src/frontend/src/api/lms/client.ts new file mode 100644 index 0000000..bb4b3d4 --- /dev/null +++ b/src/frontend/src/api/lms/client.ts @@ -0,0 +1,205 @@ +import { AxiosResponse } from 'axios'; +import { client } from '../client'; + +/** + * chg_0012 LMS v2 — multi-scene course platform. + * Path: /api/ssw/dth/lms-v2/... + * Response envelope: {code, msg, data} (see backend action-result.filter.ts). + */ + +export interface CourseRow { + id: string; + code: string; + name: string; + credits: number; + instructor: string | null; + created_at: string; +} + +export interface StudentRow { + id: string; + student_no: string; + name: string; + email: string; + created_at: string; +} + +export interface SceneRow { + id: string; + course_id: string; + scene_type: 'slide' | 'quiz' | 'simulation' | 'pbl'; + payload_json: string; + order_index: number; + created_at: string; +} + +export interface SlideRender { + scene_id: string; + scene_type: 'slide'; + order_index: number; + title: string | null; + html: string; + markdown: string; +} + +export interface QuizQuestionClient { + id: string; + type: 'choice' | 'short'; + prompt: string; + options: string[]; +} + +export interface QuizRender { + scene_id: string; + scene_type: 'quiz'; + order_index: number; + questions: QuizQuestionClient[]; +} + +export interface SimRender { + scene_id: string; + scene_type: 'simulation'; + order_index: number; + embed_url: string; + title: string | null; + sandbox: string; + height: number; +} + +export type SceneRender = SlideRender | QuizRender | SimRender; + +export interface GradeResult { + score: number; + correct_count: number; + total_count: number; + per_question: Array<{ id: string; is_right: boolean; user_answer: string }>; +} + +export interface CompleteResult { + progress_scene_ids: string[]; + progress_count: number; +} + +interface Envelope { + code: number; + msg: string; + data: T; +} + +async function unwrap(p: Promise>>): Promise { + const r = await p; + if (r.data.code !== 200) { + throw new Error(`lms-v2: ${r.data.code} ${r.data.msg}`); + } + return r.data.data; +} + +export function listLmsCourses(): Promise { + // Reuse the v1 admin courses endpoint (same schema) + return unwrap( + client.post>('/ssw/dth/lms/courses'), + ); +} + +export function listStudents(): Promise { + return unwrap(client.post>('/ssw/dth/lms/students')); +} + +export function createCourseWithScenes(input: { + code: string; + name: string; + credits?: number; + instructor?: string; + scenes?: Array<{ + scene_type: 'slide' | 'quiz' | 'simulation' | 'pbl'; + order_index: number; + payload: Record; + }>; +}): Promise<{ course: CourseRow; scenes: SceneRow[] }> { + return unwrap( + client.post>( + '/ssw/dth/lms-v2/courses', + input, + ), + ); +} + +export function createFromFrcTemplate(input: { + course_code: string; + teacher: string; +}): Promise<{ course: CourseRow; scenes: SceneRow[] }> { + return unwrap( + client.post>( + '/ssw/dth/lms-v2/courses/from-frc-template', + input, + ), + ); +} + +export function listScenesByCourse(courseId: string): Promise { + return unwrap( + client.get>( + `/ssw/dth/lms-v2/courses/${courseId}/scenes`, + ), + ); +} + +export function renderScene( + courseId: string, + sceneId: string, +): Promise { + return unwrap( + client.get>( + `/ssw/dth/lms-v2/courses/${courseId}/scenes/${sceneId}/render`, + ), + ); +} + +export function gradeQuiz( + sceneId: string, + answers: Record, +): Promise { + return unwrap( + client.post>( + `/ssw/dth/lms-v2/scenes/${sceneId}/grade`, + { answers }, + ), + ); +} + +export function completeScene( + sceneId: string, + student_id: string, + course_id: string, +): Promise { + return unwrap( + client.post>( + `/ssw/dth/lms-v2/scenes/${sceneId}/complete`, + { student_id, course_id }, + ), + ); +} + +export function enrollStudent( + courseId: string, + studentId: string, +): Promise<{ id: string; student_id: string; course_id: string }> { + // chg_0006 enrollment endpoint + return unwrap( + client.post>( + `/ssw/dth/lms/courses/${courseId}/enroll`, + { student_id: studentId }, + ), + ); +} + +export function listEnrollmentsByStudent( + studentId: string, +): Promise> { + return unwrap( + client.post>>( + `/ssw/dth/lms/students/${studentId}/enrollments`, + {}, + ), + ); +} \ No newline at end of file diff --git a/src/frontend/src/views/LMS/CourseDetail.tsx b/src/frontend/src/views/LMS/CourseDetail.tsx new file mode 100644 index 0000000..8ddd619 --- /dev/null +++ b/src/frontend/src/views/LMS/CourseDetail.tsx @@ -0,0 +1,60 @@ +import { useEffect, useState } from 'react'; +import { useParams, Link } from 'react-router-dom'; +import { + listLmsCourses, + listScenesByCourse, + CourseRow, + SceneRow, +} from '../../api/lms/client'; + +/** + * CourseDetail — shows course info + ordered scene list. + */ +export default function CourseDetail() { + const { courseId } = useParams<{ courseId: string }>(); + const [course, setCourse] = useState(null); + const [scenes, setScenes] = useState(null); + const [error, setError] = useState(null); + + useEffect(() => { + if (!courseId) return; + setError(null); + Promise.all([listLmsCourses(), listScenesByCourse(courseId)]) + .then(([courses, scenes]) => { + const found = courses.find((c) => c.id === courseId); + if (!found) setError('course not found'); + setCourse(found ?? null); + setScenes(scenes); + }) + .catch((e) => setError(e.message ?? 'load failed')); + }, [courseId]); + + if (!courseId) return
    missing course id
    ; + + return ( +
    + ← 返回课程列表 +

    {course ? course.name : '加载中…'}

    + {course && ( +

    + 课程号:{course.code} · 学分:{course.credits} · 教师: + {course.instructor ?? '—'} +

    + )} + {error &&
    {error}
    } +

    Scene 列表

    + {scenes === null &&

    加载中…

    } + {scenes && scenes.length === 0 &&

    本课程暂无 scene。

    } + {scenes && scenes.length > 0 && ( +
      + {scenes.map((s) => ( +
    1. + {s.scene_type} · order {s.order_index} ·{' '} + 打开 scene +
    2. + ))} +
    + )} +
    + ); +} \ No newline at end of file diff --git a/src/frontend/src/views/LMS/CourseList.tsx b/src/frontend/src/views/LMS/CourseList.tsx new file mode 100644 index 0000000..bdd9866 --- /dev/null +++ b/src/frontend/src/views/LMS/CourseList.tsx @@ -0,0 +1,59 @@ +import { useEffect, useState } from 'react'; +import { Link } from 'react-router-dom'; +import { listLmsCourses, CourseRow } from '../../api/lms/client'; + +/** + * CourseList — LMS v2 course list page (admin or any authenticated user). + * Lists all courses; each links to its detail/scene view. + */ +export default function CourseList() { + const [courses, setCourses] = useState(null); + const [error, setError] = useState(null); + + useEffect(() => { + setError(null); + listLmsCourses() + .then(setCourses) + .catch((e) => setError(e.message ?? 'load failed')); + }, []); + + return ( +
    +

    LMS 课程列表

    +

    + chg_0012 LMS v2 — 多场景课程平台(slide / quiz / simulation / pbl) +

    + {error && ( +
    {error}
    + )} + {courses === null &&

    加载中…

    } + {courses && courses.length === 0 &&

    暂无课程。

    } + {courses && courses.length > 0 && ( + + + + + + + + + + + + {courses.map((c) => ( + + + + + + + + ))} + +
    课程号课程名学分教师操作
    {c.code}{c.name}{c.credits}{c.instructor ?? '—'} + 查看 scene +
    + )} +
    + ); +} \ No newline at end of file diff --git a/src/frontend/src/views/LMS/PBLScene.tsx b/src/frontend/src/views/LMS/PBLScene.tsx new file mode 100644 index 0000000..03b6866 --- /dev/null +++ b/src/frontend/src/views/LMS/PBLScene.tsx @@ -0,0 +1,41 @@ +/** + * PBLScene — placeholder for Project-Based Learning scenes. + * + * The backend returns HTTP 501 NOT_IMPLEMENTED with the exact message + * "PBL 场景 v2 实现,当前仅作课程占位" (see lms-v2.service.ts renderScene + * case 'pbl'). The frontend copy below mirrors that string so e2e C10 + * can verify both ends agree. + * + * Both the backend exception's `msg` and the JSX placeholder use the same + * source string literal — a future maintainer who updates one without the + * other will fail the C10 assertion. + */ +export const PBL_PLACEHOLDER_MESSAGE = 'PBL 场景 v2 实现,当前仅作课程占位'; + +export default function PBLScene({ + courseId, + sceneId, + message, +}: { + courseId: string; + sceneId: string; + message?: string; +}) { + return ( +
    +

    即将推出

    +

    {message ?? PBL_PLACEHOLDER_MESSAGE}

    +

    + course: {courseId} · scene: {sceneId} +

    +
    + ); +} \ No newline at end of file diff --git a/src/frontend/src/views/LMS/QuizScene.tsx b/src/frontend/src/views/LMS/QuizScene.tsx new file mode 100644 index 0000000..846794f --- /dev/null +++ b/src/frontend/src/views/LMS/QuizScene.tsx @@ -0,0 +1,111 @@ +import { FormEvent, useState } from 'react'; +import { + gradeQuiz, + completeScene, + GradeResult, + QuizRender, +} from '../../api/lms/client'; + +interface Props { + courseId: string; + sceneId: string; + data: QuizRender; +} + +/** + * QuizScene — multiple choice + short answer quiz. + * - On submit: POST /scenes/:id/grade → score 0..1 + * - Then: POST /scenes/:id/complete (append-only, idempotent) + */ +export default function QuizScene({ courseId, sceneId, data }: Props) { + const [answers, setAnswers] = useState>({}); + const [result, setResult] = useState(null); + const [error, setError] = useState(null); + const [submitting, setSubmitting] = useState(false); + + function setAnswer(qid: string, val: string) { + setAnswers((a) => ({ ...a, [qid]: val })); + } + + async function onSubmit(e: FormEvent) { + e.preventDefault(); + setSubmitting(true); + setError(null); + try { + const r = await gradeQuiz(sceneId, answers); + setResult(r); + // Best-effort: complete the scene (admin user — student_id needs a real id; + // in the demo we use the first seeded student — admin won't actually + // complete, but the call exercises the endpoint.) + try { + await completeScene(sceneId, '11111111-1111-1111-1111-111111111111', courseId); + } catch { + /* ignore — caller can retry */ + } + } catch (e: any) { + setError(e.message ?? 'grade failed'); + } finally { + setSubmitting(false); + } + } + + return ( +
    +
    + {data.questions.map((q, i) => ( +
    + + Q{i + 1} ({q.type}) + +

    {q.prompt}

    + {q.type === 'choice' && ( +
    + {(q.options ?? []).map((opt) => ( + + ))} +
    + )} + {q.type === 'short' && ( + setAnswer(q.id, e.target.value)} + style={{ width: '100%', padding: 4 }} + /> + )} +
    + ))} + +
    + {error &&
    {error}
    } + {result && ( +
    + score: {result.score.toFixed(2)} ·{' '} + correct: {result.correct_count}/{result.total_count} +
    + )} +
    + ); +} \ No newline at end of file diff --git a/src/frontend/src/views/LMS/SceneRenderer.tsx b/src/frontend/src/views/LMS/SceneRenderer.tsx new file mode 100644 index 0000000..39843fb --- /dev/null +++ b/src/frontend/src/views/LMS/SceneRenderer.tsx @@ -0,0 +1,66 @@ +import { useEffect, useState } from 'react'; +import { useParams, Link } from 'react-router-dom'; +import { renderScene, SceneRender as SceneRenderT } from '../../api/lms/client'; +import SlideScene from './SlideScene'; +import QuizScene from './QuizScene'; +import SimScene from './SimScene'; +import PBLScene from './PBLScene'; + +/** + * SceneRenderer — dispatcher: fetches scene payload from /render, then + * routes to the matching Scene component (slide / quiz / simulation / pbl). + * + * For PBL scene (501 NOT_IMPLEMENTED), the backend throws and the api helper + * propagates an Error — we render PBLScene with a "coming soon" message + * matching the backend's 501 response body text exactly: + * "PBL 场景 v2 实现,当前仅作课程占位" + */ +export default function SceneRenderer() { + const { courseId, sceneId } = useParams<{ + courseId: string; + sceneId: string; + }>(); + const [data, setData] = useState(null); + const [error, setError] = useState(null); + + useEffect(() => { + if (!courseId || !sceneId) return; + setError(null); + setData(null); + renderScene(courseId, sceneId) + .then(setData) + .catch((e) => setError(e.message ?? 'render failed')); + }, [courseId, sceneId]); + + if (!courseId || !sceneId) { + return
    missing courseId/sceneId
    ; + } + + return ( +
    + ← 返回课程详情 +

    Scene Renderer

    + {error && ( + // Backend returns 501 NOT_IMPLEMENTED for pbl; we surface its msg + + )} + {data && data.scene_type === 'slide' && ( + + )} + {data && data.scene_type === 'quiz' && ( + + )} + {data && data.scene_type === 'simulation' && ( + + )} +
    + ); +} \ No newline at end of file diff --git a/src/frontend/src/views/LMS/SimScene.tsx b/src/frontend/src/views/LMS/SimScene.tsx new file mode 100644 index 0000000..aeef747 --- /dev/null +++ b/src/frontend/src/views/LMS/SimScene.tsx @@ -0,0 +1,28 @@ +import { SimRender } from '../../api/lms/client'; + +/** + * SimScene — iframe-rendered simulation scene. + * Default sandbox: 'allow-same-origin' (server picks it from payload.sandbox). + * The embed_url must start with http(s):// — server validates that on create. + */ +export default function SimScene({ data }: { data: SimRender }) { + return ( +
    + {data.title &&

    {data.title}

    } +