help_center_provider.dart 4.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128
  1. import 'package:flutter/material.dart';
  2. import 'package:flutter_riverpod/flutter_riverpod.dart';
  3. import '../core/network/dio_client.dart';
  4. import '../data/models/announcement/announcement.dart';
  5. import '../data/services/announcement_service.dart';
  6. import 'app_provider.dart';
  7. // ── State ──────────────────────────────────────────────────
  8. class HelpCenterState {
  9. final List<HelpInfo> groups;
  10. final Set<int> expandedIndices;
  11. final bool isLoading;
  12. final String? errorMessage;
  13. const HelpCenterState({
  14. this.groups = const [],
  15. this.expandedIndices = const {},
  16. this.isLoading = false,
  17. this.errorMessage,
  18. });
  19. HelpCenterState copyWith({
  20. List<HelpInfo>? groups,
  21. Set<int>? expandedIndices,
  22. bool? isLoading,
  23. String? errorMessage,
  24. }) =>
  25. HelpCenterState(
  26. groups: groups ?? this.groups,
  27. expandedIndices: expandedIndices ?? this.expandedIndices,
  28. isLoading: isLoading ?? this.isLoading,
  29. errorMessage: errorMessage,
  30. );
  31. }
  32. // ── Notifier ───────────────────────────────────────────────
  33. class HelpCenterNotifier extends AutoDisposeNotifier<HelpCenterState> {
  34. AnnouncementService get _service =>
  35. AnnouncementService(ref.read(dioClientProvider));
  36. @override
  37. HelpCenterState build() {
  38. ref.listen<Locale>(localeProvider, (previous, next) {
  39. if (previous != null && previous != next) {
  40. Future.microtask(_load);
  41. }
  42. });
  43. Future.microtask(_load);
  44. return const HelpCenterState(isLoading: true);
  45. }
  46. Future<void> _load() async {
  47. try {
  48. final lang = backendLangFromLocale(ref.read(localeProvider));
  49. final groups = await _service.getHelpList(lang: lang);
  50. state = state.copyWith(groups: groups, isLoading: false);
  51. } catch (e) {
  52. state = state.copyWith(isLoading: false, errorMessage: e.toString());
  53. }
  54. }
  55. Future<void> refresh() async {
  56. state = state.copyWith(isLoading: true, errorMessage: null);
  57. await _load();
  58. }
  59. void toggleExpand(int index) {
  60. final expanded = Set<int>.from(state.expandedIndices);
  61. if (expanded.contains(index)) {
  62. expanded.remove(index);
  63. } else {
  64. expanded.add(index);
  65. }
  66. state = state.copyWith(expandedIndices: expanded);
  67. }
  68. }
  69. final helpCenterProvider =
  70. AutoDisposeNotifierProvider<HelpCenterNotifier, HelpCenterState>(
  71. HelpCenterNotifier.new,
  72. );
  73. // ── 帮助详情 Provider ──────────────────────────────────────
  74. /// 特殊 id → type 映射
  75. const _specialHelpRoutes = {
  76. '63': 'desclaimer',
  77. '64': 'privacy',
  78. '68': 'follow',
  79. };
  80. /// 协议列表(按 categoryCode 分组缓存)
  81. final protocolListProvider =
  82. FutureProvider.autoDispose.family<List<WebInfoContent>, String>((ref, categoryCode) {
  83. final dio = ref.read(dioClientProvider);
  84. return AnnouncementService(dio).getProtocolList(categoryCode: categoryCode);
  85. });
  86. /// 按 (categoryCode, title) 查找协议内容
  87. /// title 为空时返回列表第一项(适用于单条目分类如 FOLLOW_PROTOCOL)
  88. final protocolByTitleProvider =
  89. FutureProvider.autoDispose.family<WebInfoContent?, (String, String)>(
  90. (ref, params) async {
  91. final (categoryCode, title) = params;
  92. final list = await ref.watch(protocolListProvider(categoryCode).future);
  93. if (list.isEmpty) return null;
  94. if (title.isEmpty) return list.first;
  95. try {
  96. return list.firstWhere((e) => e.title == title);
  97. } catch (_) {
  98. return list.first;
  99. }
  100. });
  101. final helpDetailProvider =
  102. FutureProvider.autoDispose.family<WebInfoContent?, String>((ref, id) {
  103. final dio = ref.read(dioClientProvider);
  104. final service = AnnouncementService(dio);
  105. final specialType = _specialHelpRoutes[id];
  106. if (specialType != null) {
  107. return service.getHelpSpecial(specialType);
  108. }
  109. return service.getHelpDetail(id);
  110. });