Revert "docs: P3 complete — backup+observability delivered (server 7b4e5c8 0.12.0 / deploy e07c9f8 0.6.0), host-verified metrics+logs+backup+drill+full-loop"

This reverts commit 979026e181.
This commit is contained in:
2026-09-30 18:36:31 +08:00
parent 979026e181
commit 256f0d91b7
2 changed files with 2 additions and 9 deletions
-7
View File
@@ -6,13 +6,6 @@ All notable changes to this repository should be documented in this file.
The format loosely follows Keep a Changelog and can be adapted to the team's habits.
本文档参考了 Keep a Changelog 的思路,也可以根据团队习惯调整。
## [0.2.6] - 2026-09-30
### Done / 完成
- P3 backup + observability delivered: crearte-server `7b4e5c8` (0.12.0 — slog JSON/text logging via LOG_FORMAT/LOG_LEVEL, per-request log middleware, hand-rolled /metrics with http+go+pgpool families and healthz/metrics self-exclusion, single-instance rate-limit tradeoff documented) and crearte-deploy `e07c9f8` (0.6.0 — backup.sh pg_dump+mc-mirror with manifest/latest/retention pruning and a docker-free --dry-run CI leg, restore-drill.sh verified against db-test only, BACKUP-RUNBOOK, api env anchor now passes LOG_* through). Verified on-host: metrics contract under real prod-profile traffic, JSON logs parseable, backup ran twice + KEEP_DAYS=1 prune + restore-drill PASS, real-stack full-loop 1 passed (no regression). Design defaults D1/D2/D3 (hand-rolled metrics / crontab / local rolling dir) after an unanswered consult; overridable per spec §2.
- P3 备份+可观测交付:crearte-server `7b4e5c8`(0.12.0——slog 结构化日志 LOG_FORMAT/LOG_LEVEL、每请求日志中间件、手写 /metrics(http+go+pgpool 三族,/healthz 与 /metrics 自身双排除)、限流单实例权衡成文)与 crearte-deploy `e07c9f8`(0.6.0——backup.sh 七步链:pg_dump + mc mirror + manifest + latest 软链 + 保留修剪 + 无 docker 依赖的 --dry-run CI 腿;restore-drill.sh 只碰 db-test;BACKUP-RUNBOOK;api 环境锚点透传 LOG_*)。本机实测:真 prod 栈流量下 metrics 计数/自排除/nomatch 桶成立、JSON 日志零不可解析、备份连跑两次 + KEEP_DAYS=1 修剪 + drill PASS、真栈 full-loop 1 passed 不回归。选型 D1/D2/D3(手写 metrics / crontab 调度 / 本地滚动目录)为提问未应答后的默认拍板,可按 spec §2 推翻。
## [0.2.5] - 2026-09-30
### Docs / 文档
+2 -2
View File
@@ -18,7 +18,7 @@
| P0 | 已知缺陷清理 | ① CORS `Access-Control-Allow-Headers` 补 `If-None-Match`(解锁 e2e:stack Step5:revoke 410 + 降级)② 清理 compose 配置漂移(`BUNDLE_KEY_STORE` 环境变量、`bundle-keys-*` 卷——密钥自 server 0.6.0 起在 Postgres)③ `crearte-deploy` CHANGELOG 补账 | server, deploy | 无 | **完成**(server `a8ea755` / deploy `27044be`,2026-09-29 合并推送) |
| P1 | prod 写侧可用 | prod 栈补对象存储(prod MinIO 或外部 S3)+ `api-prod` 配 `STORAGE_S3_*` / `GAMES_BASE_DOMAIN` / `CORS_ALLOWED_ORIGINS`;密码默认值、TLS 起步。现状:prod 无对象存储时写侧路由(上传/投稿/审核/预览)不注册,生产只读 | deploy(少量 server) | P0 | **完成**(crearte `63bb96d` / deploy `4d53d58`,2026-09-29 合并推送;TLS 与真域名留清单,见 spec §6) |
| P2 | CI + 测试基线 | 后端 / 部署仓建 CI(gofmt/vet/test + `TEST_DATABASE_URL` 集成层 + e2e:stack 全链路);与前端已有 `validate.yml` 对齐。现状:后端/部署仓无 CI,Postgres 集成测试无 `TEST_DATABASE_URL` 时静默 skip | 三仓 | P0(e2e 依赖其修复) | **完成**(server `7b97108` / crearte `711b6de` / deploy `522545d`,2026-09-30 合并推送;e2e-stack 宿主仓修订见 spec §2.2;首跑拓出 serve-runtime 子域缺陷已修(`5e0fb2e`);Actions 启用与分支保护为 owner 手动尾巴,见 spec §2.4) |
| P3 | 备份 + 可观测 | `pg_dump` 定时备份 + MinIO 数据保护 + 恢复演练 runbook;结构化 / 请求日志 + `/metrics`;限流器单实例问题记录权衡 | server, deploy | P1(拓扑定型) | **完成**(server `7b4e5c8`:slog 全量迁移 + 请求日志 + 手写 /metrics + LOG_FORMAT/LOG_LEVEL;deploy `e07c9f8`:backup.sh 七步链 + restore-drill(只碰 db-test)+ BACKUP-RUNBOOK + CI dry-run 腿 + api 环境锚点透传 LOG_*;本机真栈验收:metrics 计数/自排除/nomatch 桶、JSON 日志 0 不可解析、备份两次+KEEP_DAYS=1 修剪+drill PASS、full-loop 真栈 1 passed 不回归;见 spec §2 D1/D2/D3 默认选型) |
| P3 | 备份 + 可观测 | `pg_dump` 定时备份 + MinIO 数据保护 + 恢复演练 runbook;结构化 / 请求日志 + `/metrics`;限流器单实例问题记录权衡 | server, deploy | P1(拓扑定型) | 待启动 |
## 第二波:产品价值(可与第一波部分并行)
@@ -55,4 +55,4 @@
| P5 收藏/评分 | `docs/specs/2026-09-30-favorites-ratings-design.md` | `docs/plans/2026-09-30-favorites-ratings.md`(已执行,2026-09-30) |
| 创作者中心 `/creator`(维护者直接需求) | `docs/specs/2026-09-30-creator-center-design.md` | `docs/plans/2026-09-30-creator-center.md`(已执行,2026-09-30) |
| P2 CI+测试基线 | `docs/specs/2026-09-30-ci-test-baseline-design.md` | `docs/plans/2026-09-30-ci-test-baseline.md`(已执行,2026-09-30) |
| P3 备份+可观测 | `docs/specs/2026-09-30-backup-observability-design.md` | `docs/plans/2026-09-30-backup-observability.md`(已执行,2026-09-30) |
| P3 备份+可观测 | `docs/specs/2026-09-30-backup-observability-design.md` | `docs/plans/2026-09-30-backup-observability.md` |