crearte-monorepo/docs/CHANGELOG.md

Changelog / 更新日志

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 / 文档

• Creator center /creator delivered (maintainer-direct need, plan 2026-09-30-creator-center.md executed): pure-frontend crearte 0.17.0 — new route + homepage-style view (hero, auth-state-aware work-data placeholder card, tutorial placeholder card linking to the submission guide) and a third header nav tab; merged & pushed as crearte e2fab8a after TDD e2e (4 new default cases + 1 appended noauth case) and a 6-lens review; server/deploy untouched by design.
• 创作者中心 /creator 交付（维护者直接需求，计划 2026-09-30-creator-center.md 已执行）：纯前端 crearte 0.17.0——新路由 + 首页样式视图（hero、按登录态分流的作品数据占位卡、链向现有投稿指南的教程占位卡）与页头第三个导航 tab；TDD e2e（默认配置新增 4 用例 + noauth 追加 1 断言）与 6 透镜审查后以 crearte e2fab8a 合并推送；后端/部署仓按设计零改动。

[0.2.4] - 2026-09-30

Docs / 文档

• Roadmap P2 delivered: GitHub Actions baseline in all three repos — crearte-server validate.yml (check + empty-DB Postgres integration with a silent-skip guard + real-stack e2e-stack hosting the cross-repo checkout pair), crearte validate.yml (push:master trigger) plus e2e-stack.sh GO/REQUIRED env knobs, crearte-deploy validate.yml (compose config across four profiles with a negative empty-password guard test). First real-stack run uncovered a serve-runtime defect: the runtime triple (/__bootstrap, /sw.js, /agent.js) was gated behind the fixtures subdomain table, so live-registered games could never install the SW — fixed with a position-only move (crearte 5e0fb2e). Merged & pushed 2026-09-30: server 7b97108 / crearte 711b6de / deploy 522545d; Actions enablement and branch protection are owner-manual tails (spec §2.4).
• 路线图 P2 交付：三仓 GitHub Actions 基线——crearte-server validate.yml（check + 空库 Postgres 集成层带静默 skip 守卫 + e2e-stack 真栈 job 宿主双仓 checkout）、crearte validate.yml（push:master 触发）及 e2e-stack.sh 的 GO/REQUIRED 环境变量开关、crearte-deploy validate.yml（四 profile compose config 正路 + 空密码反路守卫断言）。真栈首跑拓出 serve-runtime 缺陷：运行时三件套（/__bootstrap、/sw.js、/agent.js）被卡在夹具子域表门槛之后，活体注册的作品永远装不上 SW——已以纯位置搬移修复（crearte 5e0fb2e）。2026-09-30 合并推送：server 7b97108 / crearte 711b6de / deploy 522545d；Actions 启用确认与分支保护为 owner 手动尾巴（spec §2.4）。

[0.2.3] - 2026-09-30

Docs / 文档

• Roadmap P5 delivered: favorites & 5-star ratings went full-stack — server favorites/ratings tables + ReactionRepository with reaction-watermark ETag invalidation and user-space endpoints (crearte-server e3da246), and frontend hot sort (Bayesian prior mean + favorite log weight), game-page reaction widget, card badges, account my-reactions section (crearte eb5fbed), merged & pushed 2026-09-30 after a 9-step live prod-stack smoke; crearte-deploy untouched by design (scope revision recorded in spec).
• 路线图 P5 交付：收藏与五星评分全栈落地——服务端 favorites/ratings 新表 + ReactionRepository（反应水位驱动 ETag 失效）与用户态端点（crearte-server e3da246）；前端热门排序（贝叶斯先验均分 + 收藏对数权重）、详情页反应组件、卡片徽标、账号页我的反应（crearte eb5fbed），2026-09-30 经 prod 演练栈 9 步冒烟后合并推送；crearte-deploy 按设计零改动（范围修订已记入 spec）。

[0.2.2] - 2026-09-29

Docs / 文档

• Roadmap P1 delivered: prod write side went live in the compose drill — minio-prod + api-prod storage/games env + templated nginx wildcard block (crearte 63bb96d / crearte-deploy 4d53d58), POSTGRES_PASSWORD default retired, TLS deferred by design with a real-server checklist in README.
• 路线图 P1 交付：prod 写侧在本机演练栈完整启用——minio-prod、api-prod 存储/游玩域名环境、nginx 通配块模板化（crearte 63bb96d / crearte-deploy 4d53d58）；POSTGRES_PASSWORD 默认值退役；TLS 按设计缓做，真机清单已入 README。

[0.2.1] - 2026-09-29

Fixed / 修复

• clone_all.sh pins master for crearte and crearte-server instead of the stale feat/submission-preview work branch — fresh clones and updates land on the integration branch that carries the merged roadmap work. (Note: update_repo switches clean checkouts to the pinned branch; dirty ones are skipped.)
• clone_all.sh 中 crearte 与 crearte-server 的引导分支由过时的 feat/submission-preview 工作分支改为 master —— 全新克隆与更新落在承载路线图已合并工作的集成分支上。（注意：update_repo 会把干净的 checkout 切到钉子分支，脏工作树自动跳过切换。）

[0.2.0] - 2026-09-29

Changed / 变更

• Roadmap delivered: P0 (known-defect cleanup — CORS If-None-Match fix in crearte-server a8ea755, compose key-store drift cleanup in crearte-deploy 27044be) and P4 (author page /users/:user, crearte f12cbf1) are merged to their repos' master and pushed; roadmap statuses updated.
• 路线图交付：P0（已知缺陷清理——crearte-server a8ea755 的 CORS If-None-Match 修复、crearte-deploy 27044be 的 compose 密钥库遗留清理）与 P4（作者主页 /users/:user，crearte f12cbf1）均已合并至各仓 master 并推送；路线图状态已更新。

[0.1.0] - 2026-09-29

Added / 新增

• Added docs/ROADMAP.md: the cross-repo roadmap decomposed into sub-projects P0–P8 (ops foundation → product value → governance), with ordering rationale and a doc index for future specs and plans.
• 新增 docs/ROADMAP.md：跨仓库路线图，分解为 P0–P8 子项目（上线底座 → 产品价值 → 治理长尾），含排序理由与后续 spec/计划的文档索引。

Changed / 变更

• Doc convention: all specs, implementation plans and cross-repo coordination docs now live in the monorepo docs/ instead of per-repo docs/superpowers/; this supersedes the crearte-deploy 0.3.0 "canonical home" convention. Commits in the monorepo wrapper may go directly to master (user-approved); the three inner repos keep their own branch rules.
• 文档约定：所有 spec、实现计划与跨仓库协作文档统一收归 monorepo docs/，不再散落各内层仓库的 docs/superpowers/；此约定取代 crearte-deploy 0.3.0 的「canonical home」约定。monorepo wrapper 可直接提交 master（维护者确认），内层三仓仍遵循各自分支规范。