Feat/user generated content

README.md

@@ -53,6 +53,15 @@ A robust, backend-driven notification system keeps users informed and brings the
 - **Integrated Notification Center:** Includes a full-featured in-app notification center where users can view their history. Foreground notifications are handled gracefully, appearing as an unread indicator that leads the user to this central hub, avoiding intrusive system alerts during active use.
 > **Your Advantage:** You get a highly flexible and scalable notification system that avoids vendor lock-in and is ready to re-engage users from day one.
 
+---
+
+### 💬 Community & Feedback Systems
+A complete suite of tools to build a vibrant user community and gather valuable feedback directly within the app.
+- **Configurable Headline Engagement:** Enable immediate user interaction directly on each headline within the feed. The entire engagement system is controlled via remote configuration, allowing you to dynamically adjust the depth of user interaction—from simple reactions to full comment threads—without an app update.
+- **Intelligent Review Funnel:** A sophisticated, multi-layered system that strategically prompts users for an app review. Its behavior is entirely driven by remote configuration, including cooldown periods and positive interaction thresholds. It first gauges user sentiment with a private, in-app prompt: positive responses trigger the native OS review dialog, while negative responses open a private feedback form, ensuring you only ask happy users for public reviews and capture valuable insights from others.
+- **Moderated Content Reporting:** Empower your community to maintain content quality with a built-in reporting system. Users can easily report headlines, sources, or individual comments through a guided process. All reports are submitted to the backend and are designed to be managed and actioned from the companion web dashboard.
+> **Your Advantage:** Deploy a full-featured community and feedback system from day one. Skip the complexity of building engagement UI, state management for reactions, and the nuanced logic of a best-practice app review funnel.
+
 </details>
 
 <details>

analysis_options.yaml

@@ -8,6 +8,7 @@ analyzer:
     document_ignores: ignore
     flutter_style_todos: ignore
     lines_longer_than_80_chars: ignore
+    one_member_abstracts: ignore
     prefer_asserts_with_message: ignore
     use_build_context_synchronously: ignore
     use_if_null_to_convert_nulls_to_bools: ignore

lib/account/view/followed_contents/countries/add_country_to_follow_page.dart

@@ -4,11 +4,113 @@ import 'package:flutter/material.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:flutter_news_app_mobile_client_full_source_code/account/bloc/available_countries_bloc.dart';
 import 'package:flutter_news_app_mobile_client_full_source_code/app/bloc/app_bloc.dart';
+import 'package:flutter_news_app_mobile_client_full_source_code/l10n/app_localizations.dart';
 import 'package:flutter_news_app_mobile_client_full_source_code/l10n/l10n.dart';
 import 'package:flutter_news_app_mobile_client_full_source_code/shared/services/content_limitation_service.dart';
 import 'package:flutter_news_app_mobile_client_full_source_code/shared/widgets/content_limitation_bottom_sheet.dart';
 import 'package:ui_kit/ui_kit.dart';
 
+class _FollowButton extends StatefulWidget {
+  const _FollowButton({required this.country, required this.isFollowed});
+
+  final Country country;
+  final bool isFollowed;
+
+  @override
+  State<_FollowButton> createState() => _FollowButtonState();
+}
+
+class _FollowButtonState extends State<_FollowButton> {
+  bool _isLoading = false;
+
+  Future<void> _onFollowToggled() async {
+    setState(() => _isLoading = true);
+
+    final l10n = AppLocalizations.of(context);
+    final appBloc = context.read<AppBloc>();
+    final userContentPreferences = appBloc.state.userContentPreferences;
+
+    if (userContentPreferences == null) {
+      setState(() => _isLoading = false);
+      return;
+    }
+
+    final updatedFollowedCountries = List<Country>.from(
+      userContentPreferences.followedCountries,
+    );
+
+    try {
+      if (widget.isFollowed) {
+        updatedFollowedCountries.removeWhere((c) => c.id == widget.country.id);
+      } else {
+        final limitationService = context.read<ContentLimitationService>();
+        final status = await limitationService.checkAction(
+          ContentAction.followCountry,
+        );
+
+        if (status != LimitationStatus.allowed) {
+          if (mounted) {
+            showContentLimitationBottomSheet(
+              context: context,
+              status: status,
+              action: ContentAction.followCountry,
+            );
+          }
+          return;
+        }
+        updatedFollowedCountries.add(widget.country);
+      }
+
+      final updatedPreferences = userContentPreferences.copyWith(
+        followedCountries: updatedFollowedCountries,
+      );
+
+      appBloc.add(
+        AppUserContentPreferencesChanged(preferences: updatedPreferences),
+      );
+    } on ForbiddenException catch (e) {
+      if (mounted) {
+        await showModalBottomSheet<void>(
+          context: context,
+          builder: (_) => ContentLimitationBottomSheet(
+            title: l10n.limitReachedTitle,
+            body: e.message,
+            buttonText: l10n.gotItButton,
+          ),
+        );
+      }
+    } finally {
+      if (mounted) {
+        setState(() => _isLoading = false);
+      }
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final l10n = AppLocalizations.of(context);
+    final colorScheme = Theme.of(context).colorScheme;
+
+    if (_isLoading) {
+      return const SizedBox(
+        width: 24,
+        height: 24,
+        child: CircularProgressIndicator(strokeWidth: 2),
+      );
+    }
+
+    return IconButton(
+      icon: widget.isFollowed
+          ? Icon(Icons.check_circle, color: colorScheme.primary)
+          : const Icon(Icons.add_circle_outline),
+      tooltip: widget.isFollowed
+          ? l10n.unfollowCountryTooltip(widget.country.name)
+          : l10n.followCountryTooltip(widget.country.name),
+      onPressed: _onFollowToggled,
+    );
+  }
+}
+
 /// {@template add_country_to_follow_page}
 /// A page that allows users to browse and select countries to follow.
 /// {@endtemplate}
@@ -138,76 +240,9 @@ class AddCountryToFollowPage extends StatelessWidget {
                                 ),
                         ),
                         title: Text(country.name, style: textTheme.titleMedium),
-                        trailing: IconButton(
-                          icon: isFollowed
-                              ? Icon(
-                                  Icons.check_circle,
-                                  color: colorScheme.primary,
-                                )
-                              : Icon(
-                                  Icons.add_circle_outline,
-                                  color: colorScheme.onSurfaceVariant,
-                                ),
-                          tooltip: isFollowed
-                              ? l10n.unfollowCountryTooltip(country.name)
-                              : l10n.followCountryTooltip(country.name),
-                          onPressed: () {
-                            // Ensure user preferences are available before
-                            // proceeding.
-                            if (userContentPreferences == null) return;
-
-                            // Create a mutable copy of the followed countries list.
-                            final updatedFollowedCountries = List<Country>.from(
-                              followedCountries,
-                            );
-
-                            // If the user is unfollowing, always allow it.
-                            if (isFollowed) {
-                              updatedFollowedCountries.removeWhere(
-                                (c) => c.id == country.id,
-                              );
-                              final updatedPreferences = userContentPreferences
-                                  .copyWith(
-                                    followedCountries: updatedFollowedCountries,
-                                  );
-
-                              context.read<AppBloc>().add(
-                                AppUserContentPreferencesChanged(
-                                  preferences: updatedPreferences,
-                                ),
-                              );
-                            } else {
-                              // If the user is following, check the limit first.
-                              final limitationService = context
-                                  .read<ContentLimitationService>();
-                              final status = limitationService.checkAction(
-                                ContentAction.followCountry,
-                              );
-
-                              if (status == LimitationStatus.allowed) {
-                                updatedFollowedCountries.add(country);
-                                final updatedPreferences =
-                                    userContentPreferences.copyWith(
-                                      followedCountries:
-                                          updatedFollowedCountries,
-                                    );
-
-                                context.read<AppBloc>().add(
-                                  AppUserContentPreferencesChanged(
-                                    preferences: updatedPreferences,
-                                  ),
-                                );
-                              } else {
-                                // If the limit is reached, show the bottom sheet.
-                                showModalBottomSheet<void>(
-                                  context: context,
-                                  builder: (_) => ContentLimitationBottomSheet(
-                                    status: status,
-                                  ),
-                                );
-                              }
-                            }
-                          },
+                        trailing: _FollowButton(
+                          country: country,
+                          isFollowed: isFollowed,
                         ),
                         contentPadding: const EdgeInsets.symmetric(
                           horizontal: AppSpacing.paddingMedium,