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

41 lines
2.2 KiB
Markdown

# 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的邀请` 在当前用户页复用筛选结果视图,不额外新建邀请独立页面。