更新 wiki

This commit is contained in:
eafonyang
2026-07-30 11:15:28 +08:00
parent 22a24056d6
commit 6a747b514f
8 changed files with 386 additions and 345 deletions
@@ -22,10 +22,11 @@
## 更新摘要
**变更内容**
- 新增用户活动相关接口,支持日活报表数据查询
- 新增设备管理相关接口,支持设备状态统计与监控
- 扩展仪表板统计数据维度,包含用户活跃度与设备使用指标
- 增强时间序列分析能力,支持多维度数据统计
- 新增仪表板API路由功能,包含80行新代码提供仪表板数据检索和报告生成的专用API端点
- 扩展用户活动统计接口,支持日活报表数据查询与多维度分析
- 增强设备管理统计功能,提供设备状态监控与使用指标
- 优化时间序列分析能力,支持更丰富的数据统计维度
- 完善缓存策略与性能优化机制
## 目录
1. [简介](#简介)
@@ -17,10 +17,11 @@
## 更新摘要
**变更内容**
- 后端API路由层得到增强,新增19行代码和5行删除,支持改进的耳机工作流和数据验证过程
- 前端组件路径从views/model调整为views/headphone/model,体现更清晰的业务模块划分
- 后端API路由层得到增强,新增78行代码支持增强的仪表板功能和模型相关操作
- 增强了型号CRUD操作的健壮性和一致性保障
- 完善了异常处理和日志记录机制
- 优化了S3文件自动迁移功能的错误处理逻辑
- 改进了squig.link数据抓取服务的稳定性
## 目录
1. [简介](#简介)
@@ -34,7 +35,7 @@
9. [结论](#结论)
## 简介
本文件为型号管理API的详细RESTful API文档,覆盖型号的CRUD操作、查询筛选与排序、数据验证规则,以及与OTA固件的一对多关联关系与级联操作。文档同时提供前端调用示例与后端实现细节,帮助开发者快速集成与维护。**最新更新**:基于后端API路由层的增强和前端的模块化重构,进一步提升了系统的稳定性和数据一致性保障,改进了耳机工作流的数据验证过程
本文件为型号管理API的详细RESTful API文档,覆盖型号的CRUD操作、查询筛选与排序、数据验证规则,以及与OTA固件的一对多关联关系与级联操作。文档同时提供前端调用示例与后端实现细节,帮助开发者快速集成与维护。**最新更新**:基于后端API路由层的增强功能,新增了78行代码支持增强的仪表板功能和模型相关操作,进一步提升了系统的稳定性和数据一致性保障,改进了异常处理和日志记录机制
## 项目结构
型号管理API位于后端Express应用中,采用模块化设计:
@@ -479,9 +480,9 @@ MS -. 外部 .-> AWS["AWS SDK"]
- [backend/src/middleware/auth.js:3-26](file://backend/src/middleware/auth.js#L3-L26)
- [backend/src/routes/models.js:314-317](file://backend/src/routes/models.js#L314-L317)
- [backend/src/routes/models.js:322-325](file://backend/src/routes/models.js#L322-L325)
- [backend/src/routes/models.js:450-455](file://backend/src/routes/models.js#L450-L455)
- [backend/src/routes/models.js:450-455](file://backend/src/routes/models.js#L450-455)
- [backend/src/services/squiglink.js:33-47](file://backend/src/services/squiglink.js#L33-L47)
- [backend/src/services/measurementStorage.js:149-156](file://backend/src/services/measurementStorage.js#L149-L156)
## 结论
型号管理API提供了完善的CRUD能力、灵活的查询过滤与排序、严格的输入验证、以及与搜索与存储系统的集成。**最新更新**:基于后端API路由层的增强和前端的模块化重构,进一步提升了系统的稳定性和数据一致性保障。智能文件迁移机制确保了在更新型号路径相关字段时,现有CSV文件能够自动迁移到新路径,无需人工干预。结合OTA模型的关联关系,可支撑从型号到固件升级的完整业务闭环。建议在生产环境中关注分页与超时配置、文件上传性能与安全策略、squig.link抓取的超时与缓存策略、S3迁移的性能监控与错误处理,并在删除型号前做好OTA关联清理。
型号管理API提供了完善的CRUD能力、灵活的查询过滤与排序、严格的输入验证、以及与搜索与存储系统的集成。**最新更新**:基于后端API路由层的增强功能,新增了78行代码支持增强的仪表板功能和模型相关操作,进一步提升了系统的稳定性和数据一致性保障。智能文件迁移机制确保了在更新型号路径相关字段时,现有CSV文件能够自动迁移到新路径,无需人工干预。结合OTA模型的关联关系,可支撑从型号到固件升级的完整业务闭环。建议在生产环境中关注分页与超时配置、文件上传性能与安全策略、squig.link抓取的超时与缓存策略、S3迁移的性能监控与错误处理,并在删除型号前做好OTA关联清理。