From c64badfc23eb8660c7a61838febf70105bdf143d Mon Sep 17 00:00:00 2001 From: yinjianm Date: Sat, 25 Apr 2026 00:59:08 +0800 Subject: [PATCH] =?UTF-8?q?feat(admin-frontend):=20=E8=A1=A5=E9=BD=90?= =?UTF-8?q?=E6=B4=BB=E8=B7=83=E7=AD=9B=E9=80=89=E4=B8=8E=E6=94=AF=E4=BB=98?= =?UTF-8?q?=E5=BF=AB=E7=85=A7=E8=83=BD=E5=8A=9B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增用户管理“活跃状态”高级筛选，并在后端支持 activity_status 复合规则，支持按活跃与非活跃筛选用户。 补齐订单支付成功快照落库与后台展示，保存支付渠道、 支付方法、实付金额和支付 IP，并在订单详情中优先展示。 同时增强节点页在线/离线筛选与批量删除、仪表盘快捷入口， 并修复已关闭工单再次回复后自动重开的统一语义。 附带同步测试、迁移、CI 工作流命名及知识库记录 --- .github/workflows/docker-publish.yml | 11 +- .helloagents/.ralph-breaker.json | 4 +- .helloagents/CHANGELOG.md | 49 +++++++ .helloagents/INDEX.md | 7 +- .../.status.json | 1 + .../proposal.md | 104 +++++++++++++++ .../tasks.md | 56 ++++++++ .../.status.json | 11 ++ .../contract.json | 47 +++++++ .../proposal.md | 88 +++++++++++++ .../tasks.md | 44 +++++++ .helloagents/archive/_index.md | 4 + .helloagents/context.md | 5 +- .helloagents/modules/_index.md | 3 +- .helloagents/modules/admin-frontend.md | 9 +- .helloagents/modules/order-payment.md | 27 ++++ .../.status.json | 11 ++ .../contract.json | 52 ++++++++ .../proposal.md | 99 ++++++++++++++ .../tasks.md | 45 +++++++ .../.status.json | 11 ++ .../contract.json | 43 ++++++ .../proposal.md | 86 ++++++++++++ .../tasks.md | 45 +++++++ .../.status.json | 11 ++ .../contract.json | 46 +++++++ .../proposal.md | 83 ++++++++++++ .../tasks.md | 43 ++++++ ...6-04-24T07-44-44-846Z-unknown-e3upr9.jsonl | 1 + ...26-04-24T08-15-56-367Z-claude-u7aa37.jsonl | 1 + .helloagents/sessions/master/default/STATE.md | 20 +-- admin-frontend/src/api/admin.ts | 4 + admin-frontend/src/types/api.d.ts | 12 ++ admin-frontend/src/utils/nodes.ts | 12 ++ admin-frontend/src/utils/orders.ts | 33 +++++ admin-frontend/src/utils/users.ts | 20 ++- .../src/views/dashboard/DashboardView.vue | 122 ++++++++++++++++-- admin-frontend/src/views/nodes/NodesView.vue | 101 ++++++++++++--- .../views/subscriptions/OrderDetailDrawer.vue | 64 ++++++++- .../src/views/subscriptions/OrdersView.vue | 78 ++++++++++- .../views/tickets/TicketWorkspaceDialog.vue | 13 +- .../src/views/tickets/TicketsView.vue | 78 +++++++++++ .../views/users/UserAdvancedFilterDialog.vue | 14 ++ .../V1/Guest/PaymentController.php | 15 ++- .../Controllers/V1/User/TicketController.php | 3 - .../Controllers/V2/Admin/OrderController.php | 2 +- .../Controllers/V2/Admin/UserController.php | 62 +++++++++ app/Models/Order.php | 7 +- app/Services/OrderService.php | 80 +++++++++++- app/Services/TicketService.php | 24 +++- ...ment_snapshot_fields_to_v2_order_table.php | 36 ++++++ plugins/TokenPay/Plugin.php | 27 ++++ ...UserControllerActivityStatusFilterTest.php | 77 +++++++++++ .../OrderServicePaymentSnapshotTest.php | 92 +++++++++++++ tests/Unit/TicketServiceReplyStateTest.php | 51 ++++++++ 55 files changed, 2023 insertions(+), 71 deletions(-) create mode 100644 .helloagents/archive/2026-04/202604250002_order-payment-snapshot/.status.json create mode 100644 .helloagents/archive/2026-04/202604250002_order-payment-snapshot/proposal.md create mode 100644 .helloagents/archive/2026-04/202604250002_order-payment-snapshot/tasks.md create mode 100644 .helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/.status.json create mode 100644 .helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/contract.json create mode 100644 .helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/proposal.md create mode 100644 .helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/tasks.md create mode 100644 .helloagents/modules/order-payment.md create mode 100644 .helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/.status.json create mode 100644 .helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/contract.json create mode 100644 .helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/proposal.md create mode 100644 .helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/tasks.md create mode 100644 .helloagents/plan/202604250006_ticket-closed-reply-reopen/.status.json create mode 100644 .helloagents/plan/202604250006_ticket-closed-reply-reopen/contract.json create mode 100644 .helloagents/plan/202604250006_ticket-closed-reply-reopen/proposal.md create mode 100644 .helloagents/plan/202604250006_ticket-closed-reply-reopen/tasks.md create mode 100644 .helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/.status.json create mode 100644 .helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/contract.json create mode 100644 .helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/proposal.md create mode 100644 .helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/tasks.md create mode 100644 database/migrations/2026_04_25_000200_add_payment_snapshot_fields_to_v2_order_table.php create mode 100644 tests/Unit/Admin/UserControllerActivityStatusFilterTest.php create mode 100644 tests/Unit/Orders/OrderServicePaymentSnapshotTest.php create mode 100644 tests/Unit/TicketServiceReplyStateTest.php diff --git a/.github/workflows/docker-publish.yml b/.github/workflows/docker-publish.yml index cd40988..7b8f2f7 100644 --- a/.github/workflows/docker-publish.yml +++ b/.github/workflows/docker-publish.yml @@ -1,12 +1,15 @@ -name: Docker Build and Publish +name: Backend Docker Build and Publish on: push: branches: ["master", "new-dev"] + paths-ignore: + - "admin-frontend/**" + - ".github/workflows/admin-frontend-docker-publish.yml" workflow_dispatch: concurrency: - group: docker-publish-${{ github.ref }} + group: backend-docker-publish-${{ github.ref }} cancel-in-progress: true env: @@ -75,8 +78,8 @@ jobs: context: . push: true platforms: linux/amd64,linux/arm64 - cache-from: type=gha,scope=docker-publish-${{ github.ref_name }} - cache-to: type=gha,mode=max,scope=docker-publish-${{ github.ref_name }} + cache-from: type=gha,scope=backend-docker-publish-${{ github.ref_name }} + cache-to: type=gha,mode=max,scope=backend-docker-publish-${{ github.ref_name }} tags: ${{ steps.meta.outputs.tags }} labels: ${{ steps.meta.outputs.labels }} build-args: | diff --git a/.helloagents/.ralph-breaker.json b/.helloagents/.ralph-breaker.json index 387a3f7..9c4f1e6 100644 --- a/.helloagents/.ralph-breaker.json +++ b/.helloagents/.ralph-breaker.json @@ -1,4 +1,4 @@ { - "consecutive_failures": 11, - "last_failure": "2026-04-24T15:13:24.613Z" + "consecutive_failures": 12, + "last_failure": "2026-04-24T15:49:44.925Z" } \ No newline at end of file diff --git a/.helloagents/CHANGELOG.md b/.helloagents/CHANGELOG.md index ef6fe97..e7be14a 100644 --- a/.helloagents/CHANGELOG.md +++ b/.helloagents/CHANGELOG.md @@ -1,5 +1,54 @@ # CHANGELOG +## [0.5.16] - 2026-04-25 + +### 新增 +- **[admin-frontend]**: 为用户管理高级筛选新增“活跃状态”条件，支持按“活跃 / 非活跃”筛选；后端 `user/fetch` 现可识别 `activity_status` 复合规则，并按“任意订阅 + 流量未用完 + 最后在线时间在半年内”为活跃标准返回结果 — by yinjianm + - 方案: [202604250018_admin-frontend-user-activity-status-filter](archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/) + - 决策: admin-frontend-user-activity-status-filter#D001(活跃判断入口固定在高级筛选弹窗), admin-frontend-user-activity-status-filter#D002(复合活跃规则统一由后端 activity_status 承接), admin-frontend-user-activity-status-filter#D003(全部状态继续由无条件表达) + +## [0.5.15] - 2026-04-25 + +### 新增 +- **[admin-frontend]**: 为节点管理工作台补齐“在线节点 / 离线节点”状态筛选，并新增针对已勾选节点的批量删除入口，接通真实 `server/manage/batchDelete` 后端链路；其中“离线节点”按本轮确认只筛显式离线状态，不包含待同步 / 已停用节点 — by yinjianm + - 方案: [202604250015_admin-frontend-node-status-filter-batch-delete](plan/202604250015_admin-frontend-node-status-filter-batch-delete/) + - 决策: admin-frontend-node-status-filter-batch-delete#D001(离线筛选仅匹配显式 offline 状态), admin-frontend-node-status-filter-batch-delete#D002(批量删除复用现有勾选工作流) + +## [0.5.14] - 2026-04-25 + +### 修复 +- **[order-payment]**: 补齐订单支付成功快照保存链路；现在会在支付成功后保存支付渠道、支付方法、实际支付金额与支付 IP，并在后台订单详情中集中展示平台订单号 / 商户订单号 / 支付快照信息 — by yinjianm + - 方案: [202604250002_order-payment-snapshot](archive/2026-04/202604250002_order-payment-snapshot/) + - 决策: order-payment-snapshot#D001(支付快照优先展示真实快照并回退当前支付配置), order-payment-snapshot#D002(实际支付金额统一按“分”存储) + +## [0.5.13] - 2026-04-25 + +### 修复 +- **[admin-frontend]**: 修复前后台已关闭工单无法再次回复的问题；现在用户与管理员再次回复 closed ticket 时都会自动重新开启工单，管理端工单工作台也补上“发送并重开”交互提示 — by yinjianm + - 方案: [202604250006_ticket-closed-reply-reopen](plan/202604250006_ticket-closed-reply-reopen/) + - 决策: ticket-closed-reply-reopen#D001(自动重开语义统一下沉到 TicketService::reply), ticket-closed-reply-reopen#D002(用户端优先通过后端语义修复打通), ticket-closed-reply-reopen#D003(管理端仅修复交互门禁) + +## [0.5.12] - 2026-04-25 + +### 新增 +- **[admin-frontend]**: 为仪表盘顶部指标卡补齐快捷入口增强；“待处理工单 / 待处理佣金 / 总用户”现在可直接进入对应工作台，其中工单页与订单页还会自动识别 dashboard 来源并落在目标视图 — by yinjianm + - 方案: [202604250002_admin-frontend-dashboard-shortcuts](plan/202604250002_admin-frontend-dashboard-shortcuts/) + - 决策: admin-frontend-dashboard-shortcuts#D001(仅开放已有明确承接页的指标卡快捷入口), admin-frontend-dashboard-shortcuts#D002(用路由查询同步 dashboard 入口上下文) + +## [0.5.11] - 2026-04-24 + +### 快速修改 +- **[admin-frontend]**: 修复节点管理页多选框点击后立即被程序化同步清空的问题；现在仅在分页切换时回填勾选状态，并在回填期间忽略内部 `selection-change` 事件，节点多选可正常选中与跨页恢复 — by yinjianm + - 类型: 快速修改（无方案包） + - 文件: admin-frontend/src/views/nodes/NodesView.vue:67,179-197,240-243,412-417 + +## [0.5.10] - 2026-04-24 + +### 快速修改 +- **[ci-workflows]**: 将后端镜像发布工作流显式命名为 `Backend Docker Build and Publish`，并对 `admin-frontend/**` 及其独立 workflow 启用 `paths-ignore`；现在仅修改 `admin-frontend` 源码时只触发前端镜像发布，不再误触发后端镜像发布 — by yinjianm + - 类型: 快速修改（无方案包） + - 文件: .github/workflows/docker-publish.yml:1-76 + ## [0.5.9] - 2026-04-24 ### 新增 diff --git a/.helloagents/INDEX.md b/.helloagents/INDEX.md index 489fc6a..792586c 100644 --- a/.helloagents/INDEX.md +++ b/.helloagents/INDEX.md @@ -3,19 +3,20 @@ ```yaml kb_version: 2 project: Xboard-new -updated_at: 2026-04-24 +updated_at: 2026-04-25 active_package: 无 ``` ## 项目概览 - 类型: PHP Laravel 主仓 + `admin-frontend` Vue3 管理端前端 -- 当前重点模块: `admin-frontend`、`subscription-protocols` -- 最新归档: `202604241703_admin-frontend-gift-card-management` +- 当前重点模块: `admin-frontend`、`order-payment`、`subscription-protocols` +- 最新归档: `202604250002_order-payment-snapshot` ## 活跃模块 - [admin-frontend](modules/admin-frontend.md): 管理端登录、主布局、仪表盘、用户/节点/订阅/系统管理与管理 API 前端封装 +- [order-payment](modules/order-payment.md): 订单支付成功快照、第三方回调元信息透传与后台支付成功信息展示 - [subscription-protocols](modules/subscription-protocols.md): 客户端订阅导出入口、协议适配器与版本兼容过滤 ## 归档与变更 diff --git a/.helloagents/archive/2026-04/202604250002_order-payment-snapshot/.status.json b/.helloagents/archive/2026-04/202604250002_order-payment-snapshot/.status.json new file mode 100644 index 0000000..bb24242 --- /dev/null +++ b/.helloagents/archive/2026-04/202604250002_order-payment-snapshot/.status.json @@ -0,0 +1 @@ +{"status":"completed","completed":5,"failed":0,"pending":0,"total":5,"done":5,"percent":100,"current":"已完成 order-payment-snapshot","updated_at":"2026-04-25 00:20:00"} diff --git a/.helloagents/archive/2026-04/202604250002_order-payment-snapshot/proposal.md b/.helloagents/archive/2026-04/202604250002_order-payment-snapshot/proposal.md new file mode 100644 index 0000000..6540cf7 --- /dev/null +++ b/.helloagents/archive/2026-04/202604250002_order-payment-snapshot/proposal.md @@ -0,0 +1,104 @@ +# 变更提案: order-payment-snapshot + +## 元信息 +```yaml +类型: 功能增强 +方案类型: implementation +优先级: P1 +状态: 执行中 +创建: 2026-04-25 +``` + +--- + +## 1. 需求 + +### 背景 +当前 `Xboard-new` 的订单支付链路在支付成功后仅稳定保留了 `payment_id`、`trade_no`、`callback_no` 与 `paid_at`，后台订单详情页也主要展示基础信息、金额拆解和佣金状态。用户本轮明确要求：订单支付成功后，应额外保存并展示支付渠道、支付方法，并在 `admin-frontend` 的订单详情中以“成功订单”样式补齐支付成功信息块，至少覆盖平台订单号、商户订单号、订单金额、实际支付金额、创建 / 完成时间、支付 IP 与订单状态等关键信息。 + +### 目标 +- 在后端订单模型中补齐支付成功快照字段，避免后续支付配置变更后后台无法追溯真实支付上下文。 +- 在支付回调成功时保存支付渠道、支付方法、实际支付金额与支付 IP，并继续兼容人工标记已支付链路。 +- 在 `admin-frontend` 订单详情抽屉中新增支付成功信息块，按 Apple 化后台风格集中展示支付渠道 / 方法与支付流水信息。 + +### 约束条件 +```yaml +范围约束: 本轮只补齐后台订单支付快照的保存与展示，不扩展到前台用户订单详情页 +技术约束: 延续 Laravel + Vue3 + TypeScript + Element Plus 现有实现，不新增第三方支付 SDK 或前端 UI 依赖 +兼容约束: 现有 `payment_id` / `callback_no` / `paid_at` 语义保持不变；支付插件回调字段缺失时必须优雅降级 +视觉约束: 订单详情延续 `.helloagents/DESIGN.md` 中 Apple 风格后台基线，不回退为厚重卡片堆叠 +``` + +### 验收标准 +- [ ] `v2_order` 新增支付快照字段后，支付成功时可保存支付渠道、支付方法、实际支付金额与支付 IP。 +- [ ] TokenPay 回调会优先写入真实回调里的平台单号 / 实付金额 / 支付 IP / 方法信息；缺失字段时后端使用合理回退值，不影响开通流程。 +- [ ] 管理端订单详情可展示支付渠道、支付方法、平台订单号、商户订单号、订单金额、实际支付金额、支付时间与支付 IP。 +- [ ] 订单详情 UI 仍保持现有黑色 Hero + 白色工作台的信息层级，不引入新的视觉体系。 +- [ ] 后端定向测试与 `admin-frontend` 构建验证通过。 + +--- + +## 2. 方案 + +### 技术方案 +1. 为 `v2_order` 增加支付快照字段，补齐模型注释与类型转换，确保支付成功后的快照能够稳定落库。 +2. 调整支付成功链路： + - `plugins/TokenPay/Plugin.php` 在回调验签成功后返回更完整的支付元信息。 + - `app/Http/Controllers/V1/Guest/PaymentController.php` 把支付回调元信息传入订单处理链路。 + - `app/Services/OrderService.php` 在 `paid()` 阶段统一写入支付快照，并兼容人工标记已支付与字段缺失场景。 +3. 调整后台订单详情： + - `app/Http/Controllers/V2/Admin/OrderController.php` 补载 `payment` 关系。 + - `admin-frontend/src/types/api.d.ts` 补齐订单支付快照类型。 + - `admin-frontend/src/views/subscriptions/OrderDetailDrawer.vue` 新增“支付成功信息”区块，按字段分组展示。 + +### 影响范围 +```yaml +涉及模块: + - app/Services + - app/Http/Controllers/V1/Guest + - app/Http/Controllers/V2/Admin + - app/Models + - plugins/TokenPay + - database/migrations + - admin-frontend/src/types + - admin-frontend/src/views/subscriptions +预计变更文件: 8-10 +``` + +### 风险评估 +| 风险 | 等级 | 应对 | +|------|------|------| +| 第三方支付回调字段命名不稳定，无法保证每个字段都存在 | 中 | 采用“真实回调优先 + 支付配置回退 + 空值兜底”策略，避免因快照缺失阻断支付 | +| 管理端订单详情新增字段后，旧订单历史数据为空 | 低 | UI 明确显示 `-`，仅对新成功订单逐步补齐 | +| 金额快照与现有“分”单位格式不一致 | 中 | 后端统一把回调金额规范为“分”存储，前端继续复用 `formatOrderAmount()` | + +--- + +## 3. 成果设计 + +### 设计方向 +- **美学基调**: Apple Admin Ledger。像运营后台里的“支付流水面板”，强调黑色首屏下的精确信息卡片与支付状态可追溯性。 +- **记忆点**: 在订单详情抽屉中新增一块“支付成功信息”面板，把支付渠道 / 方法与平台流水信息收束成一眼可读的成功订单摘要。 + +### 视觉要素 +- **配色**: 延续黑色 Hero、白色详情卡、蓝色强调与成功绿色状态点。 +- **布局**: 采用“标题说明 + 右侧状态徽章 + 双列信息网格”的后台信息卡结构，与现有基础信息 / 金额拆解区保持统一。 +- **状态**: 有支付快照时优先展示成功信息；历史订单缺字段时保留 `-` 占位，不制造伪数据。 + +--- + +## 4. 技术决策 + +### order-payment-snapshot#D001: 支付渠道与支付方法采用“快照字段 + 当前支付配置回退”双轨展示 +**日期**: 2026-04-25 +**状态**: ✅采纳 +**背景**: 仅依赖 `payment_id` 关联会受到后续支付配置改名影响，无法稳定反映订单成交当时的支付上下文。 +**决策**: 在订单表新增 `payment_channel / payment_method / payment_amount / payment_ip` 快照字段，并在详情页中优先展示快照，缺失时再回退到当前 `payment` 关联信息。 +**理由**: 既满足历史追溯，也兼容旧订单与人工处理场景。 + +### order-payment-snapshot#D002: 实际支付金额统一以“分”为单位入库 +**日期**: 2026-04-25 +**状态**: ✅采纳 +**背景**: 当前后台订单金额体系统一以“分”为真相源，前端已有 `formatOrderAmount()` 的统一格式化链路。 +**决策**: 支付回调里的实际支付金额在后端转换为整数“分”后入库。 +**理由**: 避免前后端引入第二套金额口径，复用现有订单金额展示与排序逻辑。 diff --git a/.helloagents/archive/2026-04/202604250002_order-payment-snapshot/tasks.md b/.helloagents/archive/2026-04/202604250002_order-payment-snapshot/tasks.md new file mode 100644 index 0000000..8f8d42b --- /dev/null +++ b/.helloagents/archive/2026-04/202604250002_order-payment-snapshot/tasks.md @@ -0,0 +1,56 @@ +# 任务清单: order-payment-snapshot + +> **@status:** completed | 2026-04-25 00:20 + +```yaml +@feature: order-payment-snapshot +@created: 2026-04-25 +@status: completed +@mode: R2 +``` + +## 进度概览 + +| 完成 | 失败 | 跳过 | 总数 | +|------|------|------|------| +| 5 | 0 | 0 | 5 | + +--- + +## 任务列表 + +### 1. 支付快照后端链路 + +- [√] 1.1 为 `v2_order` 新增支付快照字段，并补齐 `app/Models/Order.php` 的字段注释与类型转换 | depends_on: [] +- [√] 1.2 调整支付成功链路，在回调 / 标记已支付时保存支付渠道、支付方法、实付金额与支付 IP | depends_on: [1.1] + +### 2. 后台订单详情展示 + +- [√] 2.1 调整后台订单详情接口与前端类型声明，补齐 `payment` 关联和支付快照字段 | depends_on: [1.2] +- [√] 2.2 更新 `admin-frontend/src/views/subscriptions/OrderDetailDrawer.vue`，新增“支付成功信息”展示区块并保持现有 Apple 化后台风格 | depends_on: [2.1] + +### 3. 验证与知识库同步 + +- [√] 3.1 新增 / 运行后端定向测试与 `admin-frontend` 构建验证，并同步知识库文档与变更记录 | depends_on: [2.2] + +--- + +## 执行日志 + +| 时间 | 任务 | 状态 | 备注 | +|------|------|------|------| +| 2026-04-25 00:02 | 方案包初始化 | completed | 已确认按完整支付快照方案执行，目标是保存并展示支付渠道 / 方法 / 实付金额 / 支付 IP | +| 2026-04-25 00:10 | 1.1 / 1.2 | completed | 已新增支付快照字段，并将 TokenPay 回调元信息透传到 `OrderService::paid()` 统一落库 | +| 2026-04-25 00:16 | 2.1 / 2.2 | completed | 已补齐后台订单详情 `payment` 关联、前端类型与支付成功信息卡片展示 | +| 2026-04-25 00:20 | 3.1 | completed | 已新增后端定向测试文件；前端目标文件 `vue-tsc` 校验通过。`npm run build` 仍被既有 `DashboardView/TicketsView` 类型错误阻断，且当前工作区缺少 PHP 运行时与 `vendor`，无法直接执行 PHPUnit | + +--- + +## 执行备注 + +> 记录执行过程中的重要说明、决策变更、风险提示等 + +- 当前工作树存在与本轮无关的未提交改动，实施时必须避免覆盖已有业务变更。 +- 历史订单缺少新增快照字段属于预期兼容范围，前端详情需允许空值展示。 +- `admin-frontend` 全量构建失败来自既有 `DashboardView.vue` 与 `TicketsView.vue` 类型错误，本轮改动通过独立 `tsconfig` 对目标文件完成定向校验。 +- 当前环境缺少 PHP 可执行文件与 `vendor` 依赖目录，后端仅完成代码级实现与测试文件落地，未能执行 Laravel / PHPUnit 运行时验证。 diff --git a/.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/.status.json b/.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/.status.json new file mode 100644 index 0000000..4799ac3 --- /dev/null +++ b/.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/.status.json @@ -0,0 +1,11 @@ +{ + "status": "completed", + "completed": 5, + "failed": 0, + "pending": 0, + "total": 5, + "done": 5, + "percent": 100, + "current": "活跃状态高级筛选已完成，等待在具备 PHP 运行时的环境补跑后端单元用例", + "updated_at": "2026-04-25 00:30:00" +} diff --git a/.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/contract.json b/.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/contract.json new file mode 100644 index 0000000..f277933 --- /dev/null +++ b/.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/contract.json @@ -0,0 +1,47 @@ +{ + "updatedAt": "2026-04-24T16:18:00.000Z", + "version": 1, + "source": "R2", + "originCommand": "design", + "verifyMode": "review-first", + "reviewerFocus": [ + "高级筛选是否仅做增量改动并保持现有 Apple 风格工作台结构", + "活跃状态前端字段、摘要文案与后端复合规则是否一致", + "是否避免把隐式封禁/到期语义混入本轮活跃规则" + ], + "testerFocus": [ + "user/fetch 是否支持 activity_status=eq:1|0 的活跃/非活跃筛选", + "高级筛选弹窗是否可选择活跃状态并正确生成筛选条件", + "admin-frontend 构建与新增单元验证是否通过" + ], + "ui": { + "required": true, + "designContract": true, + "sourcePriority": [ + "proposal.md", + ".helloagents/DESIGN.md", + "hello-ui" + ], + "styleAdvisor": { + "required": false, + "reason": "", + "focus": [] + }, + "visualValidation": { + "required": false, + "reason": "本轮仅在高级筛选弹窗中增量添加一个条件字段，不涉及整页视觉重构", + "screens": [ + "#/users advanced filter dialog" + ], + "states": [ + "活跃状态字段下拉展开态" + ] + } + }, + "advisor": { + "required": false, + "reason": "", + "focus": [], + "preferredSources": [] + } +} diff --git a/.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/proposal.md b/.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/proposal.md new file mode 100644 index 0000000..a618f23 --- /dev/null +++ b/.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/proposal.md @@ -0,0 +1,88 @@ +# 变更提案: admin-frontend-user-activity-status-filter + +## 元信息 +```yaml +类型: 功能开发 +方案类型: implementation +优先级: P1 +状态: 已完成 +创建: 2026-04-25 +``` + +--- + +## 1. 需求 + +### 背景 +用户要求在 `admin-frontend` 的用户管理“高级筛选”中新增“活跃用户”判断，并明确选择扩展为“三态筛选”：支持按“全部 / 活跃 / 非活跃”理解筛选范围。当前高级筛选仅支持单字段条件组合，前端无法直接表达“有任意订阅 + 剩余流量 > 0 + 最后在线时间在半年内”这类跨字段复合判断，因此需要补齐前后端联动能力。 + +### 目标 +- 在用户管理高级筛选弹窗中新增“活跃状态”条件，允许按活跃 / 非活跃筛选用户。 +- 将“全部”保持为默认无筛选状态，不破坏现有高级筛选工作流。 +- 后端 `user/fetch` 支持识别复合过滤字段，并按“任意订阅 + 流量未用完 + 最后在线时间在半年内”为活跃规则返回结果。 + +### 约束条件 +```yaml +范围约束: 仅调整用户管理高级筛选相关前后端逻辑，不改动列表主结构和其他筛选能力 +技术约束: 前端继续使用 Vue3 + TypeScript + Element Plus；后端继续沿用现有 UserController 过滤协议 +业务约束: 活跃规则严格以用户本轮指令为准，不额外叠加封禁/到期等隐式条件 +视觉约束: 延续 apple/DESIGN.md 与 .helloagents/DESIGN.md 的 Apple 风格后台样式，只做增量字段扩展 +``` + +### 验收标准 +- [ ] 高级筛选弹窗新增“活跃状态”字段，并可选择“活跃 / 非活跃”。 +- [ ] “全部”状态下不额外发送活跃过滤条件，现有筛选行为保持不变。 +- [ ] `user/fetch` 支持 `activity_status` 复合过滤，活跃判断规则为：`plan_id` 非空、`transfer_enable > u + d`、`last_online_at >= 近半年阈值`。 +- [ ] 非活跃筛选返回活跃条件的反向集合。 +- [ ] 至少完成一次后端单元验证与一次 `admin-frontend` 构建验证。 + +--- + +## 2. 方案 + +### 页面与交互 +1. 延续现有高级筛选弹窗结构，不新增新的工具条入口。 +2. 在字段列表中新增“活跃状态”，值选择使用枚举下拉，保持与“账号状态”一致的轻量操作方式。 +3. “全部”继续通过“不添加该条件 / 清空该条件”表达，不在 UI 中额外堆叠冗余控件。 + +### 前端实现策略 +1. 在 `admin-frontend/src/utils/users.ts` 中新增活跃状态字段定义、值选项、摘要格式化与过滤载荷映射。 +2. 在 `admin-frontend/src/views/users/UserAdvancedFilterDialog.vue` 中补齐对应下拉输入分支。 +3. 保持 `useUsersManagement.ts` 与现有 `buildUserFilters()` 聚合方式不变，由工具层输出新过滤项。 + +### 后端实现策略 +1. 在 `app/Http/Controllers/V2/Admin/UserController.php` 中为 `activity_status` 增加专用解析逻辑。 +2. 活跃条件由后端统一拼装，避免前端伪造多列比较表达式。 +3. 非活跃条件按活跃规则的反向集合构造，保证“三态”中的“非活跃”可直接使用。 + +### 风险评估 +| 风险 | 等级 | 应对 | +|------|------|------| +| 现有通用过滤协议只支持单字段比较 | 中 | 通过 `activity_status` 专用分支下沉复合查询 | +| `last_online_at` 为可空字段，非活跃定义容易遗漏 null | 中 | 在后端反向条件中显式纳入 `whereNull(last_online_at)` | +| 前端筛选摘要文案与实际规则不一致 | 低 | 统一在 `users.ts` 中维护字段标签和值文案 | + +--- + +## 3. 技术决策 + +### admin-frontend-user-activity-status-filter#D001: 活跃判断作为高级筛选枚举字段而不是快捷工具条 +**日期**: 2026-04-25 +**状态**: ✅采纳 +**背景**: 用户明确要求“给用户管理的高级筛选加个活跃用户的判断”。 +**决策**: 在高级筛选弹窗中新增“活跃状态”字段，维持原有筛选弹窗交互，不额外扩展快捷筛选区。 +**理由**: 最贴合用户点名的入口，也能避免在工具条中引入新的视觉噪音。 + +### admin-frontend-user-activity-status-filter#D002: 复合活跃规则统一由后端 `activity_status` 字段承接 +**日期**: 2026-04-25 +**状态**: ✅采纳 +**背景**: 活跃规则包含“订阅存在 + 剩余流量比较 + 半年在线阈值”三段条件，前端现有过滤协议无法安全表达列与列比较。 +**决策**: 前端仅发送 `activity_status=eq:1|0`，具体 SQL 条件由 `UserController` 后端专用逻辑生成。 +**理由**: 能保证筛选规则唯一、可维护，也避免前端为了复合判断扩展非标准过滤语法。 + +### admin-frontend-user-activity-status-filter#D003: “全部”状态继续由无条件表达，不引入伪过滤值 +**日期**: 2026-04-25 +**状态**: ✅采纳 +**背景**: 用户选择了“三态筛选”，但当前高级筛选系统本质上以“有条件 / 无条件”表达是否筛选。 +**决策**: “活跃 / 非活跃”作为显式值；“全部”保持为未添加该条件或清空该条件。 +**理由**: 既满足三态语义，又不破坏现有高级筛选的组合式模型。 diff --git a/.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/tasks.md b/.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/tasks.md new file mode 100644 index 0000000..0ba9ca4 --- /dev/null +++ b/.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/tasks.md @@ -0,0 +1,44 @@ +# 任务清单: admin-frontend-user-activity-status-filter + +> **@status:** completed | 2026-04-25 00:18 + +```yaml +@feature: admin-frontend-user-activity-status-filter +@created: 2026-04-25 +@status: completed +@mode: R2 +``` + +## 进度概览 + +| 完成 | 失败 | 跳过 | 总数 | +|------|------|------|------| +| 5 | 0 | 0 | 5 | + +--- + +## 任务列表 + +- [√] 1. 读取用户管理高级筛选前后端实现，冻结“活跃 / 非活跃”筛选边界 +- [√] 2. 扩展 `admin-frontend` 高级筛选字段定义、值选项与筛选摘要，新增“活跃状态”条件 +- [√] 3. 为 `user/fetch` 增加 `activity_status` 复合过滤逻辑，按订阅 / 剩余流量 / 半年在线规则筛选 +- [√] 4. 补充至少一项单元验证，并执行 `admin-frontend` 构建验证 +- [√] 5. 同步 `.helloagents` 文档、CHANGELOG 与方案归档记录 + +--- + +## 执行日志 + +| 时间 | 任务 | 状态 | 备注 | +|------|------|------|------| +| 2026-04-25 00:18 | 方案包初始化 | completed | 已确认本轮采用“三态活跃状态筛选”，入口固定在用户管理高级筛选弹窗 | +| 2026-04-25 00:24 | 前后端实现 | completed | 已新增 `activity_status` 过滤字段，前端弹窗支持活跃 / 非活跃选择，后端支持复合规则筛选 | +| 2026-04-25 00:30 | 验证与知识同步 | completed | `admin-frontend` 执行 `npm run build` 通过；PHP 运行时当前不可用，新增 PHPUnit 用例已落地但未能在本机执行 | + +--- + +## 执行备注 + +- “全部”不作为单独过滤值落库，而是保持无条件状态。 +- 活跃判断严格按用户指定规则实现，不额外叠加封禁/到期等隐式业务语义。 +- 本机当前缺少可执行 `php` 命令，后端单元用例已补齐，需在具备 PHP 运行时的环境中补跑。 diff --git a/.helloagents/archive/_index.md b/.helloagents/archive/_index.md index 1a1c9eb..8bb22ea 100644 --- a/.helloagents/archive/_index.md +++ b/.helloagents/archive/_index.md @@ -7,6 +7,8 @@ | 时间戳 | 名称 | 类型 | 涉及模块 | 决策 | 结果 | |--------|------|------|---------|------|------| +| 202604250018 | admin-frontend-user-activity-status-filter | implementation | admin-frontend,backend | admin-frontend-user-activity-status-filter#D001,#D002,#D003 | ✅完成 | +| 202604250002 | order-payment-snapshot | implementation | admin-frontend,order-payment | order-payment-snapshot#D001,#D002 | ✅完成 | | 202604242245 | admin-frontend-node-pagination-batch-edit | implementation | admin-frontend | admin-frontend-node-pagination-batch-edit#D001,#D002,#D003 | ✅完成 | | 202604242217 | admin-frontend-orders-commission-confirmation | implementation | admin-frontend | admin-frontend-orders-commission-confirmation#D001,#D002 | ✅完成 | | 202604241703 | admin-frontend-gift-card-management | implementation | admin-frontend | admin-frontend-gift-card-management#D001,#D002,#D003 | ✅完成 | @@ -34,6 +36,8 @@ ## 按月归档 ### 2026-04 +- [202604250018_admin-frontend-user-activity-status-filter](./2026-04/202604250018_admin-frontend-user-activity-status-filter/) - 为用户管理高级筛选新增“活跃状态”条件，并在后端补齐 `activity_status` 复合过滤规则，支持按活跃 / 非活跃筛选用户 +- [202604250002_order-payment-snapshot](./2026-04/202604250002_order-payment-snapshot/) - 补齐订单支付成功快照保存链路，并在后台订单详情中集中展示支付渠道、支付方法、平台订单号、商户订单号、实付金额与支付 IP - [202604242245_admin-frontend-node-pagination-batch-edit](./2026-04/202604242245_admin-frontend-node-pagination-batch-edit/) - 为节点管理工作台补齐本地分页、父/子节点筛选、单节点置顶，以及仅对已勾选节点生效的批量修改 - [202604242217_admin-frontend-orders-commission-confirmation](./2026-04/202604242217_admin-frontend-orders-commission-confirmation/) - 修复订单页无佣金订单误显示为待确认的问题，并新增真实待确认佣金筛选与行级手动确认入口 - [202604241703_admin-frontend-gift-card-management](./2026-04/202604241703_admin-frontend-gift-card-management/) - 开放“礼品卡管理”入口，交付模板管理、兑换码管理、使用记录与统计数据四页签工作台，并接入真实 gift-card 接口 diff --git a/.helloagents/context.md b/.helloagents/context.md index 76b209c..4d6da77 100644 --- a/.helloagents/context.md +++ b/.helloagents/context.md @@ -15,6 +15,7 @@ - GHCR 前端镜像发布工作流位于 `.github/workflows/admin-frontend-docker-publish.yml`，镜像名为 `ghcr.io//xboard-admin-frontend` - 管理端 API 通过 `window.settings.secure_path` 或 `VITE_ADMIN_PATH` 解析 `/api/v2/{secure_path}` 前缀 - 登录接口复用 `/api/v2/passport/auth/login` +- 工单回复链路当前以 `TicketService::reply()` 为统一真相源：管理员或用户再次回复已关闭工单时都会自动把工单状态改回开启，同时继续维护 `reply_status` 与 `last_reply_user_id` - 管理端仪表盘现已接入: - `stat/getStats` - `stat/getOrder` @@ -88,8 +89,10 @@ - `payment/show` - `payment/drop` - `payment/sort` +- 订单支付成功后会额外快照保存 `payment_channel / payment_method / payment_amount / payment_ip`，管理端订单详情优先展示真实支付成功信息，再回退当前支付配置 - 客户端订阅导出入口位于 `app/Http/Controllers/V1/Client/ClientController.php`，会根据 `flag` / `User-Agent` 匹配 `app/Protocols/*` 导出器 - `Stash` 订阅导出位于 `app/Protocols/Stash.php`，当前对 `AnyTLS` 采用保守兼容：仅客户端版本 `>= 3.3.0` 时导出 +- 用户主题源代码当前不在仓内，仅保留 `theme/Xboard/assets/umi.js` 编译产物；涉及用户侧工单交互时，优先通过后端语义修复保证前后台一致 ## 项目概述 @@ -103,7 +106,7 @@ - 管理端路由使用 Hash 模式 - 管理端当前业务路由包含 `/dashboard`、`/users`、`/tickets`、`/nodes`、`/node-groups`、`/node-routes`、`/subscriptions/plans`、`/subscriptions/orders`、`/subscriptions/coupons`、`/subscriptions/gift-cards`、`/system/config`、`/system/notices`、`/system/payments`、`/system/plugins`、`/system/themes` 与 `/system/knowledge` -- `#/nodes` 当前已升级为真实节点工作台：支持搜索、父/子节点筛选、分页浏览、显隐切换、复制、单节点置顶、仅对已勾选节点生效的批量修改，以及 11 种协议的新增 / 编辑弹窗和排序对话框 +- `#/nodes` 当前已升级为真实节点工作台：支持搜索、在线 / 离线筛选、父/子节点筛选、分页浏览、显隐切换、复制、单节点置顶、仅对已勾选节点生效的批量修改 / 批量删除，以及 11 种协议的新增 / 编辑弹窗和排序对话框 - Bearer Token 存储于 `sessionStorage/localStorage` - `admin-frontend` 的视觉方向当前以 Apple 风格为基线，优先纯色分区、系统字体栈和低装饰成本 diff --git a/.helloagents/modules/_index.md b/.helloagents/modules/_index.md index a0a1006..e65b6b7 100644 --- a/.helloagents/modules/_index.md +++ b/.helloagents/modules/_index.md @@ -2,5 +2,6 @@ | 模块名 | 说明 | 最近更新 | |--------|------|----------| -| [admin-frontend](admin-frontend.md) | 管理端前端登录、布局、仪表盘、用户管理、节点管理与管理 API 封装 | 2026-04-23 | +| [admin-frontend](admin-frontend.md) | 管理端前端登录、布局、仪表盘、用户管理、节点管理与管理 API 封装 | 2026-04-25 | +| [order-payment](order-payment.md) | 订单支付成功快照、第三方回调元信息透传与后台支付成功信息展示 | 2026-04-25 | | [subscription-protocols](subscription-protocols.md) | 用户订阅导出入口、协议适配器与 Stash / Clash 系列兼容过滤 | 2026-04-24 | diff --git a/.helloagents/modules/admin-frontend.md b/.helloagents/modules/admin-frontend.md index c3f57c6..c24fc15 100644 --- a/.helloagents/modules/admin-frontend.md +++ b/.helloagents/modules/admin-frontend.md @@ -16,6 +16,7 @@ - 登录成功后优先跳转 `redirect` 指定路由，否则回到 `/dashboard` - 受保护路由在未登录时会自动附加 `redirect` 查询参数 - API 基础路径使用 `/api/v2/{secure_path}`，其中 `secure_path` 来自运行时配置 +- 工单工作台现允许对已关闭工单继续回复；管理员发送新消息后会提示“发送并重开”，并通过统一后端语义把工单状态重新开启 - 仪表盘以真实后端接口返回值为准，不在前端伪造业务统计 - 仪表盘“收入趋势”支持在同一张趋势图中切换“按金额 / 按数量”，数量模式同步切换摘要卡片、Y 轴标签与最近记录 - 仪表盘“作业详情”支持打开失败作业报错弹窗，集中查看 Horizon 失败作业的报错摘要、失败时间与队列信息 @@ -24,9 +25,11 @@ - `stat/getTrafficRank` 在 `24h` 口径下会按“昨天同日”统计做涨跌对比，避免日统计表因 `record_at=00:00` 被秒级窗口错位后全部回落为 `0%` - 排行项 hover 时会显示“当前流量 / 上期流量 / 变化率”详情卡；当前流量值固定右侧展示，避免长节点名挤压后不易识别 - 仪表盘 Hero 区提供“刷新全部数据”入口，统一触发总览、趋势、排行和系统状态刷新，并在页面内展示最近一次刷新时间 +- 仪表盘指标卡中的“待处理工单 / 待处理佣金 / 总用户”现已支持快捷跳转；可点击卡片会显示明确的入口提示，并保留 hover / focus-visible 反馈 +- 工单页与订单页可读取 dashboard 来源查询参数：工单页支持 `focus=opening|closed|all`，订单页支持 `workbench=pending|commission`，并会显示低干扰入口提示 - 用户管理页通过真实后端 `user/fetch`、`user/update`、`user/generate`、`user/dumpCSV`、`user/sendMail`、`user/ban`、`user/resetSecret`、`user/destroy` 与 `plan/fetch` 完成数据读写 - 新增用户时采用“先 generate，后按邮箱回查并 update”的两段式流程，以兼容后端基础创建接口 -- 用户管理页现已补齐高级筛选弹窗，支持按邮箱、用户 ID、订阅、流量、已用流量、在线设备、到期时间、UUID、Token、账号状态和备注组合筛选 +- 用户管理页现已补齐高级筛选弹窗，支持按邮箱、用户 ID、订阅、活跃状态、流量、已用流量、在线设备、到期时间、UUID、Token、账号状态和备注组合筛选；其中“活跃状态”按“有任意订阅 + 剩余流量大于 0 + 最后在线时间在半年内”为活跃规则 - 用户管理页新增勾选 + 批量操作工作流，支持“发送邮件 / 导出 CSV / 批量封禁 / 恢复正常”，作用范围按“已勾选用户 > 当前筛选结果 > 全部用户”自动判定 - 批量恢复正常沿用 `user/ban` 现有接口，通过 `banned=0|1` 兼容，不额外引入重复路由 - 用户管理页的“更多操作”菜单现已补齐 `分配订单 / TA的订单 / TA的邀请 / TA的流量记录 / 重置流量`；其中订单分配复用现有抽屉，用户订单跳转到订单页并自动按 `user_id` 过滤，邀请结果在当前用户页复用 `invite_user_id` 筛选视图 @@ -34,7 +37,7 @@ - 节点管理页通过真实后端 `server/manage/getNodes`、`server/group/fetch` 与 `server/route/fetch` 获取列表 / 关联数据，并通过 `server/manage/save`、`server/manage/sort`、`server/manage/update`、`server/manage/batchUpdate`、`server/manage/copy`、`server/manage/drop` 完成新增、编辑、排序、批量修改与行级操作 - 节点新增 / 编辑采用统一中央大弹窗，支持 `Shadowsocks / VMess / Trojan / Hysteria / VLess / TUIC / SOCKS / Naive / HTTP / Mieru / AnyTLS` 11 种协议的首版动态配置表单 - 节点排序采用本地草稿 + 上移 / 下移模式，保存时向 `server/manage/sort` 提交 `{ id, order }[]` 顺序 payload -- 节点列表现支持本地分页、父/子节点筛选，以及跨分页稳定勾选；批量修改仅作用于已勾选节点，可统一更新 `host / group_ids / rate` +- 节点列表现支持本地分页、在线 / 离线筛选、父/子节点筛选，以及跨分页稳定勾选；批量修改 / 批量删除仅作用于已勾选节点，其中批量修改可统一更新 `host / group_ids / rate` - 节点行级菜单现已补齐“置顶节点”，会复用当前排序结果生成新的顺序 payload 并提交到 `server/manage/sort` - 权限组管理页使用真实后端 `server/group/fetch`、`server/group/save` 与 `server/group/drop`，支持关键字搜索、新增/编辑中央弹窗、删除确认，以及从节点数量列跳转到 `#/nodes?group={id}` 的筛选联动 - 路由管理页使用真实后端 `server/route/fetch`、`server/route/save` 与 `server/route/drop`，支持路由列表、关键词搜索、新增/编辑中央弹窗、删除与动作值展示 @@ -46,6 +49,7 @@ - 套餐管理页渲染 `ElSwitch` 前，会先把 `show / sell / renew` 归一化成布尔值；开关事件若新旧值相同则直接短路，避免初始化阶段误写后台状态 - 套餐说明编辑采用轻量 Markdown/HTML 编辑器与预览模式，不引入额外富文本依赖 - 订单管理页使用真实后端 `order/fetch`、`order/detail`、`order/assign`、`order/paid`、`order/cancel` 与 `order/update`，支持订单列表、类型/周期/状态筛选、详情抽屉、手动分配、人工标记已支付与佣金状态维护 +- 订单详情抽屉会优先展示支付成功快照（支付渠道 / 支付方法 / 平台订单号 / 商户订单号 / 实付金额 / 支付 IP）；旧订单缺字段时回退当前 `payment` 关联或以 `-` 占位 - 订单金额、佣金金额与相关拆解字段以“分”为后端真相源，前端统一在 `src/utils/orders.ts` 中格式化为“元”展示，避免后台金额口径混乱 - 订单管理页的佣金状态不再单看 `commission_status` 默认值；无真实佣金的订单统一显示“无佣金”，只有真实佣金订单才会参与“待确认 / 发放中 / 已发放 / 无效”状态流转 - 订单页新增“确认佣金”工具栏菜单，佣金状态筛选会自动透传 `is_commission=true`，确保“真实待确认订单”不会混入无佣金记录；行级操作列可直接把真实待确认订单手动确认到“发放中” @@ -88,5 +92,6 @@ - 依赖 `src/utils/notices.ts` 负责公告表单转换、内容摘要、排序与显示字段归一化 - 依赖 `src/utils/systemConfig.ts` 负责系统配置字段元信息、默认值、回填与保存序列化 - 依赖 `src/utils/routes.ts` 负责路由动作映射、匹配规则序列化、节点引用摘要与搜索过滤 +- 依赖 Laravel 后端 `TicketService::reply()` 提供工单“再次回复自动重开”的统一业务语义 - 依赖 Laravel 注入的 `window.settings` - 构建输出到 `public/assets/admin` diff --git a/.helloagents/modules/order-payment.md b/.helloagents/modules/order-payment.md new file mode 100644 index 0000000..15b2fb5 --- /dev/null +++ b/.helloagents/modules/order-payment.md @@ -0,0 +1,27 @@ +# order-payment + +## 职责 + +- 负责订单支付成功后的支付快照保存，包括支付渠道、支付方法、实付金额与支付 IP +- 维护第三方支付回调到订单支付完成的元信息透传链路 +- 为后台订单详情提供可追溯的支付成功信息，而不是只依赖当前支付配置 + +## 行为规范 + +- `app/Http/Controllers/V1/Guest/PaymentController.php` 负责接收第三方支付回调，并把验签通过后的支付元信息传入 `OrderService::paid()` +- `OrderService::paid()` 会在订单转为 `开通中` 之前写入支付快照；若第三方字段缺失，则回退到当前 `payment` 关联信息 +- `payment_amount` 统一按“分”存储，前端继续复用订单金额格式化链路展示 +- 后台 `app/Http/Controllers/V2/Admin/OrderController.php` 的详情接口必须加载 `payment` 关联，供旧订单或人工标记支付时做展示回退 +- `plugins/TokenPay/Plugin.php` 当前会优先从回调中提取 `Id / OutOrderId / ActualAmount / IP / Method` 等字段；缺失时允许只返回基础单号，不得阻断支付成功链路 + +## 依赖关系 + +- 依赖 `app/Models/Order.php` 与 `app/Models/Payment.php` 提供订单和支付配置模型 +- 依赖 `app/Services/OrderService.php` 执行支付成功状态转换与快照落库 +- 依赖 `plugins/TokenPay/Plugin.php` 提供第三方支付回调字段映射 +- 依赖 `admin-frontend/src/views/subscriptions/OrderDetailDrawer.vue` 与 `src/utils/orders.ts` 展示后台支付成功信息 + +## 已知限制 + +- 当前工作区缺少 PHP 运行时与 `vendor`，本地无法直接运行 Laravel / PHPUnit 验证，只能完成代码级检查与前端构建验证 +- 历史订单不会自动补写新增支付快照字段，仅对本次改动上线后的新支付成功订单逐步生效 diff --git a/.helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/.status.json b/.helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/.status.json new file mode 100644 index 0000000..a94498b --- /dev/null +++ b/.helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/.status.json @@ -0,0 +1,11 @@ +{ + "status": "completed", + "completed": 5, + "failed": 0, + "pending": 0, + "total": 5, + "done": 5, + "percent": 100, + "current": "dashboard 快捷入口增强、工单/订单落地筛选与构建验证已完成", + "updated_at": "2026-04-25 00:15:43" +} diff --git a/.helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/contract.json b/.helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/contract.json new file mode 100644 index 0000000..a3879fe --- /dev/null +++ b/.helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/contract.json @@ -0,0 +1,52 @@ +{ + "updatedAt": "2026-04-24T16:02:00.000Z", + "version": 1, + "source": "R2", + "originCommand": "design", + "verifyMode": "review-first", + "reviewerFocus": [ + "仪表盘可点击指标卡是否只覆盖已有明确落点的工作台", + "工单页与订单页的路由查询同步是否不会破坏既有筛选逻辑", + "可点击卡片是否具备清晰的 hover 与 focus 提示，而不是隐形跳转" + ], + "testerFocus": [ + "点击待处理工单卡应进入工单工作台", + "点击待处理佣金卡应进入订单工作台并默认落在真实待确认佣金视图", + "点击总用户卡应进入用户工作台", + "admin-frontend 执行 npm run build 应通过" + ], + "ui": { + "required": true, + "designContract": true, + "sourcePriority": [ + "plan.md", + ".helloagents/DESIGN.md", + "hello-ui" + ], + "styleAdvisor": { + "required": false, + "reason": "", + "focus": [] + }, + "visualValidation": { + "required": false, + "reason": "", + "screens": [ + "#/dashboard metrics grid", + "#/tickets dashboard-entry notice", + "#/subscriptions/orders commission workbench" + ], + "states": [ + "metric card hover/focus", + "dashboard source info notice", + "commission workbench preset" + ] + } + }, + "advisor": { + "required": false, + "reason": "", + "focus": [], + "preferredSources": [] + } +} diff --git a/.helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/proposal.md b/.helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/proposal.md new file mode 100644 index 0000000..2da6849 --- /dev/null +++ b/.helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/proposal.md @@ -0,0 +1,99 @@ +# 变更提案: admin-frontend-dashboard-shortcuts + +## 元信息 +```yaml +类型: 体验增强 +方案类型: implementation +优先级: P2 +状态: 已完成 +创建: 2026-04-25 +``` + +--- + +## 1. 需求 + +### 背景 +用户希望 `admin-frontend` 仪表盘中的“待处理工单”可以一键进入工单页，不再从左侧菜单二次跳转；同时希望把其他已有明确去向的高频数据卡也补成更顺手的快捷入口。 + +### 目标 +- 让仪表盘顶部指标卡中“待处理工单”支持点击直达工单工作台。 +- 为其他已有明确工作台承接的指标补充快捷入口，减少运营后台的重复导航。 +- 保持现有 Apple 风格后台语气，只做低噪音、可发现、可键盘操作的交互增强。 + +### 约束条件 +```yaml +范围约束: 仅改动 admin-frontend，保持现有页面结构和路由体系 +技术约束: 不新增后端接口，仅复用现有前端路由、查询参数与工作台筛选能力 +交互约束: 快捷入口必须保留 hover/focus 可见反馈，避免把普通统计卡误做成无提示的隐形按钮 +验证约束: 以 admin-frontend 构建通过为本轮硬验证 +``` + +### 验收标准 +- [ ] 仪表盘“待处理工单”卡点击后可直接进入 `#/tickets` +- [ ] 仪表盘“待处理佣金”卡点击后可直接进入订单工作台，并默认落在真实待确认佣金视图 +- [ ] 仪表盘“总用户”卡可直接进入用户工作台 +- [ ] 可点击指标卡具有明确的快捷入口提示和可见 focus / hover 反馈 +- [ ] 工单页与订单页能识别“从仪表盘进入”的上下文，并给出低干扰提示 +- [ ] `admin-frontend` 执行构建验证通过 +- [ ] `.helloagents` 方案包、模块文档与 CHANGELOG 已同步 + +--- + +## 2. 方案 + +### 核心思路 +把仪表盘顶部指标卡从“纯展示”升级为“展示 + 跳转入口”的复合卡片，但只开放那些已有明确落点的卡片，避免为了可点击而过度链接。 + +### 实施策略 +1. 在 `DashboardView.vue` 中为具备落点的指标卡增加 action 元数据。 +2. 指标卡渲染层改成“普通卡 / 可点击卡”双态结构：可点击卡使用按钮语义、快捷提示文案与焦点反馈。 +3. `TicketsView.vue` 读取 dashboard 来源查询参数，在顶部给出“已从仪表盘进入”的提示。 +4. `OrdersView.vue` 扩展路由查询同步逻辑，让 dashboard 快捷入口可以直接落在“真实待确认佣金”工作台。 +5. 保持本轮范围在前端增量增强，不重构现有页面信息架构。 + +### 影响范围 +- `admin-frontend/src/views/dashboard/DashboardView.vue` +- `admin-frontend/src/views/tickets/TicketsView.vue` +- `admin-frontend/src/views/subscriptions/OrdersView.vue` + +### 风险评估 +- 风险较低，主要在于新增的路由查询同步不能误伤原有筛选流程。 +- 用户工作台快捷入口若没有清晰提示，可能造成“统计卡误触”；因此必须补齐视觉提示和键盘焦点态。 + +--- + +## 3. 成果设计 + +### 目的与受众 +面向运营后台管理员，在高频巡检和处理待办时减少侧边栏往返切换。 + +### 美学方向 +延续当前 Apple 化后台：白色/浅灰指标卡为主，使用单一蓝色强调“可操作性”，避免把指标区做成高噪音按钮墙。 + +### 记忆点 +“能点的指标卡，一眼就知道下一步会把你带去哪里。” + +### 视觉要素 +- 配色: 保持现有黑白主场，仅对快捷入口提示与 focus 态使用 `#0071e3` +- 布局: 不新增额外操作栏，只在卡片底部补轻量快捷提示 +- 动效: hover / active 做轻微抬升与边框响应，focus-visible 保持明确外圈 +- 氛围: 维持低噪音运营面板，不引入多余图标装饰和营销式 CTA + +--- + +## 4. 技术决策 + +### admin-frontend-dashboard-shortcuts#D001: 只把已有明确承接页的指标卡做成快捷入口 +**日期**: 2026-04-25 +**状态**: ✅采纳 +**背景**: 用户明确要求“方便的更改也都加上”，但本轮仍需保持范围克制。 +**决策**: 仅开放“待处理工单 / 待处理佣金 / 总用户”三类已有明确工作台承接的指标卡。 +**理由**: 这些卡片都有明确落点，不需要新增后端能力，也不会让首页跳转语义变得含混。 + +### admin-frontend-dashboard-shortcuts#D002: 使用路由查询参数同步仪表盘入口上下文 +**日期**: 2026-04-25 +**状态**: ✅采纳 +**背景**: 快捷入口需要让落地页进入目标视图，而不是只做普通跳转。 +**决策**: 通过 `source` / `focus` / `workbench` 查询参数驱动工单页和订单页的初始提示与筛选状态。 +**理由**: 复用现有路由体系即可完成上下文传递，改动集中、风险可控，也方便后续继续扩展其他快捷入口。 diff --git a/.helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/tasks.md b/.helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/tasks.md new file mode 100644 index 0000000..1e112ad --- /dev/null +++ b/.helloagents/plan/202604250002_admin-frontend-dashboard-shortcuts/tasks.md @@ -0,0 +1,45 @@ +# 任务清单: admin-frontend-dashboard-shortcuts + +> **@status:** completed | 2026-04-25 00:15 + +```yaml +@feature: admin-frontend-dashboard-shortcuts +@created: 2026-04-25 +@status: completed +@mode: R2 +``` + +## 进度概览 + +| 完成 | 失败 | 跳过 | 总数 | +|------|------|------|------| +| 5 | 0 | 0 | 5 | + +--- + +## 任务列表 + +- [√] 1. 梳理仪表盘可安全开放的快捷入口范围，并为指标卡补 action 元数据 +- [√] 2. 实现仪表盘指标卡的可点击态、提示文案与键盘可达交互 +- [√] 3. 扩展工单页与订单页的 dashboard 来源识别和落地筛选逻辑 +- [√] 4. 回归检查用户工作台跳转与现有筛选逻辑，避免快捷入口破坏原有行为 +- [√] 5. 执行 `admin-frontend` 构建验证，并同步 `.helloagents` 记录 + +--- + +## 执行日志 + +| 时间 | 任务 | 状态 | 备注 | +|------|------|------|------| +| 2026-04-25 00:02 | 方案设计 | completed | 确认本轮采用 dashboard 快捷入口增强包，落点限定为工单 / 佣金订单 / 用户工作台 | +| 2026-04-25 00:07 | 指标卡扩展 | completed | 为待处理工单、待处理佣金、总用户补 action 元数据与快捷入口提示 | +| 2026-04-25 00:09 | 仪表盘交互 | completed | 指标卡切换为普通卡 / 可点击卡双态，补齐 hover 与 focus-visible 反馈 | +| 2026-04-25 00:11 | 落地页联动 | completed | 工单页与订单页新增 dashboard 来源提示，并同步 opening / pending workbench 预设 | +| 2026-04-25 00:15 | 构建验证 | completed | `admin-frontend` 执行 `npm run build` 通过，并补做本地 preview HTTP 检查 | + +--- + +## 执行备注 + +- 本轮不新增后端接口；若现有筛选能力无法承接，则退回普通工作台跳转，不强行扩展业务范围。 +- 本地未接入截图型浏览器工具，本轮 UI 验收采用 `npm run build` + `npm run preview` HTTP 探活 + 代码级视觉审查的降级策略。 diff --git a/.helloagents/plan/202604250006_ticket-closed-reply-reopen/.status.json b/.helloagents/plan/202604250006_ticket-closed-reply-reopen/.status.json new file mode 100644 index 0000000..fa28d85 --- /dev/null +++ b/.helloagents/plan/202604250006_ticket-closed-reply-reopen/.status.json @@ -0,0 +1,11 @@ +{ + "status": "in_progress", + "completed": 4, + "failed": 1, + "pending": 0, + "total": 5, + "done": 5, + "percent": 100, + "current": "代码修复与前端构建已完成，等待具备 PHP/Composer 的环境补跑后端验证", + "updated_at": "2026-04-25 00:15:50" +} diff --git a/.helloagents/plan/202604250006_ticket-closed-reply-reopen/contract.json b/.helloagents/plan/202604250006_ticket-closed-reply-reopen/contract.json new file mode 100644 index 0000000..317301a --- /dev/null +++ b/.helloagents/plan/202604250006_ticket-closed-reply-reopen/contract.json @@ -0,0 +1,43 @@ +{ + "updatedAt": "2026-04-24T16:06:00.000Z", + "version": 1, + "source": "R2", + "originCommand": "design", + "verifyMode": "review-first", + "reviewerFocus": [ + "工单再次回复后的 reopen 语义是否统一落在 TicketService，不再依赖单端特判", + "管理端关闭态发送交互是否放开且未破坏现有 Apple 风格工单工作台结构", + "用户端是否通过既有 /user/ticket/reply 链路打通，而非引入新的接口分叉" + ], + "testerFocus": [ + "用户侧 closed ticket reply 后是否会自动变回开启状态", + "管理端 TicketWorkspaceDialog 在 closed ticket 下是否可发送并刷新状态", + "admin-frontend 构建与后端目标测试是否通过" + ], + "ui": { + "required": true, + "designContract": true, + "sourcePriority": [ + "proposal.md", + ".helloagents/DESIGN.md", + "hello-ui" + ], + "styleAdvisor": { + "required": false, + "reason": "", + "focus": [] + }, + "visualValidation": { + "required": false, + "reason": "本轮以行为修复为主，未进行大规模视觉改版；代码级自检即可。", + "screens": [], + "states": [] + } + }, + "advisor": { + "required": false, + "reason": "", + "focus": [], + "preferredSources": [] + } +} diff --git a/.helloagents/plan/202604250006_ticket-closed-reply-reopen/proposal.md b/.helloagents/plan/202604250006_ticket-closed-reply-reopen/proposal.md new file mode 100644 index 0000000..5bab8d0 --- /dev/null +++ b/.helloagents/plan/202604250006_ticket-closed-reply-reopen/proposal.md @@ -0,0 +1,86 @@ +# 变更提案: ticket-closed-reply-reopen + +## 元信息 +```yaml +类型: 缺陷修复 +方案类型: implementation +优先级: P1 +状态: 进行中 +创建: 2026-04-25 +``` + +--- + +## 1. 需求 + +### 背景 +用户要求在 `admin-frontend` 的工单工作台中允许“已关闭工单再次回复”，并明确选择“前后台统一”方案：无论管理员还是用户，只要对已关闭工单再次回复，就自动把该工单重新开启。当前代码中，`V1/User/TicketController::reply()` 会直接拒绝 closed ticket；`TicketService::reply()` 也没有把工单状态改回开启；同时管理端 `TicketWorkspaceDialog.vue` 还会在 closed 状态禁用发送按钮。 + +### 目标 +- 打通用户端与管理端的统一规则：已关闭工单再次回复后自动重开。 +- 保持现有 `/ticket/reply` 与 `/ticket/close` 接口不变，只修正回复链路的业务语义。 +- 管理端 `#/tickets` 保持现有 Apple 风格后台工作台，只做必要交互修复，不引入新的视觉系统分叉。 + +### 约束条件 +```yaml +范围约束: 仅修复工单再次回复与自动重开链路，不扩展其他客服、通知或工单字段 +技术约束: Laravel 后端继续复用现有 TicketService；管理端继续使用 Vue3 + TypeScript + Element Plus +兼容约束: 用户端主题源码不在仓内，仅有编译产物 bundle，因此优先通过后端语义修复保证用户侧链路可用 +业务约束: 仍需保留 ticket_must_wait_reply 限制，避免同一角色连续刷消息破坏既有等待规则 +视觉约束: 管理端交互保持 .helloagents/DESIGN.md 的 Apple 风格后台，不做大改版 +``` + +### 验收标准 +- [ ] 用户侧对已关闭工单调用回复接口时不再收到 “The ticket is closed and cannot be replied”，且回复后工单状态自动回到开启。 +- [ ] 管理端 `#/tickets` 中已关闭工单仍可进入工作台发送回复，回复成功后状态刷新为开启中的工单。 +- [ ] 回复后 `reply_status` 与 `last_reply_user_id` 仍保持当前系统既有语义，`ticket_must_wait_reply` 规则不回归。 +- [ ] 至少补齐 1 个针对工单自动重开语义的自动化测试。 +- [ ] `admin-frontend` 构建验证通过；后端目标测试通过。 + +--- + +## 2. 方案 + +### 技术方案 +1. 以 `TicketService::reply()` 为单一真相源补齐“回复即自动重开”的状态回写，确保用户端、管理端、Telegram 插件管理员回复等所有复用该服务的链路统一生效。 +2. 移除 `V1/User/TicketController::reply()` 中“closed ticket 直接拒绝”的硬拦截，让用户端能走到统一服务逻辑；保留参数校验和 `ticket_must_wait_reply` 限制。 +3. 调整管理端 `TicketWorkspaceDialog.vue` 的关闭态发送限制：closed ticket 允许继续输入并发送；关闭按钮仍只在开启态显示。 +4. 基于当前仓内可维护代码补齐自动化测试，重点覆盖“回复 closed ticket 会自动 reopen”的核心业务语义；如果用户主题 bundle 不存在额外前端禁用，则不对 minified 用户端产物做无谓 patch。 + +### 影响范围 +- 后端：`app/Services/TicketService.php`、`app/Http/Controllers/V1/User/TicketController.php` +- 管理端：`admin-frontend/src/views/tickets/TicketWorkspaceDialog.vue` +- 测试：`tests/Unit` 或 `tests/Feature` +- 文档：`.helloagents/context.md`、`.helloagents/modules/admin-frontend.md`、`.helloagents/CHANGELOG.md` + +### 风险评估 +| 风险 | 等级 | 应对 | +|------|------|------| +| 统一在服务层自动 reopen 可能影响管理员插件回复链路 | 中 | 只在“reply 成功后”把 status 设回开启，保持 reply_status/last_reply_user_id 语义不变，并补测试验证 | +| 用户主题只有编译 bundle，若前端本身禁用 closed reply，后端修复仍不足 | 中 | 已先排查 bundle，当前回复页未发现 closed 态本地禁用；若实施后验证发现仍受限，再最小化补丁 bundle | +| 管理端放开发送后，状态徽章与列表刷新可能不同步 | 低 | 回复成功后继续复用现有 `refreshWorkspace()` 与 `updated` 刷新链路 | + +--- + +## 3. 技术决策 + +### ticket-closed-reply-reopen#D001: 自动重开规则下沉到 TicketService::reply() +**日期**: 2026-04-25 +**状态**: ✅采纳 +**背景**: 用户、管理员和插件管理员回复都复用工单服务，但当前 reopen 语义分散且缺失。 +**决策**: 在 `TicketService::reply()` 内统一把成功回复后的工单状态改为 `STATUS_OPENING`。 +**理由**: 这是所有回复链路共享的唯一稳定汇合点，能避免只修某个 controller 导致语义不一致。 + +### ticket-closed-reply-reopen#D002: 用户端优先通过后端语义修复打通，不直接改 minified bundle +**日期**: 2026-04-25 +**状态**: ✅采纳 +**背景**: 仓内不存在用户主题源代码，只保留 `theme/Xboard/assets/umi.js` 编译产物。 +**决策**: 先确认用户端详情页没有本地禁用 closed reply，再仅通过后端修复放开用户端；只有验证发现前端仍阻塞时才补 bundle。 +**理由**: 降低对 minified 产物的高风险修改，优先用可维护的后端真相源完成统一业务规则。 + +### ticket-closed-reply-reopen#D003: 管理端仅修复交互门禁，不改变现有页面结构 +**日期**: 2026-04-25 +**状态**: ✅采纳 +**背景**: 当前工单工作台已经符合项目既定 Apple 风格后台基线，本轮是行为修复不是页面重做。 +**决策**: 放开发送按钮的 closed 态禁用，并继续保留现有 hero / 工作台 / 对话区布局。 +**理由**: 最小化视觉影响，避免为了一个业务修复引入额外 UI 回归。 diff --git a/.helloagents/plan/202604250006_ticket-closed-reply-reopen/tasks.md b/.helloagents/plan/202604250006_ticket-closed-reply-reopen/tasks.md new file mode 100644 index 0000000..4deffc5 --- /dev/null +++ b/.helloagents/plan/202604250006_ticket-closed-reply-reopen/tasks.md @@ -0,0 +1,45 @@ +# 任务清单: ticket-closed-reply-reopen + +> **@status:** in_progress | 2026-04-25 00:15 + +```yaml +@feature: ticket-closed-reply-reopen +@created: 2026-04-25 +@status: in_progress +@mode: R2 +``` + +## 进度概览 + +| 完成 | 失败 | 跳过 | 总数 | +|------|------|------|------| +| 4 | 1 | 0 | 5 | + +--- + +## 任务列表 + +- [√] 1. 冻结工单回复/关闭链路的根因与实施边界，确认用户端由后端语义修复打通 | depends_on: [] +- [√] 2. 修复后端工单回复逻辑：关闭态允许回复且回复成功后自动重开 | depends_on: [1] +- [√] 3. 修复管理端工单工作台：关闭态允许继续发送并复用现有刷新链路 | depends_on: [2] +- [√] 4. 补齐自动化测试，覆盖“closed ticket reply -> reopen”核心语义 | depends_on: [2] +- [X] 5. 运行后端/前端验证并同步知识库记录 | depends_on: [2, 3, 4] + +--- + +## 执行日志 + +| 时间 | 任务 | 状态 | 备注 | +|------|------|------|------| +| 2026-04-25 00:06 | 方案包初始化 | completed | 已确认本轮采用“前后台统一”方案，根因定位到 V1 用户控制器拦截、TicketService 未自动 reopen、管理端发送按钮禁用 | +| 2026-04-25 00:10 | 实现完成 | completed | 已下沉 TicketService 自动重开语义，移除用户侧 closed reply 拦截，并放开管理端关闭态发送交互 | +| 2026-04-25 00:12 | 构建验证 | completed | `admin-frontend` 执行 `npm run build` 通过，最新产物已写入 `public/assets/admin` 子模块 | +| 2026-04-25 00:15 | 后端验证受阻 | failed | 当前终端无 `php` / `composer` / `docker`，无法继续执行 PHP 语法检查与新增单元测试，只能保留测试文件与代码级审查结果 | + +--- + +## 执行备注 + +- 用户主题仓内仅保留 `theme/Xboard/assets/umi.js` 编译产物；当前已确认回复详情页没有明显的 closed 态本地禁用，优先通过后端语义修复打通用户侧。 +- 本轮不改动工单关闭接口、工单自动关闭定时任务和流量日志对话框。 +- 任务 5 标记失败仅因本机缺少 PHP / Composer / Docker 运行时；前端构建和知识库同步已完成，但后端自动验证仍待补跑。 diff --git a/.helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/.status.json b/.helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/.status.json new file mode 100644 index 0000000..9199edf --- /dev/null +++ b/.helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/.status.json @@ -0,0 +1,11 @@ +{ + "status": "completed", + "completed": 4, + "failed": 0, + "pending": 0, + "total": 4, + "done": 4, + "percent": 100, + "current": "节点页在线/离线筛选与批量删除已完成，等待用户验收", + "updated_at": "2026-04-25 00:15:00" +} diff --git a/.helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/contract.json b/.helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/contract.json new file mode 100644 index 0000000..6f59b1b --- /dev/null +++ b/.helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/contract.json @@ -0,0 +1,46 @@ +{ + "updatedAt": "2026-04-24T16:15:00.000Z", + "version": 1, + "source": "R2", + "originCommand": "design", + "verifyMode": "test-first", + "reviewerFocus": [], + "testerFocus": [ + "节点页状态筛选是否支持全部节点、在线节点、离线节点三种口径", + "离线筛选是否仅包含显式 offline 节点，不混入待同步或已停用节点", + "批量删除是否真实调用 /server/manage/batchDelete，并在成功后清空勾选与刷新列表", + "admin-frontend 执行 npm run build 应通过" + ], + "ui": { + "required": true, + "designContract": true, + "sourcePriority": [ + "plan.md", + ".helloagents/DESIGN.md", + "hello-ui" + ], + "styleAdvisor": { + "required": false, + "reason": "", + "focus": [] + }, + "visualValidation": { + "required": false, + "reason": "", + "screens": [ + "#/nodes toolbar filters", + "#/nodes selection summary" + ], + "states": [ + "status filter online/offline", + "selected nodes batch delete action" + ] + } + }, + "advisor": { + "required": false, + "reason": "", + "focus": [], + "preferredSources": [] + } +} diff --git a/.helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/proposal.md b/.helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/proposal.md new file mode 100644 index 0000000..71d43ad --- /dev/null +++ b/.helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/proposal.md @@ -0,0 +1,83 @@ +# 变更提案: admin-frontend-node-status-filter-batch-delete + +## 元信息 +```yaml +类型: 功能增强 +方案类型: implementation +优先级: P1 +状态: 待执行 +创建: 2026-04-25 +``` + +--- + +## 1. 需求 + +### 背景 +`admin-frontend` 的 `#/nodes` 已具备关键词搜索、类型 / 权限组 / 父子节点筛选、跨分页勾选与批量修改能力，但当前还缺少“按在线 / 离线状态快速筛选”的运营入口，也没有针对已勾选节点的批量删除动作。用户希望继续沿用 Apple 化后台工作台结构，在节点管理页补齐这两个高频运营动作。 + +### 目标 +- 在节点管理页工具条补充“在线节点 / 离线节点”状态筛选。 +- 按本轮确认口径，仅把显式“离线”节点纳入“离线节点”筛选；`待同步 / 已停用` 不归入离线筛选结果。 +- 为已勾选节点补齐批量删除入口，并接通真实 `server/manage/batchDelete` 后端链路。 + +### 约束条件 +```yaml +范围约束: 本轮只增强节点管理页筛选与批量操作，不扩展新的节点详情、状态面板或更多批量动作 +技术约束: 继续使用 Vue3 + TypeScript + Element Plus，不新增第三方依赖 +视觉约束: 保持当前“黑色 hero + 白色工作台 + 低噪音工具条”Apple 风格后台基线，不引入厚重危险卡片或额外弹窗层级 +业务约束: 在线 / 离线判定继续以后端 `available_status` 与现有 `getNodeStatusMeta()` 为真相源；批量删除使用现成 `server/manage/batchDelete` +确认约束: “离线节点”仅筛 `getNodeStatusMeta().dotClass === 'offline'` 的节点，`pending / disabled` 继续只出现在“全部节点” +``` + +### 验收标准 +- [ ] 节点页工具条新增状态筛选，并支持“全部节点 / 在线节点 / 离线节点”切换。 +- [ ] “离线节点”筛选结果只包含显式离线节点，不包含 `待同步 / 已停用`。 +- [ ] 已勾选节点时可触发批量删除，并在确认后真实调用 `server/manage/batchDelete`。 +- [ ] 批量删除成功后会清空勾选、刷新列表，并给出明确成功 / 失败反馈。 +- [ ] 节点页文案、提示与底部说明同步覆盖新增筛选和批量删除能力。 +- [ ] `admin-frontend` 执行 `npm run build` 通过。 + +--- + +## 2. 方案 + +### 页面结构 +1. 工具条在现有“类型 / 权限组 / 节点关系”筛选之后新增“状态”筛选，下拉项固定为“全部节点 / 在线节点 / 离线节点”。 +2. 批量删除不额外引入新弹窗入口层级，而是与现有“批量修改”一起留在节点工作台主操作流中，只在已勾选节点时启用。 +3. 选择摘要条继续承担“当前已勾选多少节点”的上下文提示，并补充危险操作入口，避免在无勾选态暴露无效删除动作。 + +### 前端实现策略 +1. 在 `src/utils/nodes.ts` 中新增状态筛选类型与过滤逻辑，保持节点状态口径统一由工具层维护。 +2. 在 `src/api/admin.ts` 中新增 `batchDeleteNodes()`，统一封装 `server/manage/batchDelete`。 +3. 在 `src/views/nodes/NodesView.vue` 中： + - 新增状态筛选状态与 `hasActiveFilters` 判断 + - 将状态筛选接入 `filterNodes()` + - 增加批量删除确认、提交、清空勾选与刷新流程 + - 同步更新 hero 文案、工具条按钮与选择摘要区 +4. 尽量维持现有样式骨架，只做最小 UI 增量，避免破坏节点页当前 Apple 化后台节奏。 + +### 风险评估 +| 风险 | 等级 | 应对 | +|------|------|------| +| “离线”语义与 `待同步 / 已停用` 容易混淆 | 中 | 过滤逻辑只认 `offline` dotClass，并在方案与实现中固定该口径 | +| 批量删除属于不可恢复操作，误触风险较高 | 高 | 仅在已勾选节点时启用，并在提交前二次确认删除数量与不可恢复性 | +| 跨分页勾选后删除可能留下过期选中状态 | 中 | 删除成功后统一 `clearSelection()` 并重载节点数据，避免残留选中 ID | + +--- + +## 3. 技术决策 + +### admin-frontend-node-status-filter-batch-delete#D001: 离线筛选只匹配显式 offline 状态 +**日期**: 2026-04-25 +**状态**: ✅采纳 +**背景**: 用户已在评估阶段明确选择“离线节点不包含待同步/已停用”。 +**决策**: `statusFilter='offline'` 时仅保留 `getNodeStatusMeta(node).dotClass === 'offline'` 的节点。 +**理由**: 能保持离线筛选语义清晰，避免把待同步或停用节点混入故障排查视图。 + +### admin-frontend-node-status-filter-batch-delete#D002: 批量删除复用主工作台选择摘要，不新增独立批量操作弹窗 +**日期**: 2026-04-25 +**状态**: ✅采纳 +**背景**: 当前节点工作台已具备跨分页勾选与选择摘要区，用户只要求补齐批量删除，不要求重做批量操作体系。 +**决策**: 批量删除入口放在现有勾选摘要区 / 工具条动作流中，通过确认框完成最后确认。 +**理由**: 改动最小、上下文最清晰，也更符合 Apple 风格后台“主表格内完成高频动作”的设计基线。 diff --git a/.helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/tasks.md b/.helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/tasks.md new file mode 100644 index 0000000..5407e52 --- /dev/null +++ b/.helloagents/plan/202604250015_admin-frontend-node-status-filter-batch-delete/tasks.md @@ -0,0 +1,43 @@ +# 任务清单: admin-frontend-node-status-filter-batch-delete + +> **@status:** completed | 2026-04-25 00:15 + +```yaml +@feature: admin-frontend-node-status-filter-batch-delete +@created: 2026-04-25 +@status: completed +@mode: R2 +``` + +## 进度概览 + +| 完成 | 失败 | 跳过 | 总数 | +|------|------|------|------| +| 4 | 0 | 0 | 4 | + +--- + +## 任务列表 + +- [√] 1. 梳理节点状态筛选口径、批量删除接口与当前节点页交互边界 +- [√] 2. 扩展节点工具层与管理端 API，补齐状态筛选和批量删除封装 +- [√] 3. 调整节点工作台筛选区、选择摘要区与删除确认流程，完成在线/离线筛选与批量删除 +- [√] 4. 执行 `admin-frontend` 构建验证，并同步 `.helloagents` 记录 + +--- + +## 执行日志 + +| 时间 | 任务 | 状态 | 备注 | +|------|------|------|------| +| 2026-04-25 00:15 | 方案设计 | completed | 用户确认“离线节点”仅筛显式离线状态，不包含待同步 / 已停用 | +| 2026-04-25 00:15 | 工具层与 API | completed | 已补齐 `statusFilter` 筛选口径与 `batchDeleteNodes()` 封装 | +| 2026-04-25 00:15 | 页面实现 | completed | 节点页已新增状态筛选、批量删除按钮、确认提示与选择摘要文案 | +| 2026-04-25 00:15 | 构建验证与知识库同步 | completed | `admin-frontend` 执行 `npm run build` 通过，并同步 context/modules/CHANGELOG | + +--- + +## 执行备注 + +- 本轮只增强 `#/nodes` 现有工作台，不改动节点新增 / 编辑协议表单与其他节点子页面。 +- 批量删除属于危险操作，必须保留明确确认文案并在成功后清空跨分页勾选状态。 diff --git a/.helloagents/replay/2026-04-24T07-44-44-846Z-unknown-e3upr9.jsonl b/.helloagents/replay/2026-04-24T07-44-44-846Z-unknown-e3upr9.jsonl index 4ed1f7f..2c9fe7a 100644 --- a/.helloagents/replay/2026-04-24T07-44-44-846Z-unknown-e3upr9.jsonl +++ b/.helloagents/replay/2026-04-24T07-44-44-846Z-unknown-e3upr9.jsonl @@ -42,3 +42,4 @@ {"ts":"2026-04-24T15:11:19.797Z","event":"visual_evidence_written","host":"unknown","source":"manual","sessionId":"2026-04-24T07-44-44-846Z-unknown-e3upr9","skillName":"generic-r2","artifacts":[".helloagents/.ralph-visual.json"],"details":{"reason":"节点管理本轮新增分页、父子筛选、已勾选批量修改与置顶动作，需要确认工作台节奏和批量作用域提示与 Apple 化后台契约一致。","tooling":["code inspection","npm run build"],"screensChecked":["#/nodes desktop"],"statesChecked":["节点列表默认加载完成态","节点列表已勾选批量操作可用态","节点批量修改弹窗展开态","节点父子筛选切换态"],"status":"PASS"}} {"ts":"2026-04-24T15:11:19.815Z","event":"closeout_evidence_written","host":"unknown","source":"manual","sessionId":"2026-04-24T07-44-44-846Z-unknown-e3upr9","skillName":"generic-r2","artifacts":[".helloagents/.ralph-closeout.json"],"details":{"requirementsCoverage":{"status":"PASS","summary":"已覆盖分页、父子筛选、单节点置顶、仅已勾选节点批量修改，以及 host/group_ids/rate 三项批量更新边界。"},"deliveryChecklist":{"status":"PASS","summary":"admin-frontend 构建通过，节点页与后端批量修改链路已落地，知识库、归档索引、会话状态与交付证据已同步。"}}} {"ts":"2026-04-24T15:11:34.418Z","event":"turn_state_written","host":"unknown","source":"manual","sessionId":"2026-04-24T07-44-44-846Z-unknown-e3upr9","details":{"kind":"complete","role":"main","requiresDeliveryGate":false}} +{"ts":"2026-04-24T15:46:56.321Z","event":"turn_state_written","host":"unknown","source":"manual","sessionId":"2026-04-24T07-44-44-846Z-unknown-e3upr9","details":{"kind":"complete","role":"main","requiresDeliveryGate":false}} diff --git a/.helloagents/replay/2026-04-24T08-15-56-367Z-claude-u7aa37.jsonl b/.helloagents/replay/2026-04-24T08-15-56-367Z-claude-u7aa37.jsonl index 93a4221..ec42da4 100644 --- a/.helloagents/replay/2026-04-24T08-15-56-367Z-claude-u7aa37.jsonl +++ b/.helloagents/replay/2026-04-24T08-15-56-367Z-claude-u7aa37.jsonl @@ -7,3 +7,4 @@ {"ts":"2026-04-24T14:20:41.339Z","event":"verify_gate_blocked","host":"claude","source":"ralph-loop","sessionId":"2026-04-24T08-15-56-367Z-claude-u7aa37","reason":"[Ralph Loop] Verification failed: ✗ npm run build npm error Missing script: \"build\" npm error npm error To see a list of scripts, run: npm error npm run npm error A complete log of this run can be found in: C:\\Users\\xiaohuli\\AppData\\Local\\npm-cache\\_logs\\2026-04-24T14_20_41_220Z-"} {"ts":"2026-04-24T14:49:36.264Z","event":"verify_gate_blocked","host":"claude","source":"ralph-loop","sessionId":"2026-04-24T08-15-56-367Z-claude-u7aa37","reason":"[Ralph Loop] Verification failed: ✗ npm run build npm error Missing script: \"build\" npm error npm error To see a list of scripts, run: npm error npm run npm error A complete log of this run can be found in: C:\\Users\\xiaohuli\\AppData\\Local\\npm-cache\\_logs\\2026-04-24T14_49_36_133Z-"} {"ts":"2026-04-24T15:13:24.623Z","event":"verify_gate_blocked","host":"claude","source":"ralph-loop","sessionId":"2026-04-24T08-15-56-367Z-claude-u7aa37","reason":"[Ralph Loop] Verification failed: ✗ npm run build npm error Missing script: \"build\" npm error npm error To see a list of scripts, run: npm error npm run npm error A complete log of this run can be found in: C:\\Users\\xiaohuli\\AppData\\Local\\npm-cache\\_logs\\2026-04-24T15_13_24_529Z-"} +{"ts":"2026-04-24T15:49:44.936Z","event":"verify_gate_blocked","host":"claude","source":"ralph-loop","sessionId":"2026-04-24T08-15-56-367Z-claude-u7aa37","reason":"[Ralph Loop] Verification failed: ✗ npm run build npm error Missing script: \"build\" npm error npm error To see a list of scripts, run: npm error npm run npm error A complete log of this run can be found in: C:\\Users\\xiaohuli\\AppData\\Local\\npm-cache\\_logs\\2026-04-24T15_49_44_822Z-"} diff --git a/.helloagents/sessions/master/default/STATE.md b/.helloagents/sessions/master/default/STATE.md index 2586185..9e7a78f 100644 --- a/.helloagents/sessions/master/default/STATE.md +++ b/.helloagents/sessions/master/default/STATE.md @@ -1,25 +1,25 @@ # 恢复快照 ## 主线目标 -完成 `admin-frontend` 独立 Docker 镜像、GHCR 自动发布、compose 分支 `admin` 服务接入，以及 `admin -> web` 的 `/api` 反向代理链路。 +为 `admin-frontend` 用户管理高级筛选新增“活跃状态”条件，并补齐对应后端复合过滤规则。 ## 正在做什么 -当前任务已完成，已补齐 `xboard-admin-frontend` 到后端 `web` 服务的 `/api` 反向代理，并整理最终变更与验证证据。 +当前任务已完成，已补齐活跃 / 非活跃筛选与前后端联动，并完成前端构建验证。 ## 关键上下文 -- 用户指出此前方案遗漏了 `xboard-admin-frontend` 访问后端 API 的回源链路，需要补齐到后端 `web` 服务。 -- `admin-frontend/Caddyfile` 现已增加 `/api` 反向代理，回源地址由 `XBOARD_BACKEND_UPSTREAM` 控制，默认值为 `http://web:7001`。 -- 独立 worktree `E:\code\php\Xboard-new-compose` 的 `compose.yaml` 已补充 `admin` 服务环境变量 `XBOARD_BACKEND_UPSTREAM=http://web:7001`，并把镜像名对齐到当前 fork `ghcr.io/micah123321/*`。 -- 本轮已同步知识库：`.helloagents/CHANGELOG.md`、`.helloagents/context.md`、`.helloagents/modules/admin-frontend.md`。 +- 高级筛选弹窗新增了 `activity_status` 字段，前端支持选择“活跃 / 非活跃”，默认无该条件即代表“全部”。 +- 后端 `UserController::fetch()` 现支持 `activity_status=eq:1|0` 的复合规则：`plan_id` 非空、剩余流量大于 0、`last_online_at` 在近半年内即视为活跃。 +- 已新增 `tests/Unit/Admin/UserControllerActivityStatusFilterTest.php` 覆盖值解析与 SQL 条件拼装，但当前环境缺少可执行 `php` 命令，尚未本机跑通该 PHPUnit 用例。 +- 已完成 `admin-frontend` 的 `npm run build`，最新产物已写入 `public/assets/admin` 子模块。 ## 下一步 -当前任务已完成；如要继续，可下一步提交/推送 `master` 与 `compose` 两个工作树中的改动，或继续把 `ws-server`、命名卷和最终部署文档一并对齐到你的实际 compose 模板。 +当前任务已完成；如继续同一业务域，建议在具备 PHP 运行时的环境补跑 `UserControllerActivityStatusFilterTest`，并用真实后台登录态手动验证“高级筛选 → 活跃 / 非活跃切换”的结果集。 ## 阻塞项 -- 本地缺少 `docker` 与 `caddy` 可执行文件，因此本轮未执行 `docker build` / `caddy validate`，仅完成了 compose YAML 语法验证与代码级自检。 +- 当前终端不存在 `php` ## 方案 -无（R1 快速修正） +`.helloagents/archive/2026-04/202604250018_admin-frontend-user-activity-status-filter/` ## 已标记技能 -hello-verify +hello-ui, hello-verify diff --git a/admin-frontend/src/api/admin.ts b/admin-frontend/src/api/admin.ts index f6216e6..77a9dab 100644 --- a/admin-frontend/src/api/admin.ts +++ b/admin-frontend/src/api/admin.ts @@ -514,6 +514,10 @@ export function batchUpdateNodes(payload: AdminNodeBatchUpdatePayload): Promise< return unwrapPost('/server/manage/batchUpdate', payload as unknown as Record) } +export function batchDeleteNodes(ids: number[]): Promise> { + return unwrapPost('/server/manage/batchDelete', { ids }) +} + export function saveNode(payload: AdminNodeSavePayload): Promise> { return unwrapPost('/server/manage/save', payload as unknown as Record) } diff --git a/admin-frontend/src/types/api.d.ts b/admin-frontend/src/types/api.d.ts index 1497991..f82239b 100644 --- a/admin-frontend/src/types/api.d.ts +++ b/admin-frontend/src/types/api.d.ts @@ -579,6 +579,13 @@ export interface AdminOrderUserRef { plan_id?: number | null } +export interface AdminOrderPaymentRef { + id: number + name: string + payment: string + icon?: string | null +} + export interface AdminCommissionLogItem { id: number invite_user_id: number @@ -597,6 +604,10 @@ export interface AdminOrderListItem { plan_id: number | null coupon_id?: number | null payment_id?: number | null + payment_channel?: string | null + payment_method?: string | null + payment_amount?: number | null + payment_ip?: string | null type: number period: string trade_no: string @@ -621,6 +632,7 @@ export interface AdminOrderListItem { export interface AdminOrderDetail extends AdminOrderListItem { user?: AdminOrderUserRef | null invite_user?: AdminOrderUserRef | null + payment?: AdminOrderPaymentRef | null commission_log?: AdminCommissionLogItem[] surplus_orders?: AdminOrderListItem[] } diff --git a/admin-frontend/src/utils/nodes.ts b/admin-frontend/src/utils/nodes.ts index 08e95c2..b01c848 100644 --- a/admin-frontend/src/utils/nodes.ts +++ b/admin-frontend/src/utils/nodes.ts @@ -1,6 +1,7 @@ import type { AdminNodeItem } from '@/types/api' export type NodeRelationFilter = 'all' | 'parent' | 'child' +export type NodeStatusFilter = 'all' | 'online' | 'offline' export interface NodeStatusMeta { label: string @@ -119,11 +120,13 @@ export function filterNodes( keyword: string, typeFilter: string, groupFilter: string, + statusFilter: NodeStatusFilter = 'all', relationFilter: NodeRelationFilter = 'all', ): AdminNodeItem[] { const normalizedKeyword = normalizeText(keyword) const normalizedType = normalizeText(typeFilter) const normalizedGroup = normalizeText(groupFilter) + const normalizedStatus = normalizeText(statusFilter) const normalizedRelation = normalizeText(relationFilter) return nodes.filter((node) => { @@ -142,6 +145,15 @@ export function filterNodes( } } + const nodeStatus = getNodeStatusMeta(node).dotClass + if (normalizedStatus === 'online' && nodeStatus !== 'online') { + return false + } + + if (normalizedStatus === 'offline' && nodeStatus !== 'offline') { + return false + } + if (normalizedRelation === 'parent' && node.parent_id) { return false } diff --git a/admin-frontend/src/utils/orders.ts b/admin-frontend/src/utils/orders.ts index 36aa005..f4dae54 100644 --- a/admin-frontend/src/utils/orders.ts +++ b/admin-frontend/src/utils/orders.ts @@ -2,6 +2,7 @@ import type { AdminOrderDetail, AdminOrderFilter, AdminOrderListItem, + AdminOrderPaymentRef, AdminPlanListItem, } from '@/types/api' import { formatPlanPrice } from './plans' @@ -113,6 +114,15 @@ function toAmount(value: unknown): number { return Number.isFinite(numeric) ? numeric : 0 } +function toDisplayText(value: unknown): string | null { + if (!['string', 'number'].includes(typeof value)) { + return null + } + + const text = String(value).trim() + return text ? text : null +} + function toTimestampMilliseconds(value: number | string | null | undefined): number | null { if (value === null || value === undefined || value === '') { return null @@ -256,6 +266,29 @@ export function getOrderPeriodLabel(period: string | null | undefined): string { return findPeriodMeta(period)?.label ?? (period || '-') } +type OrderPaymentDisplayTarget = { + payment_channel?: string | null + payment_method?: string | null + payment?: AdminOrderPaymentRef | null +} + +export function getOrderPaymentChannel(order?: OrderPaymentDisplayTarget | null): string { + return ( + toDisplayText(order?.payment_channel) + ?? toDisplayText(order?.payment?.name) + ?? toDisplayText(order?.payment?.payment) + ?? '-' + ) +} + +export function getOrderPaymentMethod(order?: OrderPaymentDisplayTarget | null): string { + return ( + toDisplayText(order?.payment_method) + ?? toDisplayText(order?.payment?.payment) + ?? '-' + ) +} + export function getOrderFilterLabel(type: OrderFilterValue): string { return getOptionLabel(ORDER_TYPE_OPTIONS, type) } diff --git a/admin-frontend/src/utils/users.ts b/admin-frontend/src/utils/users.ts index e7e2087..4401730 100644 --- a/admin-frontend/src/utils/users.ts +++ b/admin-frontend/src/utils/users.ts @@ -32,6 +32,7 @@ export type UserAdvancedFieldKey = | 'email' | 'id' | 'plan_id' + | 'activity_status' | 'transfer_enable' | 'total_used' | 'online_count' @@ -52,7 +53,7 @@ export type UserAdvancedOperator = | 'null' | 'notnull' -export type UserAdvancedInputKind = 'text' | 'number' | 'plan' | 'status' | 'date' +export type UserAdvancedInputKind = 'text' | 'number' | 'plan' | 'status' | 'activity' | 'date' export interface UserAdvancedFilterItem { key: string @@ -77,6 +78,11 @@ export const USER_STATUS_VALUE_OPTIONS = [ { label: '封禁', value: 1 }, ] as const +export const USER_ACTIVITY_STATUS_OPTIONS = [ + { label: '活跃', value: 1 }, + { label: '非活跃', value: 0 }, +] as const + export const USER_ADVANCED_FIELD_DEFINITIONS: UserAdvancedFieldDefinition[] = [ { field: 'email', @@ -113,6 +119,12 @@ export const USER_ADVANCED_FIELD_DEFINITIONS: UserAdvancedFieldDefinition[] = [ { value: 'notnull', label: '已订阅' }, ], }, + { + field: 'activity_status', + label: '活跃状态', + input: 'activity', + operators: [{ value: 'eq', label: '是' }], + }, { field: 'transfer_enable', label: '流量', @@ -303,7 +315,7 @@ function normalizeAdvancedFilterValue(item: UserAdvancedFilterItem): string | nu return timestamp ? `${item.operator}:${timestamp}` : null } - if (item.field === 'id' || item.field === 'plan_id' || item.field === 'online_count' || item.field === 'banned') { + if (item.field === 'id' || item.field === 'plan_id' || item.field === 'activity_status' || item.field === 'online_count' || item.field === 'banned') { const numeric = Number(item.value) return Number.isFinite(numeric) ? `${item.operator}:${numeric}` : null } @@ -331,6 +343,10 @@ function formatAdvancedFilterValue(item: UserAdvancedFilterItem, plans: AdminPla return Number(item.value) === 1 ? '封禁' : '正常' } + if (item.field === 'activity_status') { + return Number(item.value) === 1 ? '活跃' : '非活跃' + } + if (item.field === 'transfer_enable' || item.field === 'total_used') { return `${Number(item.value)} GB` } diff --git a/admin-frontend/src/views/dashboard/DashboardView.vue b/admin-frontend/src/views/dashboard/DashboardView.vue index fa23dee..0939341 100644 --- a/admin-frontend/src/views/dashboard/DashboardView.vue +++ b/admin-frontend/src/views/dashboard/DashboardView.vue @@ -2,6 +2,8 @@ import { computed, onMounted, ref, watch } from 'vue' import type { Component } from 'vue' import { ElMessage } from 'element-plus' +import { useRouter } from 'vue-router' +import type { LocationQueryRaw } from 'vue-router' import { Coin, DataAnalysis, @@ -9,6 +11,7 @@ import { Download, RefreshRight, Tickets, + TopRight, Upload, User, UserFilled, @@ -53,9 +56,15 @@ interface MetricCard { change?: string tone: 'dark' | 'light' | 'soft' icon: Component + action?: { + routeName: 'Tickets' | 'SubscriptionOrders' | 'Users' + query?: LocationQueryRaw + helperText: string + } } const app = useAppStore() +const router = useRouter() const booting = ref(true) const trendLoading = ref(false) const rankLoading = ref(false) @@ -151,6 +160,14 @@ const metricCards = computed(() => [ detail: '待客服跟进', tone: 'soft', icon: Tickets, + action: { + routeName: 'Tickets', + query: { + source: 'dashboard', + focus: 'opening', + }, + helperText: '进入工单台', + }, }, { key: 'commissionPendingTotal', @@ -160,6 +177,14 @@ const metricCards = computed(() => [ change: formatPercent(dashboardStats.value.commissionGrowth), tone: 'soft', icon: Discount, + action: { + routeName: 'SubscriptionOrders', + query: { + source: 'dashboard', + workbench: 'pending', + }, + helperText: '确认佣金', + }, }, { key: 'newUsers', @@ -177,6 +202,10 @@ const metricCards = computed(() => [ detail: `在线 ${formatCompactNumber(dashboardStats.value.onlineUsers)} · 设备 ${formatCompactNumber(dashboardStats.value.onlineDevices)}`, tone: 'light', icon: UserFilled, + action: { + routeName: 'Users', + helperText: '查看用户', + }, }, { key: 'monthUpload', @@ -475,6 +504,17 @@ function handleRefresh() { void refreshDashboard() } +function openMetricCard(card: MetricCard) { + if (!card.action) { + return + } + + void router.push({ + name: card.action.routeName, + query: card.action.query, + }) +} + function rankBarWidth(index: number): string { return `${Math.max(28, 100 - index * 12)}%` } @@ -548,11 +588,15 @@ onMounted(() => {
-
{{ card.label }} @@ -560,14 +604,20 @@ onMounted(() => {
{{ card.value }}

{{ card.detail }}

- - {{ card.change }} - -
+
+ + {{ card.change }} + + + {{ card.action.helperText }} + + +
+
@@ -1076,12 +1126,36 @@ onMounted(() => { } .metric-card { + border: 1px solid transparent; min-height: 150px; padding: 22px; display: grid; gap: 10px; } +.metric-card--interactive { + appearance: none; + width: 100%; + text-align: left; + cursor: pointer; + transition: transform 0.18s ease, border-color 0.18s ease, box-shadow 0.18s ease; +} + +.metric-card--interactive:hover { + transform: translateY(-2px); + border-color: rgba(0, 113, 227, 0.14); + box-shadow: 0 18px 36px rgba(15, 23, 42, 0.08); +} + +.metric-card--interactive:focus-visible { + outline: 2px solid rgba(0, 113, 227, 0.34); + outline-offset: 3px; +} + +.metric-card--interactive:active { + transform: translateY(0); +} + .metric-card__meta { display: flex; align-items: center; @@ -1126,11 +1200,37 @@ onMounted(() => { color: var(--xboard-text-muted); } -.metric-card__change { +.metric-card__footer { margin-top: auto; + display: flex; + align-items: center; + justify-content: space-between; + gap: 12px; + min-height: 20px; +} + +.metric-card__change { font-size: 13px; } +.metric-card__action { + display: inline-flex; + align-items: center; + gap: 6px; + margin-left: auto; + color: #0071e3; + font-size: 13px; + font-weight: 600; +} + +.metric-card__action-icon { + font-size: 12px; +} + +.tone-dark .metric-card__action { + color: #2997ff; +} + .panel { padding: 28px; } diff --git a/admin-frontend/src/views/nodes/NodesView.vue b/admin-frontend/src/views/nodes/NodesView.vue index 7e4f4af..a90b5d2 100644 --- a/admin-frontend/src/views/nodes/NodesView.vue +++ b/admin-frontend/src/views/nodes/NodesView.vue @@ -5,6 +5,7 @@ import { ElMessage, ElMessageBox } from 'element-plus' import type { TableInstance } from 'element-plus' import { Connection, + Delete, MoreFilled, Plus, RefreshRight, @@ -12,6 +13,7 @@ import { User, } from '@element-plus/icons-vue' import { + batchDeleteNodes, batchUpdateNodes, copyNode, deleteNode, @@ -42,6 +44,7 @@ import { getNodeStatusMeta, getNodeTypeLabel, type NodeRelationFilter, + type NodeStatusFilter, } from '@/utils/nodes' import { sortNodesByOrder } from '@/utils/nodeEditor' @@ -60,10 +63,12 @@ const routes = ref([]) const keyword = ref('') const typeFilter = ref('all') const groupFilter = ref('all') +const statusFilter = ref('all') const relationFilter = ref('all') const currentPage = ref(1) const pageSize = ref(20) const selectedNodeIds = ref([]) +const syncingSelection = ref(false) const switchingIds = ref([]) const workingIds = ref([]) const editorVisible = ref(false) @@ -72,12 +77,14 @@ const activeNode = ref(null) const sortDialogVisible = ref(false) const batchEditVisible = ref(false) const batchSubmitting = ref(false) +const batchDeleting = ref(false) const filteredNodes = computed(() => sortNodesByOrder(filterNodes( nodes.value, keyword.value, typeFilter.value, groupFilter.value, + statusFilter.value, relationFilter.value, ))) @@ -93,6 +100,7 @@ const hasActiveFilters = computed(() => ( keyword.value !== '' || typeFilter.value !== 'all' || groupFilter.value !== 'all' + || statusFilter.value !== 'all' || relationFilter.value !== 'all' )) @@ -106,7 +114,7 @@ const summaryCards = computed(() => [ const batchTargetLabel = computed(() => ( hasSelectedNodes.value ? `当前已选 ${selectedNodes.value.length} 个节点` - : '批量修改仅作用于已勾选节点' + : '批量修改 / 删除仅作用于已勾选节点' )) function getRouteGroupQuery(): string { @@ -182,12 +190,20 @@ function syncTableSelection() { return } - table.clearSelection() - paginatedNodes.value.forEach((node) => { - if (selectedNodeIds.value.includes(node.id)) { - table.toggleRowSelection(node, true) - } - }) + syncingSelection.value = true + + try { + table.clearSelection() + paginatedNodes.value.forEach((node) => { + if (selectedNodeIds.value.includes(node.id)) { + table.toggleRowSelection(node, true) + } + }) + } finally { + nextTick(() => { + syncingSelection.value = false + }) + } }) } @@ -220,6 +236,7 @@ function handleReset() { keyword.value = '' typeFilter.value = 'all' groupFilter.value = 'all' + statusFilter.value = 'all' relationFilter.value = 'all' currentPage.value = 1 } @@ -229,6 +246,10 @@ function openNodeGroupManagement() { } function handleSelectionChange(selection: AdminNodeItem[]) { + if (syncingSelection.value) { + return + } + const currentPageIds = paginatedNodes.value.map((item) => item.id) const selectionIds = selection.map((item) => item.id) const persistedIds = selectedNodeIds.value.filter((id) => !currentPageIds.includes(id)) @@ -281,6 +302,41 @@ async function handleBatchSubmit(payload: NodeBatchEditPayload) { } } +async function handleBatchDelete() { + if (!hasSelectedNodes.value) { + ElMessage.warning('请先勾选需要批量删除的节点') + return + } + + const deleteCount = selectedNodes.value.length + + try { + await ElMessageBox.confirm( + `确认批量删除 ${deleteCount} 个节点吗？此操作不可恢复。`, + '批量删除节点', + { + type: 'warning', + confirmButtonText: '确认删除', + cancelButtonText: '取消', + }, + ) + + batchDeleting.value = true + await batchDeleteNodes([...selectedNodeIds.value]) + clearSelection() + ElMessage.success(`已批量删除 ${deleteCount} 个节点`) + await loadNodeBoard() + } catch (error) { + if (error === 'cancel' || error === 'close') { + return + } + + ElMessage.error(error instanceof Error ? error.message : '批量删除失败') + } finally { + batchDeleting.value = false + } +} + async function handleToggleShow(node: AdminNodeItem, nextValue: boolean) { const previous = Boolean(node.show) if (previous === nextValue) { @@ -381,7 +437,7 @@ watch( }, ) -watch([keyword, typeFilter, groupFilter, relationFilter], () => { +watch([keyword, typeFilter, groupFilter, statusFilter, relationFilter], () => { currentPage.value = 1 }) @@ -397,10 +453,7 @@ watch( ) watch( - () => [ - paginatedNodes.value.map((item) => item.id).join(','), - selectedNodeIds.value.join(','), - ], + () => paginatedNodes.value.map((item) => item.id).join(','), () => { syncTableSelection() }, @@ -415,7 +468,7 @@ watch(

Nodes

节点管理

- 现在可以在同一页完成节点筛选、分页浏览、单行置顶、批量修改，以及新增、编辑、显隐和删除等运营动作。 + 现在可以在同一页完成节点筛选、在线 / 离线排查、分页浏览、单行置顶、批量修改与批量删除，以及新增、编辑、显隐和删除等运营动作。 @@ -466,6 +519,12 @@ watch( /> + + + + + + @@ -475,7 +534,17 @@ watch(
{{ batchTargetLabel }} - 批量修改 + 批量修改 + + + 批量删除 + 管理权限组 @@ -486,7 +555,7 @@ watch(
- 已勾选 {{ selectedNodes.length }} 个节点，批量修改只会作用于这些节点。 + 已勾选 {{ selectedNodes.length }} 个节点，批量修改与批量删除只会作用于这些节点。 清空勾选
@@ -655,7 +724,7 @@ watch( />
- 节点新增、编辑、置顶、排序与批量修改已收敛到同一工作台。 + 节点新增、编辑、置顶、排序、批量修改与批量删除已收敛到同一工作台。
diff --git a/admin-frontend/src/views/subscriptions/OrderDetailDrawer.vue b/admin-frontend/src/views/subscriptions/OrderDetailDrawer.vue index d5a056e..aafbc60 100644 --- a/admin-frontend/src/views/subscriptions/OrderDetailDrawer.vue +++ b/admin-frontend/src/views/subscriptions/OrderDetailDrawer.vue @@ -11,6 +11,8 @@ import { formatOrderDateTime, getCommissionStatusMeta, getOrderPeriodLabel, + getOrderPaymentChannel, + getOrderPaymentMethod, getOrderStatusMeta, getOrderTypeMeta, } from '@/utils/orders' @@ -41,6 +43,8 @@ const commissionMeta = computed(() => getCommissionStatusMeta( props.order?.actual_commission_balance, )) const hasCommission = computed(() => hasOrderCommission(props.order)) +const paymentChannel = computed(() => getOrderPaymentChannel(props.order)) +const paymentMethod = computed(() => getOrderPaymentMethod(props.order)) const summaryCards = computed(() => [ { label: '订单状态', value: statusMeta.value.label, detail: typeMeta.value.label }, @@ -56,10 +60,31 @@ const basicFields = computed(() => [ { label: '订阅计划', value: props.order?.plan?.name || '-' }, { label: '订单类型', value: typeMeta.value.label }, { label: '订阅周期', value: getOrderPeriodLabel(props.order?.period) }, - { label: '回调编号', value: props.order?.callback_no || '-' }, - { label: '支付时间', value: formatOrderDateTime(props.order?.paid_at) }, ]) +const paymentSummaryDescription = computed(() => ( + props.order?.paid_at + ? '集中查看支付成功后的渠道、方法与平台流水快照。' + : '订单完成支付后，这里会展示支付渠道、支付方法与平台流水信息。' +)) + +const paymentFields = computed(() => [ + { label: '支付渠道', value: paymentChannel.value }, + { label: '支付方法', value: paymentMethod.value }, + { label: '平台订单号', value: props.order?.callback_no || '-' }, + { label: '商户订单号', value: props.order?.trade_no || '-' }, + { label: '订单金额', value: formatOrderAmount(props.order?.total_amount) }, + { label: '实际支付金额', value: formatOrderAmount(props.order?.payment_amount) }, + { label: '创建时间', value: formatOrderDateTime(props.order?.created_at) }, + { label: '完成时间', value: formatOrderDateTime(props.order?.paid_at) }, + { label: '支付 IP', value: props.order?.payment_ip || '-' }, + { label: '订单状态', value: statusMeta.value.label }, +]) +const paymentBadges = computed(() => ([ + { label: paymentChannel.value, tone: 'neutral' }, + { label: paymentMethod.value, tone: 'info' }, +].filter((item) => item.label !== '-'))) + const amountFields = computed(() => [ { label: '订单金额', value: formatOrderAmount(props.order?.total_amount) }, { label: '手续费', value: formatOrderAmount(props.order?.handling_amount) }, @@ -151,6 +176,33 @@ watch( +
+
+
+

支付成功信息

+

{{ paymentSummaryDescription }}

+
+ +
+ + {{ item.label }} + +
+
+ +
+
+ {{ item.label }} + {{ item.value }} +
+
+
+
@@ -326,6 +378,13 @@ watch( gap: 10px; } +.payment-badges { + display: flex; + flex-wrap: wrap; + justify-content: flex-end; + gap: 10px; +} + .hero-badge { display: inline-flex; align-items: center; @@ -498,6 +557,7 @@ watch( } .card-header, + .payment-badges, .commission-actions, .list-row, .drawer-actions { diff --git a/admin-frontend/src/views/subscriptions/OrdersView.vue b/admin-frontend/src/views/subscriptions/OrdersView.vue index 87fadb6..35c492c 100644 --- a/admin-frontend/src/views/subscriptions/OrdersView.vue +++ b/admin-frontend/src/views/subscriptions/OrdersView.vue @@ -100,6 +100,34 @@ const scopedUserFilters = computed(() => ( : [] )) +const dashboardWorkbench = computed(() => { + const raw = route.query.workbench + const value = Array.isArray(raw) ? raw[0] : raw + if (value === 'pending' || value === 'commission') { + return value + } + + return null +}) + +const dashboardEntryNotice = computed(() => { + const raw = route.query.source + const source = Array.isArray(raw) ? raw[0] : raw + if (source !== 'dashboard') { + return '' + } + + if (dashboardWorkbench.value === 'pending') { + return '已从仪表盘进入，当前默认展示真实待确认佣金订单。' + } + + if (dashboardWorkbench.value === 'commission') { + return '已从仪表盘进入，当前默认展示全部佣金订单。' + } + + return '已从仪表盘进入订单工作台。' +}) + const scopedUserNotice = computed(() => ( scopedUserId.value ? `当前仅展示 ${scopedUserEmail.value || `用户 #${scopedUserId.value}`} 的订单。` @@ -118,6 +146,10 @@ const commissionWorkbenchLabel = computed(() => { }) const commissionWorkbenchNotice = computed(() => { + if (dashboardEntryNotice.value) { + return '' + } + if (commissionWorkbench.value === 'pending') { return '当前仅展示真实待确认佣金订单，可在操作列直接确认。' } @@ -220,6 +252,35 @@ function handleCommissionWorkbench(command: string) { refreshOrders(true) } +function syncDashboardWorkbench() { + if (dashboardWorkbench.value === 'pending') { + commissionWorkbench.value = 'pending' + commissionFilter.value = 0 + return + } + + if (dashboardWorkbench.value === 'commission') { + commissionWorkbench.value = 'commission' + commissionFilter.value = 'all' + return + } + + if (route.query.workbench !== undefined) { + commissionWorkbench.value = 'all' + commissionFilter.value = 'all' + } +} + +function clearDashboardEntry() { + const nextQuery = { ...route.query } + delete nextQuery.source + delete nextQuery.workbench + void router.replace({ + name: 'SubscriptionOrders', + query: nextQuery, + }) +} + function clearFilters() { keyword.value = '' typeFilter.value = 'all' @@ -397,13 +458,15 @@ watch([current, pageSize], () => { }) watch( - () => [route.query.user_id, route.query.user_email], + () => [route.query.user_id, route.query.user_email, route.query.workbench], () => { + syncDashboardWorkbench() refreshOrders(true) }, ) onMounted(() => { + syncDashboardWorkbench() void Promise.all([loadPlans(), loadOrders()]).catch(() => { ElMessage.error('订单管理页面初始化失败') }) @@ -555,6 +618,19 @@ onMounted(() => { + + + + [0] const statusMeta = computed(() => detail.value ? getTicketStatusMeta(detail.value) : null) const levelMeta = computed(() => detail.value ? getTicketLevelMeta(detail.value.level) : null) +const willReopenClosedTicket = computed(() => detail.value?.status === 1) async function loadSidebarTickets() { if (!props.visible) { @@ -312,6 +313,9 @@ watch(
+

+ 当前工单已关闭，发送新回复后会自动重新开启。 +

- 发送 + {{ willReopenClosedTicket ? '发送并重开' : '发送' }}
@@ -561,6 +564,12 @@ watch( background: rgba(255, 255, 255, 0.92); } +.reply-box__hint { + color: var(--xboard-text-muted); + font-size: 13px; + line-height: 1.5; +} + .reply-box__actions { display: flex; justify-content: flex-end; diff --git a/admin-frontend/src/views/tickets/TicketsView.vue b/admin-frontend/src/views/tickets/TicketsView.vue index 23ca742..3834fed 100644 --- a/admin-frontend/src/views/tickets/TicketsView.vue +++ b/admin-frontend/src/views/tickets/TicketsView.vue @@ -2,6 +2,7 @@ import { computed, onMounted, ref, watch } from 'vue' import { ElMessage, ElMessageBox } from 'element-plus' import { DataAnalysis, Search, View } from '@element-plus/icons-vue' +import { useRoute, useRouter } from 'vue-router' import { closeTicket, fetchTickets } from '@/api/admin' import type { AdminTicketListItem } from '@/types/api' import { formatDateTime } from '@/utils/dashboard' @@ -13,6 +14,8 @@ import { import TicketWorkspaceDialog from './TicketWorkspaceDialog.vue' const loading = ref(false) +const route = useRoute() +const router = useRouter() const tickets = ref([]) const total = ref(0) const current = ref(1) @@ -32,6 +35,38 @@ const headerStats = computed(() => [ { label: '当前页', value: String(current.value) }, ]) +const dashboardFocus = computed<'opening' | 'closed' | 'all' | null>(() => { + const raw = route.query.focus + const value = Array.isArray(raw) ? raw[0] : raw + if (value === 'closed') { + return 'closed' + } + + if (value === 'all') { + return 'all' + } + + if (value === 'opening' || value === 'pending') { + return 'opening' + } + + return null +}) + +const dashboardEntryNotice = computed(() => { + const raw = route.query.source + const source = Array.isArray(raw) ? raw[0] : raw + if (source !== 'dashboard') { + return '' + } + + if (dashboardFocus.value === 'opening') { + return '已从仪表盘进入，这里默认展示待处理工单。' + } + + return '已从仪表盘进入工单工作台。' +}) + function statusValueToParam() { if (statusFilter.value === 'opening') { return 0 @@ -92,6 +127,24 @@ function handleSearch() { void loadTickets() } +function applyDashboardFocus() { + if (!dashboardFocus.value) { + return + } + + statusFilter.value = dashboardFocus.value +} + +function clearDashboardEntry() { + const nextQuery = { ...route.query } + delete nextQuery.source + delete nextQuery.focus + void router.replace({ + name: 'Tickets', + query: nextQuery, + }) +} + watch([current, pageSize], () => { void loadTickets() }) @@ -101,7 +154,15 @@ watch([statusFilter, levelFilter], () => { void loadTickets() }) +watch( + () => route.query.focus, + () => { + applyDashboardFocus() + }, +) + onMounted(() => { + applyDashboardFocus() void loadTickets() }) @@ -156,6 +217,19 @@ onMounted(() => {
+ + + +