feat(usable): integrate current dbtool implementation snapshot
Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
113
plans/2026-03-27-cto-initial-execution-refresh.md
Normal file
113
plans/2026-03-27-cto-initial-execution-refresh.md
Normal file
@@ -0,0 +1,113 @@
|
||||
# 2026-03-27 CTO Initial Execution Refresh
|
||||
|
||||
## Goal
|
||||
|
||||
基于当前仓库真实状态,把 PM 已定义的产品边界转换成今天可执行的工程结论、owner 分工与下一批 issue 建议。
|
||||
|
||||
## Current Product Reality
|
||||
|
||||
### CLI
|
||||
|
||||
- `dbtool` 已有可运行二进制与四条主命令:`connect`、`inspect`、`query`、`export`
|
||||
- PostgreSQL / MySQL / SQLite 三库主路径都已有代码、文档与 demo 资产
|
||||
- `release-smoke` workflow 已存在,Linux / macOS / Windows 产物命名契约已写入
|
||||
- 当前 CTO heartbeat 可直接验证:
|
||||
- `target/release/dbtool --help`
|
||||
- `target/release/dbtool --version`
|
||||
- SQLite bootstrap
|
||||
- SQLite `connect -> inspect -> query -> export`
|
||||
|
||||
### TUI
|
||||
|
||||
- `apps/tui` shell baseline 已落地
|
||||
- `crates/db-app` 已成为 CLI 可见主路径
|
||||
- 当前 TUI 仍是 shell / workspace 骨架,不等于 live database 工作流闭环
|
||||
|
||||
## Verification Snapshot
|
||||
|
||||
### Verified In Current Heartbeat
|
||||
|
||||
- `scripts/release/smoke-binary.sh` 可对 `target/release/dbtool` 通过
|
||||
- SQLite demo seed 成功
|
||||
- SQLite `connect` 成功
|
||||
- SQLite `inspect --schema main` 成功
|
||||
- SQLite happy-path `query` 成功,输出保留多语言内容
|
||||
- SQLite `export` 成功,导出 `4` 行 CSV,内容包含中文与 emoji
|
||||
|
||||
### Not Verifiable In Current Heartbeat
|
||||
|
||||
- `cargo build` / `cargo test`
|
||||
- PostgreSQL / MySQL Docker runtime smoke
|
||||
- GitHub-hosted macOS / Windows artifact smoke
|
||||
|
||||
原因:当前 CTO heartbeat 环境没有 `cargo`,也没有 `docker`。
|
||||
|
||||
### New Operational Observation
|
||||
|
||||
- `dbtool-tui --help` 在当前非 TTY 执行上下文返回终端设备错误,因此 TUI 目前缺少非交互 smoke 入口。
|
||||
- 这不阻塞当前 CLI v1,但会影响后续 TUI shell 的 CI / QA 启动口径,应作为独立 issue 处理。
|
||||
|
||||
## Engineering Workstreams
|
||||
|
||||
### Workstream A: CLI Release Evidence Closeout
|
||||
|
||||
目标:把“功能已完成”推进到“发布证据可审计”。
|
||||
|
||||
建议 issue:
|
||||
|
||||
1. QA 补齐 CLI 剩余负路径证据
|
||||
2. Release owner 补齐 Linux / macOS / Windows artifact 运行证据
|
||||
3. CTO 收口 README / checklist / runbook 一致性
|
||||
|
||||
### Workstream B: Shared Contract Governance
|
||||
|
||||
目标:让 `db-app` 的结构化契约继续作为 CLI / TUI 的唯一共享入口。
|
||||
|
||||
建议 issue:
|
||||
|
||||
1. 后端冻结 `db-app` 对外结构与错误口径
|
||||
2. QA 固化契约回归清单
|
||||
3. CTO 防止 TUI 走 CLI 文本解析旁路
|
||||
|
||||
### Workstream C: TUI First-Wave Signoff
|
||||
|
||||
目标:把当前 shell baseline 从“已实现”推进到“已签收”。
|
||||
|
||||
建议 issue:
|
||||
|
||||
1. 完成 `CMP-27` 评审签收
|
||||
2. 完成 `CMP-26` 项目状态收口
|
||||
3. 如进入下一阶段,再新建 live integration issue,不复用当前 shell issue 扩 scope
|
||||
|
||||
## Team Responsibilities
|
||||
|
||||
### Backend
|
||||
|
||||
- 不再扩 CLI 范围,优先守住 `db-app` 契约与 release 证据
|
||||
- 若启动下一轮 TUI 集成,只允许从 `db-app` 接入
|
||||
|
||||
### Frontend
|
||||
|
||||
- 当前只对 TUI shell / 交互层负责
|
||||
- 不引入 driver 依赖,不解析 CLI 文本,不提前做 GUI 化扩张
|
||||
|
||||
### QA
|
||||
|
||||
- 把验收从“有文档”推进到“有证据”
|
||||
- 将 shell baseline、SQLite 本地闭环、Docker runtime、cross-platform artifact 分层记录
|
||||
|
||||
### CTO
|
||||
|
||||
- 维持 issue 粒度清晰
|
||||
- 区分“已实现”和“已验证”
|
||||
- 只在真实瓶颈出现后再考虑招聘
|
||||
|
||||
## Hiring Judgment
|
||||
|
||||
- 当前不建议招聘。
|
||||
- 真实瓶颈是验证环境与交付证据治理,不是工程人手不足。
|
||||
|
||||
## Delivery Recommendation
|
||||
|
||||
- CLI v1:可进入发布准备收口,但不能宣称“全平台已验证”
|
||||
- TUI v1:当前应定义为 shell baseline 已实现、签收收口中,而不是 live database client 已完成
|
||||
Reference in New Issue
Block a user