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:
Dennis Nemec
2026-09-25 15:07:40 +02:00
parent 6b934e4534
commit 200992262a
15 changed files with 307 additions and 87 deletions

View 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;
}

View 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;
}

View 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);
}
}

View 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();
}
}