docs: record dashboard detail scope gap

2026-10-25 08:56:36 +08:00
parent 88f4176e60
commit 34b9ea1169
1 changed files with 30 additions and 0 deletions
@@ -0,0 +1,30 @@
+# 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`：统计接口独立查询，未接工作台认证主体范围。