画面機能仕様書 (Screen & Function Specification)

[アプリ起動]
    │
    ▼
┌──────────┐       BottomNavigationBar       ┌──────────┐
│  S-01    │ ◄──────────────────────────────► │  S-02    │
│ 撮影画面  │         タブ切り替え              │ 一覧画面  │
└──────────┘                                  └──────────┘
                                                   │
                                                   │ サムネイルタップ
                                                   ▼
                                              ┌──────────┐
                                              │ 詳細表示   │
                                              │(インライン) │
                                              └──────────┘

操作者の視点（回転後）            コード上の配置（回転前）
┌─────────────────────┐      ┌─────────────────────┐
│ （黒い空白）          │      │  BottomNavBar        │
│  アタッチメントで隠れる │      │  明るさスライダー      │
├─────────────────────┤      │                     │
│                     │      │  カメラプレビュー      │
│  カメラプレビュー      │      │  （中央クロップ）      │
│  （中央クロップ）      │      │                     │
│                     │      ├─────────────────────┤
│  明るさスライダー      │      │ （黒い空白）          │
│  BottomNavBar        │      │  アタッチメントで隠れる │
└─────────────────────┘      └─────────────────────┘

┌─────────────────────────┐
│     BottomNavBar         │
├─────────────────────────┤
│ ┌─────┐ ┌─────┐ ┌─────┐│
│ │     │ │     │ │     ││
│ │ img │ │ img │ │ img ││
│ │     │ │     │ │     ││
│ └─────┘ └─────┘ └─────┘│
│ ┌─────┐ ┌─────┐ ┌─────┐│
│ │     │ │     │ │     ││
│ │ img │ │ img │ │ img ││
│ │     │ │     │ │     ││
│ └─────┘ └─────┘ └─────┘│
│          ...             │
├─────────────────────────┤
│   [画面上部エリア]        │  ← 逆さ配置のため上部が操作側
└─────────────────────────┘

シャッターボタンタップ
    │
    ▼
プレビュー停止（CameraController.dispose()）
    │
    ▼
baseName 生成（MiniTIAS_QM_YYYYMMDD_HHmmss．重複時 _1, _2 ...）
    │
    ▼
Camera2 API でフロントカメラを開く（RAW_SENSOR，3264×2448）
    │
    ▼
上記マニュアル制御パラメータを CaptureRequest に適用
    │
    ▼
連続 3 枚キャプチャ（設定反映のため最初の 2 枚は破棄）
    │
    ▼
3 枚目の Image + TotalCaptureResult を取得
    │
    ▼
DngCreator で DNG ファイルを直接書き込み（FileOutputStream）
  → Pictures/MiniTIAS/{baseName}.dng（約 16 MB）
    │
    ▼
LSC マップ取得（CaptureResult.STATISTICS_LENS_SHADING_CORRECTION_MAP）
    │
    ▼
メタデータ Map 構築（settings / actual / sensorCharacteristics / lscMap / image_statistics / hot_pixel_map）
    │
    ▼
Dart 側で JSON 保存
  → Pictures/MiniTIAS/{baseName}.meta.json
    │
    ▼
[並行] シャッター押下時に取得済みのライブプレビュースナップショット JPEG を保存
  → Pictures/MiniTIAS/{baseName}.preview.jpg
  ※ スナップショット取得失敗時は preview.jpg を保存しない（撮影全体は失敗扱いにしない）
    │
    ▼
MediaStore 通知（DNG / meta.json / preview.jpg すべて scanFile）
    │
    ▼
Camera2 を閉じ，プレビューを再開
    │
    ▼
スナックバーで保存完了を通知

baseName = "MiniTIAS_QM_{timestamp}"

IF "{baseName}.dng" が存在しない:
    RETURN baseName

suffix = 1
WHILE "{baseName}_{suffix}.dng" が存在する:
    suffix += 1

RETURN "{baseName}_{suffix}"

アプリ起動
    │
    ▼
カメラ権限を確認
    │
    ├── 許可済み → カメラプレビュー開始
    │
    └── 未許可 → 権限リクエストダイアログ表示
              │
              ├── 許可 → カメラプレビュー開始
              │
              └── 拒否 → 「カメラの権限が必要です」メッセージ表示
                         ＋ 設定画面への誘導ボタン

lib/
├── main.dart                     # アプリエントリポイント，Provider 登録
├── app.dart                      # MaterialApp 定義，テーマ設定，180° 回転
├── 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       # カメラプレビューウィジェット
│   ├── shutter_button.dart       # シャッターボタン
│   └── image_grid.dart           # サムネイルグリッド
└── services/
    ├── file_service.dart         # ファイル保存・命名・削除
    ├── permission_service.dart   # パーミッション管理
    ├── raw_capture_service.dart  # ネイティブ撮影（DNG/PNG）・診断の MethodChannel
    └── sound_service.dart        # シャッター音・保存完了音の制御

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