Initial commit: One Pipe System
完整的管理系统，包含账户管理、卡片管理、套餐管理、财务管理等功能模块。 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
sexygoat
488
docs/任务规划.md
Normal file
488
docs/任务规划.md
Normal file
@@ -0,0 +1,488 @@
|
||||
# 物联网卡管理系统 - 开发任务规划
|
||||
|
||||
> 项目开始日期: 2026-01-09
|
||||
> 当前状态: 进行中
|
||||
|
||||
---
|
||||
|
||||
## 📋 任务进度总览
|
||||
|
||||
- [ ] 阶段一：基础设施和认证模块（0/2）
|
||||
- [ ] 阶段二：账号管理模块（0/7）
|
||||
- [ ] 阶段三：财务管理模块（0/4）
|
||||
- [ ] 阶段四：商品管理模块（0/5）
|
||||
- [ ] 阶段五：资产管理模块（0/5）
|
||||
- [ ] 阶段六：批量操作模块（0/3）
|
||||
|
||||
**总体完成度**: 0/26 任务
|
||||
|
||||
---
|
||||
|
||||
## 🚀 阶段一：基础设施和认证模块
|
||||
|
||||
### 1.1 登录模块
|
||||
- [ ] 设计登录页面UI
|
||||
- [ ] 实现用户名密码登录
|
||||
- [ ] 实现记住密码功能
|
||||
- [ ] 集成验证码/滑块验证
|
||||
- [ ] 实现 Token 管理
|
||||
- [ ] 实现自动刷新 Token
|
||||
- [ ] 实现登出功能
|
||||
- [ ] 添加登录错误处理
|
||||
|
||||
### 1.2 权限管理基础
|
||||
- [ ] 设计权限控制策略（RBAC）
|
||||
- [ ] 实现路由权限守卫
|
||||
- [ ] 实现按钮级权限控制
|
||||
- [ ] 实现数据权限过滤
|
||||
- [ ] 完善角色权限映射
|
||||
|
||||
---
|
||||
|
||||
## 👥 阶段二：账号管理模块
|
||||
|
||||
### 2.1 平台角色管理
|
||||
- [ ] 角色列表页面（表格展示）
|
||||
- [ ] 新增角色功能
|
||||
- [ ] 角色基础信息表单
|
||||
- [ ] 权限分配（树形结构）
|
||||
- [ ] 编辑角色功能
|
||||
- [ ] 删除角色功能
|
||||
- [ ] 角色搜索和筛选
|
||||
- [ ] 角色权限预览
|
||||
|
||||
### 2.2 平台账号管理
|
||||
- [ ] 平台账号列表页面
|
||||
- [ ] 新增平台账号
|
||||
- [ ] 账号信息表单
|
||||
- [ ] 角色分配
|
||||
- [ ] 账号状态设置
|
||||
- [ ] 编辑平台账号
|
||||
- [ ] 禁用/启用账号
|
||||
- [ ] 重置密码功能
|
||||
- [ ] 账号操作日志查看
|
||||
|
||||
### 2.3 客户角色管理
|
||||
- [ ] 客户角色列表页面
|
||||
- [ ] 新增客户角色
|
||||
- [ ] 角色名称和描述
|
||||
- [ ] 能力边界配置（权限树）
|
||||
- [ ] 编辑客户角色
|
||||
- [ ] 删除客户角色
|
||||
- [ ] 角色能力说明文档
|
||||
|
||||
### 2.4 代理商管理
|
||||
- [ ] 代理商列表页面
|
||||
- [ ] 多级代理商树形展示
|
||||
- [ ] 代理商等级标识
|
||||
- [ ] 新增代理商
|
||||
- [ ] 代理商基础信息
|
||||
- [ ] 上级代理商选择
|
||||
- [ ] 代理商等级设置
|
||||
- [ ] 编辑代理商信息
|
||||
- [ ] 代理商账号管理
|
||||
- [ ] 查看代理商下的账号列表
|
||||
- [ ] 为代理商创建子账号
|
||||
- [ ] 代理商佣金配置
|
||||
- [ ] 代理商数据统计面板
|
||||
|
||||
### 2.5 企业客户管理
|
||||
- [ ] 企业客户列表页面
|
||||
- [ ] 新增企业客户
|
||||
- [ ] 企业基础信息
|
||||
- [ ] 客户角色分配
|
||||
- [ ] 联系人信息
|
||||
- [ ] 编辑企业客户
|
||||
- [ ] 企业客户账号管理
|
||||
- [ ] 创建企业管理账号
|
||||
- [ ] 账号权限设置
|
||||
- [ ] 企业客户数据看板
|
||||
|
||||
### 2.6 客户账号管理
|
||||
- [ ] 客户账号列表页面
|
||||
- [ ] 支持按代理商/企业筛选
|
||||
- [ ] 账号状态筛选
|
||||
- [ ] 查看账号详情
|
||||
- [ ] 解绑手机号
|
||||
- [ ] 重置登录密码
|
||||
- [ ] 禁用/启用账号
|
||||
- [ ] 账号操作记录
|
||||
|
||||
### 2.7 客户账号佣金管理
|
||||
- [ ] 客户账号佣金列表
|
||||
- [ ] 佣金统计卡片
|
||||
- [ ] 佣金明细表格
|
||||
- [ ] 佣金详情查看
|
||||
- [ ] 提现记录查看
|
||||
- [ ] 佣金统计图表
|
||||
|
||||
---
|
||||
|
||||
## 💰 阶段三：财务管理模块
|
||||
|
||||
### 3.1 佣金提现管理
|
||||
- [ ] 提现申请列表
|
||||
- [ ] 状态筛选（待审核、已通过、已拒绝）
|
||||
- [ ] 时间范围筛选
|
||||
- [ ] 提现申请详情
|
||||
- [ ] 审核提现申请
|
||||
- [ ] 通过操作
|
||||
- [ ] 拒绝操作（需填写原因）
|
||||
- [ ] 批量审核功能
|
||||
- [ ] 提现记录导出
|
||||
|
||||
### 3.2 佣金提现设置
|
||||
- [ ] 提现参数配置页面
|
||||
- [ ] 最低提现金额
|
||||
- [ ] 提现手续费设置
|
||||
- [ ] 单日提现次数限制
|
||||
- [ ] 提现规则说明
|
||||
- [ ] 配置历史记录
|
||||
- [ ] 参数生效管理
|
||||
|
||||
### 3.3 我的账户（当前登录账号）
|
||||
- [ ] 账户概览页面
|
||||
- [ ] 佣金总额卡片
|
||||
- [ ] 可提现金额卡片
|
||||
- [ ] 待入账金额卡片
|
||||
- [ ] 佣金收入明细
|
||||
- [ ] 提现申请功能
|
||||
- [ ] 收支流水记录
|
||||
- [ ] 佣金统计图表
|
||||
|
||||
### 3.4 收款商户设置
|
||||
- [ ] 支付参数配置页面
|
||||
- [ ] 支付商户信息
|
||||
- [ ] API密钥配置
|
||||
- [ ] 回调地址设置
|
||||
- [ ] 支付方式管理
|
||||
- [ ] 微信支付
|
||||
- [ ] 支付宝
|
||||
- [ ] 银行卡
|
||||
- [ ] 支付测试功能
|
||||
- [ ] 配置安全验证
|
||||
|
||||
---
|
||||
|
||||
## 🛍️ 阶段四：商品管理模块
|
||||
|
||||
### 4.1 号卡管理
|
||||
- [ ] 号卡列表页面
|
||||
- [ ] 号卡信息展示
|
||||
- [ ] 状态筛选
|
||||
- [ ] 新增号卡
|
||||
- [ ] 号卡基础信息
|
||||
- [ ] 运营商选择
|
||||
- [ ] 套餐配置
|
||||
- [ ] 编辑号卡
|
||||
- [ ] 号卡上下架
|
||||
- [ ] 号卡库存管理
|
||||
- [ ] 号卡详情页面
|
||||
|
||||
### 4.2 号卡分配
|
||||
- [ ] 分配记录列表
|
||||
- [ ] 为代理商分配号卡
|
||||
- [ ] 选择代理商
|
||||
- [ ] 选择号卡商品
|
||||
- [ ] 设置分配数量
|
||||
- [ ] 设置佣金模式
|
||||
- [ ] 查看分配详情
|
||||
- [ ] 撤销分配
|
||||
- [ ] 分配统计报表
|
||||
|
||||
### 4.3 套餐系列管理
|
||||
- [ ] 套餐系列列表
|
||||
- [ ] 新增套餐系列
|
||||
- [ ] 系列名称
|
||||
- [ ] 系列描述
|
||||
- [ ] 系列图标
|
||||
- [ ] 编辑套餐系列
|
||||
- [ ] 删除套餐系列
|
||||
- [ ] 套餐系列排序
|
||||
|
||||
### 4.4 套餐管理
|
||||
- [ ] 套餐列表页面
|
||||
- [ ] 权限过滤（管理员看全部，普通用户看自己的）
|
||||
- [ ] 按套餐系列筛选
|
||||
- [ ] 新增套餐
|
||||
- [ ] 套餐基础信息
|
||||
- [ ] 套餐类型（流量、语音、短信）
|
||||
- [ ] 套餐价格
|
||||
- [ ] 有效期设置
|
||||
- [ ] 编辑套餐
|
||||
- [ ] 套餐上下架
|
||||
- [ ] 套餐详情页面
|
||||
|
||||
### 4.5 套餐分配
|
||||
- [ ] 套餐分配列表
|
||||
- [ ] 为直级代理分配套餐
|
||||
- [ ] 选择代理商
|
||||
- [ ] 选择套餐
|
||||
- [ ] 设置佣金模式
|
||||
- [ ] 固定佣金
|
||||
- [ ] 比例佣金
|
||||
- [ ] 查看分配详情
|
||||
- [ ] 修改佣金设置
|
||||
- [ ] 分配统计
|
||||
|
||||
---
|
||||
|
||||
## 📦 阶段五：资产管理模块
|
||||
|
||||
### 5.1 单卡信息查询
|
||||
- [ ] ICCID 查询界面
|
||||
- [ ] 单卡详情页面
|
||||
- [ ] 基础信息展示
|
||||
- [ ] 套餐信息
|
||||
- [ ] 使用情况
|
||||
- [ ] 单卡操作功能
|
||||
- [ ] 套餐充值
|
||||
- [ ] 停机/复机
|
||||
- [ ] 查看流量详情
|
||||
- [ ] 更改过期时间
|
||||
- [ ] 转新卡
|
||||
- [ ] 查看停复机记录
|
||||
- [ ] 查看往期订单
|
||||
- [ ] 增减流量
|
||||
- [ ] 变更钱包余额
|
||||
- [ ] 充值支付密码
|
||||
- [ ] 续充
|
||||
- [ ] 设备操作入口
|
||||
|
||||
### 5.2 网卡管理
|
||||
- [ ] 网卡列表页面
|
||||
- [ ] 高级搜索
|
||||
- [ ] 状态筛选
|
||||
- [ ] 批量选择
|
||||
- [ ] 网卡详情页面
|
||||
- [ ] 批量操作入口
|
||||
- [ ] 批量充值
|
||||
- [ ] 批量停复机
|
||||
- [ ] 批量分配
|
||||
- [ ] 网卡导出功能
|
||||
- [ ] 网卡数据统计
|
||||
|
||||
### 5.3 设备管理
|
||||
- [ ] 设备列表页面
|
||||
- [ ] 设备信息展示
|
||||
- [ ] 在线状态
|
||||
- [ ] 设备详情页面
|
||||
- [ ] 设备基础信息
|
||||
- [ ] 绑定卡信息
|
||||
- [ ] 查看设备卡信息
|
||||
- [ ] 修改设备卡绑定
|
||||
- [ ] 设备相关操作
|
||||
- [ ] 设备重启
|
||||
- [ ] 设备诊断
|
||||
- [ ] 设备数据统计
|
||||
|
||||
### 5.4 资产分配
|
||||
- [ ] 资产分配页面
|
||||
- [ ] 设备批量分配
|
||||
- [ ] 选择代理商
|
||||
- [ ] 上传设备列表
|
||||
- [ ] 确认分配信息
|
||||
- [ ] 网卡批量分配
|
||||
- [ ] 选择代理商
|
||||
- [ ] 上传网卡列表（ICCID）
|
||||
- [ ] 自动关联设备处理
|
||||
- [ ] 分配预览和确认
|
||||
- [ ] 分配记录查看
|
||||
- [ ] 分配回滚功能
|
||||
|
||||
### 5.5 换卡申请管理
|
||||
- [ ] 换卡申请列表
|
||||
- [ ] 状态筛选（待处理、已完成、已拒绝）
|
||||
- [ ] 申请详情查看
|
||||
- [ ] 旧卡信息
|
||||
- [ ] 申请原因
|
||||
- [ ] 处理换卡申请
|
||||
- [ ] 填充新 ICCID
|
||||
- [ ] 确认换卡
|
||||
- [ ] 拒绝申请
|
||||
- [ ] 换卡记录追溯
|
||||
|
||||
---
|
||||
|
||||
## 🔄 阶段六：批量操作模块
|
||||
|
||||
### 6.1 网卡批量导入
|
||||
- [ ] 网卡导入页面
|
||||
- [ ] 模板下载
|
||||
- [ ] Excel 文件上传
|
||||
- [ ] 数据预览
|
||||
- [ ] 导入任务列表
|
||||
- [ ] 任务状态
|
||||
- [ ] 成功/失败统计
|
||||
- [ ] 查看导入详情
|
||||
- [ ] 成功记录
|
||||
- [ ] 失败记录和原因
|
||||
- [ ] 失败数据重新导入
|
||||
|
||||
### 6.2 设备批量导入
|
||||
- [ ] 设备导入页面
|
||||
- [ ] 模板下载
|
||||
- [ ] Excel 文件上传（设备+ICCID关系）
|
||||
- [ ] 数据预览和校验
|
||||
- [ ] 导入任务列表
|
||||
- [ ] 查看导入结果
|
||||
- [ ] 导入失败处理
|
||||
|
||||
### 6.3 线下批量充值
|
||||
- [ ] 批量充值记录列表
|
||||
- [ ] 新建批量充值
|
||||
- [ ] 模板下载
|
||||
- [ ] Excel 上传
|
||||
- [ ] 充值预览
|
||||
- [ ] 确认充值
|
||||
- [ ] 充值详情查看
|
||||
- [ ] 成功列表
|
||||
- [ ] 失败列表
|
||||
- [ ] 充值结果导出
|
||||
|
||||
### 6.4 换卡通知
|
||||
- [ ] 换卡通知列表
|
||||
- [ ] 单独创建换卡通知
|
||||
- [ ] 选择网卡
|
||||
- [ ] 填写通知内容
|
||||
- [ ] 选择通知方式（短信/邮件）
|
||||
- [ ] 批量创建换卡通知
|
||||
- [ ] 上传网卡列表
|
||||
- [ ] 设置通知内容
|
||||
- [ ] 查看通知记录
|
||||
- [ ] 发送状态
|
||||
- [ ] 已读状态
|
||||
|
||||
---
|
||||
|
||||
## 🎨 阶段七：开发能力和其他设置
|
||||
|
||||
### 7.1 开发能力管理
|
||||
- [ ] 开发能力列表页面
|
||||
- [ ] API 密钥管理
|
||||
- [ ] 生成密钥
|
||||
- [ ] 重置密钥
|
||||
- [ ] 密钥权限设置
|
||||
- [ ] Webhook 配置
|
||||
- [ ] API 文档集成
|
||||
- [ ] API 调用统计
|
||||
|
||||
### 7.2 分佣模板管理
|
||||
- [ ] 分佣模板列表
|
||||
- [ ] 新增分佣模板
|
||||
- [ ] 模板名称
|
||||
- [ ] 分佣规则配置
|
||||
- [ ] 适用范围
|
||||
- [ ] 编辑分佣模板
|
||||
- [ ] 删除分佣模板
|
||||
- [ ] 模板应用记录
|
||||
|
||||
---
|
||||
|
||||
## 📊 阶段八：数据统计和报表
|
||||
|
||||
### 8.1 数据概览（Dashboard）
|
||||
- [ ] 总体数据统计卡片
|
||||
- [ ] 网卡总数
|
||||
- [ ] 设备总数
|
||||
- [ ] 今日充值金额
|
||||
- [ ] 今日佣金
|
||||
- [ ] 数据趋势图表
|
||||
- [ ] 充值趋势
|
||||
- [ ] 新增网卡趋势
|
||||
- [ ] 代理商排行榜
|
||||
- [ ] 套餐销售排行
|
||||
|
||||
### 8.2 业务报表
|
||||
- [ ] 充值报表
|
||||
- [ ] 佣金报表
|
||||
- [ ] 代理商业绩报表
|
||||
- [ ] 套餐使用报表
|
||||
- [ ] 报表导出功能
|
||||
|
||||
---
|
||||
|
||||
## 🔧 阶段九：系统优化和完善
|
||||
|
||||
### 9.1 性能优化
|
||||
- [ ] 长列表虚拟滚动
|
||||
- [ ] 图片懒加载
|
||||
- [ ] 接口请求优化
|
||||
- [ ] 打包体积优化
|
||||
|
||||
### 9.2 用户体验优化
|
||||
- [ ] 页面加载状态
|
||||
- [ ] 错误提示优化
|
||||
- [ ] 操作反馈优化
|
||||
- [ ] 响应式适配
|
||||
|
||||
### 9.3 代码质量
|
||||
- [ ] 代码规范检查
|
||||
- [ ] 单元测试编写
|
||||
- [ ] E2E 测试
|
||||
- [ ] 代码注释完善
|
||||
|
||||
---
|
||||
|
||||
## 📝 开发规范
|
||||
|
||||
### 命名规范
|
||||
- 组件名：大驼峰，如 `UserManagement.vue`
|
||||
- 文件名：小写+连字符，如 `user-list.vue`
|
||||
- 接口名：RESTful 风格
|
||||
- 路由名：小写+连字符
|
||||
|
||||
### 代码结构
|
||||
```
|
||||
src/
|
||||
├── views/ # 页面组件
|
||||
├── components/ # 公共组件
|
||||
├── api/ # API 接口
|
||||
├── store/ # 状态管理
|
||||
├── router/ # 路由配置
|
||||
├── utils/ # 工具函数
|
||||
└── types/ # TypeScript 类型定义
|
||||
```
|
||||
|
||||
### Git 提交规范
|
||||
- `feat`: 新功能
|
||||
- `fix`: 修复bug
|
||||
- `docs`: 文档更新
|
||||
- `style`: 代码格式调整
|
||||
- `refactor`: 重构
|
||||
- `test`: 测试相关
|
||||
- `chore`: 构建/工具相关
|
||||
|
||||
---
|
||||
|
||||
## 🎯 里程碑
|
||||
|
||||
- [ ] **M1**: 基础设施完成（登录、权限） - 预计 3 天
|
||||
- [ ] **M2**: 账号管理模块完成 - 预计 7 天
|
||||
- [ ] **M3**: 财务管理模块完成 - 预计 5 天
|
||||
- [ ] **M4**: 商品管理模块完成 - 预计 5 天
|
||||
- [ ] **M5**: 资产管理模块完成 - 预计 7 天
|
||||
- [ ] **M6**: 批量操作模块完成 - 预计 4 天
|
||||
- [ ] **M7**: 数据统计和系统优化 - 预计 5 天
|
||||
|
||||
**预计总工期**: 36 个工作日
|
||||
|
||||
---
|
||||
|
||||
## 📌 注意事项
|
||||
|
||||
1. **优先级**：按阶段顺序开发，基础设施 > 核心业务 > 辅助功能
|
||||
2. **接口对接**：等待后端 API 完成后再进行集成
|
||||
3. **数据安全**：涉及敏感数据的操作需要二次确认
|
||||
4. **性能考虑**：列表超过 1000 条需要使用虚拟滚动
|
||||
5. **错误处理**：所有接口调用必须有错误处理
|
||||
6. **权限控制**：每个页面和操作都需要权限验证
|
||||
|
||||
---
|
||||
|
||||
## 🔄 更新日志
|
||||
|
||||
### 2026-01-09
|
||||
- 创建任务规划文档
|
||||
- 定义开发阶段和任务拆分
|
||||
- 明确开发规范和里程碑
|
||||
Reference in New Issue
Block a user