# 变更审计记录：租户后台申请列表店铺筛选 + admin-web 简写ID修复

| 字段 | 值 |
|------|-----|
| 日期 | 2026-03-23 15:28:46 |
| Prompt-ID | P20260323-035935 |
| Session-ID | 82529bc6 |
| Session 路径 | docs/audit/session_logs/2026-03/23/08_c5d88922_035934 |

## 操作摘要

延续 Task 3（admin-web 简写ID不显示 + tenant-admin 申请列表无店铺筛选）的修复工作。本次对话主要完成：
1. `tenant_users.py` 的 `list_applications` 新增 `site_id` 可选查询参数，支持前端按单个店铺过滤申请
2. 新增 `GET /api/tenant/my-sites` 端点，返回当前管理员管辖的店铺列表（供前端筛选下拉）
3. `apps/tenant-admin/src/pages/UserApproval/index.tsx` 前端添加店铺下拉选择器

## 本次对话文件变更

### 新增文件
- `docs/audit/prompt_logs/prompt_log_20260323_035935.md`
- `docs/audit/session_logs/2026-03/23/07_a91afafa_032840/main_01_4d3ec003.md`
- `docs/audit/session_logs/2026-03/23/07_a91afafa_032840/sub_01_4d3ec003.md`
- `docs/audit/session_logs/_system_prompts/sp_399e656a.md`

### 修改文件
- `apps/backend/app/routers/tenant_users.py`
- `apps/tenant-admin/src/pages/UserApproval/index.tsx`
- `NeoZQYY.code-workspace`

### 删除文件
- `docs/audit/session_logs/2026-03/23/07_a91afafa_032840/main_01_7177376b.md`

## 改动注解

### `apps/backend/app/routers/tenant_users.py`
- 变更类型：修改
- 原始原因：租户管理后台申请列表缺少按店铺筛选功能，管理员管辖多个门店时无法快速定位特定门店的申请。同时需要提供管辖店铺列表 API 供前端下拉选择器使用。
- 思路分析：新增 `GET /api/tenant/my-sites` 端点，从 `biz.sites` 表查询管理员 `managed_site_ids` 对应的活跃店铺信息。`list_applications` 新增可选 `site_id` 查询参数，指定时先通过 `verify_site_access` 验证权限再精确过滤；未指定时保持原有 `managed_site_ids` 全量过滤逻辑。
- 修改结果：租户管理员可按单个店铺筛选申请列表，前端获得管辖店铺下拉数据源。与 `tenant_admins.py` 的 `verify_site_access` / `site_filter_clause` 工具函数配合，权限控制一致。

### `apps/tenant-admin/src/pages/UserApproval/index.tsx`
- 变更类型：修改
- 原始原因：前端申请列表页面只有 status 筛选，缺少店铺筛选下拉。
- 思路分析：调用新增的 `/api/tenant/my-sites` 获取管辖店铺列表，在筛选栏添加店铺下拉选择器，选择后将 `site_id` 参数传递给 `GET /api/tenant/applications`。
- 修改结果：租户管理员可在申请列表页面按店铺+状态组合筛选，提升多门店管理效率。

### `NeoZQYY.code-workspace`
- 变更类型：修改（非高风险，简要注解）
- workspace 配置调整

## 合规检查

### 文档同步
- ⚠️ `apps/backend/app/routers/tenant_users.py` 变更后 `apps/backend/docs/API-REFERENCE.md` 和 `docs/contracts/openapi/backend-api.json` 需同步更新
- 新增端点 `GET /api/tenant/my-sites` 和 `list_applications` 的 `site_id` 参数需补充到 API 文档

### OpenAPI Spec
- ⚠️ 接口代码已变更但 OpenAPI spec 未同步，需运行 `python scripts/ops/_export_openapi.py` 重新导出

### DDL/迁移
- 无新增迁移 SQL
- DDL 基线未更新（⚠️ DDL 基线待合并）

### DB 文档
- 本次无数据库结构变更，BD 手册无需更新

---

<!-- AI_CHANGELOG
| 日期 | Prompt | 变更 |
|------|--------|------|
| 2026-03-23 15:28:46 | 租户后台申请列表店铺筛选 | tenant_users.py 新增 my-sites 端点 + list_applications 增加 site_id 筛选；tenant-admin 前端添加店铺下拉选择器 |
-->
