15e2426e85
- 实现账号增删改查接口和逻辑 - 支持账号状态更新及状态历史记录功能 - 提供账号列表、历史和统计信息查询API - 实现账号轮询机制，支持按使用时间轮询获取账号 - 增加账号登录流程及批量登录功能，集成接码平台和平台API - 管理账号订单容量，支持容量检查与账号登录触发 - 提供账号池状态统计接口 - 账号历史记录查询支持多种变更类型文本展示 - 密码等敏感信息采用脱敏展示 - 完善日志记录和错误处理机制，保证业务稳定运行
7.2 KiB
7.2 KiB
JD Cookie 验证
**本文档引用的文件** - [jd_cookie.go](file://api/jd_cookie/jd_cookie.go) - [account.go](file://api/jd_cookie/v1/account.go) - [order.go](file://api/jd_cookie/v1/order.go) - [history.go](file://api/jd_cookie/v1/history.go) - [jd_cookie.go](file://internal/consts/jd_cookie.go) - [jd_cookie.go](file://internal/service/jd_cookie.go) - [jd_cookie_v1_validate.go](file://internal/controller/jd_cookie/jd_cookie_v1_validate.go) - [jd_cookie_v1_batch_validate.go](file://internal/controller/jd_cookie/jd_cookie_v1_batch_validate.go) - [jd_cookie_v1_create_account.go](file://internal/controller/jd_cookie/jd_cookie_v1_create_account.go) - [jd_cookie_v1_list_account.go](file://internal/controller/jd_cookie/jd_cookie_v1_list_account.go) - [jd_cookie_v1_get_account.go](file://internal/controller/jd_cookie/jd_cookie_v1_get_account.go)目录
简介
本文档详细介绍了JD Cookie验证功能的实现，包括Cookie账户管理、订单处理和历史记录查询等核心功能。系统通过API接口提供完整的京东Cookie生命周期管理能力，支持单个和批量Cookie验证、账户管理、订单创建与状态查询等功能。
项目结构
JD Cookie相关功能分布在多个目录中，主要包括API接口定义、控制器实现、服务逻辑和常量定义等。
graph TD
subgraph "API层"
A[api/jd_cookie]
B[api/jd_cookie/v1]
end
subgraph "控制器层"
C[internal/controller/jd_cookie]
end
subgraph "服务层"
D[internal/service]
end
subgraph "常量定义"
E[internal/consts]
end
A --> C
B --> C
C --> D
D --> E
图示来源
核心组件
JD Cookie验证系统的核心组件包括Cookie账户管理、订单处理和历史记录查询三大模块。系统通过分层架构实现了高内聚低耦合的设计，各组件通过清晰的接口进行通信。
组件来源
架构概述
系统采用典型的分层架构设计，从上到下分为API层、控制器层、服务层和数据访问层。这种设计模式确保了业务逻辑的清晰分离和代码的可维护性。
graph TD
A[客户端] --> B[API接口]
B --> C[控制器]
C --> D[服务层]
D --> E[数据存储]
C --> F[认证服务]
D --> G[Redis缓存]
style A fill:#f9f,stroke:#333
style B fill:#bbf,stroke:#333
style C fill:#f96,stroke:#333
style D fill:#6f9,stroke:#333
图示来源
详细组件分析
Cookie账户管理分析
Cookie账户管理组件提供了完整的账户生命周期管理功能，包括创建、查询、更新和删除等操作。
类图
classDiagram
class JdCookieAccountApi {
+CreateAccountReq
+BatchCreateReq
+ListAccountReq
+GetAccountReq
+UpdateAccountReq
+DeleteAccountReq
+ValidateCookieReq
+BatchValidateReq
+DeleteInvalidReq
}
class CreateAccountReq {
+CookieValue string
+AccountName string
+Remark string
}
class CreateAccountRes {
+CookieId string
+Status JdCookieStatus
}
class CookieAccountInfo {
+Id int64
+CookieId string
+CookieValue string
+AccountName string
+Status JdCookieStatus
+FailureCount int
+LastUsedAt *gtime.Time
+SuspendUntil *gtime.Time
+CreatedAt *gtime.Time
+UpdatedAt *gtime.Time
+DeletedAt *gtime.Time
+Remark string
}
JdCookieAccountApi --> CreateAccountReq : "包含"
JdCookieAccountApi --> CreateAccountRes : "返回"
JdCookieAccountApi --> CookieAccountInfo : "返回"
图示来源
验证流程序列图
sequenceDiagram
participant Client as "客户端"
participant Controller as "控制器"
participant Service as "服务层"
participant Auth as "认证服务"
Client->>Controller : 发送验证请求
Controller->>Auth : 验证用户权限
Auth-->>Controller : 返回认证结果
Controller->>Service : 调用验证方法
Service->>Service : 执行Cookie验证逻辑
Service-->>Controller : 返回验证结果
Controller-->>Client : 返回响应
Note over Client,Service : 单个Cookie验证流程
图示来源
订单处理分析
订单处理组件负责管理从创建订单到支付完成的整个流程，包括订单状态查询、支付链接获取等功能。
流程图
flowchart TD
Start([开始]) --> ValidateInput["验证输入参数"]
ValidateInput --> CheckAuth["检查用户认证"]
CheckAuth --> FindCookie["查找可用Cookie"]
FindCookie --> CreateOrder["创建内部订单"]
CreateOrder --> CallJd["调用京东下单接口"]
CallJd --> GeneratePayment["生成支付链接"]
GeneratePayment --> StoreOrder["存储订单信息"]
StoreOrder --> ReturnResult["返回订单信息"]
ReturnResult --> End([结束])
style Start fill:#f9f,stroke:#333
style End fill:#f9f,stroke:#333
图示来源
依赖分析
系统各组件之间的依赖关系清晰，遵循了依赖倒置原则，高层模块不直接依赖低层模块，而是通过接口进行通信。
graph LR
A[API接口] --> B[控制器]
B --> C[服务接口]
C --> D[服务实现]
D --> E[数据访问]
D --> F[Redis]
D --> G[外部API]
class A,B,C,D,E,F,G nodeClass;
图示来源
性能考虑
系统在设计时考虑了性能优化，通过Redis缓存可用Cookie列表和轮询索引，避免了频繁的数据库查询。同时，系统设置了合理的超时机制和失败重试策略，确保在高并发场景下的稳定运行。
故障排除指南
当遇到Cookie验证失败或订单创建异常时，可以按照以下步骤进行排查：
- 检查用户认证状态是否正常
- 确认Cookie内容格式是否正确
- 查看系统日志中的错误信息
- 检查Redis连接是否正常
- 验证数据库访问是否正常
组件来源
结论
JD Cookie验证系统通过清晰的分层架构和模块化设计，实现了稳定可靠的Cookie管理和订单处理功能。系统具有良好的扩展性和可维护性，能够满足业务发展的需求。