dbtool-cli-v1/plans/20260327-190819-cmp51-tui-live-evidence-boundary.md

CMP-51 TUI Live Evidence Boundary

• 日期：2026-03-27
• 负责人：Senior Frontend Engineer

Goal

统一 dbtool-usable-v1 对 TUI 的证据分层口径，避免把 sqlite-local 局部 live path 误写成整体通过。

Assessment

• 当前仓库已有两个前端可见面：apps/tui 终端工作台与 gui/ 静态 foundation。
• CMP-51 当前不新增 UI 功能，重点是修正文档与验收边界。
• 现有文档已经说明 TUI 缺少 PostgreSQL / MySQL network live，但 partial 定义与 README 口径不够集中，容易让 QA/PM 误读。

Scope

1. 在 TUI README 中固定三层结论：shell baseline、sqlite-local local live、network live
2. 在 usable-v1 QA 文档中补齐 partial 定义和判定规则
3. 在根 README 与 release/pre-release 文档中同步相同口径

Out of Scope

• 新增 PostgreSQL / MySQL network live 实现
• 修改 db-app / CLI 契约
• 扩张到 GUI 正式工程

Validation

• git diff --stat -- README.md apps/tui/README.md USABLE_ACCEPTANCE_CHECKLIST.md USABLE_EVIDENCE_LEDGER.md USABLE_PRE_RELEASE_CHECKLIST.md USABLE_RELEASE_GATE.md
• git status --short -- README.md apps/tui/README.md USABLE_ACCEPTANCE_CHECKLIST.md USABLE_EVIDENCE_LEDGER.md USABLE_PRE_RELEASE_CHECKLIST.md USABLE_RELEASE_GATE.md

Result

• TUI 的 usable-v1 结论被固定为：shell baseline=pass、sqlite-local=partial、PostgreSQL/MySQL network live=blocked
• partial 在 evidence ledger 中获得显式定义
• README、QA checklist 与 release gate 使用同一套前端口径