luo/one-pipe-system

Files

sexygoat 222e5bb11a Initial commit: One Pipe System

完整的管理系统，包含账户管理、卡片管理、套餐管理、财务管理等功能模块。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2026-01-22 16:35:33 +08:00

11 KiB

Raw Permalink Blame History

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

项目开始日期: 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 个工作日

📌 注意事项

优先级：按阶段顺序开发，基础设施 > 核心业务 > 辅助功能
接口对接：等待后端 API 完成后再进行集成
数据安全：涉及敏感数据的操作需要二次确认
性能考虑：列表超过 1000 条需要使用虚拟滚动
错误处理：所有接口调用必须有错误处理
权限控制：每个页面和操作都需要权限验证

🔄 更新日志

2026-01-09

创建任务规划文档
定义开发阶段和任务拆分
明确开发规范和里程碑