announcement_service.dart 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170
  1. import 'package:dio/dio.dart';
  2. import '../models/announcement/announcement.dart';
  3. /// 公告 & 帮助中心 API 服务
  4. class AnnouncementService {
  5. const AnnouncementService(this._dio);
  6. final Dio _dio;
  7. /// 公告列表(分页)— POST uc/announcement/page
  8. Future<({List<AnnouncementContent> content, int totalElements})>
  9. getAnnouncementPage({
  10. int pageNo = 1,
  11. int pageSize = 15,
  12. }) async {
  13. final response = await _dio.post<Map<String, dynamic>>(
  14. 'uc/announcement/page',
  15. data: {'pageNo': pageNo, 'pageSize': pageSize},
  16. options: Options(contentType: Headers.formUrlEncodedContentType),
  17. );
  18. final data = response.data?['data'];
  19. if (data is Map<String, dynamic>) {
  20. final contentList = data['content'];
  21. final total = data['totalElements'] as int? ?? 0;
  22. if (contentList is List) {
  23. return (
  24. content: contentList
  25. .whereType<Map<String, dynamic>>()
  26. .map((e) => AnnouncementContent.fromJson(e))
  27. .toList(),
  28. totalElements: total,
  29. );
  30. }
  31. }
  32. return (content: <AnnouncementContent>[], totalElements: 0);
  33. }
  34. /// 弹窗公告列表 — GET uc/announcement/popups
  35. Future<List<AnnouncementBean>> getPopupAnnouncements() async {
  36. final response = await _dio.get<Map<String, dynamic>>(
  37. 'uc/announcement/popups',
  38. );
  39. final data = response.data?['data'];
  40. if (data is List) {
  41. return data
  42. .whereType<Map<String, dynamic>>()
  43. .map((e) => AnnouncementBean.fromJson(e))
  44. .toList();
  45. }
  46. return [];
  47. }
  48. /// 系统弹窗公告 — GET uc/announcement/system
  49. Future<AnnouncementBean?> getSystemAnnouncement() async {
  50. final response = await _dio.get<Map<String, dynamic>>(
  51. 'uc/announcement/system',
  52. );
  53. final data = response.data?['data'];
  54. if (data is Map<String, dynamic>) {
  55. return AnnouncementBean.fromJson(data);
  56. }
  57. return null;
  58. }
  59. /// 公告详情 — GET uc/announcement/{id}
  60. Future<WebInfoContent?> getAnnouncementDetail(String id) async {
  61. final response = await _dio.get<Map<String, dynamic>>(
  62. 'uc/announcement/$id',
  63. );
  64. final data = response.data?['data'];
  65. if (data is Map<String, dynamic>) {
  66. return WebInfoContent.fromJson(data);
  67. }
  68. return null;
  69. }
  70. /// 帮助中心分组列表 — POST uc/ancillary/more/help
  71. Future<List<HelpInfo>> getHelpList({String lang = 'zh_CN'}) async {
  72. final response = await _dio.post<Map<String, dynamic>>(
  73. 'uc/ancillary/more/help',
  74. data: {'lang': lang},
  75. options: Options(contentType: Headers.formUrlEncodedContentType),
  76. );
  77. final data = response.data?['data'];
  78. if (data is List) {
  79. return data
  80. .whereType<Map<String, dynamic>>()
  81. .map((e) => HelpInfo.fromJson(e))
  82. .toList();
  83. }
  84. return [];
  85. }
  86. /// 帮助详情(通用)— POST uc/ancillary/more/help/detail
  87. Future<WebInfoContent?> getHelpDetail(String id) async {
  88. final response = await _dio.post<Map<String, dynamic>>(
  89. 'uc/ancillary/more/help/detail',
  90. data: {'id': id},
  91. options: Options(contentType: Headers.formUrlEncodedContentType),
  92. );
  93. final data = response.data?['data'];
  94. if (data is Map<String, dynamic>) {
  95. return WebInfoContent.fromJson(data);
  96. }
  97. return null;
  98. }
  99. /// 协议列表 — GET cms/help/list?categoryCode=...
  100. Future<List<WebInfoContent>> getProtocolList({
  101. String categoryCode = 'PROTOCOL',
  102. String lang = 'zh_CN',
  103. }) async {
  104. final response = await _dio.get<Map<String, dynamic>>(
  105. 'cms/help/list',
  106. queryParameters: {'categoryCode': categoryCode, 'lang': lang},
  107. );
  108. final data = response.data?['data'];
  109. if (data is List) {
  110. return data
  111. .whereType<Map<String, dynamic>>()
  112. .map((e) => WebInfoContent.fromJson(e))
  113. .toList();
  114. }
  115. return [];
  116. }
  117. /// 帮助详情(特殊类型)— POST uc/ancillary/more/help/{type}
  118. /// type: desclaimer / privacy / follow
  119. Future<WebInfoContent?> getHelpSpecial(String type) async {
  120. final response = await _dio.post<Map<String, dynamic>>(
  121. 'uc/ancillary/more/help/$type',
  122. );
  123. final data = response.data?['data'];
  124. if (data is Map<String, dynamic>) {
  125. return WebInfoContent.fromJson(data);
  126. }
  127. return null;
  128. }
  129. /// 公告未读数 — GET uc/announcement/unread-count
  130. /// 返回 { unreadCount, hasUnread, latestId, readIds }
  131. Future<({int unreadCount, bool hasUnread, int? latestId, List<int> readIds})>
  132. getUnreadCount() async {
  133. final response = await _dio.get<Map<String, dynamic>>(
  134. 'uc/announcement/unread-count',
  135. );
  136. final data = response.data?['data'];
  137. if (data is Map<String, dynamic>) {
  138. final unread = (data['unreadCount'] as num?)?.toInt() ?? 0;
  139. final has = data['hasUnread'] == true || unread > 0;
  140. final latest = (data['latestId'] as num?)?.toInt();
  141. final rawIds = data['readIds'];
  142. final readIds = rawIds is List
  143. ? rawIds.whereType<num>().map((e) => e.toInt()).toList()
  144. : <int>[];
  145. return (unreadCount: unread, hasUnread: has, latestId: latest, readIds: readIds);
  146. }
  147. return (unreadCount: 0, hasUnread: false, latestId: null, readIds: <int>[]);
  148. }
  149. /// 标记指定公告为已读 — POST uc/announcement/mark-read?id=xxx
  150. Future<void> markRead(int id) async {
  151. await _dio.post<Map<String, dynamic>>(
  152. 'uc/announcement/mark-read',
  153. queryParameters: {'id': id},
  154. options: Options(contentType: Headers.formUrlEncodedContentType),
  155. );
  156. }
  157. }