企业官网建设流程全解析

Build Notes

【免费下载链接】SpacetimeDBDevelopment at the speed of light项目地址: https://gitcode.com/GitHub_Trending/sp/SpacetimeDB

Build: PASS

• Servertsc --noEmit: clean
• Clienttsc --noEmit: clean
• Clientvite build: success

这一区块的意义在于区分两类问题：环境问题（端口占用、依赖缺失、Docker 未启动）与代码缺陷。前者记入 Build Notes（不计入迭代数），后者才记入 `## Iteration N` 块（计入 "iterations to done"）。模板注释明确标注了这一点：「Environment / build workarounds that are NOT code reprompts」——这条边界直接决定基准指标的口径，是填写时最容易出错、也最需要严谨对待的地方。 ## 五、Category 与 Redeploy：两个受控枚举 模板头部注释对两个关键字段给出了**封闭取值集合**，保证跨运行的口径统一： **`Category:`（缺陷类别，五选一）** | 取值 | 含义 | |---|---| | `Feature Broken` | 功能未按规格工作（最常见，对应 BUG_REPORT 中的功能缺陷） | | `Compilation/Build` | 编译或构建失败 | | `Runtime/Crash` | 运行期崩溃或异常 | | `Integration` | 前后端集成、订阅/推送链路的集成问题 | | `Data/State` | 数据状态错误（持久化、状态不同步等） | **`Redeploy:`（重部署范围，三选一）** | 取值 | 含义 | |---|---| | `Client only` | 仅需重启客户端（如纯 UI 修复） | | `Server only` | 仅需重新部署服务端 | | `Both` | 两端都要重启 | 模板还对 Redeploy 给出了后端相关的操作提示：SpacetimeDB 后端执行 `spacetime publish` 后重启客户端；PostgreSQL/MongoDB 后端则重启 Express 服务端和/或客户端。这与 [CLAUDE.md](https://link.gitcode.com/i/79adae408546498bbbbe28d588203437) 中 fix agent 的部署约定一致（「For SpacetimeDB: run spacetime publish, then restart the Vite client」），也与 [run.sh](https://link.gitcode.com/i/e1a1e60f0595979446dda33f0903e76f) 第 540-541 行的修复指令完全对应。 ## 六、Iteration 0：部署基线 模板用 `## Iteration 0 — Deploy (hh:mm)` 记录应用的初始部署状态： ```markdown ## Iteration 0 — Deploy (hh:mm) **Status:** Deployed successfully - Client dev server running at http://localhost:<vite-port> - (postgres/mongodb) API server running at http://localhost:6001 **Reprompts:** 0 build reprompts

Iteration 0不是修复迭代，它是部署基线：记录客户端 Vite 端口、API 服务端口（PostgreSQL/MongoDB 后端为:6001）与构建 reprompt 次数。SpacetimeDB 后端的客户端端口基数为6173，PostgreSQL 为6273，MongoDB 为6373，并行运行时--run-index N会给每个端口加 N（见 RUNBOOK.md 端口表）。Reprompts字段从 0 开始累计，后续每次修复循环引发的 reprompt 会反映在后续迭代块与评分阶段使用的「Reprompt Efficiency」参考表（见 GRADING.md，0 次 reprompt = 10/10，16+ 次 = 0/10）。

七、Iteration N：修复记录的字段契约

每次修复循环追加的## Iteration N块是模板的核心，字段结构如下：

## Iteration N — Fix (YYYY-MM-DD) **Category:** Feature Broken (<count> bugs) **Bug 1: <title matching the BUG_REPORT bug>** - Root cause: <what was actually wrong> - Fix: <what changed> - Files changed: `<file>` (<function / section>) **Bug 2: <title>** - Root cause: <...> - Fix: <...> - Files changed: `<file>` **Redeploy:** Client only | Server only | Both **Server status:** Client at http://localhost:<vite-port> ✓ <!-- (+ API at :6001 for postgres/mongodb) -->

【免费下载链接】SpacetimeDBDevelopment at the speed of light项目地址: https://gitcode.com/GitHub_Trending/sp/SpacetimeDB