整理前文档快照：README
这是历史资料，不作为当前操作说明；返回现行页面。原文按文本保存，保留当时方案及验证范围。
text
# 开发进度
本文档记录 YunStack-IoT 项目的开发规划、功能状态和迭代历史。
v0.2至v0.7已按实际用户验收收口，最新内部产品版本为 **v0.7.0**，包含通用配置、本地定时/延时、安全与TLS加固及小程序视觉，见[发布说明](./v0.7.0发布说明.md)。下一主线v0.8初代BLE网关与子设备仍为规划；执行任务与勾选状态以滴答清单为准。此前发布说明和开发记录作为历史保留。
## 目录
| 文档 | 说明 |
|------|------|
| [功能状态](./功能状态.md) | 各模块完成度总览 |
| [开发计划](./开发计划.md) | 近期和远期开发计划 |
| [开发路线](./开发路线.md) | 阶段化开发行动路线（正式入口） |
| [开发记录](./开发记录.md) | 开发迭代历史 |
| [v0.7.0 发布说明](./v0.7.0发布说明.md) | 通用设备配置、本地定时与延时、安全及视觉收尾 |
| [v0.6.0 发布说明](./v0.6.0发布说明.md) | 专属设备页、界面精简、低频历史与固件/网页烧录交付 |
| [v0.5.0 发布说明](./v0.5.0发布说明.md) | 单设备分享、撤权与基础管理内部基线 |
| [v0.4.0 发布说明](./v0.4.0发布说明.md) | 首次内部发布，累计 v0.1–v0.4 已完成功能与验证边界 |
> 开发路线以本目录的 [开发路线](./开发路线.md) 为唯一正式入口。
> `Docs/05.开发指南/08.开发路线.md` 是历史路径，仅保留为迁移说明，不再维护第二份内容。
## 在线环境
| 组件 | 在线地址 | 自动部署 | 触发方式 | 环境性质 | 访问限制 |
|------|----------|----------|----------|----------|----------|
| Web 管理后台 | <https://yunstack.duruofu.cn/> | ✅ GitHub Actions | 推送 `main` 分支（或手动触发） | 在线测试环境 | 站点公开访问；业务功能需登录 |
| 后端 API | <https://yunstack-s.duruofu.cn/> | ✅ GitHub Actions | 推送 `master` 分支（或手动触发） | 在线测试环境 | 健康检查公开；业务 API 按接口鉴权 |
| 文档站 | <https://yunstack-docs.duruofu.com/> | ✅ Cloudflare Pages | 推送后由 Cloudflare Pages 自动构建（分支在 Cloudflare Pages 控制台配置） | 在线测试环境 | 受组织账号身份认证保护 |
| 微信小程序 | — | 无 | 微信开发者工具人工发布 | — | 暂不纳入自动部署 |
- Web、后端与文档站均为**在线测试环境**，不等同于正式生产环境；三者的自动部署均已落地并验证（2026-09-12）。
- 正式生产化、高可用、监控告警、灾备等仍未完成。
- 详细部署架构、触发方式与回滚说明见[部署指南](../05.部署指南.md)。
## 项目阶段
| 阶段 | 状态与方向 |
|------|------------|
| v0.1 / v0.2 / v0.3 | 基础框架、真实设备闭环、安全接入与实时状态已收口 |
| v0.4 | 已收口：两款产品IDF6.1、私有OSS、双分区OTA、任务进度与升级页面 |
| v0.5 | 已收口：单设备分享与撤权实测通过，见[v0.5.0发布说明](./v0.5.0发布说明.md) |
| v0.6 | 已收口：两款专属页、界面精简、低频历史及固件/网页烧录，用户最终确认 |
| v0.7 | 已收口：通用配置与本地定时、继电器/传感器实测与视觉通过 |
| v0.8 | 下一主线：初代BLE网关与子设备，仍为规划 |
| v0.9 / v1.0 | 组合联调 / 生产化与发布 |
范围与退出标准见[开发路线](./开发路线.md)，未实施功能仅为规划。
## 最新版本: v0.7.0 — 通用设备配置与本地定时
v0.2–v0.7已收口，下一主线为v0.8。单设备邀请、共享和撤权已交付；不引入家庭和房间。HA 桥接暂缓，其他 MQTT Broker 的兼容验证仍排在 HA 之后。
### 已完成
| 方向 | 说明 |
|------|------|
| 后端 IoT 能力 | 产品 / 设备 / 设备影子 / 在线状态 / 控制指令 / 时序数据 / 固件 / OTA 任务 / 组织与权限均已落地 |
| 真实硬件接入 | 四路继电器与EnvSense均基于ESP-IDF6.1完成配网、上报及正常OTA；继电器3.1.3→3.1.4、EnvSense1.3.0→1.3.2升级成功 |
| Web 管理后台 | 产品 / 设备 / 遥测看板 / 固件 / 组织 / Dashboard 页面完整 |
| 微信小程序 | 设备列表、设备详情、设备控制、设备设置、遥测历史；首页聚焦设备管理，已移除提前实现的场景入口与本地模拟代码 |
| 工程治理 | 后端单元测试（67 套件 / 733 用例）与 HTTP E2E（20 套件 / 153 用例）全部通过，覆盖率门槛达标；本轮类型检查与构建通过 |
| 真实设备闭环 | 四路继电器完成注册、认证、在线心跳、四路双向控制、本地按键回传、断电恢复、离线判定、30 分钟稳定运行与遥测查询；Web 和微信小程序均已验证 |
| 部署与交付 | Web / 后端 / 文档站已有在线测试环境并接入自动部署（2026-09-12 验证，见上表）；微信小程序暂不纳入自动部署；正式生产化尚未完成 |
| MQTT 安全接入 | 现有 EMQX 6.1.0 已启用后端 HTTP 认证与 Topic 授权；自动验证通过，真实继电器也已完成重新上线、四路控制/回复/影子同步及第 1、4 路按键回传验证 |
### 后续工作
| 事项 | 当前状态 |
|------|----------|
| OTA 专项加固 | 正常升级已验收；继电器编号/按键与正常断电状态恢复已获v0.6确认；主动中断OTA与异常故障恢复保留v0.9任务，不阻塞内部v0.4.0 |
| 首次统一发布 | v0.4.0标签锁定各组件提交；包含累计发布说明和文本组件清单，不提供独立安装/固件压缩包 |
| 单设备分享与基础管理 | v0.5分享与取消已获用户实测确认；SSID/RSSI专项实物显示确认转v0.6，见[联调步骤](../../02.架构与协议/14.设备分享与权限.md) |
| 界面、定时与网关 | v0.6专属/通用页面已收口；v0.7通用配置与定时已验收，v0.8网关仍待实施 |
| 场景引擎（后端） | 未实现；小程序场景模块已移除，当前优先设备接入、设备管理与单设备分享，场景留待后续版本评估 |
| 告警规则引擎 | 暂缓，不作为本轮 v0.5 内容 |
| 基础设施层覆盖率 | Influx / Redis / Prisma、Cache / Mail、WebSocket Service 仍未纳入覆盖率门槛 |
> 以上状态最后更新于 2026-10-27；在线测试环境的自动部署已于 2026-09-12 落地，四路继电器真实设备闭环已于 2026-10-25 验证。详见[功能状态](./功能状态.md)、[开发计划](./开发计划.md)与[开发记录](./开发记录.md)。
> 正式生产化、硬件量产、专项异常恢复与后续版本能力仍未完成，不在本页声明为已完成。
家庭与房间功能移至v1.0之后，再根据实际需要评估是否实施，不作为v1.0交付条件。