refactored and condensed technical documentation and comments across the codebase to improve readability

2026-07-06 23:17:06 +02:00
parent c48f5ef215
commit a19b67eb84
27 changed files with 99 additions and 193 deletions
@@ -174,12 +174,10 @@ class _AccountSectionState extends State<AccountSection> {
  }

  Future<void> _showLogoutDialog(BuildContext context) async {
-    // Sequential logout flow: dialog wipes secure storage, dialog closes
-    // (single Navigator.pop), then we flip the AccountBloc state. The bloc
-    // listener in main.dart pops the Settings route and runs the in-memory
-    // wipe. Triggering setStatus from inside removeData (the previous
-    // approach) raced AsyncDialogAction's pop(true) against popUntil(isFirst)
-    // and could leave the navigator in an inconsistent state.
+    // Flip AccountBloc state only after the dialog fully closes: doing it from
+    // inside removeData (the previous approach) raced AsyncDialogAction's
+    // pop(true) against the listener's popUntil(isFirst) and could leave the
+    // navigator in an inconsistent state.
    final confirmed = await showDialog<bool>(
      context: context,
      builder: (dialogContext) => ConfirmDialog(