From ef0edda3ed64f068f8bb0e0a2a00306ec4b627bf Mon Sep 17 00:00:00 2001 From: Codex Date: Tue, 16 Jun 2026 14:46:03 +0800 Subject: [PATCH] =?UTF-8?q?test(M00):=20=E5=A2=9E=E5=8A=A0=E7=8A=B6?= =?UTF-8?q?=E6=80=81=E6=96=87=E6=A1=A3=E9=97=A8=E7=A6=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/current-baseline.md | 2 +- docs/deployment-changelog.md | 12 +++ docs/deployment-status.md | 2 +- docs/devlogs/2026-06-16-M00-V5-基线核验.md | 2 + docs/feature-status.md | 2 +- docs/module-status.md | 2 +- docs/repository-completeness.md | 1 + .../dev/windows/check-repo-completeness.ps1 | 1 + scripts/dev/windows/check-status-docs.ps1 | 82 +++++++++++++++++++ scripts/dev/windows/test-all.ps1 | 1 + 10 files changed, 103 insertions(+), 4 deletions(-) create mode 100644 scripts/dev/windows/check-status-docs.ps1 diff --git a/docs/current-baseline.md b/docs/current-baseline.md index 58260cd..915698d 100644 --- a/docs/current-baseline.md +++ b/docs/current-baseline.md @@ -16,7 +16,7 @@ | M00 部署脚本 | 已有菜单、状态、HTTPS、Certbot、EMQX、备份检查模板 | `setup.sh`、`scripts/setup/`、`deploy/` | PARTIAL，生产未执行 | | 发布清单 dry-run | 可基于当前 HEAD 输出 `deployed=false` 的 release manifest，记录后端/后台/迁移尚未生成而跳过 | `scripts/setup/deploy-business.sh --dry-run .`、`scripts/dev/windows/check-release-manifest.ps1` | 可在 M00 验证结构；真实构建与生产发布待 M01/M09 后接入 | | 参考资料 | 已有清单、脱敏日志、页面/接口/表结构摘要 | `docs/reference-*`、`docs/db-schema-inventory.md` | PARTIAL，仍需按模块迁移正式实现 | -| 仓库完整性门禁 | 必备文件 tracked、无意外 untracked、无嵌套 Git、无 submodule、无 forbidden tracked 文件、远端一致性和空白检查已脚本化 | `scripts/dev/windows/check-repo-completeness.ps1`、`scripts/dev/windows/test-all.ps1` | 可作为 M00 提交前门禁；参考摘录和生产部署仍未完成 | +| 仓库完整性门禁 | 必备文件 tracked、无意外 untracked、无嵌套 Git、无 submodule、无 forbidden tracked 文件、远端一致性、状态文档枚举/占位和空白检查已脚本化 | `scripts/dev/windows/check-repo-completeness.ps1`、`scripts/dev/windows/check-status-docs.ps1`、`scripts/dev/windows/test-all.ps1` | 可作为 M00 提交前门禁；参考摘录和生产部署仍未完成 | | WSL 本地 MQTT | EMQX 5.8.9 active/enabled，MQTTX CLI 1.13.0，五端口监听；认证/ACL 冒烟脚本入口、配置自检、可选 TLS/遗嘱/重复消息探测入口和 WSL EMQX 检查/启动/停止入口已生成 | `scripts/dev/wsl/check-local-mqtt.sh`、`scripts/dev/wsl/check-emqx.sh`、`scripts/dev/wsl/start-emqx.sh`、`scripts/dev/wsl/stop-emqx.sh`、`scripts/dev/wsl/mqtt-smoke.sh` | 服务级可用；未配置本地账号时冒烟脚本 SKIP，认证/ACL/TLS/遗嘱/幂等需配置账号和下游证据后执行 | ## 状态校准 diff --git a/docs/deployment-changelog.md b/docs/deployment-changelog.md index 710f91c..a59fb61 100644 --- a/docs/deployment-changelog.md +++ b/docs/deployment-changelog.md @@ -1,5 +1,17 @@ # 部署变更记录 +## 2026-06-16 / V5.0-status-doc-guard + +- 关联模块：M00-B/SCM-001 +- 关联 commit：`d2fe866` 后续提交回填 +- 变化内容：新增 `scripts/dev/windows/check-status-docs.ps1`，校验状态文档中的 V5.0 允许状态枚举，并拦截 `本地 HEAD`、`待推送后回填`、`待推送后远端校验` 等临时占位；接入 `test-all.ps1`。 +- 配置变化：无。 +- 数据库变化：无。 +- 兼容性：仅增加本地提交前检查，不影响生产菜单或部署脚本。 +- 已执行验证：待提交前执行 Windows 总检查和状态文档检查。 +- 回滚方式：移除状态文档检查脚本及 `test-all.ps1` 调用即可回到上一状态。 +- 生产环境人工步骤：无。 + ## 2026-06-16 / V5.0-release-manifest-dry-run - 关联模块：M00-E/OPS-003 diff --git a/docs/deployment-status.md b/docs/deployment-status.md index 152ddb2..bf41488 100644 --- a/docs/deployment-status.md +++ b/docs/deployment-status.md @@ -27,7 +27,7 @@ | WSL 环境验证 | 已完成轻量检查、shell 语法检查、临时副本准备和清理；本地 MQTT 服务级核验通过；V5.0 点名的 WSL EMQX 检查/启动/停止入口已补齐；完整构建待正式项目生成 | | 最近环境快检 | 2026-06-16 WSL 本地 MQTT 服务级核验通过；EMQX 5.8.9 active/enabled，MQTTX CLI 1.13.0，五端口监听；认证/ACL/TLS/协议仍未验收 | | 最近部署后复检 | 未执行 | -| 最近验证 commit | `59d92c0`；release manifest dry-run 已本地验证，待推送后远端校验 | +| 最近验证 commit | `d2fe866`；release manifest dry-run 已本地验证并完成远端校验 | | 最近验证日期 | 2026-06-16 | | 已验证系统 | Ubuntu 24.04 / 未验证 | | 菜单 1 首次安装 | 脚本已实现目录布局；未在生产 Ubuntu 执行 | diff --git a/docs/devlogs/2026-06-16-M00-V5-基线核验.md b/docs/devlogs/2026-06-16-M00-V5-基线核验.md index e0b8e6d..c64f2d5 100644 --- a/docs/devlogs/2026-06-16-M00-V5-基线核验.md +++ b/docs/devlogs/2026-06-16-M00-V5-基线核验.md @@ -11,6 +11,7 @@ - 强化 `scripts/dev/windows/check-repo-completeness.ps1`，将仓库完整性从提示型检查升级为提交前门禁，并接入 `scripts/dev/windows/test-all.ps1`。 - 调整 `scripts/dev/windows/push-module.ps1`，改为先暂存显式路径、再执行完整性门禁和测试，避免新增文件被门禁误拦截。 - 为 `scripts/setup/deploy-business.sh` 新增 `--dry-run` release manifest 输出，并新增 Windows 结构检查脚本。 +- 新增 `scripts/dev/windows/check-status-docs.ps1`，校验功能/模块状态枚举并拦截临时占位。 ## 复用/改写/弃用判断 @@ -32,6 +33,7 @@ - 仓库完整性门禁：`check-repo-completeness.ps1` 现会检查必备文件是否 tracked、是否存在意外 untracked、嵌套 Git、`.gitmodules`、被跟踪的秘密/依赖/构建/备份/日志/上传文件，以及 `main...origin/main` 是否一致。 - 模块推送脚本：`push-module.ps1` 现要求显式 `-Paths` 存在并先暂存，再运行 `test-all.ps1` 和敏感信息检查，随后 commit、push 并校验远端。 - Release manifest：`deploy-business.sh --dry-run .` 可输出当前 HEAD 的 dry-run JSON，`check-release-manifest.ps1` 已验证 `commit=HEAD`、`branch=main`、`deployed=false` 和跳过构建/迁移字段。 +- 状态文档门禁：`check-status-docs.ps1` 可检查 `docs/feature-status.md` 和 `docs/module-status.md` 只使用 V5.0 允许状态，并拦截推送后不应遗留的临时占位。 - 敏感信息检查：已调整规则，空示例变量和 shell 参数展开不再误报，真实非占位长值仍会报警；`check-secrets.ps1` 通过。 - Git 历史敏感模式扫描已执行，只记录命中提交，不输出秘密值。 diff --git a/docs/feature-status.md b/docs/feature-status.md index 0d6273f..d2854b4 100644 --- a/docs/feature-status.md +++ b/docs/feature-status.md @@ -6,7 +6,7 @@ |---|---|---|---|---|---|---|---| | ENV-001 | 固定 Windows 工作区 | M00-A/M00-B | DONE | 远端 HEAD | 已确认 `D:\qipai`，Git 根、main 分支、固定 origin 和 push 校验通过。 | - | 后续每模块继续复检。 | | REF-001 | 参考资料完整纳管 | M00-A | PARTIAL | `7bb4338` | 已生成哈希清单、脱敏日志、页面地图、接口线索和旧数据库结构清单；含秘密/依赖/真实数据风险的原始包和 SQL 已移出 Git 跟踪；仓库完整性门禁已覆盖意外 untracked、嵌套 Git 和 forbidden tracked 文件。 | 后续仍需按模块生成正式源码/迁移，旧 xjar 需大文件策略。 | 进入 M00-B/M00-C 前继续保持原包忽略和摘要可追溯。 | -| SCM-001 | 模块完成即完整推送 | M00-B/M00-C | PARTIAL | `6052f34` | 首次 main push 成功，`HEAD == origin/main` 校验通过；推送脚本已生成；仓库完整性脚本已升级为提交前门禁并接入 `test-all.ps1`；`push-module.ps1` 已改为先暂存显式路径再运行门禁，支持新增文件提交。 | 后续模块仍需逐次执行并记录。 | 继续在每轮提交前执行完整性、敏感信息、大文件和远端一致性检查。 | +| SCM-001 | 模块完成即完整推送 | M00-B/M00-C | PARTIAL | `d2fe866` | 首次 main push 成功，`HEAD == origin/main` 校验通过；推送脚本已生成；仓库完整性脚本已升级为提交前门禁并接入 `test-all.ps1`；`push-module.ps1` 已改为先暂存显式路径再运行门禁；状态文档枚举和临时占位检查已接入。 | 后续模块仍需逐次执行并记录。 | 继续在每轮提交前执行完整性、敏感信息、大文件、状态文档和远端一致性检查。 | | WSL-001 | WSL 隔离辅助验证 | M00-C | PARTIAL | `a690e85` | WSL 基础脚本已执行通过；本地 MQTT 服务级核验通过；认证/ACL 冒烟脚本入口、配置自检、可选 TLS/遗嘱/重复消息探测入口已生成；V5.0 点名的 WSL EMQX 检查/启动/停止入口已补齐。 | 正式后端/后台尚未生成，无法执行完整 Linux 构建；MQTT 本地账号未配置，认证/ACL/TLS/遗嘱/幂等未验收；生产 EMQX 不由 WSL 脚本管理。 | M01/M09 生成项目后在 WSL 原生临时副本执行完整构建；配置本地 MQTT 最小权限账号后执行冒烟和可选探测。 | | 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 安装记录。 | diff --git a/docs/module-status.md b/docs/module-status.md index a5de24c..85a38a3 100644 --- a/docs/module-status.md +++ b/docs/module-status.md @@ -2,7 +2,7 @@ | 模块 | 状态 | 最近提交 | 最近开发日志 | 备注 | |---|---|---|---|---| -| M00 单仓库与服务器基础骨架 | PARTIAL | `59d92c0` | docs/devlogs/2026-06-16-M00-V5-基线核验.md | V5.0 已接入；已有成果基线、仓库完整性门禁、显式路径模块推送脚本、release manifest dry-run 检查、WSL 本地 MQTT 服务级核验、认证/ACL 冒烟入口、配置自检、可选 TLS/遗嘱/重复消息探测入口和 WSL EMQX 检查/启动/停止入口已补；生产部署、账号配置、真实验收和业务项目仍未完成。 | +| M00 单仓库与服务器基础骨架 | PARTIAL | `d2fe866` | docs/devlogs/2026-06-16-M00-V5-基线核验.md | V5.0 已接入；已有成果基线、仓库完整性门禁、状态文档门禁、显式路径模块推送脚本、release manifest dry-run 检查、WSL 本地 MQTT 服务级核验、认证/ACL 冒烟入口、配置自检、可选 TLS/遗嘱/重复消息探测入口和 WSL EMQX 检查/启动/停止入口已补；生产部署、账号配置、真实验收和业务项目仍未完成。 | | M01 后端 API 基础工程 | TODO | - | - | 等 M00 基线完成后开始。 | | M02 登录、租户、权限 | TODO | - | - | - | | M03 门店、房间、价格、营业时间 | TODO | - | - | - | diff --git a/docs/repository-completeness.md b/docs/repository-completeness.md index e7a84ba..f18b229 100644 --- a/docs/repository-completeness.md +++ b/docs/repository-completeness.md @@ -12,5 +12,6 @@ | 行尾/空白 | PASS | `scripts/dev/windows/test-all.ps1` 已运行，`git diff --check` 通过。 | | 忽略规则 | PASS | 真实 `backup/`、`backups/` 仍忽略；`deploy/backup/` 模板已放行并提交。 | | 完整性脚本 | PASS | `scripts/dev/windows/check-repo-completeness.ps1` 已升级为门禁检查：必备文件 tracked、无意外 untracked、无嵌套 Git、无 submodule、无被跟踪秘密/依赖/构建/备份/日志/上传文件、远端一致性和空白检查均会失败拦截。 | +| 状态文档检查 | PASS | `scripts/dev/windows/check-status-docs.ps1` 可检查功能/模块状态枚举，并拦截推送前临时占位遗留。 | | V5 基线文件 | PASS | 已新增 `docs/current-baseline.md`、`docs/local-dev-mqtt.md`、`scripts/dev/wsl/check-local-mqtt.sh` 和 V5 点名的 WSL 辅助脚本入口。 | | 远端一致性 | PASS | 最近一次 `git push origin main` 成功，`git fetch origin main` 后 `HEAD == origin/main`（`2e01181`）。 | diff --git a/scripts/dev/windows/check-repo-completeness.ps1 b/scripts/dev/windows/check-repo-completeness.ps1 index bc9f1c0..09ddbfa 100644 --- a/scripts/dev/windows/check-repo-completeness.ps1 +++ b/scripts/dev/windows/check-repo-completeness.ps1 @@ -23,6 +23,7 @@ $requiredPaths = @( "scripts/dev/windows/check-large-files.ps1", "scripts/dev/windows/check-line-endings.ps1", "scripts/dev/windows/check-release-manifest.ps1", + "scripts/dev/windows/check-status-docs.ps1", "scripts/dev/wsl/check-env.sh", "scripts/dev/wsl/check-emqx.sh", "scripts/dev/wsl/start-emqx.sh", diff --git a/scripts/dev/windows/check-status-docs.ps1 b/scripts/dev/windows/check-status-docs.ps1 new file mode 100644 index 0000000..6ea34e1 --- /dev/null +++ b/scripts/dev/windows/check-status-docs.ps1 @@ -0,0 +1,82 @@ +$ErrorActionPreference = "Stop" + +$allowedStatuses = @( + "TODO", + "DOING", + "PARTIAL", + "BLOCKED_INTERNAL", + "BLOCKED_EXTERNAL", + "DONE" +) +$statusHeader = [regex]::Unescape("\u72b6\u6001") + +$statusDocs = @( + "docs/module-status.md", + "docs/feature-status.md", + "docs/deployment-status.md", + "docs/repository-completeness.md", + "docs/release-manifest.md", + "docs/workspace-status.md", + "docs/current-baseline.md" +) + +$forbiddenPlaceholders = @( + [regex]::Unescape("\u672c\u5730 HEAD"), + [regex]::Unescape("push \u540e\u56de\u586b"), + [regex]::Unescape("\u5f85\u63a8\u9001\u540e\u56de\u586b"), + [regex]::Unescape("\u5f85\u63a8\u9001\u540e\u8fdc\u7aef\u6821\u9a8c") +) + +foreach ($path in $statusDocs) { + if (-not (Test-Path $path)) { + throw "Required status document missing: $path" + } + + $content = Get-Content -Raw -Encoding UTF8 $path + foreach ($placeholder in $forbiddenPlaceholders) { + if ($content.Contains($placeholder)) { + throw "Status document contains temporary placeholder '$placeholder': $path" + } + } +} + +$featureLines = Get-Content -Encoding UTF8 "docs/feature-status.md" | Where-Object { + $_.StartsWith("|") -and + -not $_.StartsWith("|---") -and + -not $_.StartsWith("| ID ") +} + +foreach ($line in $featureLines) { + $columns = $line.Trim("|").Split("|") | ForEach-Object { $_.Trim() } + if ($columns.Count -lt 4) { + throw "Malformed feature status row: $line" + } + + $status = $columns[3] + if ($allowedStatuses -notcontains $status) { + throw "Invalid feature status '$status' in row: $line" + } +} + +$moduleLines = Get-Content -Encoding UTF8 "docs/module-status.md" | Where-Object { + $_.StartsWith("|") -and + -not $_.StartsWith("|---") +} + +foreach ($line in $moduleLines) { + $columns = $line.Trim("|").Split("|") | ForEach-Object { $_.Trim() } + if ($columns.Count -lt 2) { + throw "Malformed module status row: $line" + } + + $status = $columns[1] + if ($status -eq $statusHeader) { + continue + } + + if ($allowedStatuses -notcontains $status) { + throw "Invalid module status '$status' in row: $line" + } +} + +Write-Host "PASS: status documents use stable placeholders and allowed status values." diff --git a/scripts/dev/windows/test-all.ps1 b/scripts/dev/windows/test-all.ps1 index f17c6ad..b1a9190 100644 --- a/scripts/dev/windows/test-all.ps1 +++ b/scripts/dev/windows/test-all.ps1 @@ -6,6 +6,7 @@ $ErrorActionPreference = "Stop" & powershell -ExecutionPolicy Bypass -File scripts/dev/windows/check-large-files.ps1 & powershell -ExecutionPolicy Bypass -File scripts/dev/windows/check-repo-completeness.ps1 & powershell -ExecutionPolicy Bypass -File scripts/dev/windows/check-release-manifest.ps1 +& powershell -ExecutionPolicy Bypass -File scripts/dev/windows/check-status-docs.ps1 if (Test-Path "package.json") { npm run lint --if-present