更新 wiki
This commit is contained in:
eafonyang
@@ -8,35 +8,47 @@
|
||||
- [internal/handler/device.go](file://internal/handler/device.go)
|
||||
- [internal/handler/health.go](file://internal/handler/health.go)
|
||||
- [internal/handler/ota.go](file://internal/handler/ota.go)
|
||||
- [internal/handler/curve.go](file://internal/handler/curve.go)
|
||||
- [internal/handler/share_code.go](file://internal/handler/share_code.go)
|
||||
- [internal/repository/brand.go](file://internal/repository/brand.go)
|
||||
- [internal/repository/model.go](file://internal/repository/model.go)
|
||||
- [internal/repository/ota.go](file://internal/repository/ota.go)
|
||||
- [internal/repository/curve.go](file://internal/repository/curve.go)
|
||||
- [internal/repository/share_code.go](file://internal/repository/share_code.go)
|
||||
- [internal/response/response.go](file://internal/response/response.go)
|
||||
- [pkg/encode/base64.go](file://pkg/encode/base64.go)
|
||||
- [internal/search/meilisearch.go](file://internal/search/meilisearch.go)
|
||||
- [internal/router/router.go](file://internal/router/router.go)
|
||||
- [cmd/server/main.go](file://cmd/server/main.go)
|
||||
- [internal/config/config.go](file://internal/config/config.go)
|
||||
- [internal/config/equalize.go](file://internal/config/equalize.go)
|
||||
- [internal/config/share_code_ttl.go](file://internal/config/share_code_ttl.go)
|
||||
- [internal/middleware/logger.go](file://internal/middleware/logger.go)
|
||||
- [internal/middleware/cors.go](file://internal/middleware/cors.go)
|
||||
- [internal/middleware/request_id.go](file://internal/middleware/request_id.go)
|
||||
- [internal/model/brand.go](file://internal/model/brand.go)
|
||||
- [internal/model/model.go](file://internal/model/model.go)
|
||||
- [internal/model/ota.go](file://internal/model/ota.go)
|
||||
- [internal/model/share_code.go](file://internal/model/share_code.go)
|
||||
- [internal/model/target.go](file://internal/model/target.go)
|
||||
- [internal/cache/brand_cache.go](file://internal/cache/brand_cache.go)
|
||||
- [internal/cache/model_cache.go](file://internal/cache/model_cache.go)
|
||||
- [internal/cache/curve_cache.go](file://internal/cache/curve_cache.go)
|
||||
- [internal/cache/share_code_cache.go](file://internal/cache/share_code_cache.go)
|
||||
- [internal/task/share_code_persist.go](file://internal/task/share_code_persist.go)
|
||||
- [sql/ota.sql](file://sql/ota.sql)
|
||||
- [sql/black_list.sql](file://sql/black_list.sql)
|
||||
- [sql/ota_target_device.sql](file://sql/ota_target_device.sql)
|
||||
- [sql/share_code_log.sql](file://sql/share_code_log.sql)
|
||||
</cite>
|
||||
|
||||
## 更新摘要
|
||||
**变更内容**
|
||||
- 新增OTA固件升级处理功能：引入OTAHandler组件，支持固件升级请求处理、黑名单过滤、目标设备分布和版本选择等OTA固件升级能力
|
||||
- 新增OTA仓储层：OTARepository提供完整的OTA数据访问能力，包括最新版本查询、黑名单检查、定向设备匹配等功能
|
||||
- 新增OTA数据模型：包含OTA、BlackList、OTATargetDevice三种数据结构，支持完整的OTA升级流程
|
||||
- 新增数据库表结构：ota、black_list、ota_target_device三张表，支撑OTA功能的数据存储需求
|
||||
- 更新路由集成：OTA功能已集成到/audio路由组中，提供/api/v1/audio/ota端点
|
||||
- 新增分享代码处理器（ShareCodeHandler）：实现EQ数据分享功能，支持创建、查询、导入、删除分享码，包含Redis缓存、分布式锁和异步持久化
|
||||
- 新增等化曲线处理器（CurveHandler）：实现频响曲线计算和参数化EQ生成功能，支持多种目标曲线和设备源
|
||||
- 新增分享码持久化任务：定时将Redis中的分享码操作记录刷入MySQL数据库
|
||||
- 新增分享码配置：支持灵活的TTL配置格式（分钟、小时、天）
|
||||
- 更新路由集成：分享码和等化曲线功能已集成到/audio路由组中
|
||||
|
||||
## 目录
|
||||
1. [简介](#简介)
|
||||
@@ -52,10 +64,10 @@
|
||||
11. [附录](#附录)
|
||||
|
||||
## 简介
|
||||
本文件面向 Luxsin 应用 API 的业务处理器模块，系统性梳理各处理器的职责、接口设计与实现细节，覆盖 BrandHandler、ModelHandler、ModelListHandler、DeviceHandler、HealthHandler 和新增的 OTAHandler。文档重点阐述新的依赖注入模式、错误处理机制、响应格式化策略，以及与 Gin 框架的集成方式；并通过流程图与类图展示处理器间的协作关系与数据流转过程，帮助初学者快速上手，同时为高级开发者提供深入的技术参考。
|
||||
本文件面向 Luxsin 应用 API 的业务处理器模块，系统性梳理各处理器的职责、接口设计与实现细节，覆盖 BrandHandler、ModelHandler、ModelListHandler、DeviceHandler、HealthHandler、OTAHandler、CurveHandler 和新增的 ShareCodeHandler。文档重点阐述新的依赖注入模式、错误处理机制、响应格式化策略，以及与 Gin 框架的集成方式；并通过流程图与类图展示处理器间的协作关系与数据流转过程，帮助初学者快速上手，同时为高级开发者提供深入的技术参考。
|
||||
|
||||
## 项目结构
|
||||
业务处理器位于 internal/handler 目录，采用依赖注入模式，围绕"控制器-仓储-搜索-缓存-响应"的分层组织，配合中间件与路由装配，形成清晰的控制流与依赖注入入口。新增的OTA功能通过独立的处理器、仓储层和数据模型实现完整的固件升级能力。
|
||||
业务处理器位于 internal/handler 目录，采用依赖注入模式，围绕"控制器-仓储-搜索-缓存-响应"的分层组织，配合中间件与路由装配，形成清晰的控制流与依赖注入入口。新增的分享码和等化曲线功能通过独立的处理器、仓储层和数据模型实现完整的业务能力。
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
@@ -75,18 +87,24 @@ MODEL["internal/handler/model.go<br/>NewModelHandler(modelRepo, log)"]
|
||||
MODELLIST["internal/handler/model_list.go<br/>NewModelListHandler(searchClient, log)"]
|
||||
DEVICE["internal/handler/device.go<br/>NewDeviceHandler(redis, log)"]
|
||||
OTA["internal/handler/ota.go<br/>NewOTAHandler(otaRepo, log)"]
|
||||
CURVE["internal/handler/curve.go<br/>NewCurveHandler(curveRepo, curveCache, eqCfg, s3, log)"]
|
||||
SHARECODE["internal/handler/share_code.go<br/>NewShareCodeHandler(shareCache, log, maxPerMac)"]
|
||||
end
|
||||
subgraph "仓储层"
|
||||
BRANDREPO["internal/repository/brand.go<br/>BrandRepository"]
|
||||
MODELREPO["internal/repository/model.go<br/>ModelRepository"]
|
||||
OTAREPO["internal/repository/ota.go<br/>OTARepository"]
|
||||
CURVEREPO["internal/repository/curve.go<br/>CurveRepository"]
|
||||
SHARECODEREPO["internal/repository/share_code.go<br/>ShareCodeRepository"]
|
||||
end
|
||||
subgraph "基础设施"
|
||||
RESP["internal/response/response.go<br/>统一响应体"]
|
||||
ENCODE["pkg/encode/base64.go<br/>自定义Base64编码"]
|
||||
SEARCH["internal/search/meilisearch.go<br/>Meilisearch客户端"]
|
||||
CACHE["internal/cache/*<br/>Redis缓存"]
|
||||
DB["MySQL 数据库<br/>ota, black_list, ota_target_device 表"]
|
||||
S3["S3存储<br/>CSV文件"]
|
||||
DB["MySQL 数据库<br/>ota, black_list, ota_target_device, share_code_log 表"]
|
||||
TASK["internal/task/share_code_persist.go<br/>分享码持久化任务"]
|
||||
end
|
||||
MAIN --> ROUTER
|
||||
ROUTER --> CORS
|
||||
@@ -98,17 +116,28 @@ ROUTER --> MODEL
|
||||
ROUTER --> MODELLIST
|
||||
ROUTER --> DEVICE
|
||||
ROUTER --> OTA
|
||||
ROUTER --> CURVE
|
||||
ROUTER --> SHARECODE
|
||||
BRAND --> BRANDREPO
|
||||
MODEL --> MODELREPO
|
||||
OTA --> OTAREPO
|
||||
CURVE --> CURVEREPO
|
||||
SHARECODE --> SHARECODEREPO
|
||||
BRANDREPO --> DB
|
||||
MODELREPO --> DB
|
||||
OTAREPO --> DB
|
||||
CURVEREPO --> DB
|
||||
SHARECODEREPO --> DB
|
||||
CURVE --> S3
|
||||
SHARECODE --> CACHE
|
||||
CURVE --> CACHE
|
||||
BRAND --> RESP
|
||||
MODEL --> RESP
|
||||
MODELLIST --> RESP
|
||||
DEVICE --> RESP
|
||||
OTA --> RESP
|
||||
CURVE --> RESP
|
||||
SHARECODE --> RESP
|
||||
MODELLIST --> SEARCH
|
||||
BRAND --> CACHE
|
||||
MODEL --> CACHE
|
||||
@@ -119,16 +148,18 @@ MODELLIST --> ENCODE
|
||||
|
||||
**图表来源**
|
||||
- [cmd/server/main.go:27-108](file://cmd/server/main.go#L27-L108)
|
||||
- [internal/router/router.go:16-56](file://internal/router/router.go#L16-L56)
|
||||
- [internal/router/router.go:16-82](file://internal/router/router.go#L16-L82)
|
||||
- [internal/handler/health.go:10](file://internal/handler/health.go#L10)
|
||||
- [internal/handler/brand.go:18](file://internal/handler/brand.go#L18)
|
||||
- [internal/handler/model.go:18](file://internal/handler/model.go#L18)
|
||||
- [internal/handler/model_list.go:19](file://internal/handler/model_list.go#L19)
|
||||
- [internal/handler/device.go:19](file://internal/handler/device.go#L19)
|
||||
- [internal/handler/ota.go:19](file://internal/handler/ota.go#L19)
|
||||
- [internal/handler/curve.go:37](file://internal/handler/curve.go#L37)
|
||||
- [internal/handler/share_code.go:21](file://internal/handler/share_code.go#L21)
|
||||
|
||||
**章节来源**
|
||||
- [internal/router/router.go:16-56](file://internal/router/router.go#L16-L56)
|
||||
- [internal/router/router.go:16-82](file://internal/router/router.go#L16-L82)
|
||||
- [cmd/server/main.go:27-108](file://cmd/server/main.go#L27-L108)
|
||||
|
||||
## 核心组件
|
||||
@@ -138,6 +169,8 @@ MODELLIST --> ENCODE
|
||||
- **型号检索处理器**：基于 Meilisearch 执行全文检索，依赖搜索客户端实例。
|
||||
- **设备上报处理器**：接收设备信息（MAC、型号、版本、来源 IP），依赖 Redis 客户端。
|
||||
- **OTA固件升级处理器**：处理固件升级请求，支持黑名单过滤、目标设备分布和版本选择等OTA固件升级能力。
|
||||
- **等化曲线处理器**：处理频响曲线计算和参数化EQ生成，支持多种目标曲线和设备源。
|
||||
- **分享代码处理器**：处理EQ数据分享功能，支持创建、查询、导入、删除分享码。
|
||||
|
||||
**章节来源**
|
||||
- [internal/handler/health.go:8-19](file://internal/handler/health.go#L8-L19)
|
||||
@@ -146,9 +179,11 @@ MODELLIST --> ENCODE
|
||||
- [internal/handler/model_list.go:14-24](file://internal/handler/model_list.go#L14-L24)
|
||||
- [internal/handler/device.go:14-24](file://internal/handler/device.go#L14-L24)
|
||||
- [internal/handler/ota.go:14-21](file://internal/handler/ota.go#L14-L21)
|
||||
- [internal/handler/curve.go:27-39](file://internal/handler/curve.go#L27-L39)
|
||||
- [internal/handler/share_code.go:15-23](file://internal/handler/share_code.go#L15-L23)
|
||||
|
||||
## 架构总览
|
||||
下图展示从请求进入至响应返回的关键路径，以及处理器与仓储、搜索、缓存、日志等组件的交互，体现了完整的依赖注入架构。新增的OTA功能通过独立的处理流程支持复杂的固件升级场景。
|
||||
下图展示从请求进入至响应返回的关键路径，以及处理器与仓储、搜索、缓存、日志等组件的交互，体现了完整的依赖注入架构。新增的分享码和等化曲线功能通过独立的处理流程支持复杂的业务场景。
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
@@ -180,21 +215,40 @@ DB-->>REPO : "命中/未命中"
|
||||
H->>REPO : "FindTargetDevice(ctx, otaID, mac)"
|
||||
REPO->>DB : "检查定向设备"
|
||||
DB-->>REPO : "匹配/不匹配"
|
||||
else "等化曲线"
|
||||
H->>REPO : "GetModelByBrandAndName(ctx, brand, name)"
|
||||
REPO->>DB : "查询型号信息"
|
||||
DB-->>REPO : "型号记录"
|
||||
H->>REPO : "GetTargetByLabel(ctx, target)"
|
||||
REPO->>DB : "查询目标曲线"
|
||||
DB-->>REPO : "目标记录"
|
||||
H->>DB : "调用外部EQ接口"
|
||||
DB-->>H : "参数化EQ数据"
|
||||
else "分享代码"
|
||||
H->>DB : "Redis 操作：创建/查询/删除"
|
||||
DB-->>H : "分享码数据"
|
||||
H->>REPO : "插入分享码日志"
|
||||
REPO->>DB : "写入数据库"
|
||||
DB-->>REPO : "OK"
|
||||
end
|
||||
H->>L : "记录日志/错误"
|
||||
H-->>C : "JSON 响应"
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [internal/router/router.go:45-52](file://internal/router/router.go#L45-L52)
|
||||
- [internal/router/router.go:63-78](file://internal/router/router.go#L63-L78)
|
||||
- [internal/handler/brand.go:29](file://internal/handler/brand.go#L29)
|
||||
- [internal/handler/model.go:30](file://internal/handler/model.go#L30)
|
||||
- [internal/handler/model_list.go:37](file://internal/handler/model_list.go#L37)
|
||||
- [internal/handler/device.go:71](file://internal/handler/device.go#L71)
|
||||
- [internal/handler/ota.go:57-131](file://internal/handler/ota.go#L57-L131)
|
||||
- [internal/handler/curve.go:302-489](file://internal/handler/curve.go#L302-L489)
|
||||
- [internal/handler/share_code.go:40-382](file://internal/handler/share_code.go#L40-382)
|
||||
- [internal/repository/brand.go:23-52](file://internal/repository/brand.go#L23-L52)
|
||||
- [internal/repository/model.go:23-79](file://internal/repository/model.go#L23-L79)
|
||||
- [internal/repository/ota.go:20-158](file://internal/repository/ota.go#L20-L158)
|
||||
- [internal/repository/curve.go:19-65](file://internal/repository/curve.go#L19-L65)
|
||||
- [internal/repository/share_code.go:20-58](file://internal/repository/share_code.go#L20-L58)
|
||||
- [internal/search/meilisearch.go:22-45](file://internal/search/meilisearch.go#L22-L45)
|
||||
|
||||
## 详细组件分析
|
||||
@@ -210,7 +264,7 @@ H-->>C : "JSON 响应"
|
||||
**章节来源**
|
||||
- [internal/handler/health.go:8-19](file://internal/handler/health.go#L8-L19)
|
||||
- [internal/response/response.go:15-21](file://internal/response/response.go#L15-L21)
|
||||
- [internal/router/router.go:42](file://internal/router/router.go#L42)
|
||||
- [internal/router/router.go:55](file://internal/router/router.go#L55)
|
||||
|
||||
### 品牌处理器（BrandHandler）
|
||||
- **职责**：根据品牌名称模糊查询品牌列表。
|
||||
@@ -458,6 +512,126 @@ RespInternal --> End
|
||||
- [internal/repository/ota.go:20-158](file://internal/repository/ota.go#L20-L158)
|
||||
- [internal/model/ota.go:6-42](file://internal/model/ota.go#L6-L42)
|
||||
|
||||
### 等化曲线处理器（CurveHandler）
|
||||
- **职责**：处理频响曲线计算和参数化EQ生成，支持多种目标曲线和设备源。
|
||||
- **输入参数**：
|
||||
- 查询字符串：brand（必填）
|
||||
- 查询字符串：name（必填）
|
||||
- 查询字符串：target（可选，modelCurve接口固定为Harman over-ear 2018）
|
||||
- 查询字符串：base64Resp（可选，默认关闭）
|
||||
- **处理流程**：
|
||||
1. 参数校验：验证brand、name和target参数
|
||||
2. 缓存查询：优先查询Redis缓存，包含独立存储的fr数据优化
|
||||
3. 分布式锁：缓存未命中时获取分布式锁避免并发重复请求
|
||||
4. 外部API调用：调用EQ计算接口获取参数化EQ数据
|
||||
5. 缓存写入：将结果写入Redis缓存，分离存储fr数据
|
||||
6. 响应返回：根据base64Resp参数决定响应格式
|
||||
- **错误处理**：
|
||||
- 参数校验失败返回统一错误
|
||||
- 缓存操作失败记录警告并继续处理
|
||||
- 外部API调用失败返回统一内部错误
|
||||
- 分布式锁获取失败返回统一内部错误
|
||||
- **数据模型**：Model、Target
|
||||
- **依赖注入**：通过 NewCurveHandler 构造函数注入 CurveRepository、CurveCache、EqualizeConfig、S3Storage 和 zap.Logger
|
||||
- **S3集成**：支持从S3读取CSV文件作为测量数据
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start(["进入 CurveHandler"]) --> ParseParams["解析参数 brand/name/target/base64Resp"]
|
||||
ParseParams --> Validate{"参数校验通过？"}
|
||||
Validate -- 否 --> BadReq["返回BadRequest错误"]
|
||||
Validate -- 是 --> CacheQuery["查询Redis缓存"]
|
||||
CacheQuery --> CacheHit{"缓存命中？"}
|
||||
CacheHit -- 是 --> ReturnCached["返回缓存数据"]
|
||||
CacheHit -- 否 --> AcquireLock["获取分布式锁"]
|
||||
AcquireLock --> LockOK{"获取成功？"}
|
||||
LockOK -- 否 --> WaitRetry["等待后重试"]
|
||||
WaitRetry --> CacheQuery
|
||||
LockOK -- 是 --> DoubleCheck["双重检查缓存"]
|
||||
DoubleCheck --> CacheHit2{"缓存已存在？"}
|
||||
CacheHit2 -- 是 --> ReleaseLock["释放锁"]
|
||||
ReleaseLock --> ReturnCached
|
||||
CacheHit2 -- 否 --> CallEQ["调用外部EQ接口"]
|
||||
CallEQ --> ProcessResult["处理返回结果"]
|
||||
ProcessResult --> SplitFR["分离fr数据"]
|
||||
SplitFR --> WriteCache["写入Redis缓存"]
|
||||
WriteCache --> ReleaseLock2["释放锁"]
|
||||
ReleaseLock2 --> ReturnResult["返回结果"]
|
||||
BadReq --> End(["结束"])
|
||||
ReturnCached --> End
|
||||
ReturnResult --> End
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [internal/handler/curve.go:214-292](file://internal/handler/curve.go#L214-L292)
|
||||
- [internal/handler/curve.go:301-368](file://internal/handler/curve.go#L301-L368)
|
||||
|
||||
**章节来源**
|
||||
- [internal/handler/curve.go:27-582](file://internal/handler/curve.go#L27-L582)
|
||||
- [internal/repository/curve.go:19-65](file://internal/repository/curve.go#L19-L65)
|
||||
- [internal/model/model.go:5-15](file://internal/model/model.go#L5-L15)
|
||||
- [internal/model/target.go:5-14](file://internal/model/target.go#L5-L14)
|
||||
|
||||
### 分享代码处理器（ShareCodeHandler）
|
||||
- **职责**：处理EQ数据分享功能，支持创建、查询、导入、删除分享码，包含Redis缓存、分布式锁和异步持久化。
|
||||
- **输入参数**：
|
||||
- POST /audio/shareCreate：mac（必填）、model（必填）、eq_data（必填）
|
||||
- GET /audio/shareList：mac（必填）
|
||||
- GET /audio/shareQuery：shareCode（必填）
|
||||
- GET /audio/shareAccept：mac（必填）、model（必填）、shareCode（必填）
|
||||
- GET /audio/shareDelete：mac（必填）、shareCode（必填）
|
||||
- **处理流程**：
|
||||
1. 参数校验：验证所有必需参数，检查设备型号有效性
|
||||
2. 分布式锁：创建分享码时获取分布式锁避免重复
|
||||
3. Redis操作：使用Lua脚本原子性写入多个键值对
|
||||
4. 缓存查询：查询MAC地址对应的未过期分享码数量
|
||||
5. 异步持久化：将操作记录放入队列，由后台任务刷入数据库
|
||||
6. 响应返回：根据base64Resp参数决定响应格式
|
||||
- **错误处理**：
|
||||
- 参数校验失败返回统一错误
|
||||
- Redis操作失败记录错误并返回统一内部错误
|
||||
- 分布式锁获取失败返回统一内部错误
|
||||
- 设备型号无效返回统一错误
|
||||
- **数据模型**：ShareCodeData、ShareCodeLog
|
||||
- **依赖注入**：通过 NewShareCodeHandler 构造函数注入 ShareCodeCache、zap.Logger 和 maxPerMac
|
||||
- **Redis结构**：share:{code}、share:mac:{mac}、share:pending、share:import:pending等
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start(["进入 ShareCodeHandler"]) --> ParseAction["解析具体操作"]
|
||||
ParseAction --> CreateShare["创建分享码"]
|
||||
CreateShare --> ValidateParams["参数校验"]
|
||||
ValidateParams --> CheckCount["检查MAC分享码数量"]
|
||||
CheckCount --> AcquireLock["获取分布式锁"]
|
||||
AcquireLock --> AtomicWrite["Lua原子写入Redis"]
|
||||
AtomicWrite --> EnqueuePending["加入待持久化队列"]
|
||||
EnqueuePending --> ReturnResult["返回分享码"]
|
||||
Start --> QueryShare["查询分享码"]
|
||||
QueryShare --> ValidateQuery["参数校验"]
|
||||
ValidateQuery --> ListByMAC["按MAC查询未过期分享码"]
|
||||
ListByMAC --> ReturnList["返回分享码列表"]
|
||||
Start --> AcceptShare["接受分享码"]
|
||||
AcceptShare --> ValidateAccept["参数校验"]
|
||||
ValidateAccept --> LookupCode["查找分享码"]
|
||||
LookupCode --> EnqueueImport["加入导入持久化队列"]
|
||||
EnqueueImport --> ReturnData["返回EQ数据"]
|
||||
Start --> DeleteShare["删除分享码"]
|
||||
DeleteShare --> ValidateDelete["参数校验"]
|
||||
ValidateDelete --> CheckOwnership["校验所有权"]
|
||||
CheckOwnership --> DeleteRedis["删除Redis数据"]
|
||||
DeleteRedis --> ReturnDelete["返回删除结果"]
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [internal/handler/share_code.go:40-382](file://internal/handler/share_code.go#L40-382)
|
||||
- [internal/cache/share_code_cache.go:142-331](file://internal/cache/share_code_cache.go#L142-331)
|
||||
|
||||
**章节来源**
|
||||
- [internal/handler/share_code.go:15-383](file://internal/handler/share_code.go#L15-L383)
|
||||
- [internal/cache/share_code_cache.go:33-353](file://internal/cache/share_code_cache.go#L33-L353)
|
||||
- [internal/repository/share_code.go:12-59](file://internal/repository/share_code.go#L12-L59)
|
||||
- [internal/model/share_code.go:5-25](file://internal/model/share_code.go#L5-L25)
|
||||
|
||||
## 依赖注入模式详解
|
||||
|
||||
### 依赖注入架构
|
||||
@@ -469,23 +643,33 @@ MAIN["main.go<br/>应用启动"] --> ROUTER["router.New()<br/>集中装配依赖
|
||||
ROUTER --> DB["sql.DB<br/>数据库连接"]
|
||||
ROUTER --> RDB["redis.Client<br/>Redis客户端"]
|
||||
ROUTER --> SEARCH["search.Client<br/>Meilisearch客户端"]
|
||||
ROUTER --> S3["storage.S3Storage<br/>S3存储"]
|
||||
ROUTER --> LOG["zap.Logger<br/>日志器"]
|
||||
ROUTER --> EQCFG["config.EqualizeConfig<br/>等化配置"]
|
||||
ROUTER --> SHAREMAX["int<br/>分享码数量限制"]
|
||||
ROUTER --> SHARETTL["time.Duration<br/>分享码TTL"]
|
||||
ROUTER --> BRANCACHE["cache.BrandCache<br/>品牌缓存"]
|
||||
ROUTER --> MODELCACHE["cache.ModelCache<br/>型号缓存"]
|
||||
ROUTER --> CURVECACHE["cache.CurveCache<br/>曲线缓存"]
|
||||
ROUTER --> SHARECODECACHE["cache.ShareCodeCache<br/>分享码缓存"]
|
||||
ROUTER --> BRANDREPO["repository.NewBrandRepository()<br/>品牌仓储"]
|
||||
ROUTER --> MODELREPO["repository.NewModelRepository()<br/>型号仓储"]
|
||||
ROUTER --> OTAREPO["repository.NewOTARepository()<br/>OTA仓储"]
|
||||
ROUTER --> CURVEREPO["repository.NewCurveRepository()<br/>曲线仓储"]
|
||||
ROUTER --> SHARECODEREPO["repository.NewShareCodeRepository()<br/>分享码仓储"]
|
||||
ROUTER --> HEALTH["handler.NewHealthHandler()<br/>健康检查处理器"]
|
||||
ROUTER --> BRAND["handler.NewBrandHandler()<br/>品牌处理器"]
|
||||
ROUTER --> MODEL["handler.NewModelHandler()<br/>型号处理器"]
|
||||
ROUTER --> MODELLIST["handler.NewModelListHandler()<br/>型号检索处理器"]
|
||||
ROUTER --> DEVICE["handler.NewDeviceHandler()<br/>设备上报处理器"]
|
||||
ROUTER --> OTA["handler.NewOTAHandler()<br/>OTA固件升级处理器"]
|
||||
ROUTER --> CURVE["handler.NewCurveHandler()<br/>等化曲线处理器"]
|
||||
ROUTER --> SHARECODE["handler.NewShareCodeHandler()<br/>分享代码处理器"]
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [cmd/server/main.go:77](file://cmd/server/main.go#L77)
|
||||
- [internal/router/router.go:16-56](file://internal/router/router.go#L16-L56)
|
||||
- [internal/router/router.go:22-82](file://internal/router/router.go#L22-L82)
|
||||
|
||||
### 依赖注入优势
|
||||
- **测试友好**：可以轻松注入模拟对象进行单元测试
|
||||
@@ -494,7 +678,7 @@ ROUTER --> OTA["handler.NewOTAHandler()<br/>OTA固件升级处理器"]
|
||||
- **生命周期管理**：依赖项的创建和销毁由路由集中管理
|
||||
|
||||
### 仓储层依赖
|
||||
BrandRepository、ModelRepository 和 OTARepository 现在接收相应的依赖：
|
||||
BrandRepository、ModelRepository、OTARepository、CurveRepository 和 ShareCodeRepository 现在接收相应的依赖：
|
||||
|
||||
```mermaid
|
||||
classDiagram
|
||||
@@ -523,6 +707,18 @@ class OTARepository {
|
||||
+ IsInBlackList(ctx, otaID, mac) : "bool,error"
|
||||
+ FindTargetDevice(ctx, otaID, mac) : "OTATargetDevice,error"
|
||||
}
|
||||
class CurveRepository {
|
||||
- db : "sql.DB"
|
||||
+ NewCurveRepository(db) : "CurveRepository"
|
||||
+ GetModelByBrandAndName(ctx, brandName, name) : "Model,error"
|
||||
+ GetTargetByLabel(ctx, label) : "Target,error"
|
||||
}
|
||||
class ShareCodeRepository {
|
||||
- db : "sql.DB"
|
||||
+ NewShareCodeRepository(db) : "ShareCodeRepository"
|
||||
+ InsertLog(ctx, log) : "error"
|
||||
+ HasExportLog(ctx, shareCode) : "bool,error"
|
||||
}
|
||||
class BrandCache {
|
||||
- rdb : "redis.Client"
|
||||
+ NewBrandCache(rdb) : "BrandCache"
|
||||
@@ -537,30 +733,62 @@ class ModelCache {
|
||||
+ GetAll(ctx) : "[]Model,error"
|
||||
+ SetAll(ctx, list) : "error"
|
||||
}
|
||||
class CurveCache {
|
||||
- rdb : "redis.Client"
|
||||
+ NewCurveCache(rdb) : "CurveCache"
|
||||
+ Get(ctx, brand, name, target) : "string,error"
|
||||
+ Set(ctx, brand, name, target, data) : "error"
|
||||
+ GetFR(ctx, brand, name) : "string,error"
|
||||
+ GetWithFR(ctx, brand, name, target) : "string,error"
|
||||
+ AcquireLock(ctx, brand, name, target) : "bool,error"
|
||||
+ ReleaseLock(ctx, brand, name, target) : "error"
|
||||
}
|
||||
class ShareCodeCache {
|
||||
- rdb : "redis.Client"
|
||||
- codeTTL : "time.Duration"
|
||||
+ NewShareCodeCache(rdb, codeTTL) : "ShareCodeCache"
|
||||
+ Create(ctx, macAddr, ipAddr, model, eqData) : "ShareCodeData,error"
|
||||
+ Get(ctx, shareCode) : "ShareCodeData,error"
|
||||
+ ListByMac(ctx, macAddr) : "[]ShareCodeData,error"
|
||||
+ Delete(ctx, macAddr, shareCode) : "ShareDeleteResult,error"
|
||||
+ EnqueueImportLog(ctx, macAddr, shareCode, model, ipAddr, eqData, expireAt) : "error"
|
||||
+ AcquireFlushLock(ctx, shareCode) : "bool,error"
|
||||
+ ReleaseFlushLock(ctx, shareCode) : "error"
|
||||
}
|
||||
BrandRepository --> BrandCache : "依赖注入"
|
||||
ModelRepository --> ModelCache : "依赖注入"
|
||||
OTARepository --> DB : "依赖注入"
|
||||
CurveRepository --> DB : "依赖注入"
|
||||
ShareCodeRepository --> DB : "依赖注入"
|
||||
CurveCache --> RDB : "依赖注入"
|
||||
ShareCodeCache --> RDB : "依赖注入"
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [internal/repository/brand.go:14-21](file://internal/repository/brand.go#L14-L21)
|
||||
- [internal/repository/model.go:14-21](file://internal/repository/model.go#L14-L21)
|
||||
- [internal/repository/ota.go:11-17](file://internal/repository/ota.go#L11-L17)
|
||||
- [internal/repository/curve.go:11-17](file://internal/repository/curve.go#L11-L17)
|
||||
- [internal/repository/share_code.go:12-18](file://internal/repository/share_code.go#L12-L18)
|
||||
- [internal/cache/brand_cache.go:18-24](file://internal/cache/brand_cache.go#L18-L24)
|
||||
- [internal/cache/model_cache.go:19-25](file://internal/cache/model_cache.go#L19-L25)
|
||||
- [internal/cache/curve_cache.go:18-25](file://internal/cache/curve_cache.go#L18-L25)
|
||||
- [internal/cache/share_code_cache.go:128-135](file://internal/cache/share_code_cache.go#L128-L135)
|
||||
|
||||
**章节来源**
|
||||
- [internal/router/router.go:16-56](file://internal/router/router.go#L16-L56)
|
||||
- [internal/router/router.go:22-82](file://internal/router/router.go#L22-L82)
|
||||
- [cmd/server/main.go:77](file://cmd/server/main.go#L77)
|
||||
|
||||
## 依赖分析
|
||||
- **依赖注入模式**：
|
||||
- 所有处理器通过构造函数注入依赖项，包括仓储、搜索客户端、Redis 客户端与日志器。
|
||||
- 所有处理器通过构造函数注入依赖项，包括仓储、搜索客户端、Redis 客户端、S3存储与日志器。
|
||||
- 路由在应用启动时集中装配，保证依赖一次性构建与共享。
|
||||
- **组件耦合**：
|
||||
- 处理器与仓储之间为单向依赖，职责清晰。
|
||||
- 搜索与缓存作为外部服务，通过客户端封装接入。
|
||||
- OTA处理器与数据库直接交互，提供完整的OTA数据访问能力。
|
||||
- CurveHandler与外部EQ接口和S3存储集成，支持复杂的音频处理。
|
||||
- ShareCodeHandler与Redis缓存深度集成，实现高性能的分享码管理。
|
||||
- **可能的循环依赖**：
|
||||
- 当前结构未见循环导入，符合 Go 包管理最佳实践。
|
||||
|
||||
@@ -573,40 +801,49 @@ ROUTER --> MODEL["model.go"]
|
||||
ROUTER --> MODELLIST["model_list.go"]
|
||||
ROUTER --> DEVICE["device.go"]
|
||||
ROUTER --> OTA["ota.go"]
|
||||
ROUTER --> CURVE["curve.go"]
|
||||
ROUTER --> SHARECODE["share_code.go"]
|
||||
BRAND --> BREPO["repository/brand.go"]
|
||||
MODEL --> MREPO["repository/model.go"]
|
||||
OTA --> OTAREPO["repository/ota.go"]
|
||||
CURVE --> CURVEREPO["repository/curve.go"]
|
||||
SHARECODE --> SHARECODEREPO["repository/share_code.go"]
|
||||
BRAND --> BREPO
|
||||
BREPO --> BCACHE["cache/brand_cache.go"]
|
||||
MODEL --> MREPO
|
||||
MREPO --> MCACHE["cache/model_cache.go"]
|
||||
OTA --> OTAREPO
|
||||
OTAREPO --> DB["MySQL数据库"]
|
||||
BRAND --> ENCODE["pkg/encode/base64.go"]
|
||||
MODEL --> ENCODE
|
||||
MODELLIST --> ENCODE
|
||||
OTA --> ENCODE
|
||||
CURVE --> CURVEREPO
|
||||
CURVEREPO --> DB["MySQL数据库"]
|
||||
SHARECODE --> SHARECODEREPO
|
||||
SHARECODEREPO --> DB
|
||||
CURVE --> S3["S3存储"]
|
||||
CURVE --> ENCODE["pkg/encode/base64.go"]
|
||||
SHARECODE --> ENCODE
|
||||
ALL["各处理器"] --> RESP["internal/response/response.go"]
|
||||
ALL --> LOG["zap.Logger"]
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [cmd/server/main.go:77](file://cmd/server/main.go#L77)
|
||||
- [internal/router/router.go:16-56](file://internal/router/router.go#L16-L56)
|
||||
- [internal/router/router.go:22-82](file://internal/router/router.go#L22-L82)
|
||||
- [internal/handler/brand.go:18](file://internal/handler/brand.go#L18)
|
||||
- [internal/handler/model.go:18](file://internal/handler/model.go#L18)
|
||||
- [internal/handler/model_list.go:19](file://internal/handler/model_list.go#L19)
|
||||
- [internal/handler/device.go:19](file://internal/handler/device.go#L19)
|
||||
- [internal/handler/ota.go:19](file://internal/handler/ota.go#L19)
|
||||
- [internal/handler/curve.go:37](file://internal/handler/curve.go#L37)
|
||||
- [internal/handler/share_code.go:21](file://internal/handler/share_code.go#L21)
|
||||
- [internal/repository/brand.go:19](file://internal/repository/brand.go#L19)
|
||||
- [internal/repository/model.go:19](file://internal/repository/model.go#L19)
|
||||
- [internal/repository/ota.go:15](file://internal/repository/ota.go#L15)
|
||||
- [internal/repository/curve.go:15](file://internal/repository/curve.go#L15)
|
||||
- [internal/repository/share_code.go:16](file://internal/repository/share_code.go#L16)
|
||||
- [internal/search/meilisearch.go:17](file://internal/search/meilisearch.go#L17)
|
||||
- [pkg/encode/base64.go:8](file://pkg/encode/base64.go#L8)
|
||||
- [internal/response/response.go:9](file://internal/response/response.go#L9)
|
||||
|
||||
**章节来源**
|
||||
- [internal/router/router.go:16-56](file://internal/router/router.go#L16-L56)
|
||||
- [internal/router/router.go:22-82](file://internal/router/router.go#L22-L82)
|
||||
- [cmd/server/main.go:27-108](file://cmd/server/main.go#L27-L108)
|
||||
|
||||
## 性能考虑
|
||||
@@ -617,23 +854,34 @@ ALL --> LOG["zap.Logger"]
|
||||
- 品牌与型号查询均使用 ORDER BY 与 LIKE，建议在数据库侧建立合适索引以提升模糊查询性能。
|
||||
- OTA查询涉及多表关联，建议在ota表的model、hw、beta、status字段建立复合索引。
|
||||
- 仓储层现在支持缓存降级，当缓存不可用时自动回退到数据库查询。
|
||||
- 分享码持久化查询优化，使用索引加速查询。
|
||||
- **搜索与缓存**
|
||||
- Meilisearch 适合全文检索，建议合理设置属性检索范围与分页大小。
|
||||
- Redis 写入为单键 HSet，具备良好吞吐能力；建议评估内存占用与持久化策略。
|
||||
- 缓存层现在支持全量缓存和按品牌缓存两种策略，提升查询性能。
|
||||
- **OTA查询优化**
|
||||
- OTA查询流程涉及多次数据库查询，建议在黑名单表和定向设备表建立适当的索引。
|
||||
- 可以考虑缓存常用的OTA查询结果，减少数据库压力。
|
||||
- **新增**：CurveHandler的fr数据独立存储优化，避免每个target重复存储fr数据。
|
||||
- **新增**：ShareCodeCache使用Lua脚本原子性操作，减少网络往返。
|
||||
- **外部服务集成**
|
||||
- EQ接口调用设置10秒超时，避免阻塞请求。
|
||||
- S3读取CSV文件时进行错误处理和缓存优化。
|
||||
- 分布式锁避免并发重复请求EQ接口。
|
||||
- **分享码性能优化**
|
||||
- Redis ZSET存储MAC到分享码的映射，支持快速查询未过期分享码。
|
||||
- 分布式锁防止重复创建分享码。
|
||||
- 异步持久化任务批量刷入数据库，减少实时写入压力。
|
||||
- 分享码TTL配置支持灵活的时间单位（分钟、小时、天）。
|
||||
- **中间件与日志**
|
||||
- 开启 Recovery、CORS、Logger、RequestID 中间件，有助于可观测性与稳定性；注意日志级别与输出频率对性能的影响。
|
||||
- **并发安全**
|
||||
- Redis HSet 为线程安全操作；处理器方法本身无共享可变状态，天然并发安全。
|
||||
- 分布式锁确保同一资源的串行访问。
|
||||
- 依赖注入模式减少了全局状态，提升了并发安全性。
|
||||
- **最佳实践**
|
||||
- 在生产环境启用 Release 模式，降低框架开销。
|
||||
- 对外部依赖（数据库、搜索、缓存）增加超时与重试策略，提升鲁棒性。
|
||||
- 对外部依赖（数据库、搜索、缓存、S3）增加超时与重试策略，提升鲁棒性。
|
||||
- 利用缓存预热机制，在应用启动时加载常用数据到缓存。
|
||||
- OTA查询流程复杂，建议添加适当的超时控制和错误重试机制。
|
||||
- **新增**：分享码持久化任务建议设置合理的间隔时间，平衡实时性和性能。
|
||||
|
||||
## 故障排查指南
|
||||
- **健康检查失败**
|
||||
@@ -654,6 +902,19 @@ ALL --> LOG["zap.Logger"]
|
||||
- 关注"query ota failed"、"check black list failed"、"check target device failed"等错误日志。
|
||||
- 检查数据库连接，确认ota、black_list、ota_target_device表存在且结构正确。
|
||||
- 验证OTA状态、硬件版本号、灰度标识等字段是否符合预期。
|
||||
- **等化曲线异常**
|
||||
- 校验必填参数 brand、name 是否传入且格式正确。
|
||||
- 关注"get curve point failed"、"get model curve failed"等错误日志。
|
||||
- 检查外部EQ接口连通性和响应格式。
|
||||
- 验证S3存储权限和CSV文件是否存在。
|
||||
- 关注分布式锁获取失败的情况。
|
||||
- **分享代码异常**
|
||||
- 校验必填参数是否完整，特别是POST请求的JSON格式。
|
||||
- 关注"参数校验失败"、"系统错误"等错误信息。
|
||||
- 检查Redis连接状态和Lua脚本执行情况。
|
||||
- 验证分享码TTL配置是否正确。
|
||||
- 关注分布式锁获取失败和权限验证失败的情况。
|
||||
- 检查异步持久化任务是否正常运行。
|
||||
- **依赖注入相关问题**
|
||||
- 确认所有处理器都通过构造函数正确注入了依赖项。
|
||||
- 检查路由装配顺序，确保依赖项在处理器之前创建。
|
||||
@@ -669,12 +930,14 @@ ALL --> LOG["zap.Logger"]
|
||||
- [internal/handler/model_list.go:38-42](file://internal/handler/model_list.go#L38-L42)
|
||||
- [internal/handler/device.go:61-78](file://internal/handler/device.go#L61-L78)
|
||||
- [internal/handler/ota.go:58-94](file://internal/handler/ota.go#L58-L94)
|
||||
- [internal/handler/curve.go:93-95](file://internal/handler/curve.go#L93-L95)
|
||||
- [internal/handler/share_code.go:87-111](file://internal/handler/share_code.go#L87-L111)
|
||||
- [internal/response/response.go:15-36](file://internal/response/response.go#L15-L36)
|
||||
- [internal/middleware/logger.go:10-45](file://internal/middleware/logger.go#L10-L45)
|
||||
- [internal/middleware/request_id.go:20-31](file://internal/middleware/request_id.go#L20-L31)
|
||||
|
||||
## 结论
|
||||
本处理器模块采用全新的依赖注入模式，通过构造函数注入依赖项，实现了更好的解耦和可测试性。通过统一响应体与自定义 Base64 编码实现灵活的输出策略，结合 Gin 中间件与外部服务（数据库、Meilisearch、Redis）形成稳定高效的业务处理链路。新增的OTA固件升级功能提供了完整的固件升级能力，包括黑名单过滤、目标设备分布和版本选择等特性。新的架构模式简化了处理器实现，提升了代码质量，建议在生产环境中进一步完善超时与重试、索引优化与缓存策略，持续提升性能与可靠性。
|
||||
本处理器模块采用全新的依赖注入模式，通过构造函数注入依赖项，实现了更好的解耦和可测试性。通过统一响应体与自定义 Base64 编码实现灵活的输出策略，结合 Gin 中间件与外部服务（数据库、Meilisearch、Redis、S3）形成稳定高效的业务处理链路。新增的分享码和等化曲线功能提供了完整的业务能力，包括高性能的Redis缓存、分布式锁、异步持久化和复杂的音频处理流程。新的架构模式简化了处理器实现，提升了代码质量，建议在生产环境中进一步完善超时与重试、索引优化与缓存策略，持续提升性能与可靠性。
|
||||
|
||||
## 附录
|
||||
- **路由与处理器映射**
|
||||
@@ -684,35 +947,57 @@ ALL --> LOG["zap.Logger"]
|
||||
- /audio/modelList -> ModelListHandler.ModelList
|
||||
- /audio/reportDevInfo -> DeviceHandler.ReportDevInfo
|
||||
- /audio/ota -> OTAHandler.GetOTA
|
||||
- /audio/getCurve -> CurveHandler.GetCurve
|
||||
- /audio/modelCurve -> CurveHandler.ModelCurve
|
||||
- /audio/shareCreate -> ShareCodeHandler.ExportShareCode
|
||||
- /audio/shareList -> ShareCodeHandler.ListShareCodesByMac
|
||||
- /audio/shareQuery -> ShareCodeHandler.QueryShareCode
|
||||
- /audio/shareAccept -> ShareCodeHandler.ImportShareCode
|
||||
- /audio/shareDelete -> ShareCodeHandler.DeleteShareCode
|
||||
- **依赖注入示例**
|
||||
- 品牌处理器：BrandHandler.NewBrandHandler(brandRepo, log)
|
||||
- 型号处理器：ModelHandler.NewModelHandler(modelRepo, log)
|
||||
- 型号检索处理器：ModelListHandler.NewModelListHandler(searchClient, log)
|
||||
- 设备上报处理器：DeviceHandler.NewDeviceHandler(redis, log)
|
||||
- OTA固件升级处理器：OTAHandler.NewOTAHandler(otaRepo, log)
|
||||
- **OTA查询参数说明**
|
||||
- model：设备型号（必填）
|
||||
- hw：硬件版本号（必填）
|
||||
- mac：设备MAC地址（可选）
|
||||
- beta：灰度标识（可选，默认0）
|
||||
- **OTA数据模型字段**
|
||||
- OTA：id、verCode、verName、url、md5、force、desc、model、hw、target、beta、pawVerCode、pawVerName、pawUrl、pawMd5、startTime、endTime、status
|
||||
- BlackList：id、ota_id、mac、create_at
|
||||
- OTATargetDevice：id、ota_id、mac_addr、type、create_at
|
||||
- 等化曲线处理器：CurveHandler.NewCurveHandler(curveRepo, curveCache, eqCfg, s3, log)
|
||||
- 分享代码处理器：ShareCodeHandler.NewShareCodeHandler(shareCache, log, maxPerMac)
|
||||
- **等化曲线查询参数说明**
|
||||
- brand：设备品牌（必填）
|
||||
- name：设备型号（必填）
|
||||
- target：目标曲线名称（可选，默认modelCurve固定为Harman over-ear 2018）
|
||||
- base64Resp：是否返回base64编码响应（可选）
|
||||
- **等化曲线数据模型字段**
|
||||
- Model：id、brand_name、name、form、rig、source、eq_key、create_at
|
||||
- Target：id、label、read_csv、file、bassBoost、addTime
|
||||
- **分享代码查询参数说明**
|
||||
- POST /audio/shareCreate：mac（必填）、model（必填）、eq_data（必填）
|
||||
- GET /audio/shareList：mac（必填）
|
||||
- GET /audio/shareQuery：shareCode（必填）
|
||||
- GET /audio/shareAccept：mac（必填）、model（必填）、shareCode（必填）
|
||||
- GET /audio/shareDelete：mac（必填）、shareCode（必填）
|
||||
- **分享代码数据模型字段**
|
||||
- ShareCodeData：share_code、mac_addr、ip_addr、model、eq_data、expire_at、persisted
|
||||
- ShareCodeLog：id、mac_addr、share_code、action、model、ip_addr、eq_data、expire_at、create_at
|
||||
- **数据库表结构**
|
||||
- ota表：存储OTA固件升级记录
|
||||
- black_list表：存储OTA黑名单
|
||||
- ota_target_device表：存储OTA定向设备
|
||||
- share_code_log表：存储分享码操作日志
|
||||
- **常用调用示例（路径引用）**
|
||||
- 品牌查询：[internal/handler/brand.go:25](file://internal/handler/brand.go#L25)
|
||||
- 型号查询：[internal/handler/model.go:25](file://internal/handler/model.go#L25)
|
||||
- 型号检索：[internal/handler/model_list.go:26](file://internal/handler/model_list.go#L26)
|
||||
- 设备上报：[internal/handler/device.go:26](file://internal/handler/device.go#L26)
|
||||
- OTA固件升级：[internal/handler/ota.go:25](file://internal/handler/ota.go#L25)
|
||||
- 等化曲线：[internal/handler/curve.go:56](file://internal/handler/curve.go#L56)
|
||||
- 分享代码创建：[internal/handler/share_code.go:40](file://internal/handler/share_code.go#L40)
|
||||
- 健康检查：[internal/handler/health.go:14](file://internal/handler/health.go#L14)
|
||||
- **配置与启动**
|
||||
- 配置加载与环境变量：[internal/config/config.go:18-64](file://internal/config/config.go#L18-L64)
|
||||
- 服务器启动与优雅关闭：[cmd/server/main.go:27-108](file://cmd/server/main.go#L27-L108)
|
||||
- 等化配置：[internal/config/equalize.go:12-33](file://internal/config/equalize.go#L12-L33)
|
||||
- 分享码TTL配置：[internal/config/share_code_ttl.go:15-59](file://internal/config/share_code_ttl.go#L15-L59)
|
||||
- **中间件**
|
||||
- CORS：[internal/middleware/cors.go:7-21](file://internal/middleware/cors.go#L7-L21)
|
||||
- Logger：[internal/middleware/logger.go:10-45](file://internal/middleware/logger.go#L10-L45)
|
||||
@@ -720,9 +1005,18 @@ ALL --> LOG["zap.Logger"]
|
||||
- **缓存策略**
|
||||
- 品牌缓存：brand:all 键，30分钟TTL
|
||||
- 型号缓存：model:brand:{brand} 和 model:all 键，30分钟TTL
|
||||
- 等化曲线缓存：Redis Hash存储，__fr键独立存储fr数据
|
||||
- 分享码缓存：share:{code}、share:mac:{mac}、share:pending等多键结构
|
||||
- 启动时预热缓存，提升首次查询性能
|
||||
- **OTA查询流程**
|
||||
- 最新OTA查询：按model+hw+beta+status=1排序取第一条
|
||||
- 黑名单检查：检查mac是否在指定ota_id的黑名单中
|
||||
- 定向设备检查：检查mac是否在指定ota_id的定向设备列表中
|
||||
- 版本选择：根据检查结果返回合适的OTA版本
|
||||
- **等化曲线查询流程**
|
||||
- 缓存查询：优先查询Redis缓存，包含独立存储的fr数据优化
|
||||
- 分布式锁：缓存未命中时获取分布式锁避免并发重复请求
|
||||
- 外部API调用：调用EQ计算接口获取参数化EQ数据
|
||||
- 缓存写入：将结果写入Redis缓存，分离存储fr数据
|
||||
- 版本选择：根据检查结果返回合适的OTA版本
|
||||
- **分享码查询流程**
|
||||
- 创建分享码：Lua原子性写入多个Redis键，获取分布式锁
|
||||
- 查询分享码：按MAC查询未过期分享码，主动清理过期成员
|
||||
- 导入分享码：验证分享码有效性，加入导入持久化队列
|
||||
- 删除分享码：校验所有权后删除Redis数据
|
||||
- 持久化任务：定时将分享码操作记录刷入MySQL数据库
|
||||
Reference in New Issue
Block a user