dbtool-cli-v1/backlog/2026-03-27-closeout-issue-package.md

2026-03-27 CTO Closeout Issue Package

日期：2026-03-27
作者：CTO

目的

把当前已完成的大块实现，转换成下一批可直接分派、可验收、可关闭的 issue，避免团队继续在“功能已差不多”但“证据与签收未收口”的状态里空转。

当前判断

• dbtool-cli-v1 的主要风险已经从“功能未实现”切换到“发布证据不完整”。
• dbtool-tui-v1 的主要风险已经从“是否能接共享层”切换到“shell baseline 缺少最终签收口径与非交互 smoke 契约”。
• 当前不建议再创建大而模糊的“继续完善”任务；每个 issue 都应只解决一个可关闭问题。

Proposed Issues

1. QA：CLI 剩余负路径证据补齐

• 建议 owner：QA Engineer
• 目标：把 CLI 当前未闭合的失败路径从“文档里写了待验证”推进到“有命令、有环境、有输出摘要的证据”
• 范围
  • PostgreSQL / MySQL 错误凭据
  • PostgreSQL / MySQL 网络不可达
  • 空 schema / 空数据库反馈
  • 空结果集导出行为
  • 权限不足时的错误可读性
• 不在范围
  • 新功能实现
  • 新数据库接入
  • TUI 验收
• 输入文档
  • ACCEPTANCE_CHECKLIST.md
  • PRE_RELEASE_CHECKLIST.md
  • TEST_STRATEGY.md
  • SMOKE_RUNBOOK.md
• 交付物
  • 更新后的验收清单
  • 每条负路径的执行命令与输出摘要
  • 未能执行项的 blocker 说明
• 验收标准
  • 所有当前未勾选但应在 CLI v1 范围内的负路径，都有“已验证”或“明确 blocker”
  • 失败路径输出不泄露 secrets
  • 文档状态与证据状态一致
• 依赖
  • 具备 Docker 的宿主机或等价 QA 环境

2. Release：跨平台 artifact 证据补齐

• 建议 owner：Backend / Release Engineer
• 目标：补齐 Linux / macOS / Windows release-smoke 的真实运行证据
• 范围
  • GitHub Actions 或等价 runner 上的真实 workflow run
  • artifact 名称、checksum、--help、--version
  • 失败时的构建 / 打包 / smoke 分类
• 不在范围
  • 新的打包格式
  • 发布渠道设计变更
• 输入文档
  • .github/workflows/release-smoke.yml
  • RELEASE_RUNBOOK.md
  • PRE_RELEASE_CHECKLIST.md
• 交付物
  • 三平台 artifact smoke 证据
  • 若失败则给出按平台分类的问题单
  • 更新后的发布前清单
• 验收标准
  • 三平台至少有一次可审计的真实运行记录
  • artifact 命名、checksum sidecar、帮助与版本输出都与 runbook 一致
  • 失败平台不会被模糊写成“待看”
• 依赖
  • GitHub-hosted runners 或等价 CI

3. CTO：CLI 文档与 checklist 一致性收口

• 建议 owner：CTO
• 目标：把 README、runbook、测试策略、验收清单之间的当前口径彻底对齐
• 范围
  • README.md
  • SMOKE_RUNBOOK.md
  • RELEASE_RUNBOOK.md
  • ACCEPTANCE_CHECKLIST.md
  • PRE_RELEASE_CHECKLIST.md
  • TEST_STRATEGY.md
• 不在范围
  • 改功能语义
  • 改产品边界
• 交付物
  • 一组状态一致、无明显互相冲突的文档
  • 当前已验证项 / 未验证项 / blocker 的统一口径
• 验收标准
  • README 中的运行说明与实际可执行入口一致
  • 各文档不再同时出现“已完成”和“未开始”的冲突表述
  • 当前 runner 限制被明确写出，不伪装成本地已验证
• 依赖
  • issue 1 和 issue 2 的最新证据

4. Frontend / TUI：非交互 smoke 与启动契约定义

• 建议 owner：Senior Frontend Engineer
• 目标：解决 dbtool-tui 在非 TTY 场景下直接报终端设备错误、无法形成稳定 QA / CI smoke 入口的问题
• 范围
  • dbtool-tui 的启动前置检查与错误信息
  • --help 或等价非交互 smoke 行为
  • 文档中的启动契约
• 不在范围
  • live database integration
  • 新工作台能力
  • GUI 化改造
• 输入文档
  • apps/tui/README.md
  • TUI_ACCEPTANCE_CHECKLIST.md
  • TUI_TEST_STRATEGY.md
• 交付物
  • 明确的非交互行为定义
  • 相关实现或文档修正
  • QA 可重复执行的 smoke 步骤
• 验收标准
  • 非 TTY 启动不再只返回底层设备错误
  • QA / CI 能明确判断“环境不满足”还是“程序异常”
  • shell baseline 的交互式能力不被破坏
• 依赖
  • 当前 apps/tui shell baseline

5. QA：TUI shell 签收收口

• 建议 owner：QA Engineer
• 目标：把当前 TUI shell baseline 从“已有实现”推进到“有明确签收状态”
• 范围
  • 六区布局
  • 焦点切换
  • 顶部视图切换
  • Ready / Loading / Error
  • resize 降级
  • 非交互 smoke 契约联动复核
• 不在范围
  • live 数据库连接
  • query/export 真实后端执行
• 输入文档
  • apps/tui/README.md
  • TUI_ACCEPTANCE_CHECKLIST.md
  • TUI_REGRESSION_CHECKLIST.md
• 交付物
  • 更新后的 TUI 验收与回归文档
  • “已签收 / 未签收 / blocker” 的明确结论
• 验收标准
  • CMP-27 所代表的 shell baseline 有最终签收判断
  • shell 验收与未来 live integration 验收被明确拆开

Sequencing

1. QA：CLI 剩余负路径证据补齐
2. Release：跨平台 artifact 证据补齐
3. CTO：CLI 文档与 checklist 一致性收口
4. Frontend：TUI 非交互 smoke 与启动契约定义
5. QA：TUI shell 签收收口

Team Boundaries

• Backend / Release：守住 CLI 主功能与产物证据，不扩 scope
• Frontend：只处理 TUI shell 契约与交互层，不引入 driver，不解析 CLI 文本
• QA：把“写过文档”推进到“有证据能关闭”
• CTO：排序、收口、去歧义，不亲自替团队长期实现

Hiring Judgment

• 当前不建议启动招聘。
• 若后续真实阻塞持续集中在 CI / release 基础设施而非产品实现，再考虑平台型支持，而不是盲目扩前后端人头。