跳转至

更新记录

2026-07-27：初始文档整理

  • 创建 docs/ 文档目录，仿照下位机仓库结构组织
  • 重写 README.md，补充服务架构、项目结构、配置说明和快速开始
  • 编写技术文档：云网关总体架构、Hub/Proxy/Auth 核心模块、路由一览、数据流示例和构建验证
  • 编写部署文档：生产环境搭建、Nginx 反向代理、Supervisor 配置、固件发布流程和运维命令
  • 编写安全文档：JWT 认证、设备 Token、CORS 策略、生产配置校验和威胁模型
  • 编写代码风格文档：Python 编码规范、导入顺序、类型注解和异步模式惯例
  • 编写日志文档：日志架构、Logger 层级、输出格式和固件审计日志

2026-07-14：固件发布模块重构

  • 引入 build_slave_manifest() 构建动态固件清单，验证镜像头结构、SHA-256 摘要、CRC32 和产品字段一致性
  • 新增版本发布管理：admin_publish_release、admin_activate_release、admin_list_releases
  • 引入 _bootstrap_legacy() 将旧版单文件固件自动迁移到多版本目录结构
  • 新增固件审计日志 audit.jsonl
  • 新增 _RELEASE_RE 和 _RELEASE_ID_RE 校验，防止路径遍历攻击
  • 添加 /api/v1/admin/firmware/slave/releases 路由组
  • 增强生产环境配置校验，启动时自动检查密钥强度

涉及文件： - api/routes/api_firmware.py — 重构（+~400 行） - api/config.py — 新增固件路径配置

2026-07-10：初始版本

  • 初始项目创建
  • 实现 WebSocket Hub 设备连接管理与消息分发
  • 实现 HTTP Proxy 请求代理转发与超时处理
  • 实现 JWT 认证中间件与 CORS 支持
  • 实现 13 个路由模块：设备、系统、任务、料仓、视觉、硬件、调试、固件、订单、相机、扩展、认证、反馈
  • 创建管理控制台（Console）静态前端框架
  • 创建官方网站（Site）静态页面
  • 编写 DEVICE_PROTOCOL.md 设备通信协议文档
  • 实现模拟设备客户端（mock_device.py）用于开发和测试