Files
Xboard/.helloagents/plans/202604242236_admin-frontend-user-more-actions/plan.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.2 KiB

admin-frontend 用户管理更多操作复刻 — 实施规划

目标与范围

  • 把用户管理行级“更多操作”从当前的基础维护菜单升级为更完整的运营工作台菜单。
  • 以“复用现有抽屉 / 弹窗 / 页面”为主,不重复造轮子。

架构与实现策略

  • 用户页继续以 UsersView.vue + useUsersManagement.ts 为主入口。
  • 新增 useUserScopedActions.ts 负责:
    • 用户页作用域跳转
    • 订单分配抽屉预填
    • 流量记录弹窗状态
    • 邀请结果视图的路由筛选
    • 用户流量重置调用
  • 复用组件策略:
    • OrderAssignDrawer.vue:支持预填邮箱
    • TrafficLogDialog.vue:直接挂到用户页
    • OrdersView.vue:读取路由 query 并自动追加用户过滤
  • 后端优先复用现有 traffic-reset/reset-user,避免再开新接口。

完成定义

  • 用户页“更多操作”菜单补齐目标操作项,并按截图相近顺序展示。
  • 分配订单 可直接打开抽屉,邮箱已回填。
  • TA的订单 可跳转到 #/subscriptions/orders,并自动按 user_id 过滤。
  • TA的邀请 可在用户页自动切换到“当前用户邀请结果”视图,并允许一键清除。
  • TA的流量记录 可打开流量日志弹窗。
  • 重置流量 可调用真实后端接口并在成功后刷新用户列表。

风险与验证

  • 风险 1:用户页与订单页的跨页筛选若无可见提示,容易造成理解偏差,因此需要补齐筛选提示与清除入口。
  • 风险 2:用户更多操作继续堆进 useUsersManagement.ts 容易过大,因此拆分 useUserScopedActions.ts
  • 风险 3:重置流量若重新发明接口会增加回归面,因此优先复用 traffic-reset/reset-user
  • 验证方式:
    • npm run build
    • 代码自检:用户菜单完整性、订单页 query 过滤、流量重置调用链、邀请筛选可清除

决策记录

  • [2026-04-24] 分配订单 直接复用现有订单分配抽屉,并通过 prop 预填用户邮箱。
  • [2026-04-24] TA的订单 采用跳页 + 自动过滤,而不是在用户页内塞第二套订单列表。
  • [2026-04-24] TA的邀请 在当前用户页复用筛选结果视图,不额外新建邀请独立页面。