优化部署流程

This commit is contained in:
eafonyang
2026-06-30 13:50:29 +08:00
parent a52adf7e27
commit 23f712cf86
9 changed files with 362 additions and 204 deletions
@@ -44,11 +44,10 @@
## 更新摘要
**变更内容**
- 新增分享代码处理器(ShareCodeHandler):实现EQ数据分享功能,支持创建、查询、导入、删除分享码,包含Redis缓存、分布式锁和异步持久化
- 新增等化曲线处理器(CurveHandler):实现频响曲线计算和参数化EQ生成功能,支持多种目标曲线和设备源
- 新增分享码持久化任务:定时将Redis中的分享码操作记录刷入MySQL数据库
- 新增分享码配置:支持灵活的TTL配置格式(分钟、小时、天)
- 更新路由集成:分享码和等化曲线功能已集成到/audio路由组中
- OTA处理器内部逻辑已简化:移除了paw相关字段处理,现在专注于标准OTA升级流程
- 处理器接口保持不变,继续提供/api/v1/audio/ota端点
- 查询逻辑已更新以适配简化的OTA结构,但仍保持原有的黑名单过滤和定向升级功能
- 数据库结构保持不变,仍包含ota、black_list、ota_target_device表
## 目录
1. [简介](#简介)
@@ -168,7 +167,7 @@ MODELLIST --> ENCODE
- **型号查询处理器**:按品牌或型号关键字查询型号列表,现在依赖 ModelRepository 实例。
- **型号检索处理器**:基于 Meilisearch 执行全文检索,依赖搜索客户端实例。
- **设备上报处理器**:接收设备信息(MAC、型号、版本、来源 IP),依赖 Redis 客户端。
- **OTA固件升级处理器**:处理固件升级请求,支持黑名单过滤、目标设备分布和版本选择等OTA固件升级能力。
- **OTA固件升级处理器**:处理固件升级请求,支持黑名单过滤、目标设备分布和版本选择等OTA固件升级能力。**已简化内部逻辑,移除了paw相关字段处理**。
- **等化曲线处理器**:处理频响曲线计算和参数化EQ生成,支持多种目标曲线和设备源。
- **分享代码处理器**:处理EQ数据分享功能,支持创建、查询、导入、删除分享码。
@@ -457,6 +456,8 @@ RespOK --> End
- [internal/handler/device.go:14-85](file://internal/handler/device.go#L14-L85)
### OTA固件升级处理器(OTAHandler
**更新** OTA处理器内部逻辑已简化,移除了paw相关字段处理,现在专注于标准OTA升级流程。
- **职责**:处理固件升级请求,支持黑名单过滤、目标设备分布和版本选择等OTA固件升级能力。
- **输入参数**
- 查询字符串:model(必填)
@@ -475,6 +476,7 @@ RespOK --> End
- 黑名单或定向设备检查失败返回统一内部错误
- **数据模型**OTA、BlackList、OTATargetDevice
- **依赖注入**:通过 NewOTAHandler 构造函数注入 OTARepository 和 zap.Logger
- **API端点**/audio/ota(保持不变)
```mermaid
flowchart TD
@@ -902,6 +904,7 @@ ALL --> LOG["zap.Logger"]
- 关注"query ota failed"、"check black list failed"、"check target device failed"等错误日志。
- 检查数据库连接,确认ota、black_list、ota_target_device表存在且结构正确。
- 验证OTA状态、硬件版本号、灰度标识等字段是否符合预期。
- **更新**:OTA处理器内部逻辑已简化,不再处理paw相关字段,如遇相关错误请检查其他字段。
- **等化曲线异常**
- 校验必填参数 brand、name 是否传入且格式正确。
- 关注"get curve point failed"、"get model curve failed"等错误日志。
@@ -946,7 +949,7 @@ ALL --> LOG["zap.Logger"]
- /audio/getModel -> ModelHandler.GetModel
- /audio/modelList -> ModelListHandler.ModelList
- /audio/reportDevInfo -> DeviceHandler.ReportDevInfo
- /audio/ota -> OTAHandler.GetOTA
- /audio/ota -> OTAHandler.GetOTA**已简化内部逻辑**
- /audio/getCurve -> CurveHandler.GetCurve
- /audio/modelCurve -> CurveHandler.ModelCurve
- /audio/shareCreate -> ShareCodeHandler.ExportShareCode
@@ -984,6 +987,11 @@ ALL --> LOG["zap.Logger"]
- black_list表:存储OTA黑名单
- ota_target_device表:存储OTA定向设备
- share_code_log表:存储分享码操作日志
- **OTA处理器内部逻辑更新**
- 移除了paw相关字段处理,专注于标准OTA升级流程
- 保持原有API端点:/audio/ota
- 查询逻辑已更新以适配简化的OTA结构
- 仍支持黑名单过滤和定向升级功能
- **常用调用示例(路径引用)**
- 品牌查询:[internal/handler/brand.go:25](file://internal/handler/brand.go#L25)
- 型号查询:[internal/handler/model.go:25](file://internal/handler/model.go#L25)