アーキテクチャ・非機能仕様書 (Architecture & Non-functional Specification)

lib/
├── main.dart                       # アプリエントリポイント，Provider 登録
├── app.dart                        # MaterialApp 定義，テーマ設定，180° 回転
├── models/
│   ├── display_orientation.dart    # 表示向き設定（ライブ／スナップショット両系統の単一の真実）
│   ├── preview_frame.dart          # プレビューストリームの YUV フレーム保持（不変）
│   └── preview_region.dart         # プレビュークロップ領域（正規化矩形・不変）
├── providers/
│   ├── camera_provider.dart        # カメラ制御の状態管理
│   ├── gallery_provider.dart       # 画像一覧の状態管理
│   └── diagnostics_provider.dart   # カメラ診断（インフラのみ）
├── screens/
│   ├── home_screen.dart            # BottomNavigationBar による画面切替
│   ├── capture_screen.dart         # 撮影画面 (S-01)
│   └── gallery_screen.dart         # 一覧画面 (S-02)
├── widgets/
│   ├── camera_preview.dart         # カメラプレビューウィジェット
│   ├── oriented_preview.dart       # 表示向き変換の適用（クロップ元）
│   ├── region_crop.dart            # 領域クロップ拡大表示（ライブ／スナップショット共通）
│   ├── cropped_snapshot.dart       # 保存中スナップショットのクロップ表示
│   ├── shutter_button.dart         # シャッターボタン
│   └── image_grid.dart             # サムネイルグリッド
└── services/
    ├── file_service.dart           # ファイル保存・命名・削除
    ├── permission_service.dart     # パーミッション管理
    ├── preview_region_service.dart # プレビュークロップ領域の config 読み込み
    ├── raw_capture_service.dart    # ネイティブ撮影（DNG/PNG）・診断の MethodChannel
    └── sound_service.dart          # シャッター音・保存完了音の制御

┌─────────────────────────────────┐
│  Screens（画面）                  │  UI 層: ウィジェット構築のみ
├─────────────────────────────────┤
│  Widgets（部品）                  │  再利用可能な UI コンポーネント
├─────────────────────────────────┤
│  Providers（状態管理）            │  ビジネスロジック・状態保持
├─────────────────────────────────┤
│  Services（サービス）             │  外部リソースとのインタフェース
└─────────────────────────────────┘