[03-Developer] #226 Catalog Gallery 구현

- Drift schema v2: Protocols.category CHECK 6→7 (light_circadian/sleep/movement/
  nutrition/focus_cognition/recovery_stress/emotion_relationship). schemaVersion
  1→2 + onUpgrade migrateV1ToV2 (DROP+CREATE+reseed flag 클리어).
- protocols.json 34 항목 v2 재분류 (1차 효과 기준). emotion_relationship 0 매핑.
- 도메인: DisplayCategory enum (8) + CatalogItem sealed (Protocol/Break/Diet).
- 데이터: CatalogRepository.all/byId/referencesByIds (3 source 통합).
- 상태: catalog_providers.dart (catalogItems / groupedByCategory / refsByIds).
- UI: ProtocolGalleryScreen (카테고리 칩 + 카드 그리드) + ProtocolPreviewScreen
  (모든 필드 + reference 펼치기 + "내 습관으로" disabled placeholder) +
  CatalogCard / CategoryChipRow / ReferenceExpandCard. HabitListScreen 빈
  상태 CTA + AppBar 액션.
- 테스트: migration_v1_to_v2 3건 + display_category 5건 + catalog_repository
  9건 + gallery widget 3건 + preview widget 3건 = 23 신규. 기존 88 회귀 0,
  flutter analyze 0 issues. 110 passed / 1 skipped.

설계서: docs/design/226-catalog-gallery/{README, fn-catalog_repository,
fn-migration_v1_to_v2}.md + ADR-0004.

Refs #226

app/lib/data/db/app_database.dart

@@ -5,6 +5,7 @@ import 'package:drift/native.dart';
 import 'package:path/path.dart' as p;
 import 'package:path_provider/path_provider.dart';
 
+import '../../core/constants.dart';
 import 'tables/catalog_tables.dart';
 import 'tables/user_tables.dart';
 
@@ -42,7 +43,7 @@ class AppDatabase extends _$AppDatabase {
   AppDatabase.memory() : super(NativeDatabase.memory());
 
   @override
-  int get schemaVersion => 1;
+  int get schemaVersion => 2;
 
   @override
   MigrationStrategy get migration => MigrationStrategy(
@@ -51,8 +52,16 @@ class AppDatabase extends _$AppDatabase {
           await _createIndexes(m);
         },
         onUpgrade: (m, from, to) async {
-          // Phase 1 only has v1. Reaching here is a bug.
-          assert(false, 'Phase 1 has no upgrade path. from=$from to=$to');
+          // v1 → v2 (#226): Protocols.category CHECK 6 → 7 신 카테고리.
+          // Read-only catalog 의 첫 마이그레이션. DROP + reseed 패턴 (ADR-0004).
+          // user 테이블 (Habits, Phases, ...) 무변화.
+          if (from == 1 && to >= 2) {
+            await migrateV1ToV2(m, this);
+          }
+          if (from > to || to > schemaVersion) {
+            assert(false,
+                'Unknown upgrade path: from=$from to=$to (schemaVersion=$schemaVersion)');
+          }
         },
       );
 
@@ -142,3 +151,18 @@ Future<File> appDatabaseFile() async {
   final dir = await getApplicationDocumentsDirectory();
   return File(p.join(dir.path, 'life_helper.sqlite'));
 }
+
+/// v1 → v2 마이그레이션. fn-migration_v1_to_v2.md 참고.
+///
+/// - Protocols 테이블 DROP + CREATE (v2 CHECK 적용) + 인덱스 재생성.
+/// - `kSeededV1Flag` 클리어 → 다음 부팅이 SeedImporter.importIfNeeded() 호출 → 새 JSON 재시드.
+/// - user 테이블 (Habits, Phases, TrackerEntries, ...) 무변화.
+///
+/// `onUpgrade` 에서 dispatch. 테스트는 직접 호출.
+Future<void> migrateV1ToV2(Migrator m, AppDatabase db) async {
+  await m.deleteTable(db.protocols.actualTableName);
+  await m.createTable(db.protocols);
+  await m.createIndex(Index('IDX_protocols_category',
+      'CREATE INDEX IDX_protocols_category ON protocols(category)'));
+  await (db.delete(db.metaKv)..where((t) => t.key.equals(kSeededV1Flag))).go();
+}

app/lib/data/db/app_database.g.dart

@@ -27,7 +27,8 @@ class $ProtocolsTable extends Protocols
     aliasedName,
     false,
     check: () => const CustomExpression<bool>(
-      "category IN ('health','meditation','motivation','habit','learning','diet')",
+      "category IN ('light_circadian','sleep','movement','nutrition',"
+      "'focus_cognition','recovery_stress','emotion_relationship')",
     ),
     type: DriftSqlType.string,
     requiredDuringInsert: true,
@@ -15402,7 +15403,7 @@ final class $$UsersTableReferences
     _$AppDatabase db,
   ) => MultiTypedResultKey.fromTable(
     db.phases,
-    aliasName: $_aliasNameGenerator(db.users.id, db.phases.userId),
+    aliasName: 'users__id__phases__user_id',
   );
 
   $$PhasesTableProcessedTableManager get phasesRefs {
@@ -15421,7 +15422,7 @@ final class $$UsersTableReferences
     _$AppDatabase db,
   ) => MultiTypedResultKey.fromTable(
     db.habits,
-    aliasName: $_aliasNameGenerator(db.users.id, db.habits.userId),
+    aliasName: 'users__id__habits__user_id',
   );
 
   $$HabitsTableProcessedTableManager get habitsRefs {
@@ -15439,7 +15440,7 @@ final class $$UsersTableReferences
   static MultiTypedResultKey<$ReflectionsTable, List<Reflection>>
   _reflectionsRefsTable(_$AppDatabase db) => MultiTypedResultKey.fromTable(
     db.reflections,
-    aliasName: $_aliasNameGenerator(db.users.id, db.reflections.userId),
+    aliasName: 'users__id__reflections__user_id',
   );
 
   $$ReflectionsTableProcessedTableManager get reflectionsRefs {
@@ -15909,7 +15910,7 @@ final class $$PhasesTableReferences
   $$PhasesTableReferences(super.$_db, super.$_table, super.$_typedResult);
 
   static $UsersTable _userIdTable(_$AppDatabase db) =>
-      db.users.createAlias($_aliasNameGenerator(db.phases.userId, db.users.id));
+      db.users.createAlias('phases__user_id__users__id');
 
   $$UsersTableProcessedTableManager get userId {
     final $_column = $_itemColumn<String>('user_id')!;
@@ -15929,7 +15930,7 @@ final class $$PhasesTableReferences
     _$AppDatabase db,
   ) => MultiTypedResultKey.fromTable(
     db.habits,
-    aliasName: $_aliasNameGenerator(db.phases.id, db.habits.phaseId),
+    aliasName: 'phases__id__habits__phase_id',
   );
 
   $$HabitsTableProcessedTableManager get habitsRefs {
@@ -15948,10 +15949,7 @@ final class $$PhasesTableReferences
   _rewardDeclarationsRefsTable(_$AppDatabase db) =>
       MultiTypedResultKey.fromTable(
         db.rewardDeclarations,
-        aliasName: $_aliasNameGenerator(
-          db.phases.id,
-          db.rewardDeclarations.phaseId,
-        ),
+        aliasName: 'phases__id__reward_declarations__phase_id',
       );
 
   $$RewardDeclarationsTableProcessedTableManager get rewardDeclarationsRefs {
@@ -15971,7 +15969,7 @@ final class $$PhasesTableReferences
   static MultiTypedResultKey<$ReflectionsTable, List<Reflection>>
   _reflectionsRefsTable(_$AppDatabase db) => MultiTypedResultKey.fromTable(
     db.reflections,
-    aliasName: $_aliasNameGenerator(db.phases.id, db.reflections.phaseId),
+    aliasName: 'phases__id__reflections__phase_id',
   );
 
   $$ReflectionsTableProcessedTableManager get reflectionsRefs {
@@ -16618,7 +16616,7 @@ final class $$HabitsTableReferences
   $$HabitsTableReferences(super.$_db, super.$_table, super.$_typedResult);
 
   static $UsersTable _userIdTable(_$AppDatabase db) =>
-      db.users.createAlias($_aliasNameGenerator(db.habits.userId, db.users.id));
+      db.users.createAlias('habits__user_id__users__id');
 
   $$UsersTableProcessedTableManager get userId {
     final $_column = $_itemColumn<String>('user_id')!;
@@ -16634,9 +16632,8 @@ final class $$HabitsTableReferences
     );
   }
 
-  static $PhasesTable _phaseIdTable(_$AppDatabase db) => db.phases.createAlias(
-    $_aliasNameGenerator(db.habits.phaseId, db.phases.id),
-  );
+  static $PhasesTable _phaseIdTable(_$AppDatabase db) =>
+      db.phases.createAlias('habits__phase_id__phases__id');
 
   $$PhasesTableProcessedTableManager? get phaseId {
     final $_column = $_itemColumn<String>('phase_id');
@@ -16656,10 +16653,7 @@ final class $$HabitsTableReferences
   _habitDoseVariantsRefsTable(_$AppDatabase db) =>
       MultiTypedResultKey.fromTable(
         db.habitDoseVariants,
-        aliasName: $_aliasNameGenerator(
-          db.habits.id,
-          db.habitDoseVariants.habitId,
-        ),
+        aliasName: 'habits__id__habit_dose_variants__habit_id',
       );
 
   $$HabitDoseVariantsTableProcessedTableManager get habitDoseVariantsRefs {
@@ -16679,7 +16673,7 @@ final class $$HabitsTableReferences
   static MultiTypedResultKey<$IfThenRulesTable, List<IfThenRule>>
   _ifThenRulesRefsTable(_$AppDatabase db) => MultiTypedResultKey.fromTable(
     db.ifThenRules,
-    aliasName: $_aliasNameGenerator(db.habits.id, db.ifThenRules.habitId),
+    aliasName: 'habits__id__if_then_rules__habit_id',
   );
 
   $$IfThenRulesTableProcessedTableManager get ifThenRulesRefs {
@@ -16697,7 +16691,7 @@ final class $$HabitsTableReferences
   static MultiTypedResultKey<$TrackerEntriesTable, List<TrackerEntry>>
   _trackerEntriesRefsTable(_$AppDatabase db) => MultiTypedResultKey.fromTable(
     db.trackerEntries,
-    aliasName: $_aliasNameGenerator(db.habits.id, db.trackerEntries.habitId),
+    aliasName: 'habits__id__tracker_entries__habit_id',
   );
 
   $$TrackerEntriesTableProcessedTableManager get trackerEntriesRefs {
@@ -16715,7 +16709,7 @@ final class $$HabitsTableReferences
   static MultiTypedResultKey<$LapseLogsTable, List<LapseLog>>
   _lapseLogsRefsTable(_$AppDatabase db) => MultiTypedResultKey.fromTable(
     db.lapseLogs,
-    aliasName: $_aliasNameGenerator(db.habits.id, db.lapseLogs.habitId),
+    aliasName: 'habits__id__lapse_logs__habit_id',
   );
 
   $$LapseLogsTableProcessedTableManager get lapseLogsRefs {
@@ -16734,7 +16728,7 @@ final class $$HabitsTableReferences
     _$AppDatabase db,
   ) => MultiTypedResultKey.fromTable(
     db.urgeLogs,
-    aliasName: $_aliasNameGenerator(db.habits.id, db.urgeLogs.habitId),
+    aliasName: 'habits__id__urge_logs__habit_id',
   );
 
   $$UrgeLogsTableProcessedTableManager get urgeLogsRefs {
@@ -16753,10 +16747,7 @@ final class $$HabitsTableReferences
   _rewardDeclarationsRefsTable(_$AppDatabase db) =>
       MultiTypedResultKey.fromTable(
         db.rewardDeclarations,
-        aliasName: $_aliasNameGenerator(
-          db.habits.id,
-          db.rewardDeclarations.habitId,
-        ),
+        aliasName: 'habits__id__reward_declarations__habit_id',
       );
 
   $$RewardDeclarationsTableProcessedTableManager get rewardDeclarationsRefs {
@@ -17909,9 +17900,8 @@ final class $$HabitDoseVariantsTableReferences
     super.$_typedResult,
   );
 
-  static $HabitsTable _habitIdTable(_$AppDatabase db) => db.habits.createAlias(
-    $_aliasNameGenerator(db.habitDoseVariants.habitId, db.habits.id),
-  );
+  static $HabitsTable _habitIdTable(_$AppDatabase db) =>
+      db.habits.createAlias('habit_dose_variants__habit_id__habits__id');
 
   $$HabitsTableProcessedTableManager get habitId {
     final $_column = $_itemColumn<String>('habit_id')!;
@@ -17930,10 +17920,7 @@ final class $$HabitDoseVariantsTableReferences
   static MultiTypedResultKey<$TrackerEntriesTable, List<TrackerEntry>>
   _trackerEntriesRefsTable(_$AppDatabase db) => MultiTypedResultKey.fromTable(
     db.trackerEntries,
-    aliasName: $_aliasNameGenerator(
-      db.habitDoseVariants.variantId,
-      db.trackerEntries.variantId,
-    ),
+    aliasName: 'habit_dose_variants__variant_id__tracker_entries__variant_id',
   );
 
   $$TrackerEntriesTableProcessedTableManager get trackerEntriesRefs {
@@ -18391,9 +18378,8 @@ final class $$IfThenRulesTableReferences
     extends BaseReferences<_$AppDatabase, $IfThenRulesTable, IfThenRule> {
   $$IfThenRulesTableReferences(super.$_db, super.$_table, super.$_typedResult);
 
-  static $HabitsTable _habitIdTable(_$AppDatabase db) => db.habits.createAlias(
-    $_aliasNameGenerator(db.ifThenRules.habitId, db.habits.id),
-  );
+  static $HabitsTable _habitIdTable(_$AppDatabase db) =>
+      db.habits.createAlias('if_then_rules__habit_id__habits__id');
 
   $$HabitsTableProcessedTableManager get habitId {
     final $_column = $_itemColumn<String>('habit_id')!;
@@ -18761,9 +18747,8 @@ final class $$TrackerEntriesTableReferences
     super.$_typedResult,
   );
 
-  static $HabitsTable _habitIdTable(_$AppDatabase db) => db.habits.createAlias(
-    $_aliasNameGenerator(db.trackerEntries.habitId, db.habits.id),
-  );
+  static $HabitsTable _habitIdTable(_$AppDatabase db) =>
+      db.habits.createAlias('tracker_entries__habit_id__habits__id');
 
   $$HabitsTableProcessedTableManager get habitId {
     final $_column = $_itemColumn<String>('habit_id')!;
@@ -18781,10 +18766,7 @@ final class $$TrackerEntriesTableReferences
 
   static $HabitDoseVariantsTable _variantIdTable(_$AppDatabase db) =>
       db.habitDoseVariants.createAlias(
-        $_aliasNameGenerator(
-          db.trackerEntries.variantId,
-          db.habitDoseVariants.variantId,
-        ),
+        'tracker_entries__variant_id__habit_dose_variants__variant_id',
       );
 
   $$HabitDoseVariantsTableProcessedTableManager? get variantId {
@@ -19255,9 +19237,8 @@ final class $$LapseLogsTableReferences
     extends BaseReferences<_$AppDatabase, $LapseLogsTable, LapseLog> {
   $$LapseLogsTableReferences(super.$_db, super.$_table, super.$_typedResult);
 
-  static $HabitsTable _habitIdTable(_$AppDatabase db) => db.habits.createAlias(
-    $_aliasNameGenerator(db.lapseLogs.habitId, db.habits.id),
-  );
+  static $HabitsTable _habitIdTable(_$AppDatabase db) =>
+      db.habits.createAlias('lapse_logs__habit_id__habits__id');
 
   $$HabitsTableProcessedTableManager get habitId {
     final $_column = $_itemColumn<String>('habit_id')!;
@@ -19655,9 +19636,8 @@ final class $$UrgeLogsTableReferences
     extends BaseReferences<_$AppDatabase, $UrgeLogsTable, UrgeLog> {
   $$UrgeLogsTableReferences(super.$_db, super.$_table, super.$_typedResult);
 
-  static $HabitsTable _habitIdTable(_$AppDatabase db) => db.habits.createAlias(
-    $_aliasNameGenerator(db.urgeLogs.habitId, db.habits.id),
-  );
+  static $HabitsTable _habitIdTable(_$AppDatabase db) =>
+      db.habits.createAlias('urge_logs__habit_id__habits__id');
 
   $$HabitsTableProcessedTableManager get habitId {
     final $_column = $_itemColumn<String>('habit_id')!;
@@ -20074,9 +20054,8 @@ final class $$RewardDeclarationsTableReferences
     super.$_typedResult,
   );
 
-  static $PhasesTable _phaseIdTable(_$AppDatabase db) => db.phases.createAlias(
-    $_aliasNameGenerator(db.rewardDeclarations.phaseId, db.phases.id),
-  );
+  static $PhasesTable _phaseIdTable(_$AppDatabase db) =>
+      db.phases.createAlias('reward_declarations__phase_id__phases__id');
 
   $$PhasesTableProcessedTableManager get phaseId {
     final $_column = $_itemColumn<String>('phase_id')!;
@@ -20092,9 +20071,8 @@ final class $$RewardDeclarationsTableReferences
     );
   }
 
-  static $HabitsTable _habitIdTable(_$AppDatabase db) => db.habits.createAlias(
-    $_aliasNameGenerator(db.rewardDeclarations.habitId, db.habits.id),
-  );
+  static $HabitsTable _habitIdTable(_$AppDatabase db) =>
+      db.habits.createAlias('reward_declarations__habit_id__habits__id');
 
   $$HabitsTableProcessedTableManager get habitId {
     final $_column = $_itemColumn<String>('habit_id')!;
@@ -20113,10 +20091,7 @@ final class $$RewardDeclarationsTableReferences
   static MultiTypedResultKey<$RewardClaimsTable, List<RewardClaim>>
   _rewardClaimsRefsTable(_$AppDatabase db) => MultiTypedResultKey.fromTable(
     db.rewardClaims,
-    aliasName: $_aliasNameGenerator(
-      db.rewardDeclarations.id,
-      db.rewardClaims.declarationId,
-    ),
+    aliasName: 'reward_declarations__id__reward_claims__declaration_id',
   );
 
   $$RewardClaimsTableProcessedTableManager get rewardClaimsRefs {
@@ -20710,13 +20685,9 @@ final class $$RewardClaimsTableReferences
     extends BaseReferences<_$AppDatabase, $RewardClaimsTable, RewardClaim> {
   $$RewardClaimsTableReferences(super.$_db, super.$_table, super.$_typedResult);
 
-  static $RewardDeclarationsTable _declarationIdTable(_$AppDatabase db) =>
-      db.rewardDeclarations.createAlias(
-        $_aliasNameGenerator(
-          db.rewardClaims.declarationId,
-          db.rewardDeclarations.id,
-        ),
-      );
+  static $RewardDeclarationsTable _declarationIdTable(_$AppDatabase db) => db
+      .rewardDeclarations
+      .createAlias('reward_claims__declaration_id__reward_declarations__id');
 
   $$RewardDeclarationsTableProcessedTableManager get declarationId {
     final $_column = $_itemColumn<String>('declaration_id')!;
@@ -21070,9 +21041,8 @@ final class $$ReflectionsTableReferences
     extends BaseReferences<_$AppDatabase, $ReflectionsTable, Reflection> {
   $$ReflectionsTableReferences(super.$_db, super.$_table, super.$_typedResult);
 
-  static $UsersTable _userIdTable(_$AppDatabase db) => db.users.createAlias(
-    $_aliasNameGenerator(db.reflections.userId, db.users.id),
-  );
+  static $UsersTable _userIdTable(_$AppDatabase db) =>
+      db.users.createAlias('reflections__user_id__users__id');
 
   $$UsersTableProcessedTableManager get userId {
     final $_column = $_itemColumn<String>('user_id')!;
@@ -21088,9 +21058,8 @@ final class $$ReflectionsTableReferences
     );
   }
 
-  static $PhasesTable _phaseIdTable(_$AppDatabase db) => db.phases.createAlias(
-    $_aliasNameGenerator(db.reflections.phaseId, db.phases.id),
-  );
+  static $PhasesTable _phaseIdTable(_$AppDatabase db) =>
+      db.phases.createAlias('reflections__phase_id__phases__id');
 
   $$PhasesTableProcessedTableManager? get phaseId {
     final $_column = $_itemColumn<String>('phase_id');

app/lib/data/db/daos/habit_dao.g.dart

@@ -9,4 +9,21 @@ mixin _$HabitDaoMixin on DatabaseAccessor<AppDatabase> {
   $HabitsTable get habits => attachedDatabase.habits;
   $HabitDoseVariantsTable get habitDoseVariants =>
       attachedDatabase.habitDoseVariants;
+  HabitDaoManager get managers => HabitDaoManager(this);
+}
+
+class HabitDaoManager {
+  final _$HabitDaoMixin _db;
+  HabitDaoManager(this._db);
+  $$UsersTableTableManager get users =>
+      $$UsersTableTableManager(_db.attachedDatabase, _db.users);
+  $$PhasesTableTableManager get phases =>
+      $$PhasesTableTableManager(_db.attachedDatabase, _db.phases);
+  $$HabitsTableTableManager get habits =>
+      $$HabitsTableTableManager(_db.attachedDatabase, _db.habits);
+  $$HabitDoseVariantsTableTableManager get habitDoseVariants =>
+      $$HabitDoseVariantsTableTableManager(
+        _db.attachedDatabase,
+        _db.habitDoseVariants,
+      );
 }

app/lib/data/db/daos/meta_dao.g.dart

@@ -5,4 +5,12 @@ part of 'meta_dao.dart';
 // ignore_for_file: type=lint
 mixin _$MetaDaoMixin on DatabaseAccessor<AppDatabase> {
   $MetaKvTable get metaKv => attachedDatabase.metaKv;
+  MetaDaoManager get managers => MetaDaoManager(this);
+}
+
+class MetaDaoManager {
+  final _$MetaDaoMixin _db;
+  MetaDaoManager(this._db);
+  $$MetaKvTableTableManager get metaKv =>
+      $$MetaKvTableTableManager(_db.attachedDatabase, _db.metaKv);
 }

app/lib/data/db/daos/tracker_dao.g.dart

@@ -10,4 +10,26 @@ mixin _$TrackerDaoMixin on DatabaseAccessor<AppDatabase> {
   $HabitDoseVariantsTable get habitDoseVariants =>
       attachedDatabase.habitDoseVariants;
   $TrackerEntriesTable get trackerEntries => attachedDatabase.trackerEntries;
+  TrackerDaoManager get managers => TrackerDaoManager(this);
+}
+
+class TrackerDaoManager {
+  final _$TrackerDaoMixin _db;
+  TrackerDaoManager(this._db);
+  $$UsersTableTableManager get users =>
+      $$UsersTableTableManager(_db.attachedDatabase, _db.users);
+  $$PhasesTableTableManager get phases =>
+      $$PhasesTableTableManager(_db.attachedDatabase, _db.phases);
+  $$HabitsTableTableManager get habits =>
+      $$HabitsTableTableManager(_db.attachedDatabase, _db.habits);
+  $$HabitDoseVariantsTableTableManager get habitDoseVariants =>
+      $$HabitDoseVariantsTableTableManager(
+        _db.attachedDatabase,
+        _db.habitDoseVariants,
+      );
+  $$TrackerEntriesTableTableManager get trackerEntries =>
+      $$TrackerEntriesTableTableManager(
+        _db.attachedDatabase,
+        _db.trackerEntries,
+      );
 }

app/lib/data/db/tables/catalog_tables.dart

@@ -6,7 +6,8 @@ import 'package:drift/drift.dart';
 class Protocols extends Table {
   TextColumn get id => text()();
   TextColumn get category => text().check(const CustomExpression<bool>(
-      "category IN ('health','meditation','motivation','habit','learning','diet')"))();
+      "category IN ('light_circadian','sleep','movement','nutrition',"
+      "'focus_cognition','recovery_stress','emotion_relationship')"))();
   TextColumn get title => text()();
   TextColumn get titleEn => text().nullable()();
   TextColumn get what => text()();