お気に入り機能

♥ マークで気になる豆知識をブックマーク

v1.0 機能ID: DT-FEAT-FAV

概要

ユーザーが気になった豆知識を ♥ ボタンで保存し、後で FavoritesView から振り返れる機能。 AppGroup UserDefaults キー favorite_tips に Tip ID 配列で保存。

関連画面

• お気に入り一覧
• 豆知識カード（♥ ボタン）

API

final class FavoriteService {  // @unchecked Sendable
    func getFavorites() -> [String]
    func isFavorite(id: String) -> Bool
    func toggleFavorite(id: String)
}

処理フロー

1. ユーザーが TipCardView の ♥ ボタンをタップ
2. FavoriteService.toggleFavorite(id:) 実行
3. AppGroup UserDefaults の favorite_tips 配列を更新
4. UI 即時反映（楽観UI）

ビジネスルール

• tipID をキーに保存（永続）
• 件数制限なし
• ユーザーがアプリを再インストールすると消える（クラウド同期なし）

外部連携

連携先	用途
AppGroup UserDefaults	お気に入りID配列保存

エラー処理

UserDefaults 操作のため通常エラーは発生しない。AppGroup nil 時は standard へフォールバック。

実装メモ

• @unchecked Sendable で並行アクセス対応
• 配列の重複は避ける（追加前に contains チェック）
• iCloud 同期（v1.x検討）

変更履歴

バージョン	日付	変更内容
1.0	2026-05-09	初版作成