Files
danyang-match/docs/Phase-V12-Task3-Detail-Scope-Completion-Report.md
T

31 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# V1.2 Task 3:六项详情范围收口报告
## 结论
**NOT_IMPLEMENTED**。当前仓库只有工作台聚合接口 `GET /api/v1/operator/workbench/dashboard`,没有统一的六项详情聚合路由或 `MatchmakerDashboardMapper`,也没有可复用的六项详情 scope builder。审核、咨询、预约、活动和统计模块各自的列表/详情接口仍由模块服务维护,不能据此宣称六项卡片与详情已使用同一范围查询。
## 本次完成
- 已盘点工作台控制器、审核、咨询、预约、活动和 analytics 路由/服务,确认不存在统一详情入口。
- 已确认现有聚合服务内部有 `SELF`/`TEAM`/`ALL` 解析,但该解析为私有实现,未被详情查询复用。
## 未完成与风险
- 六类详情接口尚未统一:请求仍可能进入各模块自己的列表/详情查询;跨组织拒绝、分页/时间筛选、聚合与详情一致性尚未形成单一服务端实现。
- 敏感佐证和咨询备注的独立权限仍由原模块控制,本任务未扩大其权限。
## 建议后续实现
- 新增统一 `MatchmakerDashboardMapper` 与服务端 scope builder,详情接口只接收分页和时间筛选。
- 让六项卡片与详情共用状态谓词、已发布资料条件和 `SELF`/`TEAM`/`ALL` 条件。
- 将敏感佐证、咨询备注继续留在各自权限与审计链路,不能由工作台详情隐式放开。
## 盘点依据
- `MatchmakerWorkbenchController`:仅 `GET /operator/workbench/dashboard`。
- `ReviewController`:`/operator/reviews/pending`、`/{taskId}` 独立查询。
- `CounselingController`:`/services/operator/queue`、`/assigned`、`/{id}` 独立查询。
- `ServiceAppointmentController`:`/operator/list` 独立查询。
- `ActivityOperatorController`:活动和报名列表独立查询。
- `AnalyticsController`:统计接口独立查询,未接工作台认证主体范围。