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:
2025-11-15 12:17:44 +08:00
parent a371f1cd21
commit fb83c9a706
33 changed files with 7373 additions and 52 deletions

Binary file not shown.

View File

@@ -0,0 +1,17 @@
## 企业客户管理
#### 1.客户信息管理
系统应该能够存储和管理客户的详细信息,如联系人、联系方式、地址等。
#### 2.订单管理
跟踪客户的订单,包括商品种类、数量、价格、发货状态、物流信息跟踪等。
#### 3.商品同步
支持根据不同的角色可以查询对应的商品信息。如:卡的流量详情、卡状态等。
4.售后
记录客户的售后服务、投诉、反馈等。

View File

@@ -0,0 +1,31 @@
### 分佣规则
#### 1.秒返
条件:按指定金额充值且卡激活
返佣:按照具体的情况制定金额
#### 2.次月返
条件:次月卡状态正常,不三无(满足其一即可),且满足首充条件
首充:按卡品的具体套餐定,存在累计充值或一次性充值
三无:无短信/语音/流量
#### 3.长期分佣
条件:运营商给我们结算后,其余条件同次月返
结算月:T0为激活月可能T23为结算月Tn为结算周期
#### 4.按比例分佣
条件:要满足首冲、然后开通状态、无三无情况
### 规则改变可能方向
1.按已充值金额
2.根据套餐

View File

@@ -0,0 +1,35 @@
### 一、号卡管理(关联物流信息、激活状态、充值状态、结算(上/下游)返佣、归属)
**卡片状态**:标记卡片的当前状态,如“已激活”、“未激活”、“停用”、“挂失”、“损坏”等。
### 2.**卡片管理**
4. **卡片使用情况监控**
- **流量使用情况**:对于物联网卡或数据卡等,监控卡片的流量使用情况,包括已用流量、剩余流量、流量使用超出预警等。
- **费用管理**:跟踪每张卡的费用,包括充值、消费、欠费、退费等,确保账务清晰。
### 6. **账务与费用管理**
- **充值与结算**:记录卡片的充值信息,包括充值金额、充值方式、充值时间等;并且确保卡片与用户的费用结算清晰、及时。
9. **卡片与用户/设备的关联管理**
- **用户信息绑定**:将号卡与具体的用户进行绑定,记录用户的身份信息、联系方式、购买记录等。
### 二、分佣规则
### 三、企业客户管理
1.客户信息管理,支持客户分类(行业类、区域类、客户等级类)
2.订单与销售管理
3.客户绑定订单,支持查询卡信息
### 12. **知识库与培训支持**
- **客户培训管理**:为代理商或客户提供培训内容和资源,提升他们对产品或服务的理解。
- **知识库支持**:建立一个集中管理的知识库,帮助客户和代理商快速获取产品信息、技术文档、使用手册等。
### 四、设备轮循