39 lines
1.7 KiB
Markdown
39 lines
1.7 KiB
Markdown
# CMP-48 State Recovery & Keyboard Signoff
|
||
|
||
- 日期：2026-03-27
|
||
- 负责人：Senior Frontend Engineer
|
||
|
||
## Goal
|
||
|
||
收口 `dbtool-tui` 在 usable-v1 下的状态恢复与键盘一致性签收文档，确保 QA 按当前实现而不是旧表述复核。
|
||
|
||
## Assessment
|
||
|
||
- `CMP-48` 当前最直接的前端动作不是扩功能，而是把签收口径和现有实现对齐。
|
||
- 现有文档仍缺一组显式的恢复/一致性规则，且 `TUI_REGRESSION_CHECKLIST.md` 仍残留 `l` / `e` 这类与当前实现不符的旧快捷键表述。
|
||
- `apps/tui/src/main.rs` 当前已把恢复语义收口为 `Esc`、`r`、按焦点解释的 `Enter`，以及仅在特定焦点下生效的 `[` / `]`。
|
||
|
||
## Scope
|
||
|
||
1. 在 `apps/tui/README.md` 增加状态恢复与键位一致性说明
|
||
2. 在 `TUI_ACCEPTANCE_CHECKLIST.md` 增加 usable-v1 签收关注点和恢复/键盘项
|
||
3. 在 `TUI_REGRESSION_CHECKLIST.md` 去除旧快捷键并改成与源码一致的回归步骤
|
||
4. 在 `TUI_TEST_STRATEGY.md` 明确恢复路径与键位一致性也是测试层的一部分
|
||
|
||
## Out of Scope
|
||
|
||
- 改动 TUI Rust 实现
|
||
- 新增 network live 能力
|
||
- 扩张到 GUI 或新功能
|
||
|
||
## Validation
|
||
|
||
- `git diff --stat -- apps/tui/README.md TUI_ACCEPTANCE_CHECKLIST.md TUI_REGRESSION_CHECKLIST.md TUI_TEST_STRATEGY.md`
|
||
- `grep -n "状态恢复与键位一致性\|usable-v1 签收关注点\|usable-v1 状态恢复与键盘一致性\|当前键位一致性说明" apps/tui/README.md TUI_ACCEPTANCE_CHECKLIST.md TUI_REGRESSION_CHECKLIST.md TUI_TEST_STRATEGY.md`
|
||
|
||
## Result
|
||
|
||
- QA 文档不再声明当前实现中不存在的 `l` / `e` 快捷键
|
||
- `Esc`、`r`、`Enter`、`[` / `]` 的语义被固定为可复核的签收规则
|
||
- `CMP-48` 当前文档收口与 `CMP-51` 的 evidence-boundary 收口保持一致
|