61 lines
2.7 KiB
Markdown
61 lines
2.7 KiB
Markdown
# 新建记录标题预填默认值 — 设计规格
|
||
|
||
日期：2026-07-20
|
||
|
||
## 背景
|
||
|
||
「日期记录器」拍照后进入新建记录页（`RecordEditScreen`），标题初始为空，保存按钮禁用（`canSave = false`），用户必须手动输入标题才能保存。
|
||
|
||
## 目标
|
||
|
||
新建记录时标题预填默认值，用户进入页面即可直接点保存。
|
||
|
||
## 需求确认
|
||
|
||
- 默认标题格式：**拍摄日期**，`yyyy-MM-dd`（如 `2026-07-20`）。
|
||
- 联动规则：用户**未手动编辑过标题**时，修改「拍摄日期」标题跟随同步；手动编辑过后不再联动。
|
||
- 编辑模式（`recordId != null`）行为不变：标题来自已有记录，不参与联动。
|
||
|
||
## 方案
|
||
|
||
ViewModel 负责预填和联动（状态单一来源、可单测）。不采用 Screen 层 `LaunchedEffect` 预填（状态分散、难测）。
|
||
|
||
## 改动点
|
||
|
||
### `core/src/main/kotlin/plus/rua/project/RecordEditViewModel.kt`
|
||
|
||
1. `initNewRecord()`：`title` 预填为 `formatLocalDate(shootDate)`，`canSave = true`（标题非空 + 照片就绪，沿用现有校验规则）。
|
||
2. 新增私有标记 `private var titleManuallyEdited = false`：
|
||
- `onTitleChange()` 中置 `true`（任何手动输入都算，包括清空）。
|
||
- `onShootDateChange()` 中：标记为 `false` 时同步 `title = formatLocalDate(date)`。
|
||
- `loadExistingRecord()` 加载成功后置 `true`（编辑模式已有标题不参与联动）。
|
||
3. 新增 `internal fun formatLocalDate(date: LocalDate): String`（`yyyy-MM-dd`），实现与现有 Screen 私有版本一致。
|
||
|
||
### `core/src/main/kotlin/plus/rua/project/ui/RecordEditScreen.kt`
|
||
|
||
1. 删除私有 `formatLocalDate`，改用 `RecordEditViewModel.kt` 中的 `internal` 版本，保证标题与「拍摄日期」按钮显示格式一致。
|
||
2. UI 结构、交互不变。
|
||
|
||
### 测试 `core/src/test/kotlin/plus/rua/project/RecordEditViewModelTest.kt`（新增）
|
||
|
||
覆盖用例：
|
||
- 新建模式：标题预填为拍摄日期格式，且 `canSave = true`。
|
||
- 未手动编辑：修改拍摄日期后标题跟随更新。
|
||
- 手动编辑后：修改拍摄日期标题不变。
|
||
- 手动清空标题：`canSave = false`。
|
||
|
||
测试需要 fake/stub `DateRecorderRepository`，参照现有 `DateRecorderSortTest.kt` 的测试写法。
|
||
|
||
## 边界情况
|
||
|
||
- 用户手动清空标题 → 保存按钮禁用（与现有校验一致）。
|
||
- 编辑模式：加载已有记录标题时同时将 `titleManuallyEdited` 置为 `true`，确保已有标题不会被拍摄日期联动覆盖（与"编辑模式不参与联动"的需求一致）。
|
||
|
||
## 验证
|
||
|
||
```bash
|
||
./gradlew :core:testDebugUnitTest --tests "plus.rua.project.RecordEditViewModelTest"
|
||
./gradlew spotlessApply
|
||
./gradlew :app:assembleDebug
|
||
```
|