From 94e81bffb1a00fe3dc3a79fa50dd5d2018b2701c Mon Sep 17 00:00:00 2001
From: xfy <i@rua.plus>
Date: Mon, 20 Jul 2026 15:54:59 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=BB=BA=E8=AE=B0=E5=BD=95?=
 =?UTF-8?q?=E6=A0=87=E9=A2=98=E9=A2=84=E5=A1=AB=E9=BB=98=E8=AE=A4=E5=80=BC?=
 =?UTF-8?q?=E8=AE=BE=E8=AE=A1=E8=A7=84=E6=A0=BC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../2026-07-20-record-default-title-design.md | 60 +++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-07-20-record-default-title-design.md

diff --git a/docs/superpowers/specs/2026-07-20-record-default-title-design.md b/docs/superpowers/specs/2026-07-20-record-default-title-design.md
new file mode 100644
index 0000000..bb01f43
--- /dev/null
+++ b/docs/superpowers/specs/2026-07-20-record-default-title-design.md
@@ -0,0 +1,60 @@
+# 新建记录标题预填默认值 — 设计规格
+
+日期：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
+```