docs(api): 修订并冻结API Contract V1.0.1
This commit is contained in:
1 parent
67543e0422
commit
4873e5f555
7 files changed
+108
-20
No files matched your search
@@ -107,15 +107,15 @@ flowchart LR
|
||||
|
||||
## 5. 一期规模与核心指标统计 (Review Round 1)
|
||||
|
||||
- **一期 API 总数:** 91 个
|
||||
- **P0 优先级 (核心闭环必须实现):** 49 个
|
||||
- **P1 优先级 (辅助支撑能力):** 40 个
|
||||
- **一期 API 总数:** 89 个 (以正文真实定义的 HTTP Method + Path 物理 Endpoint 为准)
|
||||
- **P0 优先级 (核心闭环必须实现):** 53 个
|
||||
- **P1 优先级 (辅助支撑能力):** 34 个
|
||||
- **P2 优先级 (依赖现场确认/延后):** 2 个
|
||||
- **模块分布统计:**
|
||||
- **Module A (人员与基础资源):** 38 个 (P0: 16, P1: 22, P2: 0)
|
||||
- **Module B (开班计划与排课):** 25 个 (P0: 17, P1: 7, P2: 1)
|
||||
- **Module A (人员与基础资源):** 38 个 (P0: 20, P1: 18, P2: 0)
|
||||
- **Module B (开班计划与排课):** 24 个 (P0: 17, P1: 6, P2: 1)
|
||||
- **Module C (住宿/门禁/考勤):** 13 个 (P0: 9, P1: 4, P2: 0)
|
||||
- **Module D (成绩/学习/统计/画像):** 15 个 (P0: 7, P1: 7, P2: 1)
|
||||
- **Module D (成绩/学习/统计/画像):** 14 个 (P0: 7, P1: 6, P2: 1)
|
||||
- **外部 Adapter 接口数量:** 3 个 (`FaceAttendanceAdapter`, `DoorAccessAdapter`, `ExternalLearningAdapter`)
|
||||
- **核心业务 Command API 数量:** 24 个 (包含 P0 核心 Command API 20 个 [19 个核心业务流程 Command + 1 个 P0 计划管理更新: `PUT /train/plans/{planId}`], P1 辅助 Command 4 个)
|
||||
- **核心聚合 VO 数量:** 8 个
|
||||
@@ -131,9 +131,9 @@ flowchart LR
|
||||
|
||||
为确保后续 Issue 拆分与开发聚焦于最小可用的完整培训业务闭环,特设立 **Phase 1 Minimal Contract** 视图。后续开发阶段将首先按此基线开展编码与单元测试:
|
||||
|
||||
### 6.1 P0 API 规模概览 (共 49 个)
|
||||
- **Module A (16个):** 教师列表/详情/增/改;学员列表/详情/录入;课程列表/详情/新增;教室列表/详情/新增;场地列表/详情/新增;宿舍列表/详情/新增/选项。
|
||||
- **Module B (17个):** 计划列表/增/查/改/完成/工作台;本期课程列表/增;参训名单列表/单增/批量导入/详情;新增课次/修改课次/课次详情/冲突预检/完整课表;报到确认。
|
||||
### 6.1 P0 API 规模概览 (共 53 个)
|
||||
- **Module A (20个):** 教师列表/详情/增/改;学员列表/详情/录入;课程列表/详情/新增;教室列表/详情/新增;场地列表/详情/新增;宿舍列表/详情/新增/选项。
|
||||
- **Module B (17个):** 计划列表/增/查/改/完成/工作台;本期课程列表/增;参训名单列表/单增/批量导入/详情;新增课次/修改课次/冲突预检/完整课表;报到确认。
|
||||
- **Module C (9个):** 批量预分配宿舍/单人调房/走读设置/住宿列表;门禁同步重试;签到/签退/人工修正/课次考勤名单。
|
||||
- **Module D (7个):** 成绩项目列表/权重配置;录入成绩;成绩台账大表/学员成绩单;学习记录接收;计划统计概览。
|
||||
|
||||
|
||||
Reference in new issue
Block a user