Compare commits
2 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 Codex
|
3106fa80ca | ||
|
Codex
|
ef0edda3ed |
@@ -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/遗嘱/幂等需配置账号和下游证据后执行 |
|
||||
|
||||
## 状态校准
|
||||
|
||||
@@ -1,5 +1,17 @@
|
||||
# 部署变更记录
|
||||
|
||||
## 2026-06-16 / V5.0-status-doc-guard
|
||||
|
||||
- 关联模块：M00-B/SCM-001
|
||||
- 关联 commit：`ef0edda`
|
||||
- 变化内容：新增 `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
|
||||
|
||||
@@ -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 执行 |
|
||||
|
||||
@@ -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 历史敏感模式扫描已执行，只记录命中提交，不输出秘密值。
|
||||
|
||||
|
||||
@@ -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 | `ef0edda` | 首次 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 安装记录。 |
|
||||
|
||||
@@ -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 | `ef0edda` | 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 | - | - | - |
|
||||
|
||||
@@ -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`）。 |
|
||||
|
||||
@@ -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",
|
||||
|
||||
@@ -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."
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user