xiner/Edu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(student-portal): contract.md + workline.md 过时待仲裁标注全部更新为已裁决 ARB-019

Browse Source
This commit is contained in:
SpecialX
2026-07-13 10:28:55 +08:00
parent d1db3dfdee
commit 58d0c4758c
2 changed files with 17 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
docs/architecture/issues/worklines/student-portal_workline.md
View File

@@ -111,12 +111,12 @@ gantt
- **作业提交页**（`/my-homework/[id]/submit`）：
- 消费 `submitHomework` mutation
- 乐观更新（useMutation onMutate 回滚 + invalidateQueries）
- 附件上传（待 ISSUE-014-05 仲裁后实现，暂走 mock）
- 附件上传（ARB-019 §21.5 方案 A 已裁决，暂走 mock）
- **我的成绩页**（`/my-grades`）：消费 `myGrades` query，成绩列表 + 趋势图
- **我的考勤页**（`/my-attendance`）：消费 `myAttendance` query，考勤日历
- **依赖**：
- student-bff GraphQL schema（ai04 P3，`packages/shared-ts/contracts/graphql/student-bff.graphql`，待 ISSUE-014-02 仲裁）
- api-gateway 路由（ai01 P3，`/api/v1/student/*` 反向代理 student-bff，待 ISSUE-014-01 仲裁）
- student-bff GraphQL schema（ai04 P3，`packages/shared-ts/contracts/graphql/student-bff.graphql`，ARB-019 §21 已裁决）
- api-gateway 路由（ai01 P3，`/api/v1/student/*` 反向代理 student-bff，ARB-019 §21 已裁决）
- core-edu gRPC（ai08 P3，提供 ExamService/HomeworkService/GradeService/AttendanceService/ClassService）
- iam gRPC（ai06 P2，GetUserInfo + GetEffectivePermissions + GetViewports）
- data-ana gRPC（ai11 P4，但 studentDashboard 聚合需要，P3 用 mock）
@@ -205,7 +205,7 @@ gantt
| teacher-portal MF Shell（ai13 P2） | exposes AppShell/GraphQLProvider/useGraphQLClient/useAuth/usePermission + shared singleton | P2 启动 | ⏳ 待 ai13 P2 |
| api-gateway HTTP :8080（ai01 P3） | `/api/v1/student/*` 反向代理 student-bff 可用 | P3 启动 | ⏳ 待 ai01 P3 |
| student-bff GraphQL（ai04 P3） | `POST /graphql` :3009 + 核心 Query/Mutation 可执行 | P3 启动 | ⏳ 待 ai04 P3 |
| student-bff GraphQL schema（ai04 + ISSUE-014-02 仲裁） | `packages/shared-ts/contracts/graphql/student-bff.graphql` 创建 | P3 启动 | ⏳ 待仲裁 |
| student-bff GraphQL schema（ai04 + ISSUE-014-02 仲裁） | `packages/shared-ts/contracts/graphql/student-bff.graphql` 创建 | P3 启动 | ✅ 已裁决（ARB-019） |
| core-edu gRPC 50053（ai08 P3） | ExamService/HomeworkService/GradeService/AttendanceService/ClassService 全部 RPC | P3 启动 | ⏳ 待 ai08 P3 |
| iam gRPC 50052（ai06 P2） | GetUserInfo + GetEffectivePermissions + GetViewports | P3 启动 | ⏳ 待 ai06 P2 |
| student-bff content/data-ana 扩展（ai04 P4） | learningPath/myWeakness/myTrend/textbooks/chapters query 可用 | P4 启动 | ⏳ 待 ai04 P4 |
@@ -291,13 +291,15 @@ gantt
| 6 | §12.3 契约表更新 | WebSocket 事件名已裁决 |
| 7 | §11.1 假设 6 更新 | 事件名已由 ARB-019 §21.6 裁决确认 |
| 8 | §20.5 技术债务表更新 | WebSocket 事件名已裁决 |
| 9 | contract.md 过时"待仲裁"标注更新 | 10 处"待 ISSUE-014-XX 仲裁"更新为"已裁决 ARB-019 §XX" |
| 10 | workline.md 过时"待仲裁"标注更新 | 4 处"待仲裁"更新为"已裁决 ARB-019" |
### §8.3 当前阶段状态
- **文档阶段**：✅ 完成（01-understanding + 02-architecture-design + contract + workline + issue 全部对齐 ARB-019 裁决）
- **代码实现阶段**：✅ 已完成（通过 `606acb6` 合并到 main，包含 P2-P6 全部代码）
- **集成测试阶段**：✅ 已完成（通过 `61d8249` + `a6b0c54` 修复全部集成测试 bug）
- **待办**：无未完成的架构工作项
- **待办**：无未完成的架构工作项（contract.md + workline.md + 02-architecture-design.md 全部对齐 ARB-019 裁决）
---