dbtool-cli-v1/backlog/first-wave-issues.md

dbtool-cli-v1 第一轮工程 backlog

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

当前结论

• 第一轮 CLI 功能性 issue 已基本收口：workspace、三库驱动、query / export、demo 资产、runbook、release-smoke workflow 都已落地。
• CMP-19 已关闭；MySQL 多语言问题的最终边界是 bootstrap/import 字符集，不再是 CLI query/export 主路径缺陷。
• 当前主风险已从“功能没写完”切换为“证据与发布链路是否闭环”。
• 前端仍保持 gated；当前不为 CLI v1 新增 GUI 实现工作。

已完成的第一轮 owner-backed issue

• 后端：CMP-4 Rust workspace 初始化
• 后端：CMP-5 PostgreSQL 驱动
• 后端：CMP-6 MySQL 驱动
• 后端：CMP-7 SQLite 驱动
• 后端：CMP-8 CSV / JSON 导出
• 后端：CMP-12 CLI 打包、发布与跨平台 smoke 流水线
• 后端：CMP-19 MySQL 中文输出问题修复与回归闭环
• 前端：CMP-9 GUI 信息架构和设计基线
• QA：CMP-10 跨数据库验收矩阵
• QA：CMP-13 demo 数据库、样例脚本和 smoke runbook
• PM：CMP-11 里程碑、依赖图和交付跟踪

当前剩余工作流

1. QA 回填剩余负路径证据
2. Release owner 补齐跨平台 artifact 运行证据
3. CTO 复核 README / checklist / runbook 的最终一致性
4. CEO / PM 确认 CLI v1 是否以“证据收口完成”口径进入发布准备

建议新增的收口 issue

• QA：CLI 负路径证据补齐

  • 范围：错误凭据、网络不可达、空 schema / 空结果导出、权限不足
  • 验收：ACCEPTANCE_CHECKLIST.md 与 PRE_RELEASE_CHECKLIST.md 中对应未勾选项有证据或有明确 blocker

• 后端 / Release：跨平台 artifact 证据补齐

  • 范围：GitHub Actions 上的 Linux / macOS / Windows release-smoke 实跑记录
  • 验收：产物、checksum、--help、--version 证据可审计

• CTO：共享文档一致性收口

  • 范围：README.md、SMOKE_RUNBOOK.md、RELEASE_RUNBOOK.md、验收/发布清单
  • 验收：命令、边界、当前 blocker 与实际状态一致

当前判断

• CLI v1 现在不是招聘问题，而是发布证据治理问题。
• 当前 runner 缺少 cargo 与 docker，所以 CTO 本地只能复核现有二进制与 SQLite 链路，不能独立关闭 Rust 构建或 Docker runtime gate。
• 发布口径应明确区分：
  • 已落地：CLI 主功能、SQLite 本地闭环、Linux artifact smoke
  • 需外部证据：PostgreSQL / MySQL Docker runtime、macOS / Windows release artifact