From 80cd20b2a590421ce12fd28bb7da0d2217775bca Mon Sep 17 00:00:00 2001 From: Codex Date: Tue, 16 Jun 2026 12:24:21 +0800 Subject: [PATCH] =?UTF-8?q?docs(M00):=20=E8=AE=B0=E5=BD=95V5=E5=9F=BA?= =?UTF-8?q?=E7=BA=BF=E6=8E=A8=E9=80=81=E6=A0=A1=E9=AA=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/deployment-changelog.md | 2 +- docs/feature-status.md | 4 ++-- docs/module-status.md | 2 +- docs/repository-completeness.md | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/deployment-changelog.md b/docs/deployment-changelog.md index 93baf63..25ecfb1 100644 --- a/docs/deployment-changelog.md +++ b/docs/deployment-changelog.md @@ -3,7 +3,7 @@ ## 2026-06-16 / V5.0-baseline-local-mqtt - 关联模块：M00-C/M00-E/IOT-001 -- 关联 commit：本轮待提交 +- 关联 commit：`289b64d` - 变化内容：接入 `V5.0.md`，恢复 `V4.8.md` 历史备份，新增 `docs/current-baseline.md`、`docs/local-dev-mqtt.md` 和 `scripts/dev/wsl/check-local-mqtt.sh`。 - 配置变化：记录 WSL 本地 EMQX 5.8.9、MQTTX CLI 1.13.0、五个监听端口和 systemd active/enabled 状态。 - 数据库变化：无。 diff --git a/docs/feature-status.md b/docs/feature-status.md index f3db48c..72ee5a3 100644 --- a/docs/feature-status.md +++ b/docs/feature-status.md @@ -7,7 +7,7 @@ | ENV-001 | 固定 Windows 工作区 | M00-A/M00-B | DONE | 远端 HEAD | 已确认 `D:\qipai`，Git 根、main 分支、固定 origin 和 push 校验通过。 | - | 后续每模块继续复检。 | | REF-001 | 参考资料完整纳管 | M00-A | PARTIAL | 本地 HEAD | 已生成哈希清单、脱敏日志、页面地图、接口线索和旧数据库结构清单；含秘密/依赖/真实数据风险的原始包和 SQL 已移出 Git 跟踪。 | 后续仍需按模块生成正式源码/迁移，旧 xjar 需大文件策略。 | 进入 M00-B/M00-C 前继续保持原包忽略和摘要可追溯。 | | SCM-001 | 模块完成即完整推送 | M00-B/M00-C | PARTIAL | 远端 HEAD | 首次 main push 成功，`HEAD == origin/main` 校验通过；推送脚本已生成。 | 后续模块仍需逐次执行并记录。 | 继续完善 M00-C 的 WSL 实际验证和脚本闭环。 | -| WSL-001 | WSL 隔离辅助验证 | M00-C | PARTIAL | 本轮待提交 | WSL 基础脚本已执行通过；新增本地 MQTT 服务级核验：EMQX 5.8.9 active/enabled，MQTTX CLI 1.13.0，五端口监听。 | 正式后端/后台尚未生成，无法执行完整 Linux 构建；MQTT 认证/ACL/TLS/协议未验收。 | M01/M09 生成项目后在 WSL 原生临时副本执行完整构建；继续补 MQTT 认证与 ACL 测试。 | +| WSL-001 | WSL 隔离辅助验证 | M00-C | PARTIAL | `289b64d` | WSL 基础脚本已执行通过；新增本地 MQTT 服务级核验：EMQX 5.8.9 active/enabled，MQTTX CLI 1.13.0，五端口监听。 | 正式后端/后台尚未生成，无法执行完整 Linux 构建；MQTT 认证/ACL/TLS/协议未验收。 | M01/M09 生成项目后在 WSL 原生临时副本执行完整构建；继续补 MQTT 认证与 ACL 测试。 | | API-001 | 固定 HTTPS API 域名 | M00-E/M01/M08/M10 | PARTIAL | `4cb3ab6` | 已新增 Windows 检查脚本、Ubuntu 菜单检查和固定域名 Nginx 模板。 | DNS/HTTPS 生产验证未执行，后端健康接口未生成。 | 后续接入真实后端健康接口并执行 Windows/WSL/Ubuntu/微信真机验证。 | | TLS-001 | Nginx 与证书自动化 | M00-E/M10 | PARTIAL | `4cb3ab6` | 已生成 Nginx 模板、Certbot 命令说明和菜单第 4 项检查，可检查模板、站点启用、TLS、健康端点、证书文件、续期配置和 `certbot.timer`。 | 证书申请/续期 dry-run、80/443 生产验证未执行。 | 在生产 Ubuntu 执行证书签发、续期 dry-run 和 Nginx 安装记录。 | | WXNET-001 | 微信合法域名与真机验证 | M00-E/M08/M10 | TODO | - | 已补 API 域名报告入口，但未做微信后台或真机验证。 | 微信后台/真机未验证。 | 后续导入小程序后执行合法域名和真机验证。 | @@ -15,5 +15,5 @@ | OPS-002 | 单仓库 Gitea 推送与拉取部署 | M00-B/M10 | PARTIAL | 远端 HEAD | Windows 到 Gitea `origin/main` 首次 push 与远端校验通过。 | 生产服务器只读拉取部署尚未验证。 | M00-D/M00-E 继续完善生产拉取、菜单部署和状态检查。 | | OPS-003 | 整仓发布清单 | M00-E/M10 | PARTIAL | 本地 HEAD | `deploy-business.sh` 可生成 dry-run release manifest；正式构建待项目生成。 | 后端/后台尚未生成。 | M01/M09 后接入真实构建结果。 | | OPS-004 | 菜单式更新与环境监测 | M00-E/M10 | PARTIAL | `292ab7f` | `setup.sh` 已接入初始化、更新、MQTT、HTTPS、状态、备份、恢复、回滚和诊断菜单；`--backup-status` 已在 WSL 验证，可检查备份工具、目录和模板。 | 未在生产 Ubuntu 执行；真实备份配置未启用。 | 生产执行后补部署记录、真实备份和恢复演练记录。 | -| IOT-001 | MQTT Broker 生产部署 | M00/M06 | PARTIAL | 本轮待提交 | 已生成 EMQX Ubuntu 安装说明、ACL 模板、授权模板和菜单第 3 项检查；WSL 本地 EMQX 5.8.9/MQTTX CLI 1.13.0 服务级核验通过。 | 缺生产 EMQX 安装、端口限制、真实账号、ACL/TLS 验收和实机验证。 | 生产执行后补 EMQX 版本、端口、ACL、备份和 MQTT 冒烟记录；本地继续补认证/ACL/TLS/遗嘱/幂等测试。 | +| IOT-001 | MQTT Broker 生产部署 | M00/M06 | PARTIAL | `289b64d` | 已生成 EMQX Ubuntu 安装说明、ACL 模板、授权模板和菜单第 3 项检查；WSL 本地 EMQX 5.8.9/MQTTX CLI 1.13.0 服务级核验通过。 | 缺生产 EMQX 安装、端口限制、真实账号、ACL/TLS 验收和实机验证。 | 生产执行后补 EMQX 版本、端口、ACL、备份和 MQTT 冒烟记录；本地继续补认证/ACL/TLS/遗嘱/幂等测试。 | | SYS-001 | 微信原生小程序 | M00-C/M08 | TODO | - | - | 参考小程序压缩包尚未深度整理。 | 后续导入正式 `miniapp/`。 | diff --git a/docs/module-status.md b/docs/module-status.md index 6cc96f7..2808abf 100644 --- a/docs/module-status.md +++ b/docs/module-status.md @@ -2,7 +2,7 @@ | 模块 | 状态 | 最近提交 | 最近开发日志 | 备注 | |---|---|---|---|---| -| M00 单仓库与服务器基础骨架 | PARTIAL | 本轮待提交 | docs/devlogs/2026-06-16-M00-V5-基线核验.md | V5.0 已接入；已有成果基线和 WSL 本地 MQTT 服务级核验已补文档；生产部署、认证/ACL/TLS 和业务项目仍未完成。 | +| M00 单仓库与服务器基础骨架 | PARTIAL | `289b64d` | docs/devlogs/2026-06-16-M00-V5-基线核验.md | V5.0 已接入；已有成果基线和 WSL 本地 MQTT 服务级核验已补文档；生产部署、认证/ACL/TLS 和业务项目仍未完成。 | | M01 后端 API 基础工程 | TODO | - | - | 等 M00 基线完成后开始。 | | M02 登录、租户、权限 | TODO | - | - | - | | M03 门店、房间、价格、营业时间 | TODO | - | - | - | diff --git a/docs/repository-completeness.md b/docs/repository-completeness.md index 70f8f43..7caf9e4 100644 --- a/docs/repository-completeness.md +++ b/docs/repository-completeness.md @@ -12,4 +12,4 @@ | 行尾/空白 | PASS | `scripts/dev/windows/test-all.ps1` 已运行，`git diff --check` 通过。 | | 忽略规则 | PASS | 真实 `backup/`、`backups/` 仍忽略；`deploy/backup/` 模板已放行并提交。 | | V5 基线文件 | PASS | 已新增 `docs/current-baseline.md`、`docs/local-dev-mqtt.md` 和 `scripts/dev/wsl/check-local-mqtt.sh`。 | -| 远端一致性 | PASS | 最近一次 `git push origin main` 成功，`git fetch origin main` 后 `HEAD == origin/main`；本轮待提交后复验。 | +| 远端一致性 | PASS | 最近一次 `git push origin main` 成功，`git fetch origin main` 后 `HEAD == origin/main`（`289b64d`）。 |