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

View File

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