feat: Enhance feature flag display with source indicators and add refresh confirmation.

also implement firebase native way to process default value

Author: bradly0cjw

assets/feature_flags.json

@@ -10,5 +10,6 @@
       "dark",
       "system"
     ]
-  }
+  },
+  "_force_override_flags": ""
 }

lib/i18n/en-US.i18n.yaml

@@ -103,7 +103,7 @@ profile:
     clearPreferences: Clear Preferences
     clearCredentials: Clear Credentials
     clearUserData: Clear User Data
-    cleared: '${item} cleared'
+    cleared: "${item} cleared"
     clearFailed: Failed to clear ${item}
     items:
       cache: Cache
@@ -128,3 +128,9 @@ about:
 featureFlags:
   title: Feature Flags
   reset: Reset to default
+  status:
+    defaultStatus: Default
+    remote: Remote
+    overrideStatus: Override
+    forced: Forced
+  refreshed: Refreshed from remote

lib/i18n/strings.g.dart

@@ -4,7 +4,7 @@
 /// To regenerate, run: `dart run slang`
 ///
 /// Locales: 2
-/// Strings: 216 (108 per locale)
+/// Strings: 226 (113 per locale)
 
 // coverage:ignore-file
 // ignore_for_file: type=lint, unused_import

lib/i18n/strings_en_US.g.dart

@@ -206,6 +206,8 @@ class _TranslationsFeatureFlagsEnUs extends TranslationsFeatureFlagsZhTw {
 	// Translations
 	@override String get title => 'Feature Flags';
 	@override String get reset => 'Reset to default';
+	@override late final _TranslationsFeatureFlagsStatusEnUs status = _TranslationsFeatureFlagsStatusEnUs._(_root);
+	@override String get refreshed => 'Refreshed from remote';
 }
 
 // Path: intro.features
@@ -314,6 +316,19 @@ class _TranslationsProfileDangerZoneEnUs extends TranslationsProfileDangerZoneZh
 	@override late final _TranslationsProfileDangerZoneItemsEnUs items = _TranslationsProfileDangerZoneItemsEnUs._(_root);
 }
 
+// Path: featureFlags.status
+class _TranslationsFeatureFlagsStatusEnUs extends TranslationsFeatureFlagsStatusZhTw {
+	_TranslationsFeatureFlagsStatusEnUs._(TranslationsEnUs root) : this._root = root, super.internal(root);
+
+	final TranslationsEnUs _root; // ignore: unused_field
+
+	// Translations
+	@override String get defaultStatus => 'Default';
+	@override String get remote => 'Remote';
+	@override String get overrideStatus => 'Override';
+	@override String get forced => 'Forced';
+}
+
 // Path: intro.features.courseTable
 class _TranslationsIntroFeaturesCourseTableEnUs extends TranslationsIntroFeaturesCourseTableZhTw {
 	_TranslationsIntroFeaturesCourseTableEnUs._(TranslationsEnUs root) : this._root = root, super.internal(root);
@@ -477,6 +492,11 @@ extension on TranslationsEnUs {
 			'about.copyright' => '© 2025 NTUT Programming Club\nLicensed under the GNU GPL v3.0',
 			'featureFlags.title' => 'Feature Flags',
 			'featureFlags.reset' => 'Reset to default',
+			'featureFlags.status.defaultStatus' => 'Default',
+			'featureFlags.status.remote' => 'Remote',
+			'featureFlags.status.overrideStatus' => 'Override',
+			'featureFlags.status.forced' => 'Forced',
+			'featureFlags.refreshed' => 'Refreshed from remote',
 			_ => null,
 		};
 	}

lib/i18n/strings_zh_TW.g.dart

@@ -297,6 +297,11 @@ class TranslationsFeatureFlagsZhTw {
 
 	/// zh-TW: '恢復預設值'
 	String get reset => '恢復預設值';
+
+	late final TranslationsFeatureFlagsStatusZhTw status = TranslationsFeatureFlagsStatusZhTw.internal(_root);
+
+	/// zh-TW: '已從遠端截取'
+	String get refreshed => '已從遠端截取';
 }
 
 // Path: intro.features
@@ -485,6 +490,27 @@ class TranslationsProfileDangerZoneZhTw {
 	late final TranslationsProfileDangerZoneItemsZhTw items = TranslationsProfileDangerZoneItemsZhTw.internal(_root);
 }
 
+// Path: featureFlags.status
+class TranslationsFeatureFlagsStatusZhTw {
+	TranslationsFeatureFlagsStatusZhTw.internal(this._root);
+
+	final Translations _root; // ignore: unused_field
+
+	// Translations
+
+	/// zh-TW: '預設'
+	String get defaultStatus => '預設';
+
+	/// zh-TW: '遠端'
+	String get remote => '遠端';
+
+	/// zh-TW: '覆寫'
+	String get overrideStatus => '覆寫';
+
+	/// zh-TW: '強制'
+	String get forced => '強制';
+}
+
 // Path: intro.features.courseTable
 class TranslationsIntroFeaturesCourseTableZhTw {
 	TranslationsIntroFeaturesCourseTableZhTw.internal(this._root);
@@ -670,6 +696,11 @@ extension on Translations {
 			'about.copyright' => '© 2025北科程式設計研究社\n以GNU GPL v3.0授權條款釋出',
 			'featureFlags.title' => '功能開關',
 			'featureFlags.reset' => '恢復預設值',
+			'featureFlags.status.defaultStatus' => '預設',
+			'featureFlags.status.remote' => '遠端',
+			'featureFlags.status.overrideStatus' => '覆寫',
+			'featureFlags.status.forced' => '強制',
+			'featureFlags.refreshed' => '已從遠端截取',
 			_ => null,
 		};
 	}

lib/i18n/zh-TW.i18n.yaml

@@ -128,3 +128,9 @@ about:
 featureFlags:
   title: 功能開關
   reset: 恢復預設值
+  status:
+    defaultStatus: 預設
+    remote: 遠端
+    overrideStatus: 覆寫
+    forced: 強制
+  refreshed: 已從遠端截取

lib/repositories/feature_flag_providers.dart

@@ -16,7 +16,9 @@ class FeatureFlagsNotifier extends AsyncNotifier<List<FeatureFlag>> {
   Future<void> refreshFlags() async {
     state = const AsyncValue.loading();
     state = await AsyncValue.guard(() {
-      return ref.read(featureFlagRepositoryProvider).getAllFlags(forceRefresh: true);
+      return ref
+          .read(featureFlagRepositoryProvider)
+          .getAllFlags(forceRefresh: true);
     });
   }
 

lib/repositories/feature_flag_repository.dart

@@ -5,25 +5,41 @@ import 'package:shared_preferences/shared_preferences.dart';
 import 'package:tattoo/services/feature_flag/feature_flag_service.dart';
 import 'package:tattoo/services/firebase_service.dart';
 
+enum FeatureFlagSource {
+  local,
+  remote,
+  override,
+  forced,
+}
+
 /// The model for a UI-consumable feature flag.
 class FeatureFlag {
   final String key;
   final dynamic defaultValue;
   final dynamic overrideValue;
   final List<dynamic>? options;
   final bool isForced;
+  final bool isRemote;
 
   const FeatureFlag({
     required this.key,
     required this.defaultValue,
     this.overrideValue,
     this.options,
     this.isForced = false,
+    this.isRemote = false,
   });
 
   dynamic get value => overrideValue ?? defaultValue;
   Type get type => defaultValue.runtimeType;
 
+  FeatureFlagSource get source {
+    if (isForced) return FeatureFlagSource.forced;
+    if (overrideValue != null) return FeatureFlagSource.override;
+    if (isRemote) return FeatureFlagSource.remote;
+    return FeatureFlagSource.local;
+  }
+
   // Type-safe getters
   bool get asBool => value as bool;
   int get asInt => value as int;
@@ -42,15 +58,17 @@ final featureFlagRepositoryProvider = Provider<FeatureFlagRepository>((ref) {
 class FeatureFlagRepository {
   final FeatureFlagService _service;
   final SharedPreferencesAsync _prefs;
-  Map<String, dynamic>? _defaultsCache;
+  Map<String, FeatureFlagData>? _defaultsCache;
 
   FeatureFlagRepository({
     required FeatureFlagService service,
     required SharedPreferencesAsync prefs,
   }) : _service = service,
        _prefs = prefs;
 
-  Future<Map<String, dynamic>> _getDefaults({bool forceRefresh = false}) async {
+  Future<Map<String, FeatureFlagData>> _getDefaults({
+    bool forceRefresh = false,
+  }) async {
     if (forceRefresh) _defaultsCache = null;
     return _defaultsCache ??= await _service.fetchDefaultFlags();
   }
@@ -59,7 +77,8 @@ class FeatureFlagRepository {
     final defaults = await _getDefaults(forceRefresh: forceRefresh);
     final list = <FeatureFlag>[];
 
-    final forceOverrideString = defaults['_force_override_flags'] as String?;
+    final forceOverrideString =
+        defaults['_force_override_flags']?.value as String?;
     final forceOverrides =
         forceOverrideString
             ?.split(',')
@@ -72,7 +91,8 @@ class FeatureFlagRepository {
       final key = entry.key;
       if (key == '_force_override_flags') continue;
 
-      dynamic defVal = entry.value;
+      dynamic defVal = entry.value.value;
+      final isRemote = entry.value.isRemote;
       List<dynamic>? options;
 
       if (defVal is Map<String, dynamic> &&
@@ -106,6 +126,7 @@ class FeatureFlagRepository {
           overrideValue: overrideVal,
           options: options,
           isForced: isForced,
+          isRemote: isRemote,
         ),
       );
     }