80f605877f
- 添加骆驼加油API端点设计及系统架构文档 - 新增定时任务模块详细说明及任务流程图 - 完成订单管理服务功能及架构介绍 - 增加账号管理模块设计与状态机说明 - 集成Pig接码平台文档，介绍验证码检测流程 - 详细列出各组件的依赖关系及性能优化措施 - 提供故障排除指南及系统扩展性总结
6.7 KiB
骆驼油订单管理
**本文档引用文件** - [main.go](file://main.go) - [camel_oil.go](file://api/camel_oil/camel_oil.go) - [order.go](file://api/camel_oil/v1/order.go) - [account.go](file://api/camel_oil/v1/account.go) - [camel_oil_v1_submit_order.go](file://internal/controller/camel_oil/camel_oil_v1_submit_order.go) - [camel_oil_v1_list_order.go](file://internal/controller/camel_oil/camel_oil_v1_list_order.go) - [camel_oil_v1_order_detail.go](file://internal/controller/camel_oil/camel_oil_v1_order_detail.go) - [camel_oil_v1_order_callback.go](file://internal/controller/camel_oil/camel_oil_v1_order_callback.go) - [camel_oil.go](file://internal/service/camel_oil.go) - [camel_oil.go](file://internal/consts/camel_oil.go)目录
简介
本系统为骆驼油平台的订单管理服务，提供账号管理、订单提交、状态查询、回调处理等核心功能。系统基于GoFrame框架构建，采用分层架构设计，支持高并发订单处理与自动化任务调度。
项目结构
骆驼油订单管理模块位于api/camel_oil目录下，包含v1版本API定义，控制器位于internal/controller/camel_oil，服务接口定义在internal/service/camel_oil.go，相关常量定义于internal/consts/camel_oil.go。系统通过API层、控制器层、服务层三层架构实现功能解耦。
graph TD
A[API层] --> B[控制器层]
B --> C[服务层]
C --> D[数据访问层]
A --> |HTTP请求| B
B --> |调用| C
C --> |操作| D
图示来源
章节来源
核心组件
系统核心组件包括订单管理、账号管理、支付回调、状态查询等功能。通过ICamelOil接口定义了完整的业务能力，包括订单提交、列表查询、详情获取、回调触发等操作。服务层实现具体业务逻辑，控制器层负责请求转发。
章节来源
架构概览
系统采用典型的分层架构模式，从上至下分为API接口层、控制器层、服务层和数据访问层。API层定义RESTful接口规范，控制器层处理HTTP请求并调用服务层，服务层封装核心业务逻辑，数据层负责持久化操作。
graph TB
subgraph "API层"
A[SubmitOrder]
B[ListOrder]
C[OrderDetail]
D[OrderCallback]
end
subgraph "控制器层"
E[camel_oil_v1_submit_order]
F[camel_oil_v1_list_order]
G[camel_oil_v1_order_detail]
H[camel_oil_v1_order_callback]
end
subgraph "服务层"
I[SubmitOrder]
J[ListOrder]
K[OrderDetail]
L[TriggerOrderCallback]
end
A --> E
B --> F
C --> G
D --> H
E --> I
F --> J
G --> K
H --> L
图示来源
- camel_oil.go
- camel_oil_v1_submit_order.go
- camel_oil_v1_list_order.go
- camel_oil_v1_order_detail.go
- camel_oil_v1_order_callback.go
详细组件分析
订单管理组件分析
订单管理组件提供完整的订单生命周期管理功能，包括创建、查询、状态更新和回调处理。系统通过SubmitOrderReq结构体定义订单提交参数，包含金额、商户订单号等必要字段。
订单提交流程
sequenceDiagram
participant 客户端
participant API
participant 控制器
participant 服务层
客户端->>API : POST /jd-v2/order/submit
API->>控制器 : 转发请求
控制器->>服务层 : 调用SubmitOrder
服务层-->>控制器 : 返回订单信息
控制器-->>API : 返回响应
API-->>客户端 : 返回订单号和支付链接
图示来源
订单查询功能
系统提供多种订单查询接口，支持按订单号、商户订单号、账号ID、状态等条件进行筛选。ListOrderReq结构体定义了分页查询参数和过滤条件。
章节来源
账号管理组件分析
账号管理组件负责维护骆驼油平台账号的状态和使用情况，包括账号创建、状态更新、历史记录等功能。
账号状态管理
系统定义了完整的账号状态机，通过CamelOilAccountStatus常量管理账号生命周期。每个状态变更都会记录到历史表中，便于追踪和审计。
章节来源
依赖分析
系统主要依赖GoFrame框架提供的基础能力，包括路由、数据库访问、日志记录等。通过main.go中的import语句引入必要模块，服务注册机制确保各组件正确初始化。
graph LR
A[骆驼油服务] --> B[GoFrame框架]
A --> C[MySQL数据库]
A --> D[Redis缓存]
A --> E[OpenTelemetry]
B --> F[路由系统]
B --> G[日志系统]
B --> H[配置管理]
图示来源
章节来源
性能考虑
系统设计考虑了高并发场景下的性能表现，通过连接池、缓存机制、异步处理等方式提升响应速度。定时任务如CronOrderPaymentCheckTask定期检查订单支付状态，避免实时查询带来的性能压力。
故障排除指南
常见问题包括订单提交失败、支付状态不更新、账号登录异常等。建议检查服务日志、数据库连接状态、第三方接口可用性。通过OrderHistory接口可查询订单变更历史，辅助问题定位。
章节来源
结论
骆驼油订单管理系统提供了完整的订单处理能力，架构清晰，功能完备。通过分层设计实现了良好的可维护性和扩展性，适合处理大规模订单业务场景。