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/profile/pages/profile_screen.dart
+3 -1
View File
@@ -28,8 +28,10 @@ class _ProfileScreenState extends State<ProfileScreen> {
_tabService.addListener(_onTabChanged);
WidgetsBinding.instance.addPostFrameCallback((_) {
// _viewModel.getCompanyProfile();
_viewModel.getProfile();
// Loads the company profile and, when its documents/website are ready,
// kicks off AI onboarding (guarded so it only runs on profile changes).
_viewModel.getCompanyProfile();
});
}
lib/views/tenders/pages/d_tenders_page.dart
+58 -32
View File
@@ -11,8 +11,10 @@ import 'package:tm_app/views/shared/base_button.dart';
import 'package:tm_app/views/shared/desktop_navigation_widget.dart';
import 'package:tm_app/views/tenders/strings/tenders_strings.dart';
import 'package:tm_app/views/tenders/widgets/main_tenders_slider.dart';
import 'package:tm_app/views/tenders/widgets/recommended_tenders_view.dart';
import 'package:tm_app/views/tenders/widgets/tenders_filter_dialog.dart';
import 'package:tm_app/views/tenders/widgets/tenders_sort_dialog.dart';
import 'package:tm_app/views/tenders/widgets/tenders_tab_bar.dart';
import '../../../core/constants/common_strings.dart';
import '../../../core/utils/app_toast.dart';
@@ -28,6 +30,9 @@ class DesktopTendersPage extends StatefulWidget {
class _DesktopTendersPageState extends State<DesktopTendersPage> {
late final TendersViewModel viewModel;
/// 0 = All, 1 = Recommended.
int _selectedTab = 0;
@override
void initState() {
super.initState();
@@ -50,47 +55,34 @@ class _DesktopTendersPageState extends State<DesktopTendersPage> {
@override
Widget build(BuildContext context) {
final userRole = context.watch<AuthViewModel>().userRole;
final bool isAllTab = _selectedTab == 0;
return Scaffold(
backgroundColor: AppColors.backgroundColor,
body: SafeArea(
child: Column(
children: [
const DesktopNavigationWidget(currentIndex: 1),
SizedBox(height: 48.0.h()),
if (userRole == Role.analyst) const _SearchBox(),
if (userRole == Role.analyst) const _ActionButtons(),
SizedBox(height: 24.0.h()),
SizedBox(
width: 740,
child: TendersTabBar(
selectedIndex: _selectedTab,
onChanged: (index) => setState(() => _selectedTab = index),
),
),
SizedBox(height: 24.0.h()),
if (isAllTab && userRole == Role.analyst) const _SearchBox(),
if (isAllTab && userRole == Role.analyst) const _ActionButtons(),
Expanded(
child: Consumer<TendersViewModel>(
builder: (context, vm, child) {
if (vm.isLoading) {
return const Center(
child: CircularProgressIndicator(
color: AppColors.jellyBean,
),
);
}
if (vm.errorMessage != null) {
return Center(child: Text(vm.errorMessage!));
}
final tenders = vm.tendersResponse?.data?.tenders ?? [];
if (tenders.isEmpty) {
return const Center(child: Text(CommonStrings.noData));
}
return Center(
child: SizedBox(
width: 740,
child: Padding(
padding: EdgeInsets.symmetric(vertical: 4.0.h()),
child: MainTendersSlider(
tenders: tenders,
isDesktop: true,
child:
isAllTab
? const _AllTendersTab()
: const Center(
child: SizedBox(
width: 740,
child: RecommendedTendersView(),
),
),
),
);
},
),
),
],
),
@@ -99,6 +91,40 @@ class _DesktopTendersPageState extends State<DesktopTendersPage> {
}
}
class _AllTendersTab extends StatelessWidget {
const _AllTendersTab();
@override
Widget build(BuildContext context) {
return Consumer<TendersViewModel>(
builder: (context, vm, child) {
if (vm.isLoading) {
return const Center(
child: CircularProgressIndicator(color: AppColors.jellyBean),
);
}
if (vm.errorMessage != null) {
return Center(child: Text(vm.errorMessage!));
}
final tenders = vm.tendersResponse?.data?.tenders ?? [];
if (tenders.isEmpty) {
return const Center(child: Text(CommonStrings.noData));
}
return Center(
child: SizedBox(
width: 740,
child: Padding(
padding: EdgeInsets.symmetric(vertical: 4.0.h()),
child: MainTendersSlider(tenders: tenders, isDesktop: true),
),
),
);
},
);
}
}
class _SearchBox extends StatefulWidget {
const _SearchBox();
lib/views/tenders/pages/m_tenders_page.dart
+59 -25
View File
@@ -9,6 +9,8 @@ import '../../../core/utils/app_toast.dart';
import '../../shared/tender_app_bar.dart';
import '../strings/tenders_strings.dart';
import '../widgets/main_tenders_slider.dart';
import '../widgets/recommended_tenders_view.dart';
import '../widgets/tenders_tab_bar.dart';
class MobileTendersPage extends StatefulWidget {
const MobileTendersPage({super.key});
@@ -19,6 +21,10 @@ class MobileTendersPage extends StatefulWidget {
class _MobileTendersPageState extends State<MobileTendersPage> {
late final TendersViewModel viewModel;
/// 0 = All, 1 = Recommended.
int _selectedTab = 0;
@override
void initState() {
super.initState();
@@ -44,34 +50,62 @@ class _MobileTendersPageState extends State<MobileTendersPage> {
backgroundColor: AppColors.backgroundColor,
appBar: tenderMobileAppBar(title: TendersStrings.tendersTitle),
body: SafeArea(
child: Consumer<TendersViewModel>(
builder: (context, viewModel, child) {
if (viewModel.isLoading) {
return const Center(
child: CircularProgressIndicator(color: AppColors.jellyBean),
);
}
if (viewModel.errorMessage != null) {
return Center(child: Text(viewModel.errorMessage!));
}
if ((viewModel.tendersResponse?.data?.tenders == null ||
viewModel.tendersResponse!.data!.tenders!.isEmpty) &&
viewModel.isLoading == false) {
return const Center(child: Text(CommonStrings.noData));
}
return SingleChildScrollView(
child: Padding(
padding: EdgeInsets.symmetric(vertical: 18.0.h()),
child: MainTendersSlider(
tenders: viewModel.tendersResponse?.data?.tenders ?? [],
),
child: Column(
children: [
Padding(
padding: EdgeInsets.symmetric(
horizontal: 24.0.w(),
vertical: 12.0.h(),
),
);
},
child: TendersTabBar(
selectedIndex: _selectedTab,
onChanged: (index) => setState(() => _selectedTab = index),
),
),
Expanded(
child:
_selectedTab == 0
? const _AllTendersTab()
: const RecommendedTendersView(),
),
],
),
),
);
}
}
class _AllTendersTab extends StatelessWidget {
const _AllTendersTab();
@override
Widget build(BuildContext context) {
return Consumer<TendersViewModel>(
builder: (context, viewModel, child) {
if (viewModel.isLoading) {
return const Center(
child: CircularProgressIndicator(color: AppColors.jellyBean),
);
}
if (viewModel.errorMessage != null) {
return Center(child: Text(viewModel.errorMessage!));
}
if ((viewModel.tendersResponse?.data?.tenders == null ||
viewModel.tendersResponse!.data!.tenders!.isEmpty) &&
viewModel.isLoading == false) {
return const Center(child: Text(CommonStrings.noData));
}
return SingleChildScrollView(
child: Padding(
padding: EdgeInsets.symmetric(vertical: 18.0.h()),
child: MainTendersSlider(
tenders: viewModel.tendersResponse?.data?.tenders ?? [],
),
),
);
},
);
}
}
lib/views/tenders/pages/t_tenders_page.dart
+51 -26
View File
@@ -9,6 +9,8 @@ import 'package:tm_app/views/tenders/widgets/main_tenders_slider.dart';
import '../../../core/constants/common_strings.dart';
import '../../shared/tender_app_bar.dart';
import '../strings/tenders_strings.dart';
import '../widgets/recommended_tenders_view.dart';
import '../widgets/tenders_tab_bar.dart';
class TabletTendersPage extends StatefulWidget {
const TabletTendersPage({super.key});
@@ -20,6 +22,9 @@ class TabletTendersPage extends StatefulWidget {
class _TabletTendersPageState extends State<TabletTendersPage> {
late final TendersViewModel viewModel;
/// 0 = All, 1 = Recommended.
int _selectedTab = 0;
@override
void initState() {
super.initState();
@@ -38,34 +43,54 @@ class _TabletTendersPageState extends State<TabletTendersPage> {
context: context,
),
drawer: const TabletNavigationWidget(currentIndex: 1),
body: Consumer<TendersViewModel>(
builder: (context, viewModel, child) {
if (viewModel.isLoading) {
return const Center(
child: CircularProgressIndicator(color: AppColors.jellyBean),
);
}
if (viewModel.errorMessage != null) {
return Center(child: Text(viewModel.errorMessage!));
}
if ((viewModel.tendersResponse?.data?.tenders == null ||
viewModel.tendersResponse!.data!.tenders!.isEmpty) &&
viewModel.isLoading == false) {
return const Center(child: Text(CommonStrings.noData));
}
return SingleChildScrollView(
child: Padding(
padding: EdgeInsetsDirectional.only(
end: 24.0.w(),
top: 128.0.h(),
),
child: MainTendersSlider(
tenders: viewModel.tendersResponse?.data?.tenders ?? [],
),
body: Padding(
padding: EdgeInsetsDirectional.only(end: 24.0.w(), top: 24.0.h()),
child: Column(
children: [
TendersTabBar(
selectedIndex: _selectedTab,
onChanged: (index) => setState(() => _selectedTab = index),
),
);
},
SizedBox(height: 24.0.h()),
Expanded(
child:
_selectedTab == 0
? const _AllTendersTab()
: const RecommendedTendersView(),
),
],
),
),
);
}
}
class _AllTendersTab extends StatelessWidget {
const _AllTendersTab();
@override
Widget build(BuildContext context) {
return Consumer<TendersViewModel>(
builder: (context, viewModel, child) {
if (viewModel.isLoading) {
return const Center(
child: CircularProgressIndicator(color: AppColors.jellyBean),
);
}
if (viewModel.errorMessage != null) {
return Center(child: Text(viewModel.errorMessage!));
}
if ((viewModel.tendersResponse?.data?.tenders == null ||
viewModel.tendersResponse!.data!.tenders!.isEmpty) &&
viewModel.isLoading == false) {
return const Center(child: Text(CommonStrings.noData));
}
return SingleChildScrollView(
child: MainTendersSlider(
tenders: viewModel.tendersResponse?.data?.tenders ?? [],
),
);
},
);
}
}
lib/views/tenders/strings/tenders_strings.dart
+18
View File
@@ -27,4 +27,22 @@ class TendersStrings {
static const String minimumTime = 'Minimum time';
static const String tenderBudgetLabel = 'Budget :';
static const String board = 'Board';
// Recommended (AI) tab
static const String allTab = 'All';
static const String recommendedTab = 'Recommended';
static const String recommendedMatchLabel = 'Match';
static const String recommendedRankPrefix = '#';
static const String recommendedStillLearningTitle =
'We’re still learning about your company';
static const String recommendedStillLearningBody =
'Recommendations will appear here once we finish analyzing your company. Check back soon.';
static const String recommendedEmptyTitle = 'No recommendations yet';
static const String recommendedEmptyBody =
'Add your company documents or website to get personalized tender recommendations.';
static const String recommendedError =
'Could not load recommendations. Please try again.';
static const String recommendedFallbackNotice =
'Showing keyword-based suggestions while AI recommendations are unavailable.';
static const String retry = 'Retry';
}
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,
),
),
),
),
);
}
}