luo/one-pipe-system

Fork 0

Files

sexygoat 31440b2904

构建并部署前端到测试环境 / build-and-deploy (push) Successful in 4m53s

Details

fetch(modify):修改原来的bug

2026-01-31 11:18:37 +08:00

5.1 KiB

Raw Blame History

Change: 套餐管理系统实现

Why

根据业务需求文档（docs/套餐.md），需要实现完整的套餐管理系统，包括4个核心模块：

套餐系列管理 - 管理套餐的分类和组织
套餐管理 - 管理具体的套餐产品（流量、价格、时长等）
代理可售套餐 - 代理商查看被分配的可售套餐及定价
单套餐分配 - 为代理商分配特定套餐并设置成本价

当前系统虽然有套餐相关的类型定义（src/types/api/package.ts）和部分页面骨架，但缺少完整的 API 对接和业务逻辑实现。此变更将实现完整的套餐管理能力。

What Changes

1. API 层实现

采用模块化设计，拆分为 4 个独立的 API 服务文件：

新增: src/api/modules/packageSeries.ts - 套餐系列 API 服务
- 套餐系列列表查询（分页、筛选）
- 创建套餐系列
- 获取套餐系列详情
- 更新套餐系列
- 删除套餐系列
- 更新套餐系列状态
新增: src/api/modules/package.ts - 套餐管理 API 服务
- 套餐列表查询（分页、多条件筛选）
- 创建套餐
- 获取套餐详情
- 更新套餐
- 删除套餐
- 更新套餐状态
- 更新套餐上架状态
- 获取系列下拉选项（用于表单选择）
新增: src/api/modules/myPackage.ts - 代理可售套餐 API 服务
- 我的可售套餐列表查询
- 获取可售套餐详情
- 我的被分配系列列表
新增: src/api/modules/shopPackageAllocation.ts - 单套餐分配 API 服务
- 单套餐分配列表查询
- 创建单套餐分配
- 获取单套餐分配详情
- 更新单套餐分配
- 删除单套餐分配
- 更新单套餐分配状态
修改: src/api/modules/index.ts - 导出新增的服务模块
- 导出 PackageSeriesService
- 导出 PackageService
- 导出 MyPackageService
- 导出 ShopPackageAllocationService

2. 类型定义增强

新增: src/types/api/packageManagement.ts - 完整的套餐管理类型定义
- 匹配文档的 API 字段（下划线命名）
- 包含所有请求/响应类型
- 包含分页结果类型

3. 页面实现

套餐系列管理 (src/views/package-management/package-series/index.vue)

列表展示（支持名称搜索、状态筛选）
新增/编辑套餐系列
删除套餐系列
状态开关（启用/禁用）

套餐管理 (src/views/package-management/package-list/index.vue)

列表展示（支持多条件筛选：名称、系列、状态、上架状态、套餐类型）
新增/编辑套餐
删除套餐
状态开关（启用/禁用）
上架状态开关（上架/下架）

代理可售套餐 (src/views/package-management/my-packages/index.vue)

查看被分配的套餐列表（支持系列、类型筛选）
查看套餐详情（成本价、建议售价、利润空间等）
查看被分配系列列表

单套餐分配 (src/views/package-management/package-assign/index.vue)

分配列表（支持店铺、套餐、状态筛选）
创建分配（选择套餐、店铺、设置成本价）
编辑分配（修改成本价）
删除分配
状态管理（启用/禁用）

4. 常量配置

新增: src/config/constants/package.ts - 套餐相关常量
- 套餐类型枚举（formal/addon）
- 流量类型枚举（real/virtual）
- 上架状态枚举（1:上架, 2:下架）
- 定价模式枚举（fixed/percent）
- 价格来源枚举（series_pricing/package_override）

5. 路由配置

已存在的路由（无需修改）：

/package-management/package-series - 套餐系列管理
/package-management/package-list - 套餐管理
/package-management/package-assign - 单套餐分配

需要新增的路由：

新增: src/router/routesAlias.ts - 添加路由别名
- MyPackages = '/package-management/my-packages' - 代理可售套餐
新增: src/router/routes/asyncRoutes.ts - 添加路由配置
- /package-management/my-packages - 代理可售套餐页面路由

Impact

受影响的规范

package-series-management - 新增能力
package-management - 新增能力
my-packages - 新增能力
shop-package-allocation - 新增能力

受影响的代码

src/api/modules/* - 新增 4 个 API 服务模块
src/types/api/* - 新增类型定义文件
src/views/package-management/* - 4 个页面完整实现
src/config/constants/* - 新增常量配置
src/router/routes/asyncRoutes.ts - 路由配置

依赖关系

依赖现有的组件库（ArtTable、ArtSearchBar、ArtTableHeader 等）
依赖现有的 HTTP 请求工具（request.ts）
依赖现有的权限控制和路由守卫
依赖 ShopService（用于单套餐分配页面的店铺选择器）
后端 API 需已实现（docs/套餐.md 中定义的接口）

注意事项：

ShopService 应该已经存在于 src/api/modules/shop.ts
如果不存在，需要先实现或使用 Mock 数据

风险评估

低风险: 独立模块，不影响现有功能
API 依赖: 需确保后端接口已实现并联调
权限控制: 需配置对应的菜单和按钮权限

5.1 KiB Raw Blame History Unescape Escape