Hox 文档目录

本目录集中存放项目说明、设计文档、协议资料、计划清单和原型文件，根目录只保留代码目录与仓库级配置。

目录结构

目录	内容
requirements/	产品说明、系统说明等需求来源文档
design/	业务流程、接口、数据库、后台、安全、测试等设计文档
protocols/	BLE、云端通信等协议文档；部分 IoT/MQTT 内容为历史设计参考
planning/	开发计划、当前进度交接、待确认事项、缺口清单
reviews/	代码与文档对比、评审和分析材料；旧评审可能是历史快照
prototypes/	小程序和管理后台原型文件
reference/	原始资料包、UI 导出页、截图等参考材料

当前入口

• planning/PROGRESS.md — 当前实现和部署状态，以此为准
• deploy/tencent-cloud.md — 腾讯云函数、MySQL、COS 部署说明
• requirements/软件系统说明.docx
• requirements/光子美容仪软件系统说明.docx
• design/01-BLE通信协议明细.md
• protocols/BLE协议冲突与问题清单.md
• protocols/协议简述-补充解析.md
• design/02-小程序业务流程与状态机.md
• planning/需求缺口清单.md
• reviews/代码与设计文档对比分析.md — 历史阶段评审，不能代表当前实现

当前实现提示

• 当前后端是 server/ 下的腾讯云 HTTP 函数，不是微信云开发函数。
• 当前小程序通过 HTTPS API 调后端，不再使用 wx.cloud.callFunction()。
• 当前设备不直接连云端 MQTT，设备通信主路径是小程序 BLE 中转。
• 登录资料授权使用 wx.getUserProfile() 官方弹窗；微信可能返回 微信用户 等脱敏资料。