Admin 测试需求
前缀 ADM-REQ。依赖 Backend P0（Admin 登录、种子数据）。
角色
仅 AdminUser（admin_users.is_active=true）。非管理员不可进入后台。
P0
| ID |
描述 |
验收（Given-When-Then） |
| ADM-REQ-001 |
登录成功进仪表盘 |
Given 有效管理员；When 短信登录；Then 进入 /admin/dashboard 且侧栏可见 |
| ADM-REQ-002 |
未登录拦截 |
Given 无 token；When 访问 /admin/users；Then 跳转 /login |
| ADM-REQ-010 |
产品树维护 |
When 创建大类与子类并启用；Then 列表可见；Canvas catalog 可见（联调） |
| ADM-REQ-011 |
面料关联 |
When 为子类批量挂材质；Then 子类面料接口返回一致（虚拟影棚等） |
| ADM-REQ-012 |
模板风格维护 |
When 在品类下创建/启停风格（/admin/product-styles）；Then 列表可见；Canvas catalog/styles 可见启用项 |
| ADM-REQ-020 |
主图/详情风格模板 CRUD |
When 在「主图/详情风格模板」页按品类×风格创建模板套、写入 product_category_ids/style_ids、上传子图（可设封面）；Then C 端 list/match 可命中；同风格可多套 |
| ADM-REQ-021 |
Word 导入（风格链路） |
When 上传合法 docx 并指定品类+风格（可选目标套）；Then 会话与提示词列表展示，图片入对应模板 |
| ADM-REQ-030 |
模型池配置 |
When 创建池并添加成员权重；Then 保存后列表/health 正常 |
| ADM-REQ-040 |
用户启停 |
When 禁用用户；Then 该用户 Canvas 登录失败或业务拒绝 |
| ADM-REQ-050 |
方案上下架 |
When 停售方案；Then C 端 plans 列表不出现 |
| ADM-REQ-051 |
提现审批 |
When 审批通过 pending 提现；Then 状态变为 approved，代理余额变化符合后端 |
| ADM-REQ-052 |
订单退款 |
When 对已支付订单退款；Then 订单 refunded，列表展示 |
P1
| ID |
描述 |
验收 |
| ADM-REQ-060 |
Prompt 测试 |
预览拼装成功；测试生图后历史可查 |
| ADM-REQ-061 |
任务取消/重试 |
对 processing/failed 任务操作后状态更新 |
| ADM-REQ-062 |
Banner/功能卡 |
配置后 Canvas 首页（若读取）展示变化 |
| ADM-REQ-063 |
分账结算 |
勾选 pending 记录 settle 后状态 settled |
| ADM-REQ-064 |
收入看板 |
revenue 页图表有数据或空态友好 |
非功能
| ID |
描述 |
| ADM-REQ-070 |
列表分页/筛选可用；错误 Toast 中文可读 |
| ADM-REQ-071 |
关键写操作有确认；刷新后数据仍在（已落库） |
近期新增需求（计费运营 / 体验）
| ID |
描述 |
验收 |
| ADM-REQ-065 |
月结关账页 |
「关账月份」（操作目标）与「列表筛选（结算月）」（查询条件）区别清晰；关账成功后筛选自动切到该月；重复关账不双加 |
| ADM-REQ-066 |
日终对账页 |
「运行日」（触发对账）与「列表筛选（业务日）」区别清晰；批次列表显示绿灯/红灯差异 |
| ADM-REQ-067 |
提现审核 |
列表支持手机号筛选（按钮/Enter 触发，非边输边查）；无单时提示去代理端申请 |
| ADM-REQ-068 |
中文日期/月份组件 |
用户计费各页日期筛选统一中文日期（ChineseDateInput）；月结用中文月份（ChineseMonthInput） |
| ADM-REQ-069 |
二级代理管理 |
代理商页支持提拔二级；分账规则支持一级/二级档位（agent_level） |
| ADM-REQ-070b |
单户对账回放 |
传手机号回放用户/代理账本；结果用主题色 + 手机/名称展示 |
| ADM-REQ-070c |
收入看板日期 |
默认今天；支持中文日期区间查询 |
数据前置
make seed 管理员账号、示例产品树、至少 1 个会员方案与 1 个代理提现样本（或测试中手工创建）。