docs(M00-E): 记录备份检查推送校验

This commit is contained in:
Codex
2026-06-15 16:56:41 +08:00
parent 292ab7f062
commit b7b88fd13a
5 changed files with 9 additions and 9 deletions
+1 -1
View File
@@ -3,7 +3,7 @@
## 2026-06-15 / 0.1.4-m00-backup-check ## 2026-06-15 / 0.1.4-m00-backup-check
- 关联模块:M00-E/OPS-004 - 关联模块:M00-E/OPS-004
- 关联 commit本轮待提交 - 关联 commit`292ab7f`
- 变化内容:新增 `deploy/backup/backup-policy.template.json``deploy/backup/backup-restore-runbook.md``setup.sh --backup-status`;备份脚本扩展为检查 MySQL/EMQX/上传文件备份工具、目录和模板。 - 变化内容:新增 `deploy/backup/backup-policy.template.json``deploy/backup/backup-restore-runbook.md``setup.sh --backup-status`;备份脚本扩展为检查 MySQL/EMQX/上传文件备份工具、目录和模板。
- 配置变化:初始化目录新增 `/opt/apps/uploads`;菜单第 6 项继续只写 manifest,不导出真实数据。 - 配置变化:初始化目录新增 `/opt/apps/uploads`;菜单第 6 项继续只写 manifest,不导出真实数据。
- 数据库变化:无。 - 数据库变化:无。
+3 -3
View File
@@ -14,8 +14,8 @@
| Gitea 仓库 SSH | ssh://git@git.txyundm.cn:2222/panda/qipai.git | | Gitea 仓库 SSH | ssh://git@git.txyundm.cn:2222/panda/qipai.git |
| 生产拉取仓库 | ssh://git@127.0.0.1:2222/panda/qipai.git | | 生产拉取仓库 | ssh://git@127.0.0.1:2222/panda/qipai.git |
| 默认分支 | main | | 默认分支 | main |
| 最近模块 push commit | `c3be30d`M00-E EMQX 检查校验记录);本轮备份检查待提交 | | 最近模块 push commit | `292ab7f`M00-E 备份恢复检查模板) |
| 最近 push 远端校验 | 上一轮通过:`HEAD == origin/main``c3be30d4c70ec83e43d0444fa0abbe24d89e0c0b`);本轮待复验 | | 最近 push 远端校验 | 通过:`HEAD == origin/main``292ab7f062d351f7791f2a12249fc27a25935679` |
| 目标系统 | Ubuntu 24.04 | | 目标系统 | Ubuntu 24.04 |
| 内核架构 | x86_64 | | 内核架构 | x86_64 |
| DPKG 架构 | amd64 | | DPKG 架构 | amd64 |
@@ -27,7 +27,7 @@
| WSL 环境验证 | 已完成轻量检查、shell 语法检查、临时副本准备和清理;完整构建待正式项目生成 | | WSL 环境验证 | 已完成轻量检查、shell 语法检查、临时副本准备和清理;完整构建待正式项目生成 |
| 最近环境快检 | 2026-06-15 WSL 执行 `setup.sh --preflight/--status/--https/--mqtt/--backup-status/--diagnose` 通过;备份策略模板/runbook 存在,`/opt/apps/backups/*` 未初始化按预期 WARN | | 最近环境快检 | 2026-06-15 WSL 执行 `setup.sh --preflight/--status/--https/--mqtt/--backup-status/--diagnose` 通过;备份策略模板/runbook 存在,`/opt/apps/backups/*` 未初始化按预期 WARN |
| 最近部署后复检 | 未执行 | | 最近部署后复检 | 未执行 |
| 最近验证 commit | `c3be30d`;本轮备份检查脚本验证已通过,待提交 | | 最近验证 commit | `292ab7f`;备份恢复检查模板已推送并完成远端校验 |
| 最近验证日期 | 2026-06-15 | | 最近验证日期 | 2026-06-15 |
| 已验证系统 | Ubuntu 24.04 / 未验证 | | 已验证系统 | Ubuntu 24.04 / 未验证 |
| 菜单 1 首次安装 | 脚本已实现目录布局;未在生产 Ubuntu 执行 | | 菜单 1 首次安装 | 脚本已实现目录布局;未在生产 Ubuntu 执行 |
+2 -2
View File
@@ -11,9 +11,9 @@
| API-001 | 固定 HTTPS API 域名 | M00-E/M01/M08/M10 | PARTIAL | `4cb3ab6` | 已新增 Windows 检查脚本、Ubuntu 菜单检查和固定域名 Nginx 模板。 | DNS/HTTPS 生产验证未执行,后端健康接口未生成。 | 后续接入真实后端健康接口并执行 Windows/WSL/Ubuntu/微信真机验证。 | | 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 安装记录。 | | 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 域名报告入口,但未做微信后台或真机验证。 | 微信后台/真机未验证。 | 后续导入小程序后执行合法域名和真机验证。 | | WXNET-001 | 微信合法域名与真机验证 | M00-E/M08/M10 | TODO | - | 已补 API 域名报告入口,但未做微信后台或真机验证。 | 微信后台/真机未验证。 | 后续导入小程序后执行合法域名和真机验证。 |
| OPS-001 | 固定 `/opt/apps` 目录 | M00-D/M10 | PARTIAL | 本轮待提交 | `scripts/setup/init-layout.sh` 已生成目录布局、uploads 目录和 manifestWSL 检查脚本通过,未在生产 Ubuntu 执行。 | 生产操作未执行。 | 由管理员在 Ubuntu 菜单执行并记录结果。 | | OPS-001 | 固定 `/opt/apps` 目录 | M00-D/M10 | PARTIAL | `292ab7f` | `scripts/setup/init-layout.sh` 已生成目录布局、uploads 目录和 manifestWSL 检查脚本通过,未在生产 Ubuntu 执行。 | 生产操作未执行。 | 由管理员在 Ubuntu 菜单执行并记录结果。 |
| OPS-002 | 单仓库 Gitea 推送与拉取部署 | M00-B/M10 | PARTIAL | 远端 HEAD | Windows 到 Gitea `origin/main` 首次 push 与远端校验通过。 | 生产服务器只读拉取部署尚未验证。 | M00-D/M00-E 继续完善生产拉取、菜单部署和状态检查。 | | 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-003 | 整仓发布清单 | M00-E/M10 | PARTIAL | 本地 HEAD | `deploy-business.sh` 可生成 dry-run release manifest;正式构建待项目生成。 | 后端/后台尚未生成。 | M01/M09 后接入真实构建结果。 |
| OPS-004 | 菜单式更新与环境监测 | M00-E/M10 | PARTIAL | 本轮待提交 | `setup.sh` 已接入初始化、更新、MQTT、HTTPS、状态、备份、恢复、回滚和诊断菜单;`--backup-status` 已在 WSL 验证,可检查备份工具、目录和模板。 | 未在生产 Ubuntu 执行;真实备份配置未启用。 | 生产执行后补部署记录、真实备份和恢复演练记录。 | | OPS-004 | 菜单式更新与环境监测 | M00-E/M10 | PARTIAL | `292ab7f` | `setup.sh` 已接入初始化、更新、MQTT、HTTPS、状态、备份、恢复、回滚和诊断菜单;`--backup-status` 已在 WSL 验证,可检查备份工具、目录和模板。 | 未在生产 Ubuntu 执行;真实备份配置未启用。 | 生产执行后补部署记录、真实备份和恢复演练记录。 |
| IOT-001 | MQTT Broker 生产部署 | M00/M06 | PARTIAL | `86f7da2` | 已生成 EMQX Ubuntu 安装说明、ACL 模板、授权模板和菜单第 3 项检查;WSL `setup.sh --mqtt` 已验证脚本可运行。 | 缺生产 EMQX 安装、端口限制、真实账号和实机验证。 | 生产执行后补 EMQX 版本、端口、ACL、备份和 MQTT 冒烟记录;M06 精化设备 Topic。 | | IOT-001 | MQTT Broker 生产部署 | M00/M06 | PARTIAL | `86f7da2` | 已生成 EMQX Ubuntu 安装说明、ACL 模板、授权模板和菜单第 3 项检查;WSL `setup.sh --mqtt` 已验证脚本可运行。 | 缺生产 EMQX 安装、端口限制、真实账号和实机验证。 | 生产执行后补 EMQX 版本、端口、ACL、备份和 MQTT 冒烟记录;M06 精化设备 Topic。 |
| SYS-001 | 微信原生小程序 | M00-C/M08 | TODO | - | - | 参考小程序压缩包尚未深度整理。 | 后续导入正式 `miniapp/`。 | | SYS-001 | 微信原生小程序 | M00-C/M08 | TODO | - | - | 参考小程序压缩包尚未深度整理。 | 后续导入正式 `miniapp/`。 |
+1 -1
View File
@@ -2,7 +2,7 @@
| 模块 | 状态 | 最近提交 | 最近开发日志 | 备注 | | 模块 | 状态 | 最近提交 | 最近开发日志 | 备注 |
|---|---|---|---|---| |---|---|---|---|---|
| M00 单仓库与服务器基础骨架 | PARTIAL | `c3be30d`;本轮备份检查待提交 | docs/devlogs/2026-06-15-M00-A-单仓库基线.md | M00-A/M00-B 基线已推送并校验;M00-C/D/E 持续完善,域名/HTTPS/Certbot/EMQX/备份检查已补模板但生产未验证。 | | M00 单仓库与服务器基础骨架 | PARTIAL | `292ab7f` | docs/devlogs/2026-06-15-M00-A-单仓库基线.md | M00-A/M00-B 基线已推送并校验;M00-C/D/E 持续完善,域名/HTTPS/Certbot/EMQX/备份检查已补模板但生产未验证。 |
| M01 后端 API 基础工程 | TODO | - | - | 等 M00 基线完成后开始。 | | M01 后端 API 基础工程 | TODO | - | - | 等 M00 基线完成后开始。 |
| M02 登录、租户、权限 | TODO | - | - | - | | M02 登录、租户、权限 | TODO | - | - | - |
| M03 门店、房间、价格、营业时间 | TODO | - | - | - | | M03 门店、房间、价格、营业时间 | TODO | - | - | - |
+2 -2
View File
@@ -10,5 +10,5 @@
| 敏感信息 | PASS/PARTIAL | 明文敏感模式扫描已通过;`参考/env` 已脱敏;含秘密/真实数据风险的原始包和 SQL 已移出 Git 跟踪。 | | 敏感信息 | PASS/PARTIAL | 明文敏感模式扫描已通过;`参考/env` 已脱敏;含秘密/真实数据风险的原始包和 SQL 已移出 Git 跟踪。 |
| 大文件 | WARN | `参考/mazongjian-server.xjar` 约 194MB,已记录哈希并作为大文件阻断项忽略。 | | 大文件 | WARN | `参考/mazongjian-server.xjar` 约 194MB,已记录哈希并作为大文件阻断项忽略。 |
| 行尾/空白 | PASS | `scripts/dev/windows/test-all.ps1` 已运行,`git diff --check` 通过。 | | 行尾/空白 | PASS | `scripts/dev/windows/test-all.ps1` 已运行,`git diff --check` 通过。 |
| 忽略规则 | PASS | 真实 `backup/``backups/` 仍忽略;`deploy/backup/` 模板已放行并提交。 | | 忽略规则 | PASS | 真实 `backup/``backups/` 仍忽略;`deploy/backup/` 模板已放行并提交。 |
| 远端一致性 | PASS | 最近一次 `git push origin main` 成功,`git fetch origin main``HEAD == origin/main`;本轮待推送后复验。 | | 远端一致性 | PASS | 最近一次 `git push origin main` 成功,`git fetch origin main``HEAD == origin/main``292ab7f`。 |