chg_0012(T2): LMS v1 重建 + v2 多场景 + 4 scene + FRC 模板 + e2e
后端: - lms_course_scene 表 + lms_enrollment.progress_scene_ids JSONB 列 - lms-v2.service.ts: createCourseWithScenes / renderScene / gradeQuiz / completeScene / createFromFrcTemplate + MiniMD (h1/h2/p/ul/li/code 5 节点 + 非法节点原样保留) - lms-v2.controller.ts: 6 endpoints (含 from-frc-template 生成 6 simulation scene 对位 chg_0010 S1-S6) - lms.module.ts: 注册 v2 controller + service - 6 不变量: 409 DUPLICATE_COURSE_CODE / 422 INVALID_SCENE_TYPE / 400 INVALID_EMBED_URL / 501 PBL 占位 + append-only idempotent / scene 严格 4 类 enum 前端: - api/lms/client.ts: listLmsCourses / listScenesByCourse / renderScene / gradeQuiz / completeScene / createFromFrcTemplate / enrollStudent - views/LMS/: CourseList / CourseDetail / SceneRenderer + Slide/Quiz/Sim/PBL 4 个 scene 组件 - App.tsx: 注册 /lms / /lms/:courseId / /lms/:courseId/:sceneId 3 个 ProtectedRoute - 0 新依赖 e2e: - tests/e2e/dth_lms_v2.test.sh: 10 case (45 sub-assertion) 覆盖 S1-S10 - C1 LMS v1 数据模型 / C2 scene_type enum / C3 多场景 + FRC 模板 / C4 选课 + 进度 append-only - C5 Slide MiniMD / C6 Quiz 判分 / C7 Sim embed_url / C8 FRC 6 scene 对位 chg_0010 S1-S6 - C9 E2E 完整流程 / C10 PBL 501 占位文案一致性 注意: chg_0006 LMS v1 schema/seed 已在盘存在(CLAUDE.md F-2 路径索引有误,应为 src/backend/src/lms/ 非 dth/lms/),未重建;v2 在 v1 之上增量扩展。 Co-Authored-By: Claude <[email protected]>
This commit is contained in:
1 parent
441c6ca2f8
commit
c1c1bf650e
14 files changed
+1661
-7
No files matched your search
@@ -55,16 +55,30 @@ export async function initPglite(): Promise<PGlite> {
|
||||
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 (
|
||||
|
||||
@@ -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<string, string> },
|
||||
) {
|
||||
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 };
|
||||
@@ -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<string, unknown>;
|
||||
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<SceneRow[]> {
|
||||
await this.courses.getOrThrow(courseId);
|
||||
const db = getDb();
|
||||
const r = await db.query<SceneRow>(
|
||||
`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<any> {
|
||||
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<string, string>,
|
||||
): 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<SceneRow | null> {
|
||||
const db = getDb();
|
||||
const r = await db.query<SceneRow>(
|
||||
`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<SceneRow> {
|
||||
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<string, unknown> {
|
||||
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('</ul>');
|
||||
inList = false;
|
||||
}
|
||||
};
|
||||
const flushCode = () => {
|
||||
if (inCode) {
|
||||
out.push(`<pre><code>${escapeHtml(codeBuf.join('\n'))}</code></pre>`);
|
||||
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(`<h1>${escapeHtml(line.replace(/^#\s+/, ''))}</h1>`);
|
||||
continue;
|
||||
}
|
||||
// H2
|
||||
if (/^##\s+/.test(line)) {
|
||||
flushList();
|
||||
out.push(`<h2>${escapeHtml(line.replace(/^##\s+/, ''))}</h2>`);
|
||||
continue;
|
||||
}
|
||||
// List item (supports ` - xxx` nesting by ignoring indent depth for v0)
|
||||
if (/^\s*-\s+/.test(line)) {
|
||||
if (!inList) {
|
||||
out.push('<ul>');
|
||||
inList = true;
|
||||
}
|
||||
const text = line.replace(/^\s*-\s+/, '');
|
||||
out.push(`<li>${escapeHtml(text)}</li>`);
|
||||
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(`<p>${escapeHtml(line)}</p>`);
|
||||
}
|
||||
flushCode();
|
||||
flushList();
|
||||
return out.join('\n');
|
||||
}
|
||||
|
||||
function escapeHtml(s: string): string {
|
||||
return String(s)
|
||||
.replace(/&/g, '&')
|
||||
.replace(/</g, '<')
|
||||
.replace(/>/g, '>')
|
||||
.replace(/"/g, '"')
|
||||
.replace(/'/g, ''');
|
||||
}
|
||||
@@ -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 {}
|
||||
@@ -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() {
|
||||
<Route path="/operators/:code/run" element={<Run />} />
|
||||
<Route path="/books/Book" element={<Book />} />
|
||||
<Route path="/books/Product" element={<Product />} />
|
||||
<Route path="/lms" element={<LMSCourseList />} />
|
||||
<Route path="/lms/:courseId" element={<LMSCourseDetail />} />
|
||||
<Route
|
||||
path="/lms/:courseId/:sceneId"
|
||||
element={<LMSSceneRenderer />}
|
||||
/>
|
||||
</Route>
|
||||
<Route path="/" element={<Navigate to="/login" replace />} />
|
||||
<Route path="*" element={<Navigate to="/login" replace />} />
|
||||
|
||||
@@ -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<T> {
|
||||
code: number;
|
||||
msg: string;
|
||||
data: T;
|
||||
}
|
||||
|
||||
async function unwrap<T>(p: Promise<AxiosResponse<Envelope<T>>>): Promise<T> {
|
||||
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<CourseRow[]> {
|
||||
// Reuse the v1 admin courses endpoint (same schema)
|
||||
return unwrap(
|
||||
client.post<Envelope<CourseRow[]>>('/ssw/dth/lms/courses'),
|
||||
);
|
||||
}
|
||||
|
||||
export function listStudents(): Promise<StudentRow[]> {
|
||||
return unwrap(client.post<Envelope<StudentRow[]>>('/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<string, unknown>;
|
||||
}>;
|
||||
}): Promise<{ course: CourseRow; scenes: SceneRow[] }> {
|
||||
return unwrap(
|
||||
client.post<Envelope<{ course: CourseRow; scenes: SceneRow[] }>>(
|
||||
'/ssw/dth/lms-v2/courses',
|
||||
input,
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
export function createFromFrcTemplate(input: {
|
||||
course_code: string;
|
||||
teacher: string;
|
||||
}): Promise<{ course: CourseRow; scenes: SceneRow[] }> {
|
||||
return unwrap(
|
||||
client.post<Envelope<{ course: CourseRow; scenes: SceneRow[] }>>(
|
||||
'/ssw/dth/lms-v2/courses/from-frc-template',
|
||||
input,
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
export function listScenesByCourse(courseId: string): Promise<SceneRow[]> {
|
||||
return unwrap(
|
||||
client.get<Envelope<SceneRow[]>>(
|
||||
`/ssw/dth/lms-v2/courses/${courseId}/scenes`,
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
export function renderScene(
|
||||
courseId: string,
|
||||
sceneId: string,
|
||||
): Promise<SceneRender> {
|
||||
return unwrap(
|
||||
client.get<Envelope<SceneRender>>(
|
||||
`/ssw/dth/lms-v2/courses/${courseId}/scenes/${sceneId}/render`,
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
export function gradeQuiz(
|
||||
sceneId: string,
|
||||
answers: Record<string, string>,
|
||||
): Promise<GradeResult> {
|
||||
return unwrap(
|
||||
client.post<Envelope<GradeResult>>(
|
||||
`/ssw/dth/lms-v2/scenes/${sceneId}/grade`,
|
||||
{ answers },
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
export function completeScene(
|
||||
sceneId: string,
|
||||
student_id: string,
|
||||
course_id: string,
|
||||
): Promise<CompleteResult> {
|
||||
return unwrap(
|
||||
client.post<Envelope<CompleteResult>>(
|
||||
`/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<Envelope<{ id: string; student_id: string; course_id: string }>>(
|
||||
`/ssw/dth/lms/courses/${courseId}/enroll`,
|
||||
{ student_id: studentId },
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
export function listEnrollmentsByStudent(
|
||||
studentId: string,
|
||||
): Promise<Array<{ id: string; student_id: string; course_id: string }>> {
|
||||
return unwrap(
|
||||
client.post<Envelope<Array<{ id: string; student_id: string; course_id: string }>>>(
|
||||
`/ssw/dth/lms/students/${studentId}/enrollments`,
|
||||
{},
|
||||
),
|
||||
);
|
||||
}
|
||||
@@ -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<CourseRow | null>(null);
|
||||
const [scenes, setScenes] = useState<SceneRow[] | null>(null);
|
||||
const [error, setError] = useState<string | null>(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 <div style={{ padding: 24 }}>missing course id</div>;
|
||||
|
||||
return (
|
||||
<div style={{ padding: 24, maxWidth: 960, margin: '0 auto' }}>
|
||||
<Link to="/lms">← 返回课程列表</Link>
|
||||
<h1>{course ? course.name : '加载中…'}</h1>
|
||||
{course && (
|
||||
<p style={{ color: '#666' }}>
|
||||
课程号:{course.code} · 学分:{course.credits} · 教师:
|
||||
{course.instructor ?? '—'}
|
||||
</p>
|
||||
)}
|
||||
{error && <div style={{ color: '#c00' }}>{error}</div>}
|
||||
<h2>Scene 列表</h2>
|
||||
{scenes === null && <p>加载中…</p>}
|
||||
{scenes && scenes.length === 0 && <p>本课程暂无 scene。</p>}
|
||||
{scenes && scenes.length > 0 && (
|
||||
<ol>
|
||||
{scenes.map((s) => (
|
||||
<li key={s.id} style={{ marginBottom: 8 }}>
|
||||
<strong>{s.scene_type}</strong> · order {s.order_index} ·{' '}
|
||||
<Link to={`/lms/${courseId}/${s.id}`}>打开 scene</Link>
|
||||
</li>
|
||||
))}
|
||||
</ol>
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -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<CourseRow[] | null>(null);
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
|
||||
useEffect(() => {
|
||||
setError(null);
|
||||
listLmsCourses()
|
||||
.then(setCourses)
|
||||
.catch((e) => setError(e.message ?? 'load failed'));
|
||||
}, []);
|
||||
|
||||
return (
|
||||
<div style={{ padding: 24, maxWidth: 960, margin: '0 auto' }}>
|
||||
<h1>LMS 课程列表</h1>
|
||||
<p style={{ color: '#666' }}>
|
||||
chg_0012 LMS v2 — 多场景课程平台(slide / quiz / simulation / pbl)
|
||||
</p>
|
||||
{error && (
|
||||
<div style={{ color: '#c00', marginBottom: 12 }}>{error}</div>
|
||||
)}
|
||||
{courses === null && <p>加载中…</p>}
|
||||
{courses && courses.length === 0 && <p>暂无课程。</p>}
|
||||
{courses && courses.length > 0 && (
|
||||
<table style={{ width: '100%', borderCollapse: 'collapse' }}>
|
||||
<thead>
|
||||
<tr style={{ borderBottom: '2px solid #333' }}>
|
||||
<th style={{ textAlign: 'left', padding: 8 }}>课程号</th>
|
||||
<th style={{ textAlign: 'left', padding: 8 }}>课程名</th>
|
||||
<th style={{ textAlign: 'left', padding: 8 }}>学分</th>
|
||||
<th style={{ textAlign: 'left', padding: 8 }}>教师</th>
|
||||
<th style={{ textAlign: 'left', padding: 8 }}>操作</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{courses.map((c) => (
|
||||
<tr key={c.id} style={{ borderBottom: '1px solid #ddd' }}>
|
||||
<td style={{ padding: 8 }}>{c.code}</td>
|
||||
<td style={{ padding: 8 }}>{c.name}</td>
|
||||
<td style={{ padding: 8 }}>{c.credits}</td>
|
||||
<td style={{ padding: 8 }}>{c.instructor ?? '—'}</td>
|
||||
<td style={{ padding: 8 }}>
|
||||
<Link to={`/lms/${c.id}`}>查看 scene</Link>
|
||||
</td>
|
||||
</tr>
|
||||
))}
|
||||
</tbody>
|
||||
</table>
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -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 (
|
||||
<div
|
||||
data-testid="pbl-placeholder"
|
||||
style={{
|
||||
marginTop: 16,
|
||||
padding: 24,
|
||||
border: '1px dashed #999',
|
||||
background: '#fffbe6',
|
||||
}}
|
||||
>
|
||||
<h2>即将推出</h2>
|
||||
<p>{message ?? PBL_PLACEHOLDER_MESSAGE}</p>
|
||||
<p style={{ color: '#888', fontSize: 12 }}>
|
||||
course: {courseId} · scene: {sceneId}
|
||||
</p>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -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<Record<string, string>>({});
|
||||
const [result, setResult] = useState<GradeResult | null>(null);
|
||||
const [error, setError] = useState<string | null>(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 (
|
||||
<div style={{ marginTop: 16 }}>
|
||||
<form onSubmit={onSubmit}>
|
||||
{data.questions.map((q, i) => (
|
||||
<fieldset
|
||||
key={q.id}
|
||||
style={{ marginBottom: 16, padding: 12, border: '1px solid #ddd' }}
|
||||
>
|
||||
<legend>
|
||||
Q{i + 1} ({q.type})
|
||||
</legend>
|
||||
<p>{q.prompt}</p>
|
||||
{q.type === 'choice' && (
|
||||
<div>
|
||||
{(q.options ?? []).map((opt) => (
|
||||
<label key={opt} style={{ display: 'block' }}>
|
||||
<input
|
||||
type="radio"
|
||||
name={q.id}
|
||||
value={opt}
|
||||
checked={answers[q.id] === opt}
|
||||
onChange={() => setAnswer(q.id, opt)}
|
||||
/>
|
||||
{' '}{opt}
|
||||
</label>
|
||||
))}
|
||||
</div>
|
||||
)}
|
||||
{q.type === 'short' && (
|
||||
<input
|
||||
type="text"
|
||||
value={answers[q.id] ?? ''}
|
||||
onChange={(e) => setAnswer(q.id, e.target.value)}
|
||||
style={{ width: '100%', padding: 4 }}
|
||||
/>
|
||||
)}
|
||||
</fieldset>
|
||||
))}
|
||||
<button type="submit" disabled={submitting}>
|
||||
{submitting ? '提交中…' : '提交答卷'}
|
||||
</button>
|
||||
</form>
|
||||
{error && <div style={{ color: '#c00', marginTop: 12 }}>{error}</div>}
|
||||
{result && (
|
||||
<div
|
||||
data-testid="quiz-result"
|
||||
style={{
|
||||
marginTop: 12,
|
||||
padding: 12,
|
||||
background: '#f5f5f5',
|
||||
border: '1px solid #ddd',
|
||||
}}
|
||||
>
|
||||
<strong>score:</strong> {result.score.toFixed(2)} ·{' '}
|
||||
<strong>correct:</strong> {result.correct_count}/{result.total_count}
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -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<SceneRenderT | null>(null);
|
||||
const [error, setError] = useState<string | null>(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 <div style={{ padding: 24 }}>missing courseId/sceneId</div>;
|
||||
}
|
||||
|
||||
return (
|
||||
<div style={{ padding: 24, maxWidth: 960, margin: '0 auto' }}>
|
||||
<Link to={`/lms/${courseId}`}>← 返回课程详情</Link>
|
||||
<h1>Scene Renderer</h1>
|
||||
{error && (
|
||||
// Backend returns 501 NOT_IMPLEMENTED for pbl; we surface its msg
|
||||
<PBLScene
|
||||
courseId={courseId}
|
||||
sceneId={sceneId}
|
||||
message={error}
|
||||
/>
|
||||
)}
|
||||
{data && data.scene_type === 'slide' && (
|
||||
<SlideScene data={data} />
|
||||
)}
|
||||
{data && data.scene_type === 'quiz' && (
|
||||
<QuizScene
|
||||
courseId={courseId}
|
||||
sceneId={sceneId}
|
||||
data={data}
|
||||
/>
|
||||
)}
|
||||
{data && data.scene_type === 'simulation' && (
|
||||
<SimScene data={data} />
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -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 (
|
||||
<div style={{ marginTop: 16 }}>
|
||||
{data.title && <h2>{data.title}</h2>}
|
||||
<iframe
|
||||
title={`sim-scene-${data.scene_id}`}
|
||||
src={data.embed_url}
|
||||
sandbox={data.sandbox}
|
||||
style={{
|
||||
width: '100%',
|
||||
height: data.height,
|
||||
border: '1px solid #ccc',
|
||||
background: '#fafafa',
|
||||
}}
|
||||
/>
|
||||
<p style={{ color: '#888', fontSize: 12 }}>
|
||||
embed_url: {data.embed_url}
|
||||
</p>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,26 @@
|
||||
import { SlideRender } from '../../api/lms/client';
|
||||
|
||||
/**
|
||||
* SlideScene — render a slide scene.
|
||||
* Markdown is converted to HTML on the server (MiniMD with 5 node types
|
||||
* h1/h2/p/ul/li/code; illegal nodes preserved verbatim). We inject HTML via
|
||||
* dangerouslySetInnerHTML since this is fully server-rendered, trusted output.
|
||||
*/
|
||||
export default function SlideScene({ data }: { data: SlideRender }) {
|
||||
return (
|
||||
<div style={{ marginTop: 16 }}>
|
||||
{data.title && <h2>{data.title}</h2>}
|
||||
<div
|
||||
className="slide-content"
|
||||
// MiniMD output is server-rendered from a controlled input. The
|
||||
// payload comes from the admin who created the course.
|
||||
dangerouslySetInnerHTML={{ __html: data.html }}
|
||||
/>
|
||||
{/* Hidden raw markdown kept for e2e/debug visibility */}
|
||||
<details style={{ marginTop: 24, color: '#888' }}>
|
||||
<summary>raw markdown</summary>
|
||||
<pre>{data.markdown}</pre>
|
||||
</details>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
Reference in new issue
Block a user