feat(admin-frontend): 完成订阅与系统管理真实工作台

补齐订单、优惠券、主题、插件、公告与支付管理页面，接入对应后台接口、路由入口与工具层类型定义。同时修复套餐页开关初始化误写问题，避免浏览即触发写操作。在订阅协议侧为 Stash 导出增加 AnyTLS 版本守卫，未知版本或低于 3.3.0 时不再导出该协议，并补充回归测试与知识记录。
2026-04-24 16:52:41 +08:00
parent 16203b14f6
commit f7cef30b9c
89 changed files with 11122 additions and 92 deletions
@@ -0,0 +1,46 @@
+# admin-frontend 订单管理首版交付 — 需求
+
+确认后冻结，执行阶段不可修改。如需变更必须回到设计阶段重新确认。
+
+## 核心目标
+- 在 `admin-frontend` 中开放“订阅管理 / 订单管理”入口，不再保留禁用态。
+- 参考用户提供的订单管理截图，交付真实订单列表页，覆盖搜索、筛选、排序、分页与详情查看。
+- 保持 `apple/DESIGN.md` 与 `.helloagents/DESIGN.md` 定义的 Apple 化后台视觉语言，但优先贴近截图中的数据密集型运营视图。
+
+## 功能边界
+- 必须实现 `#/subscriptions/orders` 真实页面。
+- 页面必须包含：
+  - 添加订单入口
+  - 订单号搜索
+  - 类型 / 周期 / 订单状态 / 佣金状态筛选
+  - 支持排序的订单表格
+  - 订单详情抽屉
+  - 分配订单抽屉
+- 必须接入现有 Laravel 管理接口：
+  - `GET /order/fetch`
+  - `POST /order/detail`
+  - `POST /order/assign`
+  - `POST /order/paid`
+  - `POST /order/cancel`
+  - `POST /order/update`
+- 详情抽屉至少支持：
+  - 查看订单核心信息与金额拆解
+  - 对待支付订单手动标记已支付
+  - 对待支付订单取消
+  - 对有佣金金额的订单更新佣金状态
+
+## 非目标
+- 本轮不实现礼品卡管理真实页面。
+- 本轮不改造 Laravel 订单后端接口逻辑。
+- 本轮不新增批量操作、多选导出或订单打印等扩展功能。
+
+## 技术约束
+- 技术栈固定为 `Vue 3 + TypeScript + Vite + Element Plus`。
+- 后端真相源以仓库内 `App\Http\Controllers\V2\Admin\OrderController` 为准。
+- 构建验证使用 `admin-frontend/package.json` 中已有 `npm run build`。
+
+## 质量要求
+- 订单页面需要对齐截图中的高密度表格工作流，同时保持 Apple 化后台的克制风格。
+- 金额字段必须统一处理“后端以分存储、前端以元展示”的换算。
+- 页面需覆盖加载、错误、空状态与成功反馈。
+- 最终至少完成一次构建验证，并留下结构化视觉验收与交付证据。