merge sandbox/f0cf2f4: chg_0006 LMS bootstrap (3 子系统 + 5 S 场景 + 6 cases)

Co-Authored-By: Claude Code <[email protected]>
This commit is contained in:
xstudio agentandClaude Code committed 2026-09-28 16:46:52 +08:00
1 parent f1a15c44f4
commit 5c27b0fd39
17 files changed
+1039 -1

No files matched your search

@@ -0,0 +1,44 @@
---
change_id: chg_0006
status: proposed
owner: pm@dth
stakeholders: [pd, dev, qa]
priority: P1
target_release: v0.5
created: 2026-09-28
skip_coverage: false
---
# Change: LMS 起头(学员 + 课程 + 选课)
## Why
需求 §6.1 LMS 是数智安全人才平台的核心子系统之一。本 chg 落地 LMS 三个最小子系统:学员管理(学号/姓名/邮箱)、课程管理(代码/学分/教师)、选课(学员 ↔ 课程)。
## Who
高校教师 / 学员 / 教务管理员。
## Scope
- 学员管理:list / create / get / update / delete
- 课程管理:list / create / get / update / delete
- 选课:enroll / list-by-student / list-by-course
- 3 张 PGlite 表:lms_student / lms_course / lms_enrollment
- e2e:tests/e2e/dth_lms.test.sh(4 case 对应 S1-S4)
## Non-Goals
- 不做 LMS 前端(前端 chg_0004 已定,operator 列表的 UI 模式可直接复用)
- 不做作业 / 考试 / 题库 / 教师端(后续 chg)
- 不做权限分层(admin 端管所有 LMS 资源;非 admin 暂不允许)
- 不做学员能力图谱(5 模块雷达图)
## Impact
- 新 capability `lms`(独立元能力,S 编号从 1 起)
## Acceptance
- [ ] admin GET /api/ssw/dth/lms/students 返回 ≥ 2 学员(seed 后)
- [ ] admin POST /api/ssw/dth/lms/students 创建新学员,GET /api/ssw/dth/lms/students/:id 返回该学员
- [ ] admin GET /api/ssw/dth/lms/courses 返回 ≥ 2 课程(seed 后)
- [ ] admin POST /api/ssw/dth/lms/courses/:id/enroll 把学生加入课程,GET /api/ssw/dth/lms/students/:id/enrollments 列出该生所有课程
- [ ] check_spec_coverage.sh gap=0
## Rollout
合并 main;后端 :30000 重启即生效。PGlite 启动期创建 3 表 + seed 2 学员 2 课程。
@@ -0,0 +1,38 @@
---
change_id: chg_0006
owner: pd@dth
status: draft
requires_human_validation: false
---
# Spec: lms
## Requirement
WHEN 管理员调用学员/课程列表接口 THE SYSTEM SHALL 返回资源列表(含 seed 初始数据)。
WHEN 管理员对学员/课程发起 create/update/delete/enroll THE SYSTEM SHALL 返回操作结果。
## ADDED Scenarios
### S1 list_students_returns_seeded
- **WHEN** admin GET /api/ssw/dth/lms/students
- **THEN** 响应 data 数组长度 ≥ 2,每个元素含 id/student_no/name/email/created_at
### S2 create_then_get_student
- **WHEN** admin POST /api/ssw/dth/lms/students body={"student_no":"S2026001","name":"张三","email":"zhangsan@school.edu"}
- **THEN** data.id 为 36 位 UUID
- **AND** GET /api/ssw/dth/lms/students/:id 的 data.name == "张三"
### S3 list_courses_returns_seeded
- **WHEN** admin GET /api/ssw/dth/lms/courses
- **THEN** 响应 data 数组长度 ≥ 2,每个元素含 id/code/name/credits/instructor/created_at
### S4 enroll_student_to_course
- **WHEN** admin POST /api/ssw/dth/lms/courses/:courseId/enroll body={"student_id":"<seed student id>"}
- **THEN** 响应 code = 200
- **AND** GET /api/ssw/dth/lms/students/:studentId/enrollments 返回 ≥ 1 条含 course_id=enrolled
### all test_runner_and_gate_pass
- **WHEN** 跑 `bash tests/e2e/dth_lms.test.sh`
- **THEN** C5_test_runner_passes_all 通过(≥4 S 场景断言)
- **AND** 跑 `bash openspec/scripts/check_spec_coverage.sh`
- **AND** C6_check_spec_coverage_gap_zero 通过(gap=0)
@@ -0,0 +1,30 @@
# Tasks (DAG)
- id: T1
type: architect
depends_on: []
output: docs/dth/lms/design.md(3 表 schema + 接口契约 + seed 策略)
verification: design covers 3 表 + 4 S 场景 + seed 数据
- id: T2
type: implementer
depends_on: [T1]
output: src/backend/src/common/pglite/init.ts 追加 3 张表 + seed 2 学员 2 课程
verification: 启动期能 CREATE TABLE IF NOT EXISTS + seed 成功
- id: T3
type: implementer
depends_on: [T2]
output: src/backend/src/lms/{students,courses,enrollments}.{service,controller}.ts + lms.module.ts
verification: 3 子模块 6 文件 + module 注册到 app.module.ts
- id: T4
type: tester
depends_on: [T3]
output: tests/e2e/dth_lms.test.sh(4 case 对应 S1-S4)
verification: 4/4 pass
- id: T5
type: qa
depends_on: [T4]
output: PROJECT_ROOT=. bash openspec/scripts/check_spec_coverage.sh
verification: stdout PASS gap=0
@@ -0,0 +1,21 @@
# spec: lms@chg_0006
scenarios:
- id: S1
cases: [C1_list_students_has_seeded]
- id: S2
cases: [C2_create_and_get_student]
- id: S3
cases: [C3_list_courses_has_seeded]
- id: S4
cases: [C4_enroll_student_to_course]
- id: all
cases: [C5_test_runner_passes_all, C6_check_spec_coverage_gap_zero]
gate:
blocking_gap_tolerance: 0
implementation_files:
- src/backend/src/lms/
- src/backend/src/common/pglite/init.ts
- tests/e2e/dth_lms.test.sh
test_files:
- tests/e2e/
@@ -0,0 +1,64 @@
---
change_id: chg_0006
owner: qa@dth
status: draft
spec_ref: spec.md
---
# Testcases
## Cases
### C1_list_students_has_seeded
- Scenario: S1
- Type: integration
- Priority: P0
- Given: admin token
- When: GET /api/ssw/dth/lms/students
- Then: data 数组长度 ≥ 2;每项含 id/student_no/name/email/created_at
- Bound Task: T4
### C2_create_and_get_student
- Scenario: S2
- Type: integration
- Priority: P0
- Given: admin token
- When: POST /api/ssw/dth/lms/students body={"student_no":"S2026001","name":"张三","email":"zhangsan@school.edu"}
- Then: data.id 匹配 UUID 正则;GET /students/:id 的 data.name == "张三"
- Bound Task: T4
### C3_list_courses_has_seeded
- Scenario: S3
- Type: integration
- Priority: P0
- Given: admin token
- When: GET /api/ssw/dth/lms/courses
- Then: data 数组长度 ≥ 2;每项含 id/code/name/credits/instructor/created_at
- Bound Task: T4
### C4_enroll_student_to_course
- Scenario: S4
- Type: integration
- Priority: P0
- Given: admin token + 1 个 seed student id + 1 个 seed course id
- When: POST /courses/:courseId/enroll body={"student_id":"<student id>"}
- Then: code = 200;GET /students/:studentId/enrollments 长度 ≥ 1 含 course_id
- Bound Task: T4
### C5_test_runner_passes_all
- Scenario: all
- Type: e2e
- Priority: P0
- Given: 后端运行
- When: bash tests/e2e/dth_lms.test.sh
- Then: exit 0
- Bound Task: T4
### C6_check_spec_coverage_gap_zero
- Scenario: all
- Type: e2e
- Priority: P0
- Given: chg 工件齐备
- When: PROJECT_ROOT=. bash openspec/scripts/check_spec_coverage.sh
- Then: stdout PASS gap=0
- Bound Task: T5