one-pipe-system/docs/任务规划.md

# 物联网卡管理系统 - 开发任务规划

> 项目开始日期: 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
- 创建任务规划文档
- 定义开发阶段和任务拆分
- 明确开发规范和里程碑