アーキテクチャ概要 & レイヤー設計

本ページは Palleria のソースコード構造と責務分割の概要です。利用者に見える振る舞い、状態、外部連携の正確な仕様はアプリケーション仕様を基準にしてください。

---

全体レイヤー構成図

 ┌────────────────────────────────────────────────────────┐
 │                   UI Layer (Kotlin)                    │
 │  - Jetpack Compose + Miuix KMP Components              │
 │  - Navigation / ViewModels (StateFlow / Coroutines)    │
 └───────────────────────────┬────────────────────────────┘
                             │
 ┌───────────────────────────▼────────────────────────────┐
 │                Data & Local Storage Layer              │
 │  - Room DB (アカウント表示情報・履歴・保存作品) │
 │  - DataStore (AppSettings / SettingsStore)             │
 └───────────────────────────┬────────────────────────────┘
                             │ (UniFFI)
 ┌───────────────────────────▼────────────────────────────┐
 │                 Rust Core (pixiv-api)                  │
 │  - Transport Bridge (OkHttp / Rust Client)             │
 │  - Serde JSON Decoder (バッファサイズ上限制御)         │
 │  - DTO & Domain Model Mapping                          │
 └────────────────────────────────────────────────────────┘

---

主要パッケージ構成 (com.yunfie.illustia)

• account: AndroidのAccountAuthenticator・SyncAdapter・Provider連携
• data: リポジトリ層 (IllustiaRepository)、API クライアント、画像キャッシュ・URL 検証
• models: UI およびデータレイヤーで共有するデータモデル群 (Illust, UserProfile, SearchTarget 等)
• nativebridge: 画像保存やAndroid Intentの処理。UniFFI生成コードは app/build/generated/uniffi/kotlin 配下
• settings: AppSettings 定義と SettingsStore による設定の永続化
• ui: Compose 画面 (ui/screens/) および共通 UI コンポーネント (ui/components/)
• updater: 更新情報の取得と APK ダウンロード
• wallpaper: ライブ壁紙サービス (PalleriaLiveWallpaperService)
• widget: アプリウィジェットプロバイダ (IllustWidgetProvider, RankingWidgetProvider)