docs: 补充部署示例、worktrees 设置并记录 T0.1 偏差
This commit is contained in:
+36
-1
@@ -6,7 +6,42 @@
|
||||
|
||||
## 总控 L
|
||||
|
||||
暂无。
|
||||
### T0.1 2026-09-30
|
||||
|
||||
1. **前端嵌入方式**
|
||||
- 原条款:DEVELOPMENT 第 3 节 `web/embed.go` 用 `//go:embed all:dist`;TASKS T0.1;`.gitignore` 忽略 `web/dist`。
|
||||
- 实际做法:默认构建用 `-tags` 以外的 `embed_stub.go` 嵌入 `web/stub/`;`task build` 加 `-tags embeddist` 嵌入真实 `web/dist`。
|
||||
- 原因:`web/dist` 不进仓库,且要求没有前端产物时也能 `go build`。
|
||||
- 备选方案:提交最小 `dist`;或构建前脚本生成占位目录。
|
||||
- 影响:裸 `go build` 不含真实前端;正式产物必须走 `task build`。
|
||||
|
||||
2. **listen.addr 写入时机**
|
||||
- 原条款:DEVELOPMENT 4.1「端口写 0 时」写 `<data_dir>/listen.addr`。
|
||||
- 实际做法:只要 `serve` 启动成功就写入实际监听地址。
|
||||
- 原因:测试启动器统一读取该文件更简单,固定端口场景也无害。
|
||||
- 备选方案:仅当配置端口为 0 时写入。
|
||||
- 影响:多一个小文件;行为超集,兼容文档要求。
|
||||
|
||||
3. **迁移占位**
|
||||
- 原条款:T0.3 才写完整表与 `VACUUM INTO` 备份;T0.1 允许空执行器加空 0001。
|
||||
- 实际做法:`internal/store.Migrate` 建 `schema_migrations` 并应用 `0001_init.sql`(内容为 `SELECT 1;`);不做迁移前备份。
|
||||
- 原因:保证 serve 可跑通迁移路径,表结构留给 T0.3。
|
||||
- 备选方案:完全空文件 + 只记版本。
|
||||
- 影响:T0.3 需替换 0001 正文并补备份逻辑;已应用的占位版本号仍为 1。
|
||||
|
||||
4. **Taskfile 引入 taskfiles**
|
||||
- 原条款:TASKS T0.1 / 4.2 引入 `taskfiles/*.yml`。
|
||||
- 实际做法:`includes: '*': taskfile: taskfiles/*.yml, optional: true`,并放 `_init.yml` 占位。
|
||||
- 原因:空目录 glob 可能失败;各线稍后加自己的 yml。
|
||||
- 备选方案:主文件逐条 optional include 各线文件名。
|
||||
- 影响:无。
|
||||
|
||||
5. **deploy/Dockerfile**
|
||||
- 原条款:完整多架构镜像属 Q4;T0.1 需要 `task docker` 目标。
|
||||
- 实际做法:提供单架构多阶段 Dockerfile 骨架,供 `task docker` 使用;T0.1 验证另用官方 `golang` 镜像跑 `task check`。
|
||||
- 原因:让 docker 目标可执行,又不抢 Q4 范围。
|
||||
- 备选方案:docker 目标仅 echo 提示。
|
||||
- 影响:镜像发布流程仍由 Q4 定稿。
|
||||
|
||||
## 平台 P
|
||||
|
||||
|
||||
Reference in New Issue
Block a user