Files
Xboard/.helloagents/plans/202604242236_admin-frontend-user-more-actions/requirements.md
T
yinjianm d4168720ac feat(admin-frontend): 补齐用户节点与订单运营工作台
新增用户高级筛选、批量操作与更多行级动作,支持邮件、
CSV、封禁恢复、订单分配、邀请查看、流量记录与重置流量

增强节点管理页的分页、父子筛选、跨页勾选、批量修改与
单节点置顶,并补齐后端批量更新 host、group_ids、rate

修复订单佣金状态误判问题,新增真实佣金筛选与行级确认,
同时优化仪表盘排行悬浮详情展示

补充 admin-frontend 独立 Dockerfile、Caddy 配置与 GHCR
发布工作流,支持通过独立镜像部署管理前端
2026-04-24 23:15:48 +08:00

2.1 KiB

admin-frontend 用户管理更多操作复刻 — 需求

确认后冻结,执行阶段不可修改。如需变更必须回到设计阶段重新确认。

核心目标

  • admin-frontend 的用户管理“更多操作”菜单中,继续复刻旧后台的用户级操作项。
  • 本轮目标菜单项包括:
    • 编辑
    • 分配订单
    • 复制订阅 URL
    • 重置 UUID 及订阅 URL
    • TA 的订单
    • TA 的邀请
    • TA 的流量记录
    • 重置流量
    • 删除

功能边界

  • 分配订单 必须直接在用户页打开可用的订单分配抽屉,并预填当前用户邮箱。
  • TA的订单 必须跳转到订单管理页,并自动按当前用户过滤订单。
  • TA的邀请 必须进入“邀请了哪些用户”的结果视图,不接受只弹提示。
  • TA的流量记录 必须直接打开现有流量记录弹窗。
  • 重置流量 必须调用真实后端链路,不接受只在前端重置显示值。
  • 保留本轮上一阶段已交付的高级筛选与批量操作能力,不得回退。

非目标

  • 本轮不重做用户管理整体布局。
  • 本轮不新增完整“邀请管理”独立页面,只需要让“TA的邀请”形成可用结果视图。
  • 本轮不重构订单管理与流量日志页面主体结构,只做最小必要联动。

技术约束

  • 技术栈固定为 Vue 3 + TypeScript + Vite + Element Plus
  • 前端改动集中在 admin-frontend/src/views/users/*、必要的订单页联动与 API 封装。
  • 流量重置优先复用现有后端 traffic-reset/reset-user 能力,不重复发明新接口。
  • 视觉继续遵循 apple/DESIGN.md.helloagents/DESIGN.md

质量要求

  • “更多操作”菜单的文案顺序与操作节奏尽量贴近用户截图。
  • 用户点击某项操作后,必须形成明确结果:打开抽屉 / 打开弹窗 / 跳转并带筛选 / 成功提示。
  • 订单页与用户页的联动筛选必须可见、可清除,不能让用户陷入“看不出为什么被过滤”的状态。
  • 最终至少完成一次 admin-frontend 构建验证,并同步知识库与验收证据。