merge sandbox/f0cf2f4: chg_0006 LMS bootstrap (3 子系统 + 5 S 场景 + 6 cases)
Co-Authored-By: Claude Code <[email protected]>
This commit is contained in:
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
|
||||
Reference in new issue
Block a user