Guoguo bb4b80f867 refactor: restructure entire project for human maintainability
Server:
- Add Express framework, replace custom router/request parser
- Create DAO layer (12 files) centralizing all 73 SQL queries
- Rewrite 7 route files as thin Express controllers calling DAOs
- Add SCF-to-Express adapter (lib/serverless.js)
- Add auth middleware (middleware/auth.js)
- Remove dead code from lib/auth.js

Admin console:
- Extract DataTable component (table + pagination)
- Extract ConfirmModal component (modal + form styles)
- Create listMixin for paginated list pages
- Move form styles to common.css for slot compatibility
- Refactor device + subscription pages as examples

Miniprogram:
- Split 734-line BLE monolith into 4 focused modules
  (protocol, connection, commands, barrel index)
- Create API module (utils/api.js) with named functions
- Create page utilities (utils/page.js)
- Refactor index + profile pages to use API module
2026-04-29 05:58:20 -07:00

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
  • design/02-小程序业务流程与状态机.md
  • planning/需求缺口清单.md
  • reviews/代码与设计文档对比分析.md — 历史阶段评审,不能代表当前实现

当前实现提示

  • 当前后端是 server/ 下的腾讯云 HTTP 函数,不是微信云开发函数。
  • 当前小程序通过 HTTPS API 调后端,不再使用 wx.cloud.callFunction()
  • 当前设备不直接连云端 MQTT,设备通信主路径是小程序 BLE 中转。
  • 登录资料授权使用 wx.getUserProfile() 官方弹窗;微信可能返回 微信用户 等脱敏资料。
S
描述
无详细信息
自述文档
1.9 MiB
语言
JavaScript 77.2%
Vue 22%
CSS 0.7%