Feat/build full user management

README.md

@@ -33,6 +33,19 @@ Manage the entire lifecycle of your content from a single, intuitive interface.
 
 </details>
 
+<details>
+<summary><strong>👥 User & Role Management</strong></summary>
+
+### 👥 Granular User & Role Management
+Effortlessly manage your entire user base with a dedicated user management system. View all registered users, filter them by email or role, and dynamically adjust their dashboard permissions.
+- **Full User Roster:** See a comprehensive list of all users, including their email, app subscription level, and current dashboard role.
+- **Dynamic Role Promotion:** Promote trusted users to a "Publisher" role, granting them content management capabilities without full administrative access.
+- **Powerful Filtering:** Quickly locate specific users or user segments with multi-faceted filtering by email, app role, and dashboard role.
+> **Your Advantage:** Delegate content creation responsibilities securely, build out your editorial team, and maintain a clear overview of all system users and their permissions, all from a single, centralized interface.
+
+</details>
+
+
 <details>
 <summary><strong>⚙️ App Monetization & Remote Control</strong></summary>
 
@@ -60,7 +73,7 @@ Dynamically control the mobile app's behavior and operational state directly fro
 ### 🔐 Secure Administrative Access
 A complete and secure user authentication system is built-in for your editorial and administrative teams.
 - **Modern, Passwordless Sign-In:** Ensures that only authorized personnel can access the dashboard using a secure and easy-to-use email-based verification system.
-> **Your Advantage:** The security and user management for your administrative team is already handled, providing peace of mind from day one.
+> **Your Advantage:** The security and access control for your administrative team is already handled, providing peace of mind from day one.
 
 ---
 

lib/app/view/app.dart

@@ -22,6 +22,8 @@ import 'package:flutter_news_app_web_dashboard_full_source_code/overview/bloc/ov
 import 'package:flutter_news_app_web_dashboard_full_source_code/router/router.dart';
 import 'package:flutter_news_app_web_dashboard_full_source_code/shared/services/pending_deletions_service.dart';
 import 'package:flutter_news_app_web_dashboard_full_source_code/shared/shared.dart';
+import 'package:flutter_news_app_web_dashboard_full_source_code/user_management/bloc/user_filter/user_filter_bloc.dart';
+import 'package:flutter_news_app_web_dashboard_full_source_code/user_management/bloc/user_management_bloc.dart';
 import 'package:go_router/go_router.dart';
 import 'package:kv_storage_service/kv_storage_service.dart';
 import 'package:logging/logging.dart';
@@ -41,6 +43,7 @@ class App extends StatelessWidget {
     required DataRepository<Country> countriesRepository,
     required DataRepository<Language> languagesRepository,
     required DataRepository<LocalAd> localAdsRepository,
+    required DataRepository<User> usersRepository,
     required KVStorageService storageService,
     required AppEnvironment environment,
     required PendingDeletionsService pendingDeletionsService,
@@ -57,6 +60,7 @@ class App extends StatelessWidget {
        _countriesRepository = countriesRepository,
        _languagesRepository = languagesRepository,
        _localAdsRepository = localAdsRepository,
+       _usersRepository = usersRepository,
        _environment = environment,
        _pendingDeletionsService = pendingDeletionsService;
 
@@ -72,6 +76,7 @@ class App extends StatelessWidget {
   final DataRepository<Country> _countriesRepository;
   final DataRepository<Language> _languagesRepository;
   final DataRepository<LocalAd> _localAdsRepository;
+  final DataRepository<User> _usersRepository;
   final KVStorageService _kvStorageService;
   final AppEnvironment _environment;
 
@@ -93,6 +98,7 @@ class App extends StatelessWidget {
         RepositoryProvider.value(value: _countriesRepository),
         RepositoryProvider.value(value: _languagesRepository),
         RepositoryProvider.value(value: _localAdsRepository),
+        RepositoryProvider.value(value: _usersRepository),
         RepositoryProvider.value(value: _kvStorageService),
         RepositoryProvider(
           create: (context) => const ThrottledFetchingService(),
@@ -163,6 +169,15 @@ class App extends StatelessWidget {
               sourcesRepository: context.read<DataRepository<Source>>(),
             ),
           ),
+          // The UserFilterBloc is provided here to be available for both the
+          // UserManagementBloc and the UI components.
+          BlocProvider(create: (_) => UserFilterBloc()),
+          BlocProvider(
+            create: (context) => UserManagementBloc(
+              usersRepository: context.read<DataRepository<User>>(),
+              userFilterBloc: context.read<UserFilterBloc>(),
+            ),
+          ),
         ],
         child: _AppView(
           authenticationRepository: _authenticationRepository,

lib/app/view/app_shell.dart

@@ -50,6 +50,11 @@ class AppShell extends StatelessWidget {
             selectedIcon: const Icon(Icons.folder),
             label: l10n.contentManagement,
           ),
+          NavigationDestination(
+            icon: const Icon(Icons.people_outline),
+            selectedIcon: const Icon(Icons.people),
+            label: l10n.userManagement,
+          ),
           NavigationDestination(
             icon: const Icon(Icons.settings_applications_outlined),
             selectedIcon: const Icon(Icons.settings_applications),

lib/bootstrap.dart

@@ -65,6 +65,7 @@ Future<Widget> bootstrap(
   DataClient<Country> countriesClient;
   DataClient<Language> languagesClient;
   DataClient<LocalAd> localAdsClient;
+  DataClient<User> usersClient;
 
   if (appConfig.environment == app_config.AppEnvironment.demo) {
     headlinesClient = DataInMemory<Headline>(
@@ -125,6 +126,12 @@ Future<Widget> bootstrap(
       initialData: localAdsFixturesData,
       logger: Logger('DataInMemory<LocalAd>'),
     );
+    usersClient = DataInMemory<User>(
+      toJson: (i) => i.toJson(),
+      getId: (i) => i.id,
+      // No initial data for users in demo mode.
+      logger: Logger('DataInMemory<User>'),
+    );
   } else if (appConfig.environment == app_config.AppEnvironment.development) {
     headlinesClient = DataApi<Headline>(
       httpClient: httpClient!,
@@ -196,6 +203,13 @@ Future<Widget> bootstrap(
       toJson: LocalAd.toJson,
       logger: Logger('DataApi<LocalAd>'),
     );
+    usersClient = DataApi<User>(
+      httpClient: httpClient,
+      modelName: 'user',
+      fromJson: User.fromJson,
+      toJson: (user) => user.toJson(),
+      logger: Logger('DataApi<User>'),
+    );
   } else {
     headlinesClient = DataApi<Headline>(
       httpClient: httpClient!,
@@ -267,6 +281,13 @@ Future<Widget> bootstrap(
       toJson: FeedItem.toJson,
       logger: Logger('DataApi<LocalAd>'),
     );
+    usersClient = DataApi<User>(
+      httpClient: httpClient,
+      modelName: 'user',
+      fromJson: User.fromJson,
+      toJson: (user) => user.toJson(),
+      logger: Logger('DataApi<User>'),
+    );
   }
 
   pendingDeletionsService = PendingDeletionsServiceImpl(
@@ -300,6 +321,7 @@ Future<Widget> bootstrap(
   final localAdsRepository = DataRepository<LocalAd>(
     dataClient: localAdsClient,
   );
+  final usersRepository = DataRepository<User>(dataClient: usersClient);
 
   return App(
     authenticationRepository: authenticationRepository,
@@ -313,6 +335,7 @@ Future<Widget> bootstrap(
     countriesRepository: countriesRepository,
     languagesRepository: languagesRepository,
     localAdsRepository: localAdsRepository,
+    usersRepository: usersRepository,
     storageService: kvStorage,
     environment: environment,
     pendingDeletionsService: pendingDeletionsService,

lib/l10n/app_localizations.dart

@@ -2845,6 +2845,138 @@ abstract class AppLocalizations {
   /// In en, this message translates to:
   /// **'Logo URL'**
   String get logoUrl;
+
+  /// Label for the user management navigation item
+  ///
+  /// In en, this message translates to:
+  /// **'User Management'**
+  String get userManagement;
+
+  /// Description for the User Management page
+  ///
+  /// In en, this message translates to:
+  /// **'Manage system users, including their roles and permissions.'**
+  String get userManagementPageDescription;
+
+  /// Headline for loading state of users
+  ///
+  /// In en, this message translates to:
+  /// **'Loading Users'**
+  String get loadingUsers;
+
+  /// Message when no users are found
+  ///
+  /// In en, this message translates to:
+  /// **'No users found.'**
+  String get noUsersFound;
+
+  /// Column header for user email
+  ///
+  /// In en, this message translates to:
+  /// **'Email'**
+  String get email;
+
+  /// Column header for user app role
+  ///
+  /// In en, this message translates to:
+  /// **'App Role'**
+  String get appRole;
+
+  /// Column header for user dashboard role
+  ///
+  /// In en, this message translates to:
+  /// **'Dashboard Role'**
+  String get dashboardRole;
+
+  /// Column header for creation date
+  ///
+  /// In en, this message translates to:
+  /// **'Created At'**
+  String get createdAt;
+
+  /// Action to promote a user to a publisher role.
+  ///
+  /// In en, this message translates to:
+  /// **'Promote to Publisher'**
+  String get promoteToPublisher;
+
+  /// Action to demote a publisher back to a standard user role.
+  ///
+  /// In en, this message translates to:
+  /// **'Demote to User'**
+  String get demoteToUser;
+
+  /// Localized name for DashboardUserRole.admin
+  ///
+  /// In en, this message translates to:
+  /// **'Admin'**
+  String get adminRole;
+
+  /// Localized name for DashboardUserRole.publisher
+  ///
+  /// In en, this message translates to:
+  /// **'Publisher'**
+  String get publisherRole;
+
+  /// Title for the filter dialog when filtering users.
+  ///
+  /// In en, this message translates to:
+  /// **'Filter Users'**
+  String get filterUsers;
+
+  /// Hint text for the user search field.
+  ///
+  /// In en, this message translates to:
+  /// **'Search by user email...'**
+  String get searchByUserEmail;
+
+  /// Hint text for selecting app roles in a filter dialog.
+  ///
+  /// In en, this message translates to:
+  /// **'Select App Roles'**
+  String get selectAppRoles;
+
+  /// Hint text for selecting dashboard roles in a filter dialog.
+  ///
+  /// In en, this message translates to:
+  /// **'Select Dashboard Roles'**
+  String get selectDashboardRoles;
+
+  /// Column header for authentication status
+  ///
+  /// In en, this message translates to:
+  /// **'Authentication'**
+  String get authentication;
+
+  /// Column header for subscription status
+  ///
+  /// In en, this message translates to:
+  /// **'Subscription'**
+  String get subscription;
+
+  /// Authentication status for a guest user
+  ///
+  /// In en, this message translates to:
+  /// **'Anonymous'**
+  String get authenticationAnonymous;
+
+  /// Authentication status for a signed-in user
+  ///
+  /// In en, this message translates to:
+  /// **'Authenticated'**
+  String get authenticationAuthenticated;
+
+  /// Subscription status for a free user
+  ///
+  /// In en, this message translates to:
+  /// **'Free'**
+  String get subscriptionFree;
+
+  /// Subscription status for a premium user
+  ///
+  /// In en, this message translates to:
+  /// **'Premium'**
+  String get subscriptionPremium;
 }
 
 class _AppLocalizationsDelegate

lib/l10n/app_localizations_ar.dart

@@ -1515,4 +1515,71 @@ class AppLocalizationsAr extends AppLocalizations {
 
   @override
   String get logoUrl => 'رابط الشعار';
+
+  @override
+  String get userManagement => 'إدارة المستخدمين';
+
+  @override
+  String get userManagementPageDescription =>
+      'إدارة مستخدمي النظام، بما في ذلك أدوارهم وأذوناتهم.';
+
+  @override
+  String get loadingUsers => 'جاري تحميل المستخدمين';
+
+  @override
+  String get noUsersFound => 'لم يتم العثور على مستخدمين.';
+
+  @override
+  String get email => 'البريد الإلكتروني';
+
+  @override
+  String get appRole => 'دور التطبيق';
+
+  @override
+  String get dashboardRole => 'دور لوحة التحكم';
+
+  @override
+  String get createdAt => 'تاريخ الإنشاء';
+
+  @override
+  String get promoteToPublisher => 'ترقية إلى ناشر';
+
+  @override
+  String get demoteToUser => 'تخفيض إلى مستخدم';
+
+  @override
+  String get adminRole => 'مسؤول';
+
+  @override
+  String get publisherRole => 'ناشر';
+
+  @override
+  String get filterUsers => 'تصفية المستخدمين';
+
+  @override
+  String get searchByUserEmail => 'البحث بالبريد الإلكتروني للمستخدم...';
+
+  @override
+  String get selectAppRoles => 'اختر أدوار التطبيق';
+
+  @override
+  String get selectDashboardRoles => 'اختر أدوار لوحة التحكم';
+
+  @override
+  String get authentication => 'المصادقة';
+
+  @override
+  String get subscription => 'الاشتراك';
+
+  @override
+  String get authenticationAnonymous => 'مجهول';
+
+  @override
+  String get authenticationAuthenticated => 'موثق';
+
+  @override
+  String get subscriptionFree => 'مجاني';
+
+  @override
+  String get subscriptionPremium => 'مميز';
 }