feat: 实现统一错误处理系统 (003-error-handling)
- 新增统一错误码定义和管理 (pkg/errors/codes.go) - 新增全局错误处理器和中间件 (pkg/errors/handler.go, internal/middleware/error_handler.go) - 新增错误上下文管理 (pkg/errors/context.go) - 增强 Panic 恢复中间件 (internal/middleware/recover.go) - 新增完整的单元测试和集成测试 - 新增功能文档 (docs/003-error-handling/) - 新增功能规范 (specs/003-error-handling/) - 更新 CLAUDE.md 和 README.md
This commit is contained in:
BIN
docs/优化说明/产品套餐汇总表11.10.xlsx
Normal file
BIN
docs/优化说明/产品套餐汇总表11.10.xlsx
Normal file
Binary file not shown.
17
docs/优化说明/企业客户管理.md
Normal file
17
docs/优化说明/企业客户管理.md
Normal file
@@ -0,0 +1,17 @@
|
||||
## 企业客户管理
|
||||
|
||||
#### 1.客户信息管理
|
||||
|
||||
系统应该能够存储和管理客户的详细信息,如联系人、联系方式、地址等。
|
||||
|
||||
#### 2.订单管理
|
||||
|
||||
跟踪客户的订单,包括商品种类、数量、价格、发货状态、物流信息跟踪等。
|
||||
|
||||
#### 3.商品同步
|
||||
|
||||
支持根据不同的角色可以查询对应的商品信息。如:卡的流量详情、卡状态等。
|
||||
|
||||
4.售后
|
||||
|
||||
记录客户的售后服务、投诉、反馈等。
|
||||
31
docs/优化说明/分佣.md
Normal file
31
docs/优化说明/分佣.md
Normal file
@@ -0,0 +1,31 @@
|
||||
### 分佣规则
|
||||
|
||||
#### 1.秒返
|
||||
|
||||
条件:按指定金额充值且卡激活
|
||||
|
||||
返佣:按照具体的情况制定金额
|
||||
|
||||
#### 2.次月返
|
||||
|
||||
条件:次月卡状态正常,不三无(满足其一即可),且满足首充条件
|
||||
|
||||
首充:按卡品的具体套餐定,存在累计充值或一次性充值
|
||||
|
||||
三无:无短信/语音/流量
|
||||
|
||||
#### 3.长期分佣
|
||||
|
||||
条件:运营商给我们结算后,其余条件同次月返
|
||||
|
||||
结算月:T0为激活月,可能T23为结算月(Tn为结算周期)
|
||||
|
||||
#### 4.按比例分佣
|
||||
|
||||
条件:要满足首冲、然后开通状态、无三无情况
|
||||
|
||||
### 规则改变可能方向
|
||||
|
||||
1.按已充值金额
|
||||
|
||||
2.根据套餐
|
||||
35
docs/优化说明/模块.md
Normal file
35
docs/优化说明/模块.md
Normal file
@@ -0,0 +1,35 @@
|
||||
### 一、号卡管理(关联物流信息、激活状态、充值状态、结算(上/下游)返佣、归属)
|
||||
|
||||
**卡片状态**:标记卡片的当前状态,如“已激活”、“未激活”、“停用”、“挂失”、“损坏”等。
|
||||
|
||||
### 2.**卡片管理**
|
||||
|
||||
4. **卡片使用情况监控**
|
||||
|
||||
- **流量使用情况**:对于物联网卡或数据卡等,监控卡片的流量使用情况,包括已用流量、剩余流量、流量使用超出预警等。
|
||||
|
||||
- **费用管理**:跟踪每张卡的费用,包括充值、消费、欠费、退费等,确保账务清晰。
|
||||
|
||||
### 6. **账务与费用管理**
|
||||
- **充值与结算**:记录卡片的充值信息,包括充值金额、充值方式、充值时间等;并且确保卡片与用户的费用结算清晰、及时。
|
||||
|
||||
9. **卡片与用户/设备的关联管理**
|
||||
|
||||
- **用户信息绑定**:将号卡与具体的用户进行绑定,记录用户的身份信息、联系方式、购买记录等。
|
||||
|
||||
### 二、分佣规则
|
||||
|
||||
### 三、企业客户管理
|
||||
|
||||
1.客户信息管理,支持客户分类(行业类、区域类、客户等级类)
|
||||
|
||||
2.订单与销售管理
|
||||
|
||||
3.客户绑定订单,支持查询卡信息
|
||||
|
||||
### 12. **知识库与培训支持**
|
||||
|
||||
- **客户培训管理**:为代理商或客户提供培训内容和资源,提升他们对产品或服务的理解。
|
||||
- **知识库支持**:建立一个集中管理的知识库,帮助客户和代理商快速获取产品信息、技术文档、使用手册等。
|
||||
|
||||
### 四、设备轮循
|
||||
Reference in New Issue
Block a user