From 283a474eb15b7becae47565fa20ddd7049ad84ae Mon Sep 17 00:00:00 2001
From: xfy <i@rua.plus>
Date: Tue, 16 Jun 2026 17:38:55 +0800
Subject: [PATCH] docs: add rose day icon design spec

---
 .../specs/2026-06-16-rose-day-icon-design.md  | 94 +++++++++++++++++++
 1 file changed, 94 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-06-16-rose-day-icon-design.md

diff --git a/docs/superpowers/specs/2026-06-16-rose-day-icon-design.md b/docs/superpowers/specs/2026-06-16-rose-day-icon-design.md
new file mode 100644
index 0000000..0d45dba
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-16-rose-day-icon-design.md
@@ -0,0 +1,94 @@
+# 玫瑰日图标设计
+
+## 背景
+
+在日历单元格上为每年 **10 月 16 日** 增加一个小玫瑰图标，作为纪念日标识。实现方式参考已有的生日皇冠图标配置。
+
+## 目标
+
+- 每年 10 月 16 日的单元格左上角显示玫瑰图标。
+- 与生日皇冠共用同一套渲染位置、尺寸和点击动画。
+- 若 10 月 16 日同时命中生日，优先显示玫瑰图标。
+- 不引入额外的无障碍文本，图标仅作为视觉装饰。
+
+## 方案选择
+
+采用**方案一：沿用生日模式做最小扩展**。理由：
+
+- 与现有生日代码完全同构，改动最小；
+- 符合用户“参考已有生日的配置”的要求；
+- 可读性最好，降低维护者理解成本。
+
+## 详细设计
+
+### 数据层
+
+文件：`core/src/main/kotlin/plus/rua/project/LunarCache.kt`
+
+在 `DayCellInfo` 中新增字段：
+
+```kotlin
+data class DayCellInfo(
+    val annotationText: String,
+    val isAnnotationHighlight: Boolean,
+    val holidayBadge: String?,
+    val lunarMonthName: String? = null,
+    val isBirthday: Boolean = false,
+    val isRoseDay: Boolean = false,
+)
+```
+
+在 `LunarCache.compute()` 中加入玫瑰日判断：
+
+```kotlin
+val isRoseDay = date.month.number == 10 && date.day == 16
+```
+
+并将 `isRoseDay` 传入所有 `DayCellInfo(...)` 构造分支。
+
+### UI 层
+
+文件：`core/src/main/kotlin/plus/rua/project/ui/DayCell.kt`
+
+在 `DayCellImpl` 中：
+
+1. 读取 `val isRoseDay = lunarData.isRoseDay`。
+2. 新增 `roseClickTick` 与 `roseScale` 状态。
+3. 在 `clickable` 的 `onClick` 中：若 `isRoseDay` 则触发 `roseClickTick += 1`，随后调用外部 `onClick()`。
+4. 在 `Box` 的左上角优先渲染玫瑰图标：
+   - 若 `isRoseDay` 为 `true`，显示 `R.drawable.ic_rose`；
+   - 否则若 `isBirthday` 为 `true`，显示 `R.drawable.ic_birthday_crown`。
+5. 图标尺寸、内边距与皇冠保持一致：
+   - `size(14.dp)`
+   - `padding(start = 2.dp, top = 2.dp)`
+   - `rotationZ = -45f`
+   - 点击时通过 `graphicsLayer` 的 `scaleX / scaleY` 播放弹跳动画。
+
+### 资源
+
+- 源文件：`~/Pictures/rose-svgrepo-com.svg`
+- 目标路径：`core/src/main/res/drawable/ic_rose.xml`
+- 转换方式：将 SVG 转为 Android VectorDrawable，保留原始填充色，渲染时使用 `Color.Unspecified`。
+
+### 测试
+
+新增文件：`core/src/test/kotlin/plus/rua/project/LunarCacheRoseDayTest.kt`
+
+覆盖以下场景：
+
+1. `LocalDate(2026, 10, 16)` 的 `isRoseDay` 为 `true`。
+2. 普通日期（如 `LocalDate(2026, 6, 15)`）的 `isRoseDay` 为 `false`。
+3. 非 10 月的 16 日（如 `LocalDate(2026, 9, 16)`）的 `isRoseDay` 为 `false`。
+
+## 改动文件
+
+- `core/src/main/kotlin/plus/rua/project/LunarCache.kt`
+- `core/src/main/kotlin/plus/rua/project/ui/DayCell.kt`
+- `core/src/main/res/drawable/ic_rose.xml`（新增）
+- `core/src/test/kotlin/plus/rua/project/LunarCacheRoseDayTest.kt`（新增）
+
+## 风险与注意事项
+
+- 图标与生日皇冠同位置，需确保 `isRoseDay` 判断在前，避免被生日皇冠覆盖。
+- SVG 转换后需检查 `viewportWidth` / `viewportHeight` 与 `pathData` 是否正确。
+- 新增字段后 `DayCellInfo` 的 `copy` / 解构等用法不受影响。