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

31 lines
1.9 KiB
Markdown
Raw Normal View History

2026-10-25 08:56:36 +08:00
# 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`:统计接口独立查询,未接工作台认证主体范围。