refactor: use GET tenders/recommend and improve tender title UX
continuous-integration/drone/push Build is passing

Load the Recommended tab from GET /api/v1/tenders/recommend instead of the
AI POST flow with 503 fallback. Fix notification pagination offset, make
tender titles selectable across list and detail views, and ignore .cursor.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
AmirReza Jamali
2026-06-27 12:23:53 +03:30
parent 7c26288c01
commit 984f2e5139
11 changed files with 121 additions and 198 deletions
@@ -1,19 +1,15 @@
import 'package:flutter/foundation.dart';
import 'package:tm_app/core/network/app_exceptions.dart';
import 'package:tm_app/core/utils/result.dart';
import 'package:tm_app/data/repositories/company_ai_repository.dart';
import 'package:tm_app/data/repositories/home_repository.dart';
import 'package:tm_app/data/services/model/recommend_response/recommend_response.dart';
import 'package:tm_app/data/services/model/recommendation_item/recommendation_item.dart';
import 'package:tm_app/data/services/model/recommended_tenders_response/recommended_tenders_response.dart';
import 'package:tm_app/data/services/model/tender_data/tender_data.dart';
/// Drives the "Recommended" (AI) tab in the tenders section.
/// Drives the "Recommended" tab in the tenders section.
///
/// Calls `POST /api/v1/recommend`. When the AI service is unavailable (503) it
/// falls back to the legacy CPV/keyword list (`GET /api/v1/tenders/recommend`),
/// and when the AI returns no results shortly after onboarding it surfaces a
/// "still learning" hint instead of an empty error.
/// Calls `GET /api/v1/tenders/recommend`. When the result is empty shortly
/// after onboarding it surfaces a "still learning" hint instead of an empty
/// error.
class AiRecommendationsViewModel with ChangeNotifier {
AiRecommendationsViewModel({
required CompanyAiRepository companyAiRepository,
@@ -26,21 +22,17 @@ class AiRecommendationsViewModel with ChangeNotifier {
/// How long after onboarding an empty result is treated as "still learning".
static const Duration _stillLearningWindow = Duration(minutes: 30);
static const int _fallbackPageSize = 20;
static const int _pageSize = 20;
bool _isLoading = false;
String? _errorMessage;
List<RecommendationItem> _items = const [];
List<TenderData> _fallbackTenders = const [];
bool _usingFallback = false;
List<TenderData> _recommendedTenders = const [];
bool _stillLearning = false;
bool _hasLoaded = false;
bool get isLoading => _isLoading;
String? get errorMessage => _errorMessage;
List<RecommendationItem> get items => _items;
List<TenderData> get fallbackTenders => _fallbackTenders;
bool get usingFallback => _usingFallback;
List<TenderData> get recommendedTenders => _recommendedTenders;
bool get stillLearning => _stillLearning;
/// True once a load has completed (used to distinguish "no results" from
@@ -51,8 +43,7 @@ class AiRecommendationsViewModel with ChangeNotifier {
bool get isEmpty =>
!_isLoading &&
_errorMessage == null &&
_items.isEmpty &&
_fallbackTenders.isEmpty;
_recommendedTenders.isEmpty;
/// Loads recommendations if they haven't been loaded yet this session.
Future<void> loadIfNeeded() async {
@@ -62,28 +53,32 @@ class AiRecommendationsViewModel with ChangeNotifier {
await loadRecommendations();
}
/// Loads AI recommendations, applying the 503 fallback and empty-state logic.
/// Loads recommended tenders for the Recommended tab.
Future<void> loadRecommendations() async {
_isLoading = true;
_errorMessage = null;
_usingFallback = false;
_stillLearning = false;
notifyListeners();
final result = await _companyAiRepository.getRecommendations();
final result = await _homeRepository.getHomeRecommendedTenders(
limit: _pageSize,
offset: 0,
);
var loadedSuccessfully = false;
switch (result) {
case Ok<RecommendResponse>():
_items = result.value.data ?? const [];
_fallbackTenders = const [];
if (_items.isEmpty) {
case Ok<RecommendedTendersResponse>():
_recommendedTenders =
result.value.data?.tenders.whereType<TenderData>().toList() ??
const [];
if (_recommendedTenders.isEmpty) {
_stillLearning = _onboardingWasRecent();
}
loadedSuccessfully = true;
case Error<RecommendResponse>():
loadedSuccessfully = await _handleError(result.error);
case Error<RecommendedTendersResponse>():
_recommendedTenders = const [];
_errorMessage = result.error.toString();
}
_isLoading = false;
@@ -94,39 +89,6 @@ class AiRecommendationsViewModel with ChangeNotifier {
/// Pull-to-refresh: always re-fetches.
Future<void> refresh() => loadRecommendations();
Future<bool> _handleError(Exception error) async {
// 503 means the AI service isn't configured/available — fall back to the
// legacy recommend list rather than showing an error. NetworkManager only
// exposes this status when Dio received an HTTP response; connection and
// timeout failures have no reliable status code and should remain retryable.
if (error is AppException && error.statusCode == 503) {
await _loadFallback();
return _errorMessage == null;
}
_items = const [];
_fallbackTenders = const [];
_errorMessage = error.toString();
return false;
}
Future<void> _loadFallback() async {
final result = await _homeRepository.getHomeRecommendedTenders(
limit: _fallbackPageSize,
offset: 0,
);
switch (result) {
case Ok<RecommendedTendersResponse>():
_items = const [];
_fallbackTenders =
result.value.data?.tenders.whereType<TenderData>().toList() ??
const [];
_usingFallback = true;
case Error<RecommendedTendersResponse>():
_errorMessage = result.error.toString();
}
}
bool _onboardingWasRecent() {
final startedAt = _companyAiRepository.lastOnboardingStartedAt();
if (startedAt == null) {
+3 -3
View File
@@ -87,7 +87,7 @@ class NotificationViewModel with ChangeNotifier {
}
notifyListeners();
final int offset = page * _pageSize;
final int offset = (page - 1) * _pageSize;
final result = await _repository.getNotifications(
limit: _pageSize,
@@ -138,7 +138,7 @@ class NotificationViewModel with ChangeNotifier {
}
notifyListeners();
final int offset = page * _pageSize;
final int offset = (page - 1) * _pageSize;
final result = await _repository.getUnreadNotifications(
limit: _pageSize,
offset: offset,
@@ -181,7 +181,7 @@ class NotificationViewModel with ChangeNotifier {
}
notifyListeners();
final int offset = page * _pageSize;
final int offset = (page - 1) * _pageSize;
final result = await _repository.getImportantNotifications(
limit: _pageSize,
+1 -2
View File
@@ -301,7 +301,7 @@ class _TaskCard extends StatelessWidget {
),
),
if (due != null) const SizedBox(height: 12),
Text(
SelectableText(
card.title ?? '',
style: TextStyle(
fontSize: 14,
@@ -309,7 +309,6 @@ class _TaskCard extends StatelessWidget {
color: AppColors.grey70,
),
maxLines: 3,
overflow: TextOverflow.ellipsis,
),
const SizedBox(height: 12),
if (card.priority != null) _PriorityChip(priority: card.priority!),
@@ -141,7 +141,7 @@ class TenderDetailHeader extends StatelessWidget {
);
}
Widget _titleText() => Text(
Widget _titleText() => SelectableText(
detail.title ?? '',
style: TextStyle(
color: AppColors.grey80,
+2 -2
View File
@@ -75,10 +75,10 @@ class TendersListItem extends StatelessWidget {
),
),
SizedBox(height: 12.0.h()),
Text(
SelectableText(
tender.title ?? '',
maxLines: 2,
style: TextStyle(
overflow: TextOverflow.ellipsis,
fontSize: 16.0.sp(),
fontWeight: FontWeight.w600,
color: AppColors.grey80,
@@ -128,10 +128,10 @@ class LikedListItem extends StatelessWidget {
),
),
SizedBox(height: 12.0.h()),
Text(
SelectableText(
tender.title!,
maxLines: 2,
style: TextStyle(
overflow: TextOverflow.ellipsis,
fontSize: 16.0.sp(),
fontWeight: FontWeight.w600,
color: AppColors.grey80,
@@ -7,10 +7,9 @@ import 'package:tm_app/data/services/model/tender_data/tender_data.dart';
import 'package:tm_app/view_models/ai_recommendations_view_model.dart';
import '../strings/tenders_strings.dart';
import 'recommendation_card.dart';
/// The "Recommended" (AI) tab body. Handles loading, empty/"still learning",
/// error+retry and the 503 fallback states for [AiRecommendationsViewModel].
/// The "Recommended" tab body. Handles loading, empty/"still learning",
/// error+retry and the recommended tender list for [AiRecommendationsViewModel].
class RecommendedTendersView extends StatefulWidget {
const RecommendedTendersView({super.key});
@@ -49,20 +48,16 @@ class _RecommendedTendersViewState extends State<RecommendedTendersView> {
onRetry: vm.refresh,
);
}
if (vm.usingFallback && vm.fallbackTenders.isNotEmpty) {
return _FallbackList(tenders: vm.fallbackTenders, onRefresh: vm.refresh);
}
if (vm.items.isNotEmpty) {
if (vm.recommendedTenders.isNotEmpty) {
return RefreshIndicator(
color: AppColors.jellyBean,
onRefresh: vm.refresh,
child: ListView.separated(
padding: EdgeInsets.all(16.0.h()),
itemCount: vm.items.length,
itemCount: vm.recommendedTenders.length,
separatorBuilder: (_, __) => SizedBox(height: 12.0.h()),
itemBuilder:
(context, index) =>
RecommendationCard(item: vm.items[index]),
itemBuilder: (context, index) =>
_RecommendedTenderCard(tender: vm.recommendedTenders[index]),
),
);
}
@@ -76,56 +71,8 @@ class _RecommendedTendersViewState extends State<RecommendedTendersView> {
}
}
/// Renders the legacy keyword-based fallback list with a notice banner.
class _FallbackList extends StatelessWidget {
const _FallbackList({required this.tenders, required this.onRefresh});
final List<TenderData> tenders;
final Future<void> Function() onRefresh;
@override
Widget build(BuildContext context) {
return RefreshIndicator(
color: AppColors.jellyBean,
onRefresh: onRefresh,
child: ListView.separated(
padding: EdgeInsets.all(16.0.h()),
itemCount: tenders.length + 1,
separatorBuilder: (_, __) => SizedBox(height: 12.0.h()),
itemBuilder: (context, index) {
if (index == 0) {
return _fallbackNotice();
}
return _FallbackTenderCard(tender: tenders[index - 1]);
},
),
);
}
Widget _fallbackNotice() {
return Container(
width: double.infinity,
padding: EdgeInsets.all(12.0.h()),
decoration: BoxDecoration(
color: AppColors.orange10,
borderRadius: BorderRadius.circular(8.0.w()),
),
child: Text(
TendersStrings.recommendedFallbackNotice,
style: TextStyle(
fontSize: 13.0.sp(),
fontWeight: FontWeight.w500,
color: AppColors.yellow4,
),
),
);
}
}
/// Lightweight card for a fallback tender. Decoupled from [TendersViewModel]
/// (no feedback/pagination) so it can render outside the All-tab flow.
class _FallbackTenderCard extends StatelessWidget {
const _FallbackTenderCard({required this.tender});
class _RecommendedTenderCard extends StatelessWidget {
const _RecommendedTenderCard({required this.tender});
final TenderData tender;
@@ -156,10 +103,9 @@ class _FallbackTenderCard extends StatelessWidget {
crossAxisAlignment: CrossAxisAlignment.start,
children: [
if (title.isNotEmpty)
Text(
SelectableText(
title,
maxLines: 2,
overflow: TextOverflow.ellipsis,
style: TextStyle(
fontSize: 15.0.sp(),
fontWeight: FontWeight.w600,
+1 -1
View File
@@ -198,7 +198,7 @@ class TenderCard extends StatelessWidget {
}
Widget _tenderTitle() {
return Text(
return SelectableText(
tender.title ?? '',
maxLines: isDesktop ? 2 : 4,
style: TextStyle(
@@ -99,10 +99,9 @@ class TenderCard extends StatelessWidget {
SizedBox(height: 12.0.h()),
// Title
Text(
SelectableText(
tender.title!,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: TextStyle(
color: AppColors.grey80,
fontSize: 16.0.sp(),