Skip to content

基线决策:动机、终点、对等边界与技术栈选型 #89

Closed

Description

@JonasGao

Part of #88

Question

两轮 answer-board grilling(round 1 终点与边界、round 2 技术选型)敲定的基线决策是什么?本票记录并关闭这些决策,作为后续所有票的前提。

Activity

  1. JonasGao commented on Nov 5, 2026

    @JonasGao
    CollaboratorAuthor

    决议

    Charting 阶段两轮 answer-board grilling(round 1 终点与边界、round 2 技术选型)的用户决策,全部作为地图级前提:

    Round 1 — 终点与边界

    • 动机:单一自包含二进制部署 + 常驻内存/性能(不含"摆脱 React")
    • 地图终点:规划终点——所有架构与迁移决策定稿、产出可执行迁移蓝图;施工不在本图内,走正常 feature 迭代
    • 对等边界:严格对等——功能、HTTP API 契约(含 skills 的 PAT 接口与 {error,code} 形状)、CONTEXT.md 中文术语、e2e 行为全部冻结;e2e 套件当验收预言机
    • 数据库:沿用现有 SQLite 库文件与 26 张表 schema;drizzle 的 41 个 SQL 迁移与 __drizzle_migrations 账本沿用,真实数据零迁移
    • 前端框架:React + Vite(动机务实 → 保留组件/测试/设计系统,改动面最小)

    Round 2 — 技术选型

    • Go HTTP 栈:chi(非 std、非全家桶)
    • SQLite 驱动:modernc.org/sqlite(纯 Go,无 CGO,交叉编译即复制)
    • DB 访问层:sqlc(SQL-first codegen,与"schema 即真相"同构)
    • 布局与切换:同仓双栈(server/ + web/),feature 推进到 e2e 全绿后一次性切换 systemd、删除 src/
    • SPA 路由器:React Router v7 库模式
    • 构建发布:go:embed 全打进单二进制;systemd unit 形状不变、同端口 6868
    • 蓝图形态:ADR 系列(docs/adr/ 顺延编号)+ docs/migration-blueprint.md 索引与施工顺序

    架构盘点基线(决策依据):57 路由全纯 HTTP、15 页面 12 个已是 use client、无 cookie/session(localStorage Bearer + withAuth)、1 个 'use server' action 需变路由、NDJSON 生成引擎(Vercel AI SDK v7 tool-loop)为最大移植风险。

  2. JonasGao commented on Nov 5, 2026

    @JonasGao
    CollaboratorAuthor

    基线已记录,作为全部子票的前提关闭。

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions