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

# V1.2 Task 3：六项详情范围收口报告

## 结论

**PARTIAL**。已新增统一详情入口 `GET /api/v1/operator/workbench/details/{type}`，服务端从认证主体推导 `SELF`、`TEAM`、`ALL` 范围，禁止请求参数替代主体或组织，并复用已发布资料条件和工作台状态口径。

## 已完成

- 支持 `review`、`matchmaker`、`counseling`、`appointment`、`match`、`activity` 六类详情。
- 普通红娘仅本人有效对象，组长仅本组织，管理员为全平台。
- 详情接口只接受类型、页码和页大小，不接受 `userId`、`matchmakerId`、`teamId`、`scope`。
- 未发布资料版本不进入详情统计。
- 无权限返回 `403`，组长无组织返回组织范围拒绝。
- 不返回身份证原始佐证、完整手机号或咨询备注正文。

## 当前限制

- 原有模块详情接口尚未全部迁移到统一入口，旧路由仍需逐步收敛。
- 本轮使用本机 PostgreSQL/Redis 活栈完成 SELF/TEAM/ALL 登录和六类详情路由验收；正式发布仍需在干净环境复验。
- 当前自动化已验证接口可用和范围推导，浏览器卡片点击与详情页面联调仍待执行。

## 验证

- `mvn -B -f backend/pom.xml -s backend/maven-settings.xml -DskipTests compile`：通过。
- `$env:E2E_OPERATOR_USERNAME='demo_admin'; $env:E2E_ADMIN_PASSWORD='demo123'; $env:E2E_OPERATOR_PASSWORD='demo123'; python -m pytest tests/e2e/v12_permission_scope_dashboard_test.py -q`：7 passed。