feat(flags): Feature-Flags aus Config-Datei; Gutschriften-Abschnitt abschaltbar
- Schalter stehen in assets/feature_flags.json (Key -> enabled + Beschreibung) statt als Konstanten im Code - Enum Feature buendelt die stabilen Keys; FeatureFlags liest die Datei, ignoriert unbekannte Keys und nutzt fuer fehlende den Default aus dem Enum - Laden beim App-Start im AppBloc, bereitgestellt per RepositoryProvider; FeatureGate blendet Bereiche bei inaktivem Feature komplett aus - articles.credit_section = false: Abschnitt "Gutschriften" im Artikel-Step ist ausgeblendet - Bisheriges Stepper-Flag migriert (articles.credit_amount_stepper); die fuenf ungenutzten statischen Flags mit veralteten Kommentaren entfernt - Tests: Asset enthaelt alle Keys, Parsing, Defaults, FeatureGate Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
20
lib/feature/feature_flags/feature.dart
Normal file
20
lib/feature/feature_flags/feature.dart
Normal file
@ -0,0 +1,20 @@
|
||||
/// Alle schaltbaren Features der App.
|
||||
///
|
||||
/// [key] ist der stabile Bezeichner in `assets/feature_flags.json`, über den
|
||||
/// ein Feature aktiviert oder deaktiviert wird. Der Wert selbst steht nie im
|
||||
/// Code — nur, was gilt, falls ein Key in der Datei fehlt ([defaultEnabled]).
|
||||
enum Feature {
|
||||
/// Abschnitt „Gutschriften" (Betrags-Gutschrift) im Artikel-Step.
|
||||
articlesCreditSection('articles.credit_section', defaultEnabled: true),
|
||||
|
||||
/// Betrags-Gutschrift per +/−-Stepper statt freiem Textfeld.
|
||||
articlesCreditAmountStepper(
|
||||
'articles.credit_amount_stepper',
|
||||
defaultEnabled: false,
|
||||
);
|
||||
|
||||
const Feature(this.key, {required this.defaultEnabled});
|
||||
|
||||
final String key;
|
||||
final bool defaultEnabled;
|
||||
}
|
||||
45
lib/feature/feature_flags/feature_flags.dart
Normal file
45
lib/feature/feature_flags/feature_flags.dart
Normal file
@ -0,0 +1,45 @@
|
||||
import 'package:flutter/foundation.dart';
|
||||
|
||||
import 'feature.dart';
|
||||
|
||||
/// Unveränderlicher Satz an Feature-Schaltern, geladen aus
|
||||
/// `assets/feature_flags.json` (siehe [FeatureFlagsRepository]).
|
||||
///
|
||||
/// Erwartetes Format:
|
||||
/// ```json
|
||||
/// { "features": { "<key>": { "enabled": true, "description": "…" } } }
|
||||
/// ```
|
||||
/// `description` ist nur Doku für Menschen. Unbekannte Keys werden
|
||||
/// ignoriert, fehlende fallen auf [Feature.defaultEnabled] zurück.
|
||||
@immutable
|
||||
class FeatureFlags {
|
||||
const FeatureFlags(this._enabledByKey);
|
||||
|
||||
factory FeatureFlags.fromJson(Map<String, dynamic> json) {
|
||||
final features = json['features'];
|
||||
if (features is! Map<String, dynamic>) {
|
||||
throw const FormatException('feature_flags.json: "features" fehlt.');
|
||||
}
|
||||
final knownKeys = {for (final f in Feature.values) f.key};
|
||||
final enabledByKey = <String, bool>{};
|
||||
features.forEach((key, value) {
|
||||
final enabled = value is Map<String, dynamic> ? value['enabled'] : null;
|
||||
if (enabled is! bool) {
|
||||
throw FormatException(
|
||||
'feature_flags.json: "$key.enabled" muss true oder false sein.',
|
||||
);
|
||||
}
|
||||
if (!knownKeys.contains(key)) {
|
||||
debugPrint('FeatureFlags: unbekannter Key "$key" wird ignoriert.');
|
||||
return;
|
||||
}
|
||||
enabledByKey[key] = enabled;
|
||||
});
|
||||
return FeatureFlags(enabledByKey);
|
||||
}
|
||||
|
||||
final Map<String, bool> _enabledByKey;
|
||||
|
||||
bool isEnabled(Feature feature) =>
|
||||
_enabledByKey[feature.key] ?? feature.defaultEnabled;
|
||||
}
|
||||
20
lib/feature/feature_flags/feature_flags_repository.dart
Normal file
20
lib/feature/feature_flags/feature_flags_repository.dart
Normal file
@ -0,0 +1,20 @@
|
||||
import 'dart:convert';
|
||||
|
||||
import 'package:flutter/services.dart' show rootBundle;
|
||||
|
||||
import 'feature_flags.dart';
|
||||
|
||||
/// Lädt die Feature-Schalter aus der mitgelieferten Asset-Datei.
|
||||
class FeatureFlagsRepository {
|
||||
const FeatureFlagsRepository({this.assetPath = 'assets/feature_flags.json'});
|
||||
|
||||
final String assetPath;
|
||||
|
||||
Future<FeatureFlags> load() async {
|
||||
final json = jsonDecode(await rootBundle.loadString(assetPath));
|
||||
if (json is! Map<String, dynamic>) {
|
||||
throw const FormatException('feature_flags.json ist kein JSON-Objekt.');
|
||||
}
|
||||
return FeatureFlags.fromJson(json);
|
||||
}
|
||||
}
|
||||
22
lib/feature/feature_flags/feature_gate.dart
Normal file
22
lib/feature/feature_flags/feature_gate.dart
Normal file
@ -0,0 +1,22 @@
|
||||
import 'package:flutter/widgets.dart';
|
||||
import 'package:flutter_bloc/flutter_bloc.dart';
|
||||
|
||||
import 'feature.dart';
|
||||
import 'feature_flags.dart';
|
||||
|
||||
/// Zeigt [child] nur, wenn [feature] aktiviert ist — sonst nichts (kein
|
||||
/// Platzhalter, kein Abstand). Die Schalter kommen aus dem [FeatureFlags],
|
||||
/// das oberhalb per `RepositoryProvider` bereitsteht.
|
||||
class FeatureGate extends StatelessWidget {
|
||||
const FeatureGate({super.key, required this.feature, required this.child});
|
||||
|
||||
final Feature feature;
|
||||
final Widget child;
|
||||
|
||||
@override
|
||||
Widget build(BuildContext context) {
|
||||
return context.read<FeatureFlags>().isEnabled(feature)
|
||||
? child
|
||||
: const SizedBox.shrink();
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user