Skip to content

定稿:迁移蓝图与施工顺序(ADR 批次 + blueprint.md + 切换 runbook) #96

Closed

Description

@JonasGao

Part of #88

Question

汇总全部前置票结论,产出蓝图本体:ADR 批次划分与编号、docs/migration-blueprint.md 结构、施工分批顺序(哪个域先迁、生成引擎放哪一批)、切换 runbook(e2e 全绿 → systemd 切换 → 删 src/)终审。

Activity

  1. JonasGao commented on Nov 5, 2026

    @JonasGao
    CollaboratorAuthor

    来自 评审:测试与 e2e 基建迁移方案(已关闭)的定稿输入,落蓝图时直接吸收:

    • 引擎节:Go openai-compatible 路径必须继续发 /chat/completions 且消息历史形状(user instruction 文本 + assistant tool_calls 回放)不变——e2e scripted-AI 的 marker 协议依赖;「现有 e2e 套件零改动通过」写成引擎验收标准。
    • 施工顺序验收基线(两段式 + 演练):施工期路由族完工 = 仅 Go httptest 同用例集全绿(e2e 仍指向 Next);全 57 路由就绪后、正式切换前,runbook 写死预切换演练(全套 e2e 对 Go 单二进制跑绿);cutover 门槛 = 全量 e2e 零改动跑绿;cutover 后删 TS server 测试。
    • runbook:memory.peak 回读兼作「内存不劣于 Next 版」量化验收(基线 6.1–6.2G,见 e2e/next-server.ts 注释);E2E_WORKERS / MemoryMax 调整为 cutover 后实测决策。
    • Makefile:make build(vite build → go build embed)须为 e2e/发布共享入口,不写 e2e 专属构建脚本。
    • 单测批次切分规则:测试跟着代码走(33 个 route.test.ts → Go httptest 同用例集含 {error,code} 断言;lib server-only → Go 单测;被 client import 的留 vitest)——定稿:迁移蓝图与施工顺序(ADR 批次 + blueprint.md + 切换 runbook) #96 只需切批次顺序,不再定边界。

    完整决议 D1–D8 见 #95 关票评论。

  2. self-assigned this
    on Nov 5, 2026
  3. JonasGao commented on Nov 5, 2026

    @JonasGao
    CollaboratorAuthor

    决议(answer-board 单轮 9 问 + 终审通过)

    蓝图本体已交付:ADR-0025–0030 + docs/migration-blueprint.md(docs/migration-blueprint 分支 → 已合并 main,commit 7726bd3)。

    9 项定稿(7 项按推荐、2 项用户偏离推荐):

    1. ADR 批次:6 篇(0025 数据栈 / 0026 迁移账本 / 0027 AI 引擎 / 0028 SPA / 0029 测试基建 / 0030 顺序与切换),操作细节只进 blueprint.md。
    2. 后端批次:B0 骨架 → B1 认证审计 → B2 简单 CRUD → B3 计划 → B4 采集(含增补)→ B5 模板/AI 配置 → B6 报告+生成引擎(殿后,风险已被垂直切片消除)。
    3. SPA 时序(偏离推荐):串行殿后——后端 B0–B6 全部完成后整体迁 SPA(B7,内部按页分 PR、整批验收),不两轨并行。
    4. Go module:仓根 github.com/dev-zapi/weekly-reporter(embed 直接吃 drizzle/ 与 web/dist),cmd/wr + internal/ 按域分包。
    5. collect 增补路由:两条 POST 1:1 镜像 action(scan-repos / batch-add-sources),返回形状照现状(200 + 内嵌 error 字段)。
    6. make dev 终态:dev-api(go run)+ dev-web(vite)两 target。
    7. 迁移工具终态:切换后手写 SQL + wr db new + CI corpus lint(调研:drizzle 迁移账本的 Go 兼容策略 #91 推荐落地);过渡期继续 drizzle-kit generate。
    8. cutover(偏离推荐):单 PR、无观察期——预切换演练绿 → 同 PR 切 systemd + e2e 永久指 Go + 删 TS 侧;回滚 = git revert。
    9. 快速确认组全采纳:build-info 双侧(web 脚本 + Go ldflags)、vitest→Go 随域批次走同 PR 删、check:skills 原样保留、blueprint 七节结构、风险登记前三条。

    雾区六项全部出雾落档:module 布局(ADR-0025)、collect 路由形状(ADR-0030+B4)、gen-build-info(ADR-0025 ldflags)、Makefile/systemd(blueprint §4/§7)、vitest 批次(ADR-0029+blueprint §5)、check:skills(blueprint §2 不变量)。

    本票为地图 #88 最后一张开放票:地图走完,开工前无未决问题。施工走正常 feature 迭代,入口 = blueprint.md §5。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions