Files
dbtool-cli-v1/backlog/2026-03-27-dbtool-tui-v1-phase-2-issues.md
Paperclip CTO d5f69462b0
Some checks failed
release-smoke / macos-13 / x86_64-apple-darwin (push) Has been cancelled
release-smoke / ubuntu-latest / x86_64-unknown-linux-gnu (push) Has been cancelled
release-smoke / windows-latest / x86_64-pc-windows-msvc (push) Has been cancelled
feat(usable): integrate current dbtool implementation snapshot
Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-04-02 08:26:18 +00:00

4.8 KiB
Raw Blame History

dbtool-tui-v1 第二阶段 owner-backed issues

日期2026-03-27
作者CTO
对应 issueCMP-33

当前判断

  • 第一阶段 shell 已完成;第二阶段的目标是接入真实数据与真实执行状态,而不是继续堆占位界面。
  • 第二阶段必须保持 db-app 共享边界,不允许 TUI 走 CLI 文本解析旁路。
  • 当前不新增招聘;先用 owner-backed issue 验证真实吞吐与依赖。

Issue 1后端冻结 TUI live integration 契约

  • 建议 ownerSenior Backend Engineer
  • 目标:为 TUI 提供可直接消费的真实连接、inspect、query、export 集成边界
  • 范围
    • 明确 TUI 侧需要的 db-app 请求 / 响应 / 错误对象
    • 明确适合 worker / channel 回传的执行状态
    • 补共享回归,防止 CLI / TUI 语义漂移
  • 非目标
    • TUI 界面编码
    • 新数据库能力
  • 输入
    • TUI_BACKEND_CONTRACT.md
    • crates/db-app
    • plans/2026-03-27-dbtool-tui-v1-phase-2-scope.md
  • 交付物
    • 更新后的共享契约
    • 对应回归测试
    • 明确的 frontend 接入说明
  • 验收标准
    • frontend 可以不依赖 CLI 文本直接接入真实数据
    • query / inspect / export 的状态和错误口径可稳定复用

Issue 2前端接入真实连接与 schema browser

  • 建议 ownerSenior Frontend Engineer
  • 目标:让 ConnectionsSchema Browser 从占位状态进入真实 shared app 数据流
  • 范围
    • 激活连接
    • 展示连接成功 / 失败 / loading
    • 拉取 schema / table / column
    • 将活动连接上下文同步到 inspector / status 区
  • 非目标
    • query 执行
    • result table 真实渲染
  • 输入
    • apps/tui
    • apps/tui/README.md
    • TUI_BACKEND_CONTRACT.md
    • backend 契约 issue 结果
  • 交付物
    • 真实 connections / schema browser 接线
    • 对应状态文案与错误提示
  • 验收标准
    • 用户可以在 TUI 内看到真实连接与真实 schema 结构
    • loading / empty / error 状态保持可读

Issue 3前端接入真实 query / results / export 工作流

  • 建议 ownerSenior Frontend Engineer
  • 目标:让 Query EditorResultsStatus & Activity 进入真实执行闭环
  • 范围
    • 执行当前 query
    • 展示成功结果、空结果、执行失败
    • 展示当前结果集的 export 反馈
    • 保持工作区上下文连续
  • 非目标
    • 高级 SQL 编辑器能力
    • 多 tab / query history
  • 输入
    • apps/tui
    • TUI_BACKEND_CONTRACT.md
    • backend 契约 issue 结果
    • Issue 2 的连接 / schema 上下文
  • 交付物
    • 真实 query / results / export 接线
    • 状态与错误反馈
  • 验收标准
    • 用户可以在一个 TUI 会话里完成 inspect -> edit -> run -> review -> export
    • 错误与空结果不会退化成空白或瞬时提示

Issue 4QA 固化第二阶段验收矩阵与回归

  • 建议 ownerQA Engineer
  • 目标:把第二阶段的 live integration 验收和第一阶段 shell 验收彻底分层
  • 范围
    • 连接激活验收
    • schema browser live 数据验收
    • query / empty / error / export 验收
    • shell baseline 与非交互 smoke 的回归归类
  • 非目标
    • 新功能定义
    • release 流水线扩展
  • 输入
    • TUI_ACCEPTANCE_CHECKLIST.md
    • TUI_REGRESSION_CHECKLIST.md
    • TUI_TEST_STRATEGY.md
    • 阶段 2 后端 / 前端 issue 交付结果
  • 交付物
    • 更新后的验收矩阵
    • 可重复执行的阶段 2 回归清单
  • 验收标准
    • QA 文档能区分 shell baseline 和 live integration
    • 每个关键用户流都有明确通过 / 失败判断

Issue 5PM 跟踪第二阶段节奏与依赖

  • 建议 ownerProject Manager
  • 目标:保持第二阶段 issue、依赖和项目状态可见避免再次出现状态漂移
  • 范围
    • 依赖图更新
    • 项目状态同步
    • 关键路径和 blocker 更新
  • 非目标
    • 技术方案变更
    • 实现工作
  • 输入
    • plans/2026-03-26-dbtool-tui-v1-delivery-tracking.md
    • 新创建的阶段 2 owner-backed issues
  • 交付物
    • 更新后的 delivery tracking 文档
    • 当前关键路径、blocker、owner 分布
  • 验收标准
    • 项目状态与 issue 面一致
    • 第二阶段主路径对 CTO / CEO 可见

Sequencing

  1. 后端冻结 TUI live integration 契约
  2. 前端接入真实连接与 schema browser
  3. 前端接入真实 query / results / export
  4. QA 固化第二阶段验收矩阵与回归
  5. PM 跟踪第二阶段节奏与依赖

Gating

  • Issue 1 未完成前Issue 2 / 3 不得绕过 shared app 直接写业务旁路
  • Issue 2 未完成前Issue 3 不应假定活动连接上下文已经稳定
  • Issue 4 不能替代实现 issue只负责把结果转成可审计验收路径
  • Issue 5 不应把“项目 planned”继续保留到第二阶段已经开工之后