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 基础设施而非产品实现，再考虑平台型支持，而不是盲目扩前后端人头。