mazyar/tm_app
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add AI recommendations flow for tenders

Browse Source 
Implement company AI onboarding/recommendation models, services, repository, and tender UI integration with supporting tests.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
AmirReza Jamali
2026-06-16 11:47:52 +03:30
parent 83b32549ce
commit 50e4f43738
34 changed files with 2558 additions and 112 deletions
Download Patch File Download Diff File Expand all files Collapse all files
lib/views/tenders/widgets/recommendation_card.dart
+107
View File
@@ -0,0 +1,107 @@
import 'package:flutter/material.dart';
import 'package:tm_app/core/routes/app_routes.dart';
import 'package:tm_app/core/theme/colors.dart';
import 'package:tm_app/core/utils/size_config.dart';
import 'package:tm_app/data/services/model/recommendation_item/recommendation_item.dart';
import '../strings/tenders_strings.dart';
/// A single AI recommendation: rank badge + the AI's analysis, tappable to open
/// the tender detail via [RecommendationItem.tenderId].
class RecommendationCard extends StatelessWidget {
const RecommendationCard({required this.item, super.key});
final RecommendationItem item;
void _openDetail(BuildContext context) {
final tenderId = item.tenderId;
if (tenderId == null || tenderId.isEmpty) {
return;
}
TenderDetailRouteData(tenderId: tenderId).push(context);
}
@override
Widget build(BuildContext context) {
final analysis = item.analysis?.trim() ?? '';
return InkWell(
borderRadius: BorderRadius.circular(12.0.w()),
onTap: () => _openDetail(context),
child: Container(
width: double.infinity,
padding: EdgeInsets.all(16.0.h()),
decoration: BoxDecoration(
color: AppColors.grey0,
borderRadius: BorderRadius.circular(12.0.w()),
border: Border.all(color: AppColors.grey30),
),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Row(
children: [
_rankBadge(),
SizedBox(width: 12.0.w()),
Text(
TendersStrings.recommendedMatchLabel,
style: TextStyle(
fontSize: 14.0.sp(),
fontWeight: FontWeight.w600,
color: AppColors.grey70,
),
),
],
),
if (analysis.isNotEmpty) ...[
SizedBox(height: 12.0.h()),
Text(
analysis,
style: TextStyle(
fontSize: 14.0.sp(),
fontWeight: FontWeight.w400,
color: AppColors.grey80,
height: 1.5,
),
),
],
SizedBox(height: 16.0.h()),
Align(
alignment: AlignmentDirectional.centerEnd,
child: Text(
TendersStrings.tenderSeeMore,
style: TextStyle(
fontSize: 14.0.sp(),
fontWeight: FontWeight.w600,
color: AppColors.mainBlue,
),
),
),
],
),
),
);
}
Widget _rankBadge() {
final rank = item.rank?.trim();
final label =
(rank == null || rank.isEmpty)
? TendersStrings.recommendedRankPrefix
: '${TendersStrings.recommendedRankPrefix}$rank';
return Container(
padding: EdgeInsets.symmetric(horizontal: 12.0.w(), vertical: 4.0.h()),
decoration: BoxDecoration(
color: AppColors.primary10,
borderRadius: BorderRadius.circular(8.0.w()),
),
child: Text(
label,
style: TextStyle(
fontSize: 14.0.sp(),
fontWeight: FontWeight.w700,
color: AppColors.mainBlue,
),
),
);
}
}
lib/views/tenders/widgets/recommended_tenders_view.dart
+283
View File
@@ -0,0 +1,283 @@
import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
import 'package:tm_app/core/routes/app_routes.dart';
import 'package:tm_app/core/theme/colors.dart';
import 'package:tm_app/core/utils/size_config.dart';
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].
class RecommendedTendersView extends StatefulWidget {
const RecommendedTendersView({super.key});
@override
State<RecommendedTendersView> createState() => _RecommendedTendersViewState();
}
class _RecommendedTendersViewState extends State<RecommendedTendersView> {
@override
void initState() {
super.initState();
WidgetsBinding.instance.addPostFrameCallback((_) {
if (mounted) {
context.read<AiRecommendationsViewModel>().loadIfNeeded();
}
});
}
@override
Widget build(BuildContext context) {
return Consumer<AiRecommendationsViewModel>(
builder: (context, vm, child) {
if (vm.isLoading) {
return const _LoadingSkeleton();
}
if (vm.errorMessage != null) {
return _MessageState(
title: TendersStrings.recommendedError,
onRetry: vm.refresh,
);
}
if (vm.stillLearning) {
return _MessageState(
title: TendersStrings.recommendedStillLearningTitle,
body: TendersStrings.recommendedStillLearningBody,
onRetry: vm.refresh,
);
}
if (vm.usingFallback && vm.fallbackTenders.isNotEmpty) {
return _FallbackList(tenders: vm.fallbackTenders, onRefresh: vm.refresh);
}
if (vm.items.isNotEmpty) {
return RefreshIndicator(
color: AppColors.jellyBean,
onRefresh: vm.refresh,
child: ListView.separated(
padding: EdgeInsets.all(16.0.h()),
itemCount: vm.items.length,
separatorBuilder: (_, __) => SizedBox(height: 12.0.h()),
itemBuilder:
(context, index) =>
RecommendationCard(item: vm.items[index]),
),
);
}
return _MessageState(
title: TendersStrings.recommendedEmptyTitle,
body: TendersStrings.recommendedEmptyBody,
onRetry: vm.refresh,
);
},
);
}
}
/// 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});
final TenderData tender;
void _openDetail(BuildContext context) {
final id = tender.id;
if (id == null || id.isEmpty) {
return;
}
TenderDetailRouteData(tenderId: id).push(context);
}
@override
Widget build(BuildContext context) {
final title = tender.title?.trim() ?? '';
final buyer = tender.buyerOrganization?.name?.trim() ?? '';
return InkWell(
borderRadius: BorderRadius.circular(12.0.w()),
onTap: () => _openDetail(context),
child: Container(
width: double.infinity,
padding: EdgeInsets.all(16.0.h()),
decoration: BoxDecoration(
color: AppColors.grey0,
borderRadius: BorderRadius.circular(12.0.w()),
border: Border.all(color: AppColors.grey30),
),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
if (title.isNotEmpty)
Text(
title,
maxLines: 2,
overflow: TextOverflow.ellipsis,
style: TextStyle(
fontSize: 15.0.sp(),
fontWeight: FontWeight.w600,
color: AppColors.grey80,
),
),
if (buyer.isNotEmpty) ...[
SizedBox(height: 8.0.h()),
Text(
buyer,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: TextStyle(
fontSize: 13.0.sp(),
fontWeight: FontWeight.w400,
color: AppColors.grey60,
),
),
],
],
),
),
);
}
}
/// Centered title/body message with an optional retry button. Wrapped in a
/// scroll view so pull-to-refresh works even when empty.
class _MessageState extends StatelessWidget {
const _MessageState({required this.title, this.body, this.onRetry});
final String title;
final String? body;
final Future<void> Function()? onRetry;
@override
Widget build(BuildContext context) {
final content = Padding(
padding: EdgeInsets.symmetric(horizontal: 32.0.w(), vertical: 48.0.h()),
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
Text(
title,
textAlign: TextAlign.center,
style: TextStyle(
fontSize: 16.0.sp(),
fontWeight: FontWeight.w600,
color: AppColors.grey70,
),
),
if (body != null) ...[
SizedBox(height: 12.0.h()),
Text(
body!,
textAlign: TextAlign.center,
style: TextStyle(
fontSize: 14.0.sp(),
fontWeight: FontWeight.w400,
color: AppColors.grey60,
height: 1.5,
),
),
],
if (onRetry != null) ...[
SizedBox(height: 24.0.h()),
TextButton(
onPressed: onRetry,
child: Text(
TendersStrings.retry,
style: TextStyle(
fontSize: 14.0.sp(),
fontWeight: FontWeight.w600,
color: AppColors.mainBlue,
),
),
),
],
],
),
);
if (onRetry == null) {
return Center(child: content);
}
return RefreshIndicator(
color: AppColors.jellyBean,
onRefresh: onRetry!,
child: SingleChildScrollView(
physics: const AlwaysScrollableScrollPhysics(),
child: ConstrainedBox(
constraints: BoxConstraints(minHeight: SizeConfig.screenHeight * 0.6),
child: Center(child: content),
),
),
);
}
}
/// Simple placeholder list shown while recommendations load.
class _LoadingSkeleton extends StatelessWidget {
const _LoadingSkeleton();
@override
Widget build(BuildContext context) {
return ListView.separated(
padding: EdgeInsets.all(16.0.h()),
itemCount: 4,
separatorBuilder: (_, __) => SizedBox(height: 12.0.h()),
itemBuilder:
(context, index) => Container(
height: 120.0.h(),
decoration: BoxDecoration(
color: AppColors.grey0,
borderRadius: BorderRadius.circular(12.0.w()),
border: Border.all(color: AppColors.grey30),
),
),
);
}
}
lib/views/tenders/widgets/tenders_tab_bar.dart
+64
View File
@@ -0,0 +1,64 @@
import 'package:flutter/material.dart';
import 'package:tm_app/core/theme/colors.dart';
import 'package:tm_app/core/utils/size_config.dart';
import '../strings/tenders_strings.dart';
/// Segmented control switching between the "All" tenders list and the
/// "Recommended" AI tab.
class TendersTabBar extends StatelessWidget {
const TendersTabBar({
required this.selectedIndex,
required this.onChanged,
super.key,
});
/// 0 = All, 1 = Recommended.
final int selectedIndex;
final ValueChanged<int> onChanged;
@override
Widget build(BuildContext context) {
return Container(
height: 44.0.h(),
padding: EdgeInsets.all(4.0.h()),
decoration: BoxDecoration(
color: AppColors.grey0,
borderRadius: BorderRadius.circular(12.0.w()),
border: Border.all(color: AppColors.grey30),
),
child: Row(
children: [
_segment(TendersStrings.allTab, 0),
_segment(TendersStrings.recommendedTab, 1),
],
),
);
}
Widget _segment(String label, int index) {
final bool isActive = selectedIndex == index;
return Expanded(
child: GestureDetector(
behavior: HitTestBehavior.opaque,
onTap: () => onChanged(index),
child: AnimatedContainer(
duration: const Duration(milliseconds: 200),
alignment: Alignment.center,
decoration: BoxDecoration(
color: isActive ? AppColors.mainBlue : Colors.transparent,
borderRadius: BorderRadius.circular(8.0.w()),
),
child: Text(
label,
style: TextStyle(
fontSize: 14.0.sp(),
fontWeight: FontWeight.w600,
color: isActive ? AppColors.grey0 : AppColors.grey60,
),
),
),
),
);
}
}