Implement tender workflows and dashboard integration

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

.gitignore

@@ -52,4 +52,7 @@ app.*.map.json
 # Firebase Configuration (sensitive files - should not be in version control)
 **/android/app/google-services.json
 **/ios/Runner/GoogleService-Info.plist
-**/lib/firebase_options.dart
+**/lib/firebase_options.dart
+
+# IDE
+.cursor

docs/home-page-api-benchmarks.md

@@ -0,0 +1,165 @@
+# Home Page API — Response Time Benchmarks
+
+Measured from the client network (curl) against production.
+
+| Field | Value |
+|-------|-------|
+| **Date** | 2026-07-07 |
+| **Base URL** | `https://app.opplenz.com` |
+| **Runs per endpoint** | 10 |
+| **Account** | `test@email.com` |
+| **Company ID** | `69dbef4e0917c63d28787737` |
+
+All requests returned **HTTP 200** on every run.
+
+---
+
+## Average response time
+
+| # | Endpoint | Method | Avg (ms) | Min (ms) | Max (ms) | Blocks UI? | % of blocking load |
+|---|----------|--------|----------|----------|----------|------------|-------------------|
+| 1 | `/api/v1/tender-approvals/stats` | GET | **614** | 520 | 793 | Yes | 3.4% |
+| 2 | `/api/v1/tender-approvals?limit=10&offset=0` | GET | **16,688** | 16,503 | 17,061 | Yes | **93.6%** |
+| 3 | `/api/v1/feedback?feedback_type=like&limit=1&offset=0` | GET | **554** | 506 | 668 | Yes | 3.1% |
+| 4 | `/api/v1/notifications?seen=false&limit=1&event_type=PUSH` | GET | **548** | 483 | 642 | No | — |
+| 5 | `/api/v1/tenders/recommend?limit=10&offset=0` | GET | **5,716** | 4,010 | 8,361 | No* | — |
+
+\* Call #5 only fires when call #2 returns an empty tender list. It does not block the initial loading spinner, but still adds server load and may update the list shortly after render.
+
+---
+
+## Totals
+
+| Metric | Time |
+|--------|------|
+| **Sequential blocking total** (calls 1 + 2 + 3) | **~17.9 s** |
+| **Slowest single endpoint** | `GET /api/v1/tender-approvals` — **16.7 s avg** |
+| **Fastest endpoint** | `GET /api/v1/notifications` — **0.5 s avg** |
+
+The home page waits on calls 1 → 2 → 3 in series before rendering. **`/api/v1/tender-approvals` accounts for ~94% of that wait.**
+
+---
+
+## Raw timings (seconds)
+
+### 1. Tender approval stats
+`GET /api/v1/tender-approvals/stats`
+
+| Run | Time (s) |
+|-----|----------|
+| 1 | 0.779 |
+| 2 | 0.662 |
+| 3 | 0.644 |
+| 4 | 0.793 |
+| 5 | 0.597 |
+| 6 | 0.536 |
+| 7 | 0.562 |
+| 8 | 0.533 |
+| 9 | 0.520 |
+| 10 | 0.520 |
+| **Avg** | **0.614** |
+
+### 2. Your tenders
+`GET /api/v1/tender-approvals?limit=10&offset=0`
+
+| Run | Time (s) |
+|-----|----------|
+| 1 | 16.503 |
+| 2 | 16.573 |
+| 3 | 16.873 |
+| 4 | 16.607 |
+| 5 | 17.061 |
+| 6 | 16.600 |
+| 7 | 16.628 |
+| 8 | 16.707 |
+| 9 | 16.727 |
+| 10 | 16.606 |
+| **Avg** | **16.688** |
+
+### 3. Liked tenders count
+`GET /api/v1/feedback?feedback_type=like&limit=1&offset=0`
+
+| Run | Time (s) |
+|-----|----------|
+| 1 | 0.629 |
+| 2 | 0.506 |
+| 3 | 0.515 |
+| 4 | 0.594 |
+| 5 | 0.521 |
+| 6 | 0.509 |
+| 7 | 0.529 |
+| 8 | 0.529 |
+| 9 | 0.542 |
+| 10 | 0.668 |
+| **Avg** | **0.554** |
+
+### 4. Unread notifications (background)
+`GET /api/v1/notifications?seen=false&limit=1&event_type=PUSH`
+
+| Run | Time (s) |
+|-----|----------|
+| 1 | 0.566 |
+| 2 | 0.540 |
+| 3 | 0.486 |
+| 4 | 0.607 |
+| 5 | 0.541 |
+| 6 | 0.498 |
+| 7 | 0.614 |
+| 8 | 0.642 |
+| 9 | 0.506 |
+| 10 | 0.483 |
+| **Avg** | **0.548** |
+
+### 5. Recommended tenders (conditional)
+`GET /api/v1/tenders/recommend?limit=10&offset=0`
+
+| Run | Time (s) |
+|-----|----------|
+| 1 | 4.364 |
+| 2 | 5.880 |
+| 3 | 5.402 |
+| 4 | 4.010 |
+| 5 | 6.512 |
+| 6 | 5.827 |
+| 7 | 5.584 |
+| 8 | 5.653 |
+| 9 | 8.361 |
+| 10 | 5.575 |
+| **Avg** | **5.716** |
+
+---
+
+## Key finding
+
+| Priority | Endpoint | Issue |
+|----------|----------|-------|
+| **P0** | `GET /api/v1/tender-approvals?limit=10&offset=0` | ~17 s average — dominates home page load |
+| P1 | `GET /api/v1/tenders/recommend?limit=10&offset=0` | ~5.7 s average — slow when used as fallback |
+| P2 | `GET /api/v1/tender-approvals/stats` | ~0.6 s — acceptable but called on every home visit |
+| — | Feedback + notifications | ~0.55 s each — not a bottleneck |
+
+---
+
+## How to reproduce
+
+```bash
+TOKEN='<access_token>'
+BASE='https://app.opplenz.com'
+
+for url in \
+  "$BASE/api/v1/tender-approvals/stats" \
+  "$BASE/api/v1/tender-approvals?limit=10&offset=0" \
+  "$BASE/api/v1/feedback?feedback_type=like&limit=1&offset=0" \
+  "$BASE/api/v1/notifications?seen=false&limit=1&event_type=PUSH" \
+  "$BASE/api/v1/tenders/recommend?limit=10&offset=0"
+do
+  curl -s -o /dev/null -w "%{time_total}s %{http_code} $url\n" \
+    -H "Authorization: Bearer $TOKEN" "$url"
+done
+```
+
+---
+
+## Related
+
+See [home-page-api-calls.md](./home-page-api-calls.md) for full call order, parameters, and optimization suggestions.

docs/home-page-api-calls.md

@@ -0,0 +1,280 @@
+# Home Page API Calls
+
+Document for the backend team. Describes every HTTP request the mobile/web client fires when the user opens `/home`, including call order, parameters, and what blocks the UI from rendering.
+
+**Context:** Home page load feels slow. The client currently waits on **3 sequential API calls** before showing content. A 4th call runs in the background; a 5th may fire when the user has no "your tenders".
+
+**Base URL:** `https://app.opplenz.com`  
+**Auth:** All requests include `Authorization: Bearer <access_token>`.
+
+---
+
+## Summary
+
+| # | Endpoint | Method | Blocking UI? | When |
+|---|----------|--------|--------------|------|
+| 1 | `/api/v1/tender-approvals/stats` | GET | **Yes** | Always on home load |
+| 2 | `/api/v1/tender-approvals?limit=10&offset=0` | GET | **Yes** | Always on home load |
+| 3 | `/api/v1/feedback?feedback_type=like&limit=1&offset=0` | GET | **Yes** | Always on home load |
+| 4 | `/api/v1/notifications?seen=false&limit=1&event_type=PUSH` | GET | No (background) | App shell mount (parallel) |
+| 5 | `/api/v1/tenders/recommend?limit=10&offset=0` | GET | No | Only when call #2 returns an empty tender list |
+
+**Minimum calls on first load:** 4 (calls 1–3 + 4)  
+**Maximum calls on first load:** 5 (adds call 5 when user has no your-tenders)
+
+**Perceived load time (client-side):** Sum of response times for calls 1 → 2 → 3 (sequential `await` chain).
+
+---
+
+## Call sequence
+
+```
+User opens /home
+│
+├─ [parallel, background] App shell
+│   └─ GET /api/v1/notifications?seen=false&limit=1&event_type=PUSH
+│
+└─ [blocking] HomeViewModel.init()
+    │
+    ├─ 1. GET /api/v1/tender-approvals/stats          ← await
+    ├─ 2. GET /api/v1/tender-approvals?limit=10&offset=0   ← await
+    │      └─ if tenders[] is empty (fire-and-forget, not awaited):
+    │         GET /api/v1/tenders/recommend?limit=10&offset=0
+    └─ 3. GET /api/v1/feedback?feedback_type=like&limit=1&offset=0   ← await
+         └─ UI renders (_isLoading = false)
+```
+
+Source: `lib/view_models/home_view_model.dart` → `init()`
+
+---
+
+## API details
+
+### 1. Tender approval stats
+
+Partnership / self-apply progress rings on the home dashboard.
+
+| Field | Value |
+|-------|-------|
+| **Method** | `GET` |
+| **Path** | `/api/v1/tender-approvals/stats` |
+| **Query params** | None |
+| **Blocking** | Yes — first call in `init()` |
+| **Response fields used** | `data.partnership_count`, `data.self_apply_count` |
+
+**Example:**
+```http
+GET /api/v1/tender-approvals/stats
+Authorization: Bearer <token>
+Accept: application/json
+```
+
+---
+
+### 2. Your tenders (horizontal list)
+
+Main tender carousel and "Your Tenders" section.
+
+| Field | Value |
+|-------|-------|
+| **Method** | `GET` |
+| **Path** | `/api/v1/tender-approvals` |
+| **Query params** | `limit=10`, `offset=0` |
+| **Optional filters** | Not sent from home (`status`, `created_from`, `created_to` are empty) |
+| **Blocking** | Yes — second call in `init()` |
+| **Response fields used** | `data.tenders[].tender` (full tender objects), `data.metadata.pages` (pagination) |
+
+**Example:**
+```http
+GET /api/v1/tender-approvals?limit=10&offset=0
+Authorization: Bearer <token>
+Accept: application/json
+```
+
+**Note:** This is likely the heaviest call — it returns up to 10 full tender objects with nested data.
+
+---
+
+### 3. Liked tenders count
+
+"Liked Tenders" stat card count.
+
+| Field | Value |
+|-------|-------|
+| **Method** | `GET` |
+| **Path** | `/api/v1/feedback` |
+| **Query params** | `feedback_type=like`, `limit=1`, `offset=0` |
+| **Blocking** | Yes — third call in `init()` |
+| **Response fields used** | `data.meta.total` only (client ignores the single returned item) |
+
+**Example:**
+```http
+GET /api/v1/feedback?feedback_type=like&limit=1&offset=0
+Authorization: Bearer <token>
+Accept: application/json
+```
+
+**Optimization opportunity:** Client only needs a count. A dedicated count endpoint (or `meta.total` without loading feedback records) would be faster than a full feedback query.
+
+---
+
+### 4. Unread notification check (background)
+
+Red dot on the notification tab icon.
+
+| Field | Value |
+|-------|-------|
+| **Method** | `GET` |
+| **Path** | `/api/v1/notifications` |
+| **Query params** | `seen=false`, `limit=1`, `event_type=PUSH` |
+| **Blocking** | No — fired from app shell `postFrameCallback` |
+| **Response fields used** | Presence of any result (updates `NotificationStateService`) |
+
+**Example:**
+```http
+GET /api/v1/notifications?seen=false&limit=1&event_type=PUSH
+Authorization: Bearer <token>
+Accept: application/json
+```
+
+Source: `lib/core/routes/app_shell/app_shell_screen.dart`
+
+---
+
+### 5. Recommended tenders (conditional fallback)
+
+Shown when the user has no "your tenders". Replaces the horizontal list label with "Recommended Tenders".
+
+| Field | Value |
+|-------|-------|
+| **Method** | `GET` |
+| **Path** | `/api/v1/tenders/recommend` |
+| **Query params** | `limit=10`, `offset=0` |
+| **Blocking** | No — triggered inside `getYourTenders()` without `await` |
+| **Condition** | Fires only when call #2 returns `data.tenders` empty |
+| **Response fields used** | `data.tenders[]` (full tender objects) |
+
+**Example:**
+```http
+GET /api/v1/tenders/recommend?limit=10&offset=0
+Authorization: Bearer <token>
+Accept: application/json
+```
+
+---
+
+## Pagination (scroll, not initial load)
+
+After the home page renders, scrolling the horizontal tender list near the end triggers additional calls:
+
+| Mode | Endpoint | Params |
+|------|----------|--------|
+| Your tenders | `GET /api/v1/tender-approvals` | `limit=10`, `offset=<page * 10>` |
+| Recommended (fallback mode) | `GET /api/v1/tenders/recommend` | `limit=10`, `offset=<page * 10>` |
+
+Page size is always **10**.
+
+---
+
+## Re-fetch triggers
+
+The full `init()` sequence (calls 1–3, and possibly 5) runs again when:
+
+- User switches away from Home tab and returns to it
+- User navigates to Liked Tenders and comes back (`homeViewModel.init()` on return)
+
+This means the same 3–5 API calls can repeat on every tab switch back to Home.
+
+---
+
+## APIs defined but NOT called on home load
+
+| Endpoint | Notes |
+|----------|-------|
+| `GET /api/v1/feedback/stats/company` | Defined in client (`HomeApi.statsCompany`) but never called from home |
+
+Some home stat cards show hardcoded `0` values (approved tenders count, tender value) — no API backing today.
+
+---
+
+## Performance notes for backend
+
+### Client-side bottleneck
+
+The client **does not parallelize** calls 1, 2, and 3. Total time-to-interactive ≈ `T(stats) + T(your-tenders) + T(liked-count)`.
+
+### Suggested backend investigations
+
+1. **`GET /api/v1/tender-approvals?limit=10&offset=0`** — Likely the slowest call. Check query plans, N+1 joins, and payload size (10 full tender objects).
+2. **`GET /api/v1/tender-approvals/stats`** — Runs before every home load; consider caching per company/user.
+3. **`GET /api/v1/feedback?feedback_type=like&limit=1&offset=0`** — Client only reads `meta.total`. A lightweight `GET /api/v1/feedback/count?feedback_type=like` would avoid loading feedback rows.
+4. **`GET /api/v1/tenders/recommend`** — May involve recommendation/AI logic; profile separately from tender-approvals.
+
+### Suggested backend optimizations
+
+| Idea | Benefit |
+|------|---------|
+| Single aggregated `GET /api/v1/home` endpoint | One round-trip instead of 3 sequential |
+| Return stats + liked count alongside tender-approvals list | Eliminate calls 1 and 3 |
+| Slim tender DTO for list views (id, title, deadline, status only) | Smaller payloads on call #2 and #5 |
+| Cache stats and liked count with short TTL | Faster repeat visits / tab switches |
+
+### Suggested client optimizations (for reference)
+
+These are frontend changes the mobile team could make independently:
+
+- Run calls 1, 2, and 3 in parallel (`Future.wait`)
+- Do not re-run full `init()` on every tab switch — refresh only stale data
+- Await the recommend fallback before clearing loading state (avoids UI flicker)
+
+---
+
+## Source files (client)
+
+| File | Role |
+|------|------|
+| `lib/view_models/home_view_model.dart` | Orchestrates all home API calls |
+| `lib/data/repositories/home_repository.dart` | Repository layer |
+| `lib/data/services/home_service.dart` | Stats, recommend, notifications |
+| `lib/data/services/your_tenders_service.dart` | Your tenders list |
+| `lib/data/services/liked_tenders_service.dart` | Liked count |
+| `lib/data/services/api/home_api.dart` | Endpoint path constants |
+| `lib/data/services/api/your_tenders_api.dart` | Tender-approvals URL builder |
+| `lib/data/services/api/liked_tenders_api.dart` | Feedback URL builder |
+| `lib/core/routes/app_shell/app_shell_screen.dart` | Background notification check |
+| `lib/views/home/pages/home_screen.dart` | Re-init on tab return |
+
+---
+
+## Quick test commands
+
+Replace `$TOKEN` with a valid access token.
+
+```bash
+# 1. Stats
+curl -s -w "\n%{http_code} %{time_total}s\n" \
+  'https://app.opplenz.com/api/v1/tender-approvals/stats' \
+  -H "Authorization: Bearer $TOKEN" | tail -1
+
+# 2. Your tenders
+curl -s -w "\n%{http_code} %{time_total}s\n" \
+  'https://app.opplenz.com/api/v1/tender-approvals?limit=10&offset=0' \
+  -H "Authorization: Bearer $TOKEN" | tail -1
+
+# 3. Liked count
+curl -s -w "\n%{http_code} %{time_total}s\n" \
+  'https://app.opplenz.com/api/v1/feedback?feedback_type=like&limit=1&offset=0' \
+  -H "Authorization: Bearer $TOKEN" | tail -1
+
+# 4. Notifications (background)
+curl -s -w "\n%{http_code} %{time_total}s\n" \
+  'https://app.opplenz.com/api/v1/notifications?seen=false&limit=1&event_type=PUSH' \
+  -H "Authorization: Bearer $TOKEN" | tail -1
+
+# 5. Recommended (only when your tenders empty)
+curl -s -w "\n%{http_code} %{time_total}s\n" \
+  'https://app.opplenz.com/api/v1/tenders/recommend?limit=10&offset=0' \
+  -H "Authorization: Bearer $TOKEN" | tail -1
+```
+
+Run all five and compare `time_total` to identify the slowest endpoint.

lib/core/config/dependencies.dart

@@ -3,6 +3,7 @@ import 'package:provider/single_child_widget.dart';
 import 'package:tm_app/core/network/network_manager.dart';
 import 'package:tm_app/core/services/tab_navigation_service.dart';
 import 'package:tm_app/core/theme/theme_provider.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/repositories/liked_tenders_repository.dart';
 import 'package:tm_app/data/repositories/notification_repository.dart';
@@ -13,9 +14,11 @@ import 'package:tm_app/data/services/home_service.dart';
 import 'package:tm_app/data/services/liked_tenders_service.dart';
 import 'package:tm_app/data/services/notification_check_service.dart';
 import 'package:tm_app/data/services/notification_service.dart';
+import 'package:tm_app/data/services/company_ai_service.dart';
 import 'package:tm_app/data/services/notification_state_service.dart';
 import 'package:tm_app/data/services/tender_detail_service.dart';
 import 'package:tm_app/data/services/your_tenders_service.dart';
+import 'package:tm_app/data/services/tender_submissions_service.dart';
 import 'package:tm_app/view_models/final_completion_of_documents_view_model.dart';
 
 import '../../data/repositories/auth_repository.dart';
@@ -79,6 +82,11 @@ List<SingleChildWidget> get apiClients {
       create: (context) => YourTendersService(networkManager: context.read()),
       lazy: true,
     ),
+    Provider(
+      create:
+          (context) => TenderSubmissionsService(networkManager: context.read()),
+      lazy: true,
+    ),
     Provider(
       create: (context) => LikedTendersService(networkManager: context.read()),
       lazy: true,
@@ -99,6 +107,10 @@ List<SingleChildWidget> get apiClients {
       create: (context) => BoardService(networkManager: context.read()),
       lazy: true,
     ),
+    Provider(
+      create: (context) => CompanyAiService(networkManager: context.read()),
+      lazy: true,
+    ),
   ];
 }
 
@@ -113,6 +125,7 @@ List<SingleChildWidget> get repositories {
           (context) => YourTendersRepository(
             yourTendersService: context.read(),
             likedTendersService: context.read(),
+            tenderSubmissionsService: context.read(),
           ),
       lazy: true,
     ),
@@ -122,6 +135,7 @@ List<SingleChildWidget> get repositories {
             homeService: context.read(),
             yourTendersService: context.read(),
             likedTendersService: context.read(),
+            tenderSubmissionsService: context.read(),
           ),
       lazy: true,
     ),
@@ -155,6 +169,14 @@ List<SingleChildWidget> get repositories {
       create: (context) => BoardRepository(boardService: context.read()),
       lazy: true,
     ),
+    Provider(
+      create:
+          (context) => CompanyAiRepository(
+            companyAiService: context.read(),
+            prefs: context.read(),
+          ),
+      lazy: true,
+    ),
   ];
 }
 

lib/core/constants/pref_keys.dart

@@ -9,4 +9,13 @@ class PrefKeys {
   static const String bearer = 'bearer';
   static const String refreshToken = 'refresh_token';
   static const String customerData = 'customer_data';
+
+  /// Fingerprint (hash of the company's document ids + website) of the last
+  /// profile version we triggered AI onboarding for. Lets us skip redundant
+  /// `POST /api/v1/onboarding` calls until the company's data actually changes.
+  static const String onboardingFingerprint = 'ai_onboarding_fingerprint';
+
+  /// Epoch milliseconds when AI onboarding was last started. Used by the
+  /// Recommended tab to show a "still learning" hint for a short grace period.
+  static const String onboardingStartedAt = 'ai_onboarding_started_at';
 }

lib/core/network/network_manager.dart

@@ -179,7 +179,16 @@ class NetworkManager {
   /// Handle HTTP error responses
   Result<T> _handleHttpError<T>(Response response) {
     final statusCode = response.statusCode;
-    final message = _extractErrorMessage(response.data);
+    var message = _extractErrorMessage(response.data);
+    if (statusCode == 422 && response.data is Map<String, dynamic>) {
+      final envelope = response.data as Map<String, dynamic>;
+      final error = envelope['error'];
+      if (error is Map<String, dynamic> &&
+          error['details'] is String &&
+          (error['details'] as String).isNotEmpty) {
+        message = error['details'] as String;
+      }
+    }
 
     switch (statusCode) {
       case 400:
@@ -238,16 +247,10 @@ class NetworkManager {
         );
 
       case DioExceptionType.badResponse:
-        if (e.response?.statusCode == 401) {
-          // Handle token refresh logic here if needed
-          // For now, return authentication error
-          return Result.error(
-            AuthenticationException(
-              'Authentication failed',
-              e.response?.statusCode,
-              e,
-            ),
-          );
+        if (e.response != null) {
+          // Preserve the backend envelope (including validation details) for
+          // non-2xx responses such as 409 and 422.
+          return _handleHttpError(e.response!);
         }
         return Result.error(
           FetchDataException(

lib/core/providers/profile_provider.dart

@@ -2,6 +2,7 @@ import 'package:flutter/material.dart';
 import 'package:provider/provider.dart';
 
 import '../../data/repositories/auth_repository.dart';
+import '../../data/repositories/company_ai_repository.dart';
 import '../../data/repositories/profile_repository.dart';
 import '../../view_models/profile_view_model.dart';
 
@@ -13,6 +14,7 @@ Widget profileProvider({required Widget child}) {
         (context) => ProfileViewModel(
           profileRepository: context.read<ProfileRepository>(),
           authRepository: context.read<AuthRepository>(),
+          companyAiRepository: context.read<CompanyAiRepository>(),
         ),
     child: child,
   );

lib/core/providers/tenders_provider.dart

@@ -1,17 +1,33 @@
 import 'package:flutter/material.dart';
 import 'package:provider/provider.dart';
 
+import '../../data/repositories/company_ai_repository.dart';
+import '../../data/repositories/home_repository.dart';
 import '../../data/repositories/tenders_repository.dart';
+import '../../view_models/ai_recommendations_view_model.dart';
 import '../../view_models/tenders_view_model.dart';
 
-/// Lazy TendersViewModel provider
-/// Wraps screens that need TendersViewModel
+/// Lazy providers for the tenders section.
+///
+/// Provides [TendersViewModel] (the "All" tab) and [AiRecommendationsViewModel]
+/// (the "Recommended" AI tab) to screens that need them.
 Widget tendersProvider({required Widget child}) {
-  return ChangeNotifierProvider(
-    create:
-        (context) => TendersViewModel(
-          tendersRepository: context.read<TendersRepository>(),
-        ),
+  return MultiProvider(
+    providers: [
+      ChangeNotifierProvider(
+        create:
+            (context) => TendersViewModel(
+              tendersRepository: context.read<TendersRepository>(),
+            ),
+      ),
+      ChangeNotifierProvider(
+        create:
+            (context) => AiRecommendationsViewModel(
+              companyAiRepository: context.read<CompanyAiRepository>(),
+              homeRepository: context.read<HomeRepository>(),
+            ),
+      ),
+    ],
     child: child,
   );
 }

lib/core/routes/app_routes.dart

@@ -200,7 +200,9 @@ class TendersRouteData extends GoRouteData with _$TendersRouteData {
 
   @override
   Widget build(BuildContext context, GoRouterState state) {
-    return tendersProvider(child: const TendersScreen());
+    return tendersProvider(
+      child: TendersScreen(initialTab: state.uri.queryParameters['tab']),
+    );
   }
 }
 

lib/core/utils/app_toast.dart

@@ -7,7 +7,12 @@ class AppToast {
       context: context,
       type: ToastificationType.success,
       style: ToastificationStyle.flatColored,
-      title: Text(message),
+      title: Text(
+        message,
+        maxLines: 5,
+        softWrap: true,
+        overflow: TextOverflow.ellipsis,
+      ),
       autoCloseDuration: const Duration(seconds: 3),
     );
   }
@@ -17,7 +22,12 @@ class AppToast {
       context: context,
       type: ToastificationType.error,
       style: ToastificationStyle.flatColored,
-      title: Text(message),
+      title: Text(
+        message,
+        maxLines: 5,
+        softWrap: true,
+        overflow: TextOverflow.ellipsis,
+      ),
       autoCloseDuration: const Duration(seconds: 3),
     );
   }
@@ -31,8 +41,18 @@ class AppToast {
       context: context,
       type: ToastificationType.info,
       style: ToastificationStyle.flatColored,
-      title: Text(title),
-      description: Text(description),
+      title: Text(
+        title,
+        maxLines: 2,
+        softWrap: true,
+        overflow: TextOverflow.ellipsis,
+      ),
+      description: Text(
+        description,
+        maxLines: 5,
+        softWrap: true,
+        overflow: TextOverflow.ellipsis,
+      ),
       autoCloseDuration: const Duration(seconds: 6),
     );
   }

lib/data/repositories/company_ai_repository.dart

@@ -0,0 +1,88 @@
+import 'package:shared_preferences/shared_preferences.dart';
+import 'package:tm_app/core/constants/pref_keys.dart';
+import 'package:tm_app/core/utils/logger.dart';
+import 'package:tm_app/core/utils/result.dart';
+import 'package:tm_app/data/services/company_ai_service.dart';
+import 'package:tm_app/data/services/model/onboarding_response/onboarding_response.dart';
+import 'package:tm_app/data/services/model/recommend_response/recommend_response.dart';
+
+/// Outcome of [CompanyAiRepository.maybeStartOnboarding].
+enum AiOnboardingOutcome {
+  /// Onboarding was started against the AI service.
+  started,
+
+  /// Skipped: the company has no documents and no website yet.
+  skippedNoData,
+
+  /// Skipped: this profile version was already onboarded.
+  skippedUnchanged,
+
+  /// The onboarding request failed (network/server). Safe to retry later.
+  failed,
+}
+
+/// Coordinates AI onboarding and recommendation calls.
+///
+/// Onboarding is asynchronous on the AI side and only needs to run when the
+/// company's documents or website change, so this repository fingerprints that
+/// data in [SharedPreferences] and skips redundant calls — mirroring the
+/// `onCompanyProfileReady` guidance in the mobile integration guide.
+class CompanyAiRepository {
+  CompanyAiRepository({
+    required CompanyAiService companyAiService,
+    required SharedPreferences prefs,
+  }) : _companyAiService = companyAiService,
+       _prefs = prefs;
+
+  final CompanyAiService _companyAiService;
+  final SharedPreferences _prefs;
+
+  /// Starts onboarding only when the company has data to index and its
+  /// fingerprint differs from the last successful run.
+  Future<AiOnboardingOutcome> maybeStartOnboarding({
+    required List<String> documentFileIds,
+    required String? website,
+  }) async {
+    final hasWebsite = website != null && website.trim().isNotEmpty;
+    if (documentFileIds.isEmpty && !hasWebsite) {
+      return AiOnboardingOutcome.skippedNoData;
+    }
+
+    final fingerprint = _fingerprint(documentFileIds, website);
+    if (fingerprint == _prefs.getString(PrefKeys.onboardingFingerprint)) {
+      return AiOnboardingOutcome.skippedUnchanged;
+    }
+
+    final result = await _companyAiService.startOnboarding();
+    switch (result) {
+      case Ok<OnboardingResponse>():
+        await _prefs.setString(PrefKeys.onboardingFingerprint, fingerprint);
+        await _prefs.setInt(
+          PrefKeys.onboardingStartedAt,
+          DateTime.now().millisecondsSinceEpoch,
+        );
+        AppLogger().info('✅ AI onboarding started for fingerprint $fingerprint');
+        return AiOnboardingOutcome.started;
+      case Error<OnboardingResponse>():
+        // Don't persist the fingerprint so the next profile load retries.
+        AppLogger().logWarning('⚠️ AI onboarding failed: ${result.error}');
+        return AiOnboardingOutcome.failed;
+    }
+  }
+
+  Future<Result<RecommendResponse>> getRecommendations() {
+    return _companyAiService.getRecommendations();
+  }
+
+  /// Epoch milliseconds of the last started onboarding, or null if none.
+  int? lastOnboardingStartedAt() =>
+      _prefs.getInt(PrefKeys.onboardingStartedAt);
+
+  /// Stable, order-independent fingerprint of the data the AI service indexes.
+  /// Stored verbatim (it is not sensitive) so it compares reliably across app
+  /// launches, unlike [String.hashCode].
+  String _fingerprint(List<String> documentFileIds, String? website) {
+    final ids = [...documentFileIds]..sort();
+    return '${ids.join(',')}|${website?.trim() ?? ''}';
+  }
+}

lib/data/repositories/home_repository.dart

@@ -4,6 +4,9 @@ import 'package:tm_app/data/services/liked_tenders_service.dart';
 import 'package:tm_app/data/services/model/recommended_tenders_response/recommended_tenders_response.dart';
 import 'package:tm_app/data/services/model/tender_approvals_response/tender_approvals_response.dart';
 import 'package:tm_app/data/services/model/tender_approvals_stats_response/tender_approvals_stats_response.dart';
+import 'package:tm_app/data/services/model/feedback_stats_response/feedback_stat_response.dart';
+import 'package:tm_app/data/services/model/tender_submission/tender_submission.dart';
+import 'package:tm_app/data/services/tender_submissions_service.dart';
 
 import '../services/model/request_models/get_tenders_request_model/get_tenders_request_model.dart';
 import '../services/model/request_models/tender_feedback_request_model/tender_feedback_request_model.dart';
@@ -14,12 +17,15 @@ class HomeRepository {
     required HomeService homeService,
     required YourTendersService yourTendersService,
     required LikedTendersService likedTendersService,
+    required TenderSubmissionsService tenderSubmissionsService,
   }) : _homeService = homeService,
        _yourTendersService = yourTendersService,
-       _likedTendersService = likedTendersService;
+       _likedTendersService = likedTendersService,
+       _tenderSubmissionsService = tenderSubmissionsService;
   final HomeService _homeService;
   final YourTendersService _yourTendersService;
   final LikedTendersService _likedTendersService;
+  final TenderSubmissionsService _tenderSubmissionsService;
 
   Future<Result<RecommendedTendersResponse>> getHomeRecommendedTenders({
     required int limit,
@@ -38,6 +44,12 @@ class HomeRepository {
     return _homeService.getTendersApprovalsStats();
   }
 
+  Future<Result<FeedbackStatResponse>> getCustomerFeedbackStats() =>
+      _homeService.getFeedbackStats();
+
+  Future<Result<TenderSubmissionStatsResponse>> getSubmissionStats() =>
+      _tenderSubmissionsService.getStats();
+
   /// Returns how many tenders the current user has liked (not company-wide).
   Future<Result<int>> getUserLikedTendersCount() async {
     final result = await _likedTendersService.getLikedTenders(

lib/data/repositories/your_tenders_repository.dart

@@ -4,17 +4,22 @@ import 'package:tm_app/data/services/model/liked_tenders_response/liked_tenders_
 import 'package:tm_app/data/services/model/request_models/get_tenders_request_model/get_tenders_request_model.dart';
 import 'package:tm_app/data/services/model/tender_approvals_response/tender_approvals_response.dart';
 import 'package:tm_app/data/services/your_tenders_service.dart';
+import 'package:tm_app/data/services/tender_submissions_service.dart';
+import 'package:tm_app/data/services/model/tender_submission/tender_submission.dart';
 
 import '../services/model/request_models/tender_feedback_request_model/tender_feedback_request_model.dart';
 
 class YourTendersRepository {
   final YourTendersService _yourTendersService;
   final LikedTendersService _likedTendersService;
+  final TenderSubmissionsService _tenderSubmissionsService;
   YourTendersRepository({
     required YourTendersService yourTendersService,
     required LikedTendersService likedTendersService,
+    required TenderSubmissionsService tenderSubmissionsService,
   }) : _yourTendersService = yourTendersService,
-       _likedTendersService = likedTendersService;
+       _likedTendersService = likedTendersService,
+       _tenderSubmissionsService = tenderSubmissionsService;
 
   Future<Result<TenderApprovalsResponse>> getTenders({
     required GetTendersRequestModel requestModel,
@@ -27,4 +32,41 @@ class YourTendersRepository {
   }) {
     return _likedTendersService.getLikedTenders(requestModel: requestModel);
   }
+
+  Future<Result<TenderSubmissionsResponse>> getSubmissions({
+    required String stage,
+    int limit = 20,
+    int offset = 0,
+  }) => _tenderSubmissionsService.getSubmissions(
+    stages: [stage],
+    limit: limit,
+    offset: offset,
+  );
+
+  Future<Result<TenderSubmissionResponse>> getSubmissionById(String id) =>
+      _tenderSubmissionsService.getById(id);
+
+  Future<Result<TenderSubmissionResponse>> getSubmissionByTender(
+    String tenderId,
+  ) => _tenderSubmissionsService.getByTender(tenderId);
+
+  Future<Result<TenderSubmissionResponse>> ensureSubmission(
+    String tenderId, {
+    String? companyId,
+  }) => _tenderSubmissionsService.ensure(tenderId, companyId: companyId);
+
+  Future<Result<TenderSubmissionResponse>> updateSubmissionStatus({
+    required String id,
+    required String status,
+    String? reason,
+    String? description,
+  }) => _tenderSubmissionsService.updateStatus(
+    id: id,
+    status: status,
+    reason: reason,
+    description: description,
+  );
+
+  Future<Result<TenderSubmissionStatsResponse>> getSubmissionStats() =>
+      _tenderSubmissionsService.getStats();
 }

lib/data/services/api/company_ai_api.dart

@@ -0,0 +1,14 @@
+/// Backend endpoints that power AI-based tender recommendations.
+///
+/// The app talks only to the backend; it gathers company data, forwards it to
+/// the AI service and returns results in the standard API envelope. The
+/// `company_id` is read from the JWT, so neither endpoint takes a request body.
+class CompanyAiApi {
+  CompanyAiApi._();
+
+  /// Registers the company with the AI service. Asynchronous on the AI side.
+  static const String onboarding = '/api/v1/onboarding';
+
+  /// Fetches ranked AI tender recommendations for the company.
+  static const String recommend = '/api/v1/recommend';
+}

lib/data/services/api/home_api.dart

@@ -14,7 +14,7 @@ class HomeApi {
   }
 
   static const String tenderApprovalStats = '/api/v1/tender-approvals/stats';
-  static const String statsCompany = '/api/v1/feedback/stats/company';
+  static const String statsCustomer = '/api/v1/feedback/stats/customer';
   static const String checkUnreadNotifications =
       '/api/v1/notifications?seen=false&limit=1&event_type=PUSH';
 }

lib/data/services/api/liked_tenders_api.dart

@@ -9,8 +9,8 @@ class LikedTendersApi {
     required String dateTo,
   }) {
     if (dateFrom.isNotEmpty && dateTo.isNotEmpty) {
-      return '$tendersFeedback?feedback_type=$feedbackType&limit=$limit&offset=$offset&date_from=$dateFrom&date_to=$dateTo';
+      return '$tendersFeedback?feedback_type=$feedbackType&limit=$limit&offset=$offset&include_total=true&date_from=$dateFrom&date_to=$dateTo';
     }
-    return '$tendersFeedback?feedback_type=$feedbackType&limit=$limit&offset=$offset';
+    return '$tendersFeedback?feedback_type=$feedbackType&limit=$limit&offset=$offset&include_total=true';
   }
 }

lib/data/services/api/tender_submissions_api.dart

@@ -0,0 +1,10 @@
+class TenderSubmissionsApi {
+  static const String base = '/api/v1/tender-submissions';
+
+  static const String list = base;
+  static const String stats = '$base/stats';
+  static String byId(String id) => '$base/$id';
+  static String byTender(String tenderId) => '$base/tender/$tenderId';
+  static String ensure(String tenderId) => '$base/tender/$tenderId/ensure';
+  static String status(String id) => '$base/$id/status';
+}

lib/data/services/company_ai_service.dart

@@ -0,0 +1,34 @@
+import 'dart:convert';
+
+import 'package:tm_app/core/utils/result.dart';
+import 'package:tm_app/data/services/api/company_ai_api.dart';
+import 'package:tm_app/data/services/model/onboarding_response/onboarding_response.dart';
+import 'package:tm_app/data/services/model/recommend_response/recommend_response.dart';
+
+import '../../core/network/network_manager.dart';
+
+/// Thin wrapper over the AI recommendation endpoints. The backend reads
+/// `company_id` from the JWT, so both calls send an empty JSON body.
+class CompanyAiService {
+  CompanyAiService({required NetworkManager networkManager})
+    : _networkManager = networkManager;
+  final NetworkManager _networkManager;
+
+  Future<Result<OnboardingResponse>> startOnboarding() async {
+    return _networkManager.makeRequest(
+      CompanyAiApi.onboarding,
+      method: 'POST',
+      (json) => OnboardingResponse.fromJson(json),
+      data: jsonEncode(const <String, dynamic>{}),
+    );
+  }
+
+  Future<Result<RecommendResponse>> getRecommendations() async {
+    return _networkManager.makeRequest(
+      CompanyAiApi.recommend,
+      method: 'POST',
+      (json) => RecommendResponse.fromJson(json),
+      data: jsonEncode(const <String, dynamic>{}),
+    );
+  }
+}

lib/data/services/home_service.dart

@@ -35,7 +35,7 @@ class HomeService {
 
   Future<Result<FeedbackStatResponse>> getFeedbackStats() async {
     final result = await _networkManager.makeRequest(
-      HomeApi.statsCompany,
+      HomeApi.statsCustomer,
       (json) => FeedbackStatResponse.fromJson(json),
       method: 'GET',
     );
@@ -44,7 +44,7 @@ class HomeService {
 
   Future<Result<Map<String, dynamic>>> checkUnreadNotifications() async {
     final result = await _networkManager.makeRequest(
-            HomeApi.checkUnreadNotifications,
+      HomeApi.checkUnreadNotifications,
       (json) => json,
       method: 'GET',
     );

lib/data/services/liked_tenders_service.dart

@@ -22,11 +22,20 @@ class LikedTendersService {
       dateTo: requestModel.dateTo,
     );
 
-    final result = await _networkManager.makeRequest(
-      uri,
-      (json) => LikedTendersResponse.fromJson(json),
-      method: 'GET',
-    );
+    final result = await _networkManager.makeRequest(uri, (json) {
+      // Feedback pagination is returned at the envelope root, while the
+      // legacy app model stores it beside data.feedback.
+      final normalized = Map<String, dynamic>.from(json);
+      final data = normalized['data'];
+      final meta = normalized['meta'];
+      if (data is Map && meta is Map) {
+        normalized['data'] = {
+          ...Map<String, dynamic>.from(data),
+          'meta': Map<String, dynamic>.from(meta),
+        };
+      }
+      return LikedTendersResponse.fromJson(normalized);
+    }, method: 'GET');
 
     return result;
   }

lib/data/services/model/company_profile_data/company_profile_data.dart

@@ -14,6 +14,11 @@ abstract class CompanyProfileData with _$CompanyProfileData {
     required String? industry,
     @JsonKey(name: 'founded_year') required int? foundedYear,
     @JsonKey(name: 'created_at') required int? createdAt,
+    // Drives the AI onboarding fingerprint (see CompanyAiRepository): onboarding
+    // re-runs only when the company's documents or website change. Optional so
+    // existing payloads that omit them keep deserializing.
+    @JsonKey(name: 'document_file_ids') List<String>? documentFileIds,
+    String? website,
   }) = _CompanyProfileData;
 
   factory CompanyProfileData.fromJson(Map<String, dynamic> json) =>

lib/data/services/model/company_profile_data/company_profile_data.freezed.dart

@@ -15,7 +15,10 @@ T _$identity<T>(T value) => value;
 /// @nodoc
 mixin _$CompanyProfileData {
 
- String? get id; String? get name;@JsonKey(name: 'registration_number') String? get registrationNumber; String? get industry;@JsonKey(name: 'founded_year') int? get foundedYear;@JsonKey(name: 'created_at') int? get createdAt;
+ String? get id; String? get name;@JsonKey(name: 'registration_number') String? get registrationNumber; String? get industry;@JsonKey(name: 'founded_year') int? get foundedYear;@JsonKey(name: 'created_at') int? get createdAt;// Drives the AI onboarding fingerprint (see CompanyAiRepository): onboarding
+// re-runs only when the company's documents or website change. Optional so
+// existing payloads that omit them keep deserializing.
+@JsonKey(name: 'document_file_ids') List<String>? get documentFileIds; String? get website;
 /// Create a copy of CompanyProfileData
 /// with the given fields replaced by the non-null parameter values.
 @JsonKey(includeFromJson: false, includeToJson: false)
@@ -28,16 +31,16 @@ $CompanyProfileDataCopyWith<CompanyProfileData> get copyWith => _$CompanyProfile
 
 @override
 bool operator ==(Object other) {
-  return identical(this, other) || (other.runtimeType == runtimeType&&other is CompanyProfileData&&(identical(other.id, id) || other.id == id)&&(identical(other.name, name) || other.name == name)&&(identical(other.registrationNumber, registrationNumber) || other.registrationNumber == registrationNumber)&&(identical(other.industry, industry) || other.industry == industry)&&(identical(other.foundedYear, foundedYear) || other.foundedYear == foundedYear)&&(identical(other.createdAt, createdAt) || other.createdAt == createdAt));
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is CompanyProfileData&&(identical(other.id, id) || other.id == id)&&(identical(other.name, name) || other.name == name)&&(identical(other.registrationNumber, registrationNumber) || other.registrationNumber == registrationNumber)&&(identical(other.industry, industry) || other.industry == industry)&&(identical(other.foundedYear, foundedYear) || other.foundedYear == foundedYear)&&(identical(other.createdAt, createdAt) || other.createdAt == createdAt)&&const DeepCollectionEquality().equals(other.documentFileIds, documentFileIds)&&(identical(other.website, website) || other.website == website));
 }
 
 @JsonKey(includeFromJson: false, includeToJson: false)
 @override
-int get hashCode => Object.hash(runtimeType,id,name,registrationNumber,industry,foundedYear,createdAt);
+int get hashCode => Object.hash(runtimeType,id,name,registrationNumber,industry,foundedYear,createdAt,const DeepCollectionEquality().hash(documentFileIds),website);
 
 @override
 String toString() {
-  return 'CompanyProfileData(id: $id, name: $name, registrationNumber: $registrationNumber, industry: $industry, foundedYear: $foundedYear, createdAt: $createdAt)';
+  return 'CompanyProfileData(id: $id, name: $name, registrationNumber: $registrationNumber, industry: $industry, foundedYear: $foundedYear, createdAt: $createdAt, documentFileIds: $documentFileIds, website: $website)';
 }
 
 
@@ -48,7 +51,7 @@ abstract mixin class $CompanyProfileDataCopyWith<$Res>  {
   factory $CompanyProfileDataCopyWith(CompanyProfileData value, $Res Function(CompanyProfileData) _then) = _$CompanyProfileDataCopyWithImpl;
 @useResult
 $Res call({
- String? id, String? name,@JsonKey(name: 'registration_number') String? registrationNumber, String? industry,@JsonKey(name: 'founded_year') int? foundedYear,@JsonKey(name: 'created_at') int? createdAt
+ String? id, String? name,@JsonKey(name: 'registration_number') String? registrationNumber, String? industry,@JsonKey(name: 'founded_year') int? foundedYear,@JsonKey(name: 'created_at') int? createdAt,@JsonKey(name: 'document_file_ids') List<String>? documentFileIds, String? website
 });
 
 
@@ -65,7 +68,7 @@ class _$CompanyProfileDataCopyWithImpl<$Res>
 
 /// Create a copy of CompanyProfileData
 /// with the given fields replaced by the non-null parameter values.
-@pragma('vm:prefer-inline') @override $Res call({Object? id = freezed,Object? name = freezed,Object? registrationNumber = freezed,Object? industry = freezed,Object? foundedYear = freezed,Object? createdAt = freezed,}) {
+@pragma('vm:prefer-inline') @override $Res call({Object? id = freezed,Object? name = freezed,Object? registrationNumber = freezed,Object? industry = freezed,Object? foundedYear = freezed,Object? createdAt = freezed,Object? documentFileIds = freezed,Object? website = freezed,}) {
   return _then(_self.copyWith(
 id: freezed == id ? _self.id : id // ignore: cast_nullable_to_non_nullable
 as String?,name: freezed == name ? _self.name : name // ignore: cast_nullable_to_non_nullable
@@ -73,7 +76,9 @@ as String?,registrationNumber: freezed == registrationNumber ? _self.registratio
 as String?,industry: freezed == industry ? _self.industry : industry // ignore: cast_nullable_to_non_nullable
 as String?,foundedYear: freezed == foundedYear ? _self.foundedYear : foundedYear // ignore: cast_nullable_to_non_nullable
 as int?,createdAt: freezed == createdAt ? _self.createdAt : createdAt // ignore: cast_nullable_to_non_nullable
-as int?,
+as int?,documentFileIds: freezed == documentFileIds ? _self.documentFileIds : documentFileIds // ignore: cast_nullable_to_non_nullable
+as List<String>?,website: freezed == website ? _self.website : website // ignore: cast_nullable_to_non_nullable
+as String?,
   ));
 }
 
@@ -158,10 +163,10 @@ return $default(_that);case _:
 /// }
 /// ```
 
-@optionalTypeArgs TResult maybeWhen<TResult extends Object?>(TResult Function( String? id,  String? name, @JsonKey(name: 'registration_number')  String? registrationNumber,  String? industry, @JsonKey(name: 'founded_year')  int? foundedYear, @JsonKey(name: 'created_at')  int? createdAt)?  $default,{required TResult orElse(),}) {final _that = this;
+@optionalTypeArgs TResult maybeWhen<TResult extends Object?>(TResult Function( String? id,  String? name, @JsonKey(name: 'registration_number')  String? registrationNumber,  String? industry, @JsonKey(name: 'founded_year')  int? foundedYear, @JsonKey(name: 'created_at')  int? createdAt, @JsonKey(name: 'document_file_ids')  List<String>? documentFileIds,  String? website)?  $default,{required TResult orElse(),}) {final _that = this;
 switch (_that) {
 case _CompanyProfileData() when $default != null:
-return $default(_that.id,_that.name,_that.registrationNumber,_that.industry,_that.foundedYear,_that.createdAt);case _:
+return $default(_that.id,_that.name,_that.registrationNumber,_that.industry,_that.foundedYear,_that.createdAt,_that.documentFileIds,_that.website);case _:
   return orElse();
 
 }
@@ -179,10 +184,10 @@ return $default(_that.id,_that.name,_that.registrationNumber,_that.industry,_tha
 /// }
 /// ```
 
-@optionalTypeArgs TResult when<TResult extends Object?>(TResult Function( String? id,  String? name, @JsonKey(name: 'registration_number')  String? registrationNumber,  String? industry, @JsonKey(name: 'founded_year')  int? foundedYear, @JsonKey(name: 'created_at')  int? createdAt)  $default,) {final _that = this;
+@optionalTypeArgs TResult when<TResult extends Object?>(TResult Function( String? id,  String? name, @JsonKey(name: 'registration_number')  String? registrationNumber,  String? industry, @JsonKey(name: 'founded_year')  int? foundedYear, @JsonKey(name: 'created_at')  int? createdAt, @JsonKey(name: 'document_file_ids')  List<String>? documentFileIds,  String? website)  $default,) {final _that = this;
 switch (_that) {
 case _CompanyProfileData():
-return $default(_that.id,_that.name,_that.registrationNumber,_that.industry,_that.foundedYear,_that.createdAt);case _:
+return $default(_that.id,_that.name,_that.registrationNumber,_that.industry,_that.foundedYear,_that.createdAt,_that.documentFileIds,_that.website);case _:
   throw StateError('Unexpected subclass');
 
 }
@@ -199,10 +204,10 @@ return $default(_that.id,_that.name,_that.registrationNumber,_that.industry,_tha
 /// }
 /// ```
 
-@optionalTypeArgs TResult? whenOrNull<TResult extends Object?>(TResult? Function( String? id,  String? name, @JsonKey(name: 'registration_number')  String? registrationNumber,  String? industry, @JsonKey(name: 'founded_year')  int? foundedYear, @JsonKey(name: 'created_at')  int? createdAt)?  $default,) {final _that = this;
+@optionalTypeArgs TResult? whenOrNull<TResult extends Object?>(TResult? Function( String? id,  String? name, @JsonKey(name: 'registration_number')  String? registrationNumber,  String? industry, @JsonKey(name: 'founded_year')  int? foundedYear, @JsonKey(name: 'created_at')  int? createdAt, @JsonKey(name: 'document_file_ids')  List<String>? documentFileIds,  String? website)?  $default,) {final _that = this;
 switch (_that) {
 case _CompanyProfileData() when $default != null:
-return $default(_that.id,_that.name,_that.registrationNumber,_that.industry,_that.foundedYear,_that.createdAt);case _:
+return $default(_that.id,_that.name,_that.registrationNumber,_that.industry,_that.foundedYear,_that.createdAt,_that.documentFileIds,_that.website);case _:
   return null;
 
 }
@@ -214,7 +219,7 @@ return $default(_that.id,_that.name,_that.registrationNumber,_that.industry,_tha
 @JsonSerializable()
 
 class _CompanyProfileData implements CompanyProfileData {
-  const _CompanyProfileData({required this.id, required this.name, @JsonKey(name: 'registration_number') required this.registrationNumber, required this.industry, @JsonKey(name: 'founded_year') required this.foundedYear, @JsonKey(name: 'created_at') required this.createdAt});
+  const _CompanyProfileData({required this.id, required this.name, @JsonKey(name: 'registration_number') required this.registrationNumber, required this.industry, @JsonKey(name: 'founded_year') required this.foundedYear, @JsonKey(name: 'created_at') required this.createdAt, @JsonKey(name: 'document_file_ids') final  List<String>? documentFileIds, this.website}): _documentFileIds = documentFileIds;
   factory _CompanyProfileData.fromJson(Map<String, dynamic> json) => _$CompanyProfileDataFromJson(json);
 
 @override final  String? id;
@@ -223,6 +228,22 @@ class _CompanyProfileData implements CompanyProfileData {
 @override final  String? industry;
 @override@JsonKey(name: 'founded_year') final  int? foundedYear;
 @override@JsonKey(name: 'created_at') final  int? createdAt;
+// Drives the AI onboarding fingerprint (see CompanyAiRepository): onboarding
+// re-runs only when the company's documents or website change. Optional so
+// existing payloads that omit them keep deserializing.
+ final  List<String>? _documentFileIds;
+// Drives the AI onboarding fingerprint (see CompanyAiRepository): onboarding
+// re-runs only when the company's documents or website change. Optional so
+// existing payloads that omit them keep deserializing.
+@override@JsonKey(name: 'document_file_ids') List<String>? get documentFileIds {
+  final value = _documentFileIds;
+  if (value == null) return null;
+  if (_documentFileIds is EqualUnmodifiableListView) return _documentFileIds;
+  // ignore: implicit_dynamic_type
+  return EqualUnmodifiableListView(value);
+}
+
+@override final  String? website;
 
 /// Create a copy of CompanyProfileData
 /// with the given fields replaced by the non-null parameter values.
@@ -237,16 +258,16 @@ Map<String, dynamic> toJson() {
 
 @override
 bool operator ==(Object other) {
-  return identical(this, other) || (other.runtimeType == runtimeType&&other is _CompanyProfileData&&(identical(other.id, id) || other.id == id)&&(identical(other.name, name) || other.name == name)&&(identical(other.registrationNumber, registrationNumber) || other.registrationNumber == registrationNumber)&&(identical(other.industry, industry) || other.industry == industry)&&(identical(other.foundedYear, foundedYear) || other.foundedYear == foundedYear)&&(identical(other.createdAt, createdAt) || other.createdAt == createdAt));
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is _CompanyProfileData&&(identical(other.id, id) || other.id == id)&&(identical(other.name, name) || other.name == name)&&(identical(other.registrationNumber, registrationNumber) || other.registrationNumber == registrationNumber)&&(identical(other.industry, industry) || other.industry == industry)&&(identical(other.foundedYear, foundedYear) || other.foundedYear == foundedYear)&&(identical(other.createdAt, createdAt) || other.createdAt == createdAt)&&const DeepCollectionEquality().equals(other._documentFileIds, _documentFileIds)&&(identical(other.website, website) || other.website == website));
 }
 
 @JsonKey(includeFromJson: false, includeToJson: false)
 @override
-int get hashCode => Object.hash(runtimeType,id,name,registrationNumber,industry,foundedYear,createdAt);
+int get hashCode => Object.hash(runtimeType,id,name,registrationNumber,industry,foundedYear,createdAt,const DeepCollectionEquality().hash(_documentFileIds),website);
 
 @override
 String toString() {
-  return 'CompanyProfileData(id: $id, name: $name, registrationNumber: $registrationNumber, industry: $industry, foundedYear: $foundedYear, createdAt: $createdAt)';
+  return 'CompanyProfileData(id: $id, name: $name, registrationNumber: $registrationNumber, industry: $industry, foundedYear: $foundedYear, createdAt: $createdAt, documentFileIds: $documentFileIds, website: $website)';
 }
 
 
@@ -257,7 +278,7 @@ abstract mixin class _$CompanyProfileDataCopyWith<$Res> implements $CompanyProfi
   factory _$CompanyProfileDataCopyWith(_CompanyProfileData value, $Res Function(_CompanyProfileData) _then) = __$CompanyProfileDataCopyWithImpl;
 @override @useResult
 $Res call({
- String? id, String? name,@JsonKey(name: 'registration_number') String? registrationNumber, String? industry,@JsonKey(name: 'founded_year') int? foundedYear,@JsonKey(name: 'created_at') int? createdAt
+ String? id, String? name,@JsonKey(name: 'registration_number') String? registrationNumber, String? industry,@JsonKey(name: 'founded_year') int? foundedYear,@JsonKey(name: 'created_at') int? createdAt,@JsonKey(name: 'document_file_ids') List<String>? documentFileIds, String? website
 });
 
 
@@ -274,7 +295,7 @@ class __$CompanyProfileDataCopyWithImpl<$Res>
 
 /// Create a copy of CompanyProfileData
 /// with the given fields replaced by the non-null parameter values.
-@override @pragma('vm:prefer-inline') $Res call({Object? id = freezed,Object? name = freezed,Object? registrationNumber = freezed,Object? industry = freezed,Object? foundedYear = freezed,Object? createdAt = freezed,}) {
+@override @pragma('vm:prefer-inline') $Res call({Object? id = freezed,Object? name = freezed,Object? registrationNumber = freezed,Object? industry = freezed,Object? foundedYear = freezed,Object? createdAt = freezed,Object? documentFileIds = freezed,Object? website = freezed,}) {
   return _then(_CompanyProfileData(
 id: freezed == id ? _self.id : id // ignore: cast_nullable_to_non_nullable
 as String?,name: freezed == name ? _self.name : name // ignore: cast_nullable_to_non_nullable
@@ -282,7 +303,9 @@ as String?,registrationNumber: freezed == registrationNumber ? _self.registratio
 as String?,industry: freezed == industry ? _self.industry : industry // ignore: cast_nullable_to_non_nullable
 as String?,foundedYear: freezed == foundedYear ? _self.foundedYear : foundedYear // ignore: cast_nullable_to_non_nullable
 as int?,createdAt: freezed == createdAt ? _self.createdAt : createdAt // ignore: cast_nullable_to_non_nullable
-as int?,
+as int?,documentFileIds: freezed == documentFileIds ? _self._documentFileIds : documentFileIds // ignore: cast_nullable_to_non_nullable
+as List<String>?,website: freezed == website ? _self.website : website // ignore: cast_nullable_to_non_nullable
+as String?,
   ));
 }
 

lib/data/services/model/company_profile_data/company_profile_data.g.dart

@@ -14,6 +14,11 @@ _CompanyProfileData _$CompanyProfileDataFromJson(Map<String, dynamic> json) =>
       industry: json['industry'] as String?,
       foundedYear: (json['founded_year'] as num?)?.toInt(),
       createdAt: (json['created_at'] as num?)?.toInt(),
+      documentFileIds:
+          (json['document_file_ids'] as List<dynamic>?)
+              ?.map((e) => e as String)
+              .toList(),
+      website: json['website'] as String?,
     );
 
 Map<String, dynamic> _$CompanyProfileDataToJson(_CompanyProfileData instance) =>
@@ -24,4 +29,6 @@ Map<String, dynamic> _$CompanyProfileDataToJson(_CompanyProfileData instance) =>
       'industry': instance.industry,
       'founded_year': instance.foundedYear,
       'created_at': instance.createdAt,
+      'document_file_ids': instance.documentFileIds,
+      'website': instance.website,
     };

lib/data/services/model/onboarding_data/onboarding_data.dart

@@ -0,0 +1,19 @@
+// ignore_for_file: invalid_annotation_target
+
+import 'package:freezed_annotation/freezed_annotation.dart';
+
+part 'onboarding_data.freezed.dart';
+part 'onboarding_data.g.dart';
+
+/// Payload returned by `POST /api/v1/onboarding`.
+///
+/// Onboarding is asynchronous on the AI side, so the only field is a coarse
+/// [status] (e.g. `started`). Recommendations may stay empty until the AI
+/// service finishes indexing.
+@freezed
+abstract class OnboardingData with _$OnboardingData {
+  const factory OnboardingData({required String? status}) = _OnboardingData;
+
+  factory OnboardingData.fromJson(Map<String, dynamic> json) =>
+      _$OnboardingDataFromJson(json);
+}

lib/data/services/model/onboarding_data/onboarding_data.freezed.dart

@@ -0,0 +1,277 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+// coverage:ignore-file
+// ignore_for_file: type=lint
+// ignore_for_file: unused_element, deprecated_member_use, deprecated_member_use_from_same_package, use_function_type_syntax_for_parameters, unnecessary_const, avoid_init_to_null, invalid_override_different_default_values_named, prefer_expression_function_bodies, annotate_overrides, invalid_annotation_target, unnecessary_question_mark
+
+part of 'onboarding_data.dart';
+
+// **************************************************************************
+// FreezedGenerator
+// **************************************************************************
+
+// dart format off
+T _$identity<T>(T value) => value;
+
+/// @nodoc
+mixin _$OnboardingData {
+
+ String? get status;
+/// Create a copy of OnboardingData
+/// with the given fields replaced by the non-null parameter values.
+@JsonKey(includeFromJson: false, includeToJson: false)
+@pragma('vm:prefer-inline')
+$OnboardingDataCopyWith<OnboardingData> get copyWith => _$OnboardingDataCopyWithImpl<OnboardingData>(this as OnboardingData, _$identity);
+
+  /// Serializes this OnboardingData to a JSON map.
+  Map<String, dynamic> toJson();
+
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is OnboardingData&&(identical(other.status, status) || other.status == status));
+}
+
+@JsonKey(includeFromJson: false, includeToJson: false)
+@override
+int get hashCode => Object.hash(runtimeType,status);
+
+@override
+String toString() {
+  return 'OnboardingData(status: $status)';
+}
+
+
+}
+
+/// @nodoc
+abstract mixin class $OnboardingDataCopyWith<$Res>  {
+  factory $OnboardingDataCopyWith(OnboardingData value, $Res Function(OnboardingData) _then) = _$OnboardingDataCopyWithImpl;
+@useResult
+$Res call({
+ String? status
+});
+
+
+
+
+}
+/// @nodoc
+class _$OnboardingDataCopyWithImpl<$Res>
+    implements $OnboardingDataCopyWith<$Res> {
+  _$OnboardingDataCopyWithImpl(this._self, this._then);
+
+  final OnboardingData _self;
+  final $Res Function(OnboardingData) _then;
+
+/// Create a copy of OnboardingData
+/// with the given fields replaced by the non-null parameter values.
+@pragma('vm:prefer-inline') @override $Res call({Object? status = freezed,}) {
+  return _then(_self.copyWith(
+status: freezed == status ? _self.status : status // ignore: cast_nullable_to_non_nullable
+as String?,
+  ));
+}
+
+}
+
+
+/// Adds pattern-matching-related methods to [OnboardingData].
+extension OnboardingDataPatterns on OnboardingData {
+/// A variant of `map` that fallback to returning `orElse`.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case _:
+///     return orElse();
+/// }
+/// ```
+
+@optionalTypeArgs TResult maybeMap<TResult extends Object?>(TResult Function( _OnboardingData value)?  $default,{required TResult orElse(),}){
+final _that = this;
+switch (_that) {
+case _OnboardingData() when $default != null:
+return $default(_that);case _:
+  return orElse();
+
+}
+}
+/// A `switch`-like method, using callbacks.
+///
+/// Callbacks receives the raw object, upcasted.
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case final Subclass2 value:
+///     return ...;
+/// }
+/// ```
+
+@optionalTypeArgs TResult map<TResult extends Object?>(TResult Function( _OnboardingData value)  $default,){
+final _that = this;
+switch (_that) {
+case _OnboardingData():
+return $default(_that);case _:
+  throw StateError('Unexpected subclass');
+
+}
+}
+/// A variant of `map` that fallback to returning `null`.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case _:
+///     return null;
+/// }
+/// ```
+
+@optionalTypeArgs TResult? mapOrNull<TResult extends Object?>(TResult? Function( _OnboardingData value)?  $default,){
+final _that = this;
+switch (_that) {
+case _OnboardingData() when $default != null:
+return $default(_that);case _:
+  return null;
+
+}
+}
+/// A variant of `when` that fallback to an `orElse` callback.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case _:
+///     return orElse();
+/// }
+/// ```
+
+@optionalTypeArgs TResult maybeWhen<TResult extends Object?>(TResult Function( String? status)?  $default,{required TResult orElse(),}) {final _that = this;
+switch (_that) {
+case _OnboardingData() when $default != null:
+return $default(_that.status);case _:
+  return orElse();
+
+}
+}
+/// A `switch`-like method, using callbacks.
+///
+/// As opposed to `map`, this offers destructuring.
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case Subclass2(:final field2):
+///     return ...;
+/// }
+/// ```
+
+@optionalTypeArgs TResult when<TResult extends Object?>(TResult Function( String? status)  $default,) {final _that = this;
+switch (_that) {
+case _OnboardingData():
+return $default(_that.status);case _:
+  throw StateError('Unexpected subclass');
+
+}
+}
+/// A variant of `when` that fallback to returning `null`
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case _:
+///     return null;
+/// }
+/// ```
+
+@optionalTypeArgs TResult? whenOrNull<TResult extends Object?>(TResult? Function( String? status)?  $default,) {final _that = this;
+switch (_that) {
+case _OnboardingData() when $default != null:
+return $default(_that.status);case _:
+  return null;
+
+}
+}
+
+}
+
+/// @nodoc
+@JsonSerializable()
+
+class _OnboardingData implements OnboardingData {
+  const _OnboardingData({required this.status});
+  factory _OnboardingData.fromJson(Map<String, dynamic> json) => _$OnboardingDataFromJson(json);
+
+@override final  String? status;
+
+/// Create a copy of OnboardingData
+/// with the given fields replaced by the non-null parameter values.
+@override @JsonKey(includeFromJson: false, includeToJson: false)
+@pragma('vm:prefer-inline')
+_$OnboardingDataCopyWith<_OnboardingData> get copyWith => __$OnboardingDataCopyWithImpl<_OnboardingData>(this, _$identity);
+
+@override
+Map<String, dynamic> toJson() {
+  return _$OnboardingDataToJson(this, );
+}
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is _OnboardingData&&(identical(other.status, status) || other.status == status));
+}
+
+@JsonKey(includeFromJson: false, includeToJson: false)
+@override
+int get hashCode => Object.hash(runtimeType,status);
+
+@override
+String toString() {
+  return 'OnboardingData(status: $status)';
+}
+
+
+}
+
+/// @nodoc
+abstract mixin class _$OnboardingDataCopyWith<$Res> implements $OnboardingDataCopyWith<$Res> {
+  factory _$OnboardingDataCopyWith(_OnboardingData value, $Res Function(_OnboardingData) _then) = __$OnboardingDataCopyWithImpl;
+@override @useResult
+$Res call({
+ String? status
+});
+
+
+
+
+}
+/// @nodoc
+class __$OnboardingDataCopyWithImpl<$Res>
+    implements _$OnboardingDataCopyWith<$Res> {
+  __$OnboardingDataCopyWithImpl(this._self, this._then);
+
+  final _OnboardingData _self;
+  final $Res Function(_OnboardingData) _then;
+
+/// Create a copy of OnboardingData
+/// with the given fields replaced by the non-null parameter values.
+@override @pragma('vm:prefer-inline') $Res call({Object? status = freezed,}) {
+  return _then(_OnboardingData(
+status: freezed == status ? _self.status : status // ignore: cast_nullable_to_non_nullable
+as String?,
+  ));
+}
+
+
+}
+
+// dart format on

lib/data/services/model/onboarding_data/onboarding_data.g.dart

@@ -0,0 +1,13 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'onboarding_data.dart';
+
+// **************************************************************************
+// JsonSerializableGenerator
+// **************************************************************************
+
+_OnboardingData _$OnboardingDataFromJson(Map<String, dynamic> json) =>
+    _OnboardingData(status: json['status'] as String?);
+
+Map<String, dynamic> _$OnboardingDataToJson(_OnboardingData instance) =>
+    <String, dynamic>{'status': instance.status};

lib/data/services/model/onboarding_response/onboarding_response.dart

@@ -0,0 +1,24 @@
+// ignore_for_file: invalid_annotation_target
+
+import 'package:freezed_annotation/freezed_annotation.dart';
+
+import '../error/error_model.dart';
+import '../onboarding_data/onboarding_data.dart';
+
+part 'onboarding_response.freezed.dart';
+part 'onboarding_response.g.dart';
+
+/// Standard API envelope for `POST /api/v1/onboarding`.
+@freezed
+abstract class OnboardingResponse with _$OnboardingResponse {
+  @JsonSerializable(explicitToJson: true)
+  const factory OnboardingResponse({
+    @JsonKey(name: 'data') required OnboardingData? data,
+    @JsonKey(name: 'error') required ErrorModel? error,
+    required String? message,
+    required bool? success,
+  }) = _OnboardingResponse;
+
+  factory OnboardingResponse.fromJson(Map<String, dynamic> json) =>
+      _$OnboardingResponseFromJson(json);
+}

lib/data/services/model/onboarding_response/onboarding_response.freezed.dart

@@ -0,0 +1,334 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+// coverage:ignore-file
+// ignore_for_file: type=lint
+// ignore_for_file: unused_element, deprecated_member_use, deprecated_member_use_from_same_package, use_function_type_syntax_for_parameters, unnecessary_const, avoid_init_to_null, invalid_override_different_default_values_named, prefer_expression_function_bodies, annotate_overrides, invalid_annotation_target, unnecessary_question_mark
+
+part of 'onboarding_response.dart';
+
+// **************************************************************************
+// FreezedGenerator
+// **************************************************************************
+
+// dart format off
+T _$identity<T>(T value) => value;
+
+/// @nodoc
+mixin _$OnboardingResponse {
+
+@JsonKey(name: 'data') OnboardingData? get data;@JsonKey(name: 'error') ErrorModel? get error; String? get message; bool? get success;
+/// Create a copy of OnboardingResponse
+/// with the given fields replaced by the non-null parameter values.
+@JsonKey(includeFromJson: false, includeToJson: false)
+@pragma('vm:prefer-inline')
+$OnboardingResponseCopyWith<OnboardingResponse> get copyWith => _$OnboardingResponseCopyWithImpl<OnboardingResponse>(this as OnboardingResponse, _$identity);
+
+  /// Serializes this OnboardingResponse to a JSON map.
+  Map<String, dynamic> toJson();
+
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is OnboardingResponse&&(identical(other.data, data) || other.data == data)&&(identical(other.error, error) || other.error == error)&&(identical(other.message, message) || other.message == message)&&(identical(other.success, success) || other.success == success));
+}
+
+@JsonKey(includeFromJson: false, includeToJson: false)
+@override
+int get hashCode => Object.hash(runtimeType,data,error,message,success);
+
+@override
+String toString() {
+  return 'OnboardingResponse(data: $data, error: $error, message: $message, success: $success)';
+}
+
+
+}
+
+/// @nodoc
+abstract mixin class $OnboardingResponseCopyWith<$Res>  {
+  factory $OnboardingResponseCopyWith(OnboardingResponse value, $Res Function(OnboardingResponse) _then) = _$OnboardingResponseCopyWithImpl;
+@useResult
+$Res call({
+@JsonKey(name: 'data') OnboardingData? data,@JsonKey(name: 'error') ErrorModel? error, String? message, bool? success
+});
+
+
+$OnboardingDataCopyWith<$Res>? get data;$ErrorModelCopyWith<$Res>? get error;
+
+}
+/// @nodoc
+class _$OnboardingResponseCopyWithImpl<$Res>
+    implements $OnboardingResponseCopyWith<$Res> {
+  _$OnboardingResponseCopyWithImpl(this._self, this._then);
+
+  final OnboardingResponse _self;
+  final $Res Function(OnboardingResponse) _then;
+
+/// Create a copy of OnboardingResponse
+/// with the given fields replaced by the non-null parameter values.
+@pragma('vm:prefer-inline') @override $Res call({Object? data = freezed,Object? error = freezed,Object? message = freezed,Object? success = freezed,}) {
+  return _then(_self.copyWith(
+data: freezed == data ? _self.data : data // ignore: cast_nullable_to_non_nullable
+as OnboardingData?,error: freezed == error ? _self.error : error // ignore: cast_nullable_to_non_nullable
+as ErrorModel?,message: freezed == message ? _self.message : message // ignore: cast_nullable_to_non_nullable
+as String?,success: freezed == success ? _self.success : success // ignore: cast_nullable_to_non_nullable
+as bool?,
+  ));
+}
+/// Create a copy of OnboardingResponse
+/// with the given fields replaced by the non-null parameter values.
+@override
+@pragma('vm:prefer-inline')
+$OnboardingDataCopyWith<$Res>? get data {
+    if (_self.data == null) {
+    return null;
+  }
+
+  return $OnboardingDataCopyWith<$Res>(_self.data!, (value) {
+    return _then(_self.copyWith(data: value));
+  });
+}/// Create a copy of OnboardingResponse
+/// with the given fields replaced by the non-null parameter values.
+@override
+@pragma('vm:prefer-inline')
+$ErrorModelCopyWith<$Res>? get error {
+    if (_self.error == null) {
+    return null;
+  }
+
+  return $ErrorModelCopyWith<$Res>(_self.error!, (value) {
+    return _then(_self.copyWith(error: value));
+  });
+}
+}
+
+
+/// Adds pattern-matching-related methods to [OnboardingResponse].
+extension OnboardingResponsePatterns on OnboardingResponse {
+/// A variant of `map` that fallback to returning `orElse`.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case _:
+///     return orElse();
+/// }
+/// ```
+
+@optionalTypeArgs TResult maybeMap<TResult extends Object?>(TResult Function( _OnboardingResponse value)?  $default,{required TResult orElse(),}){
+final _that = this;
+switch (_that) {
+case _OnboardingResponse() when $default != null:
+return $default(_that);case _:
+  return orElse();
+
+}
+}
+/// A `switch`-like method, using callbacks.
+///
+/// Callbacks receives the raw object, upcasted.
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case final Subclass2 value:
+///     return ...;
+/// }
+/// ```
+
+@optionalTypeArgs TResult map<TResult extends Object?>(TResult Function( _OnboardingResponse value)  $default,){
+final _that = this;
+switch (_that) {
+case _OnboardingResponse():
+return $default(_that);case _:
+  throw StateError('Unexpected subclass');
+
+}
+}
+/// A variant of `map` that fallback to returning `null`.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case _:
+///     return null;
+/// }
+/// ```
+
+@optionalTypeArgs TResult? mapOrNull<TResult extends Object?>(TResult? Function( _OnboardingResponse value)?  $default,){
+final _that = this;
+switch (_that) {
+case _OnboardingResponse() when $default != null:
+return $default(_that);case _:
+  return null;
+
+}
+}
+/// A variant of `when` that fallback to an `orElse` callback.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case _:
+///     return orElse();
+/// }
+/// ```
+
+@optionalTypeArgs TResult maybeWhen<TResult extends Object?>(TResult Function(@JsonKey(name: 'data')  OnboardingData? data, @JsonKey(name: 'error')  ErrorModel? error,  String? message,  bool? success)?  $default,{required TResult orElse(),}) {final _that = this;
+switch (_that) {
+case _OnboardingResponse() when $default != null:
+return $default(_that.data,_that.error,_that.message,_that.success);case _:
+  return orElse();
+
+}
+}
+/// A `switch`-like method, using callbacks.
+///
+/// As opposed to `map`, this offers destructuring.
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case Subclass2(:final field2):
+///     return ...;
+/// }
+/// ```
+
+@optionalTypeArgs TResult when<TResult extends Object?>(TResult Function(@JsonKey(name: 'data')  OnboardingData? data, @JsonKey(name: 'error')  ErrorModel? error,  String? message,  bool? success)  $default,) {final _that = this;
+switch (_that) {
+case _OnboardingResponse():
+return $default(_that.data,_that.error,_that.message,_that.success);case _:
+  throw StateError('Unexpected subclass');
+
+}
+}
+/// A variant of `when` that fallback to returning `null`
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case _:
+///     return null;
+/// }
+/// ```
+
+@optionalTypeArgs TResult? whenOrNull<TResult extends Object?>(TResult? Function(@JsonKey(name: 'data')  OnboardingData? data, @JsonKey(name: 'error')  ErrorModel? error,  String? message,  bool? success)?  $default,) {final _that = this;
+switch (_that) {
+case _OnboardingResponse() when $default != null:
+return $default(_that.data,_that.error,_that.message,_that.success);case _:
+  return null;
+
+}
+}
+
+}
+
+/// @nodoc
+
+@JsonSerializable(explicitToJson: true)
+class _OnboardingResponse implements OnboardingResponse {
+  const _OnboardingResponse({@JsonKey(name: 'data') required this.data, @JsonKey(name: 'error') required this.error, required this.message, required this.success});
+  factory _OnboardingResponse.fromJson(Map<String, dynamic> json) => _$OnboardingResponseFromJson(json);
+
+@override@JsonKey(name: 'data') final  OnboardingData? data;
+@override@JsonKey(name: 'error') final  ErrorModel? error;
+@override final  String? message;
+@override final  bool? success;
+
+/// Create a copy of OnboardingResponse
+/// with the given fields replaced by the non-null parameter values.
+@override @JsonKey(includeFromJson: false, includeToJson: false)
+@pragma('vm:prefer-inline')
+_$OnboardingResponseCopyWith<_OnboardingResponse> get copyWith => __$OnboardingResponseCopyWithImpl<_OnboardingResponse>(this, _$identity);
+
+@override
+Map<String, dynamic> toJson() {
+  return _$OnboardingResponseToJson(this, );
+}
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is _OnboardingResponse&&(identical(other.data, data) || other.data == data)&&(identical(other.error, error) || other.error == error)&&(identical(other.message, message) || other.message == message)&&(identical(other.success, success) || other.success == success));
+}
+
+@JsonKey(includeFromJson: false, includeToJson: false)
+@override
+int get hashCode => Object.hash(runtimeType,data,error,message,success);
+
+@override
+String toString() {
+  return 'OnboardingResponse(data: $data, error: $error, message: $message, success: $success)';
+}
+
+
+}
+
+/// @nodoc
+abstract mixin class _$OnboardingResponseCopyWith<$Res> implements $OnboardingResponseCopyWith<$Res> {
+  factory _$OnboardingResponseCopyWith(_OnboardingResponse value, $Res Function(_OnboardingResponse) _then) = __$OnboardingResponseCopyWithImpl;
+@override @useResult
+$Res call({
+@JsonKey(name: 'data') OnboardingData? data,@JsonKey(name: 'error') ErrorModel? error, String? message, bool? success
+});
+
+
+@override $OnboardingDataCopyWith<$Res>? get data;@override $ErrorModelCopyWith<$Res>? get error;
+
+}
+/// @nodoc
+class __$OnboardingResponseCopyWithImpl<$Res>
+    implements _$OnboardingResponseCopyWith<$Res> {
+  __$OnboardingResponseCopyWithImpl(this._self, this._then);
+
+  final _OnboardingResponse _self;
+  final $Res Function(_OnboardingResponse) _then;
+
+/// Create a copy of OnboardingResponse
+/// with the given fields replaced by the non-null parameter values.
+@override @pragma('vm:prefer-inline') $Res call({Object? data = freezed,Object? error = freezed,Object? message = freezed,Object? success = freezed,}) {
+  return _then(_OnboardingResponse(
+data: freezed == data ? _self.data : data // ignore: cast_nullable_to_non_nullable
+as OnboardingData?,error: freezed == error ? _self.error : error // ignore: cast_nullable_to_non_nullable
+as ErrorModel?,message: freezed == message ? _self.message : message // ignore: cast_nullable_to_non_nullable
+as String?,success: freezed == success ? _self.success : success // ignore: cast_nullable_to_non_nullable
+as bool?,
+  ));
+}
+
+/// Create a copy of OnboardingResponse
+/// with the given fields replaced by the non-null parameter values.
+@override
+@pragma('vm:prefer-inline')
+$OnboardingDataCopyWith<$Res>? get data {
+    if (_self.data == null) {
+    return null;
+  }
+
+  return $OnboardingDataCopyWith<$Res>(_self.data!, (value) {
+    return _then(_self.copyWith(data: value));
+  });
+}/// Create a copy of OnboardingResponse
+/// with the given fields replaced by the non-null parameter values.
+@override
+@pragma('vm:prefer-inline')
+$ErrorModelCopyWith<$Res>? get error {
+    if (_self.error == null) {
+    return null;
+  }
+
+  return $ErrorModelCopyWith<$Res>(_self.error!, (value) {
+    return _then(_self.copyWith(error: value));
+  });
+}
+}
+
+// dart format on

lib/data/services/model/onboarding_response/onboarding_response.g.dart

@@ -0,0 +1,29 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'onboarding_response.dart';
+
+// **************************************************************************
+// JsonSerializableGenerator
+// **************************************************************************
+
+_OnboardingResponse _$OnboardingResponseFromJson(Map<String, dynamic> json) =>
+    _OnboardingResponse(
+      data:
+          json['data'] == null
+              ? null
+              : OnboardingData.fromJson(json['data'] as Map<String, dynamic>),
+      error:
+          json['error'] == null
+              ? null
+              : ErrorModel.fromJson(json['error'] as Map<String, dynamic>),
+      message: json['message'] as String?,
+      success: json['success'] as bool?,
+    );
+
+Map<String, dynamic> _$OnboardingResponseToJson(_OnboardingResponse instance) =>
+    <String, dynamic>{
+      'data': instance.data?.toJson(),
+      'error': instance.error?.toJson(),
+      'message': instance.message,
+      'success': instance.success,
+    };

lib/data/services/model/recommend_response/recommend_response.dart

@@ -0,0 +1,27 @@
+// ignore_for_file: invalid_annotation_target
+
+import 'package:freezed_annotation/freezed_annotation.dart';
+
+import '../error/error_model.dart';
+import '../recommendation_item/recommendation_item.dart';
+
+part 'recommend_response.freezed.dart';
+part 'recommend_response.g.dart';
+
+/// Standard API envelope for `POST /api/v1/recommend`.
+///
+/// [data] holds the ranked recommendations and may be empty (or null) until
+/// the AI service finishes indexing the company.
+@freezed
+abstract class RecommendResponse with _$RecommendResponse {
+  @JsonSerializable(explicitToJson: true)
+  const factory RecommendResponse({
+    @JsonKey(name: 'data') required List<RecommendationItem>? data,
+    @JsonKey(name: 'error') required ErrorModel? error,
+    required String? message,
+    required bool? success,
+  }) = _RecommendResponse;
+
+  factory RecommendResponse.fromJson(Map<String, dynamic> json) =>
+      _$RecommendResponseFromJson(json);
+}

lib/data/services/model/recommend_response/recommend_response.freezed.dart

@@ -0,0 +1,318 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+// coverage:ignore-file
+// ignore_for_file: type=lint
+// ignore_for_file: unused_element, deprecated_member_use, deprecated_member_use_from_same_package, use_function_type_syntax_for_parameters, unnecessary_const, avoid_init_to_null, invalid_override_different_default_values_named, prefer_expression_function_bodies, annotate_overrides, invalid_annotation_target, unnecessary_question_mark
+
+part of 'recommend_response.dart';
+
+// **************************************************************************
+// FreezedGenerator
+// **************************************************************************
+
+// dart format off
+T _$identity<T>(T value) => value;
+
+/// @nodoc
+mixin _$RecommendResponse {
+
+@JsonKey(name: 'data') List<RecommendationItem>? get data;@JsonKey(name: 'error') ErrorModel? get error; String? get message; bool? get success;
+/// Create a copy of RecommendResponse
+/// with the given fields replaced by the non-null parameter values.
+@JsonKey(includeFromJson: false, includeToJson: false)
+@pragma('vm:prefer-inline')
+$RecommendResponseCopyWith<RecommendResponse> get copyWith => _$RecommendResponseCopyWithImpl<RecommendResponse>(this as RecommendResponse, _$identity);
+
+  /// Serializes this RecommendResponse to a JSON map.
+  Map<String, dynamic> toJson();
+
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is RecommendResponse&&const DeepCollectionEquality().equals(other.data, data)&&(identical(other.error, error) || other.error == error)&&(identical(other.message, message) || other.message == message)&&(identical(other.success, success) || other.success == success));
+}
+
+@JsonKey(includeFromJson: false, includeToJson: false)
+@override
+int get hashCode => Object.hash(runtimeType,const DeepCollectionEquality().hash(data),error,message,success);
+
+@override
+String toString() {
+  return 'RecommendResponse(data: $data, error: $error, message: $message, success: $success)';
+}
+
+
+}
+
+/// @nodoc
+abstract mixin class $RecommendResponseCopyWith<$Res>  {
+  factory $RecommendResponseCopyWith(RecommendResponse value, $Res Function(RecommendResponse) _then) = _$RecommendResponseCopyWithImpl;
+@useResult
+$Res call({
+@JsonKey(name: 'data') List<RecommendationItem>? data,@JsonKey(name: 'error') ErrorModel? error, String? message, bool? success
+});
+
+
+$ErrorModelCopyWith<$Res>? get error;
+
+}
+/// @nodoc
+class _$RecommendResponseCopyWithImpl<$Res>
+    implements $RecommendResponseCopyWith<$Res> {
+  _$RecommendResponseCopyWithImpl(this._self, this._then);
+
+  final RecommendResponse _self;
+  final $Res Function(RecommendResponse) _then;
+
+/// Create a copy of RecommendResponse
+/// with the given fields replaced by the non-null parameter values.
+@pragma('vm:prefer-inline') @override $Res call({Object? data = freezed,Object? error = freezed,Object? message = freezed,Object? success = freezed,}) {
+  return _then(_self.copyWith(
+data: freezed == data ? _self.data : data // ignore: cast_nullable_to_non_nullable
+as List<RecommendationItem>?,error: freezed == error ? _self.error : error // ignore: cast_nullable_to_non_nullable
+as ErrorModel?,message: freezed == message ? _self.message : message // ignore: cast_nullable_to_non_nullable
+as String?,success: freezed == success ? _self.success : success // ignore: cast_nullable_to_non_nullable
+as bool?,
+  ));
+}
+/// Create a copy of RecommendResponse
+/// with the given fields replaced by the non-null parameter values.
+@override
+@pragma('vm:prefer-inline')
+$ErrorModelCopyWith<$Res>? get error {
+    if (_self.error == null) {
+    return null;
+  }
+
+  return $ErrorModelCopyWith<$Res>(_self.error!, (value) {
+    return _then(_self.copyWith(error: value));
+  });
+}
+}
+
+
+/// Adds pattern-matching-related methods to [RecommendResponse].
+extension RecommendResponsePatterns on RecommendResponse {
+/// A variant of `map` that fallback to returning `orElse`.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case _:
+///     return orElse();
+/// }
+/// ```
+
+@optionalTypeArgs TResult maybeMap<TResult extends Object?>(TResult Function( _RecommendResponse value)?  $default,{required TResult orElse(),}){
+final _that = this;
+switch (_that) {
+case _RecommendResponse() when $default != null:
+return $default(_that);case _:
+  return orElse();
+
+}
+}
+/// A `switch`-like method, using callbacks.
+///
+/// Callbacks receives the raw object, upcasted.
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case final Subclass2 value:
+///     return ...;
+/// }
+/// ```
+
+@optionalTypeArgs TResult map<TResult extends Object?>(TResult Function( _RecommendResponse value)  $default,){
+final _that = this;
+switch (_that) {
+case _RecommendResponse():
+return $default(_that);case _:
+  throw StateError('Unexpected subclass');
+
+}
+}
+/// A variant of `map` that fallback to returning `null`.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case _:
+///     return null;
+/// }
+/// ```
+
+@optionalTypeArgs TResult? mapOrNull<TResult extends Object?>(TResult? Function( _RecommendResponse value)?  $default,){
+final _that = this;
+switch (_that) {
+case _RecommendResponse() when $default != null:
+return $default(_that);case _:
+  return null;
+
+}
+}
+/// A variant of `when` that fallback to an `orElse` callback.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case _:
+///     return orElse();
+/// }
+/// ```
+
+@optionalTypeArgs TResult maybeWhen<TResult extends Object?>(TResult Function(@JsonKey(name: 'data')  List<RecommendationItem>? data, @JsonKey(name: 'error')  ErrorModel? error,  String? message,  bool? success)?  $default,{required TResult orElse(),}) {final _that = this;
+switch (_that) {
+case _RecommendResponse() when $default != null:
+return $default(_that.data,_that.error,_that.message,_that.success);case _:
+  return orElse();
+
+}
+}
+/// A `switch`-like method, using callbacks.
+///
+/// As opposed to `map`, this offers destructuring.
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case Subclass2(:final field2):
+///     return ...;
+/// }
+/// ```
+
+@optionalTypeArgs TResult when<TResult extends Object?>(TResult Function(@JsonKey(name: 'data')  List<RecommendationItem>? data, @JsonKey(name: 'error')  ErrorModel? error,  String? message,  bool? success)  $default,) {final _that = this;
+switch (_that) {
+case _RecommendResponse():
+return $default(_that.data,_that.error,_that.message,_that.success);case _:
+  throw StateError('Unexpected subclass');
+
+}
+}
+/// A variant of `when` that fallback to returning `null`
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case _:
+///     return null;
+/// }
+/// ```
+
+@optionalTypeArgs TResult? whenOrNull<TResult extends Object?>(TResult? Function(@JsonKey(name: 'data')  List<RecommendationItem>? data, @JsonKey(name: 'error')  ErrorModel? error,  String? message,  bool? success)?  $default,) {final _that = this;
+switch (_that) {
+case _RecommendResponse() when $default != null:
+return $default(_that.data,_that.error,_that.message,_that.success);case _:
+  return null;
+
+}
+}
+
+}
+
+/// @nodoc
+
+@JsonSerializable(explicitToJson: true)
+class _RecommendResponse implements RecommendResponse {
+  const _RecommendResponse({@JsonKey(name: 'data') required final  List<RecommendationItem>? data, @JsonKey(name: 'error') required this.error, required this.message, required this.success}): _data = data;
+  factory _RecommendResponse.fromJson(Map<String, dynamic> json) => _$RecommendResponseFromJson(json);
+
+ final  List<RecommendationItem>? _data;
+@override@JsonKey(name: 'data') List<RecommendationItem>? get data {
+  final value = _data;
+  if (value == null) return null;
+  if (_data is EqualUnmodifiableListView) return _data;
+  // ignore: implicit_dynamic_type
+  return EqualUnmodifiableListView(value);
+}
+
+@override@JsonKey(name: 'error') final  ErrorModel? error;
+@override final  String? message;
+@override final  bool? success;
+
+/// Create a copy of RecommendResponse
+/// with the given fields replaced by the non-null parameter values.
+@override @JsonKey(includeFromJson: false, includeToJson: false)
+@pragma('vm:prefer-inline')
+_$RecommendResponseCopyWith<_RecommendResponse> get copyWith => __$RecommendResponseCopyWithImpl<_RecommendResponse>(this, _$identity);
+
+@override
+Map<String, dynamic> toJson() {
+  return _$RecommendResponseToJson(this, );
+}
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is _RecommendResponse&&const DeepCollectionEquality().equals(other._data, _data)&&(identical(other.error, error) || other.error == error)&&(identical(other.message, message) || other.message == message)&&(identical(other.success, success) || other.success == success));
+}
+
+@JsonKey(includeFromJson: false, includeToJson: false)
+@override
+int get hashCode => Object.hash(runtimeType,const DeepCollectionEquality().hash(_data),error,message,success);
+
+@override
+String toString() {
+  return 'RecommendResponse(data: $data, error: $error, message: $message, success: $success)';
+}
+
+
+}
+
+/// @nodoc
+abstract mixin class _$RecommendResponseCopyWith<$Res> implements $RecommendResponseCopyWith<$Res> {
+  factory _$RecommendResponseCopyWith(_RecommendResponse value, $Res Function(_RecommendResponse) _then) = __$RecommendResponseCopyWithImpl;
+@override @useResult
+$Res call({
+@JsonKey(name: 'data') List<RecommendationItem>? data,@JsonKey(name: 'error') ErrorModel? error, String? message, bool? success
+});
+
+
+@override $ErrorModelCopyWith<$Res>? get error;
+
+}
+/// @nodoc
+class __$RecommendResponseCopyWithImpl<$Res>
+    implements _$RecommendResponseCopyWith<$Res> {
+  __$RecommendResponseCopyWithImpl(this._self, this._then);
+
+  final _RecommendResponse _self;
+  final $Res Function(_RecommendResponse) _then;
+
+/// Create a copy of RecommendResponse
+/// with the given fields replaced by the non-null parameter values.
+@override @pragma('vm:prefer-inline') $Res call({Object? data = freezed,Object? error = freezed,Object? message = freezed,Object? success = freezed,}) {
+  return _then(_RecommendResponse(
+data: freezed == data ? _self._data : data // ignore: cast_nullable_to_non_nullable
+as List<RecommendationItem>?,error: freezed == error ? _self.error : error // ignore: cast_nullable_to_non_nullable
+as ErrorModel?,message: freezed == message ? _self.message : message // ignore: cast_nullable_to_non_nullable
+as String?,success: freezed == success ? _self.success : success // ignore: cast_nullable_to_non_nullable
+as bool?,
+  ));
+}
+
+/// Create a copy of RecommendResponse
+/// with the given fields replaced by the non-null parameter values.
+@override
+@pragma('vm:prefer-inline')
+$ErrorModelCopyWith<$Res>? get error {
+    if (_self.error == null) {
+    return null;
+  }
+
+  return $ErrorModelCopyWith<$Res>(_self.error!, (value) {
+    return _then(_self.copyWith(error: value));
+  });
+}
+}
+
+// dart format on

lib/data/services/model/recommend_response/recommend_response.g.dart

@@ -0,0 +1,31 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'recommend_response.dart';
+
+// **************************************************************************
+// JsonSerializableGenerator
+// **************************************************************************
+
+_RecommendResponse _$RecommendResponseFromJson(Map<String, dynamic> json) =>
+    _RecommendResponse(
+      data:
+          (json['data'] as List<dynamic>?)
+              ?.map(
+                (e) => RecommendationItem.fromJson(e as Map<String, dynamic>),
+              )
+              .toList(),
+      error:
+          json['error'] == null
+              ? null
+              : ErrorModel.fromJson(json['error'] as Map<String, dynamic>),
+      message: json['message'] as String?,
+      success: json['success'] as bool?,
+    );
+
+Map<String, dynamic> _$RecommendResponseToJson(_RecommendResponse instance) =>
+    <String, dynamic>{
+      'data': instance.data?.map((e) => e.toJson()).toList(),
+      'error': instance.error?.toJson(),
+      'message': instance.message,
+      'success': instance.success,
+    };

lib/data/services/model/recommendation_item/recommendation_item.dart

@@ -0,0 +1,24 @@
+// ignore_for_file: invalid_annotation_target
+
+import 'package:freezed_annotation/freezed_annotation.dart';
+
+part 'recommendation_item.freezed.dart';
+part 'recommendation_item.g.dart';
+
+/// A single AI tender recommendation returned by `POST /api/v1/recommend`.
+///
+/// [tenderId] is the backend tender id used with
+/// `GET /api/v1/tenders/details/:id`. [rank] is a display order string where
+/// `1` is the best match. All fields are nullable to stay resilient to partial
+/// API payloads.
+@freezed
+abstract class RecommendationItem with _$RecommendationItem {
+  const factory RecommendationItem({
+    required String? rank,
+    @JsonKey(name: 'tender_id') required String? tenderId,
+    required String? analysis,
+  }) = _RecommendationItem;
+
+  factory RecommendationItem.fromJson(Map<String, dynamic> json) =>
+      _$RecommendationItemFromJson(json);
+}

lib/data/services/model/recommendation_item/recommendation_item.freezed.dart

@@ -0,0 +1,283 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+// coverage:ignore-file
+// ignore_for_file: type=lint
+// ignore_for_file: unused_element, deprecated_member_use, deprecated_member_use_from_same_package, use_function_type_syntax_for_parameters, unnecessary_const, avoid_init_to_null, invalid_override_different_default_values_named, prefer_expression_function_bodies, annotate_overrides, invalid_annotation_target, unnecessary_question_mark
+
+part of 'recommendation_item.dart';
+
+// **************************************************************************
+// FreezedGenerator
+// **************************************************************************
+
+// dart format off
+T _$identity<T>(T value) => value;
+
+/// @nodoc
+mixin _$RecommendationItem {
+
+ String? get rank;@JsonKey(name: 'tender_id') String? get tenderId; String? get analysis;
+/// Create a copy of RecommendationItem
+/// with the given fields replaced by the non-null parameter values.
+@JsonKey(includeFromJson: false, includeToJson: false)
+@pragma('vm:prefer-inline')
+$RecommendationItemCopyWith<RecommendationItem> get copyWith => _$RecommendationItemCopyWithImpl<RecommendationItem>(this as RecommendationItem, _$identity);
+
+  /// Serializes this RecommendationItem to a JSON map.
+  Map<String, dynamic> toJson();
+
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is RecommendationItem&&(identical(other.rank, rank) || other.rank == rank)&&(identical(other.tenderId, tenderId) || other.tenderId == tenderId)&&(identical(other.analysis, analysis) || other.analysis == analysis));
+}
+
+@JsonKey(includeFromJson: false, includeToJson: false)
+@override
+int get hashCode => Object.hash(runtimeType,rank,tenderId,analysis);
+
+@override
+String toString() {
+  return 'RecommendationItem(rank: $rank, tenderId: $tenderId, analysis: $analysis)';
+}
+
+
+}
+
+/// @nodoc
+abstract mixin class $RecommendationItemCopyWith<$Res>  {
+  factory $RecommendationItemCopyWith(RecommendationItem value, $Res Function(RecommendationItem) _then) = _$RecommendationItemCopyWithImpl;
+@useResult
+$Res call({
+ String? rank,@JsonKey(name: 'tender_id') String? tenderId, String? analysis
+});
+
+
+
+
+}
+/// @nodoc
+class _$RecommendationItemCopyWithImpl<$Res>
+    implements $RecommendationItemCopyWith<$Res> {
+  _$RecommendationItemCopyWithImpl(this._self, this._then);
+
+  final RecommendationItem _self;
+  final $Res Function(RecommendationItem) _then;
+
+/// Create a copy of RecommendationItem
+/// with the given fields replaced by the non-null parameter values.
+@pragma('vm:prefer-inline') @override $Res call({Object? rank = freezed,Object? tenderId = freezed,Object? analysis = freezed,}) {
+  return _then(_self.copyWith(
+rank: freezed == rank ? _self.rank : rank // ignore: cast_nullable_to_non_nullable
+as String?,tenderId: freezed == tenderId ? _self.tenderId : tenderId // ignore: cast_nullable_to_non_nullable
+as String?,analysis: freezed == analysis ? _self.analysis : analysis // ignore: cast_nullable_to_non_nullable
+as String?,
+  ));
+}
+
+}
+
+
+/// Adds pattern-matching-related methods to [RecommendationItem].
+extension RecommendationItemPatterns on RecommendationItem {
+/// A variant of `map` that fallback to returning `orElse`.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case _:
+///     return orElse();
+/// }
+/// ```
+
+@optionalTypeArgs TResult maybeMap<TResult extends Object?>(TResult Function( _RecommendationItem value)?  $default,{required TResult orElse(),}){
+final _that = this;
+switch (_that) {
+case _RecommendationItem() when $default != null:
+return $default(_that);case _:
+  return orElse();
+
+}
+}
+/// A `switch`-like method, using callbacks.
+///
+/// Callbacks receives the raw object, upcasted.
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case final Subclass2 value:
+///     return ...;
+/// }
+/// ```
+
+@optionalTypeArgs TResult map<TResult extends Object?>(TResult Function( _RecommendationItem value)  $default,){
+final _that = this;
+switch (_that) {
+case _RecommendationItem():
+return $default(_that);case _:
+  throw StateError('Unexpected subclass');
+
+}
+}
+/// A variant of `map` that fallback to returning `null`.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case _:
+///     return null;
+/// }
+/// ```
+
+@optionalTypeArgs TResult? mapOrNull<TResult extends Object?>(TResult? Function( _RecommendationItem value)?  $default,){
+final _that = this;
+switch (_that) {
+case _RecommendationItem() when $default != null:
+return $default(_that);case _:
+  return null;
+
+}
+}
+/// A variant of `when` that fallback to an `orElse` callback.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case _:
+///     return orElse();
+/// }
+/// ```
+
+@optionalTypeArgs TResult maybeWhen<TResult extends Object?>(TResult Function( String? rank, @JsonKey(name: 'tender_id')  String? tenderId,  String? analysis)?  $default,{required TResult orElse(),}) {final _that = this;
+switch (_that) {
+case _RecommendationItem() when $default != null:
+return $default(_that.rank,_that.tenderId,_that.analysis);case _:
+  return orElse();
+
+}
+}
+/// A `switch`-like method, using callbacks.
+///
+/// As opposed to `map`, this offers destructuring.
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case Subclass2(:final field2):
+///     return ...;
+/// }
+/// ```
+
+@optionalTypeArgs TResult when<TResult extends Object?>(TResult Function( String? rank, @JsonKey(name: 'tender_id')  String? tenderId,  String? analysis)  $default,) {final _that = this;
+switch (_that) {
+case _RecommendationItem():
+return $default(_that.rank,_that.tenderId,_that.analysis);case _:
+  throw StateError('Unexpected subclass');
+
+}
+}
+/// A variant of `when` that fallback to returning `null`
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case _:
+///     return null;
+/// }
+/// ```
+
+@optionalTypeArgs TResult? whenOrNull<TResult extends Object?>(TResult? Function( String? rank, @JsonKey(name: 'tender_id')  String? tenderId,  String? analysis)?  $default,) {final _that = this;
+switch (_that) {
+case _RecommendationItem() when $default != null:
+return $default(_that.rank,_that.tenderId,_that.analysis);case _:
+  return null;
+
+}
+}
+
+}
+
+/// @nodoc
+@JsonSerializable()
+
+class _RecommendationItem implements RecommendationItem {
+  const _RecommendationItem({required this.rank, @JsonKey(name: 'tender_id') required this.tenderId, required this.analysis});
+  factory _RecommendationItem.fromJson(Map<String, dynamic> json) => _$RecommendationItemFromJson(json);
+
+@override final  String? rank;
+@override@JsonKey(name: 'tender_id') final  String? tenderId;
+@override final  String? analysis;
+
+/// Create a copy of RecommendationItem
+/// with the given fields replaced by the non-null parameter values.
+@override @JsonKey(includeFromJson: false, includeToJson: false)
+@pragma('vm:prefer-inline')
+_$RecommendationItemCopyWith<_RecommendationItem> get copyWith => __$RecommendationItemCopyWithImpl<_RecommendationItem>(this, _$identity);
+
+@override
+Map<String, dynamic> toJson() {
+  return _$RecommendationItemToJson(this, );
+}
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is _RecommendationItem&&(identical(other.rank, rank) || other.rank == rank)&&(identical(other.tenderId, tenderId) || other.tenderId == tenderId)&&(identical(other.analysis, analysis) || other.analysis == analysis));
+}
+
+@JsonKey(includeFromJson: false, includeToJson: false)
+@override
+int get hashCode => Object.hash(runtimeType,rank,tenderId,analysis);
+
+@override
+String toString() {
+  return 'RecommendationItem(rank: $rank, tenderId: $tenderId, analysis: $analysis)';
+}
+
+
+}
+
+/// @nodoc
+abstract mixin class _$RecommendationItemCopyWith<$Res> implements $RecommendationItemCopyWith<$Res> {
+  factory _$RecommendationItemCopyWith(_RecommendationItem value, $Res Function(_RecommendationItem) _then) = __$RecommendationItemCopyWithImpl;
+@override @useResult
+$Res call({
+ String? rank,@JsonKey(name: 'tender_id') String? tenderId, String? analysis
+});
+
+
+
+
+}
+/// @nodoc
+class __$RecommendationItemCopyWithImpl<$Res>
+    implements _$RecommendationItemCopyWith<$Res> {
+  __$RecommendationItemCopyWithImpl(this._self, this._then);
+
+  final _RecommendationItem _self;
+  final $Res Function(_RecommendationItem) _then;
+
+/// Create a copy of RecommendationItem
+/// with the given fields replaced by the non-null parameter values.
+@override @pragma('vm:prefer-inline') $Res call({Object? rank = freezed,Object? tenderId = freezed,Object? analysis = freezed,}) {
+  return _then(_RecommendationItem(
+rank: freezed == rank ? _self.rank : rank // ignore: cast_nullable_to_non_nullable
+as String?,tenderId: freezed == tenderId ? _self.tenderId : tenderId // ignore: cast_nullable_to_non_nullable
+as String?,analysis: freezed == analysis ? _self.analysis : analysis // ignore: cast_nullable_to_non_nullable
+as String?,
+  ));
+}
+
+
+}
+
+// dart format on

lib/data/services/model/recommendation_item/recommendation_item.g.dart

@@ -0,0 +1,21 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'recommendation_item.dart';
+
+// **************************************************************************
+// JsonSerializableGenerator
+// **************************************************************************
+
+_RecommendationItem _$RecommendationItemFromJson(Map<String, dynamic> json) =>
+    _RecommendationItem(
+      rank: json['rank'] as String?,
+      tenderId: json['tender_id'] as String?,
+      analysis: json['analysis'] as String?,
+    );
+
+Map<String, dynamic> _$RecommendationItemToJson(_RecommendationItem instance) =>
+    <String, dynamic>{
+      'rank': instance.rank,
+      'tender_id': instance.tenderId,
+      'analysis': instance.analysis,
+    };

lib/data/services/model/recommended_tenders_response/recommended_tenders_response.dart

@@ -10,16 +10,13 @@ part 'recommended_tenders_response.g.dart';
 @freezed
 abstract class RecommendedTendersResponse with _$RecommendedTendersResponse {
   @JsonSerializable(explicitToJson: true)
-  const factory 
-RecommendedTendersResponse({
-  required bool? succes,
-  required String? message,
-  required ErrorModel? error,
-  required RecommendedTendersData? data,
-  
+  const factory RecommendedTendersResponse({
+    @JsonKey(name: 'success') required bool? success,
+    required String? message,
+    required ErrorModel? error,
+    required RecommendedTendersData? data,
   }) = _RecommendedTendersResponse;
 
-  factory 
-RecommendedTendersResponse.fromJson(Map<String, dynamic> json) =>
+  factory RecommendedTendersResponse.fromJson(Map<String, dynamic> json) =>
       _$RecommendedTendersResponseFromJson(json);
 }

lib/data/services/model/recommended_tenders_response/recommended_tenders_response.freezed.dart

@@ -15,7 +15,7 @@ T _$identity<T>(T value) => value;
 /// @nodoc
 mixin _$RecommendedTendersResponse {
 
- bool? get succes; String? get message; ErrorModel? get error; RecommendedTendersData? get data;
+ bool? get success; String? get message; ErrorModel? get error; RecommendedTendersData? get data;
 /// Create a copy of RecommendedTendersResponse
 /// with the given fields replaced by the non-null parameter values.
 @JsonKey(includeFromJson: false, includeToJson: false)
@@ -28,16 +28,16 @@ $RecommendedTendersResponseCopyWith<RecommendedTendersResponse> get copyWith =>
 
 @override
 bool operator ==(Object other) {
-  return identical(this, other) || (other.runtimeType == runtimeType&&other is RecommendedTendersResponse&&(identical(other.succes, succes) || other.succes == succes)&&(identical(other.message, message) || other.message == message)&&(identical(other.error, error) || other.error == error)&&(identical(other.data, data) || other.data == data));
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is RecommendedTendersResponse&&(identical(other.success, success) || other.success == success)&&(identical(other.message, message) || other.message == message)&&(identical(other.error, error) || other.error == error)&&(identical(other.data, data) || other.data == data));
 }
 
 @JsonKey(includeFromJson: false, includeToJson: false)
 @override
-int get hashCode => Object.hash(runtimeType,succes,message,error,data);
+int get hashCode => Object.hash(runtimeType,success,message,error,data);
 
 @override
 String toString() {
-  return 'RecommendedTendersResponse(succes: $succes, message: $message, error: $error, data: $data)';
+  return 'RecommendedTendersResponse(success: $success, message: $message, error: $error, data: $data)';
 }
 
 
@@ -48,7 +48,7 @@ abstract mixin class $RecommendedTendersResponseCopyWith<$Res>  {
   factory $RecommendedTendersResponseCopyWith(RecommendedTendersResponse value, $Res Function(RecommendedTendersResponse) _then) = _$RecommendedTendersResponseCopyWithImpl;
 @useResult
 $Res call({
- bool? succes, String? message, ErrorModel? error, RecommendedTendersData? data
+ bool? success, String? message, ErrorModel? error, RecommendedTendersData? data
 });
 
 
@@ -65,9 +65,9 @@ class _$RecommendedTendersResponseCopyWithImpl<$Res>
 
 /// Create a copy of RecommendedTendersResponse
 /// with the given fields replaced by the non-null parameter values.
-@pragma('vm:prefer-inline') @override $Res call({Object? succes = freezed,Object? message = freezed,Object? error = freezed,Object? data = freezed,}) {
+@pragma('vm:prefer-inline') @override $Res call({Object? success = freezed,Object? message = freezed,Object? error = freezed,Object? data = freezed,}) {
   return _then(_self.copyWith(
-succes: freezed == succes ? _self.succes : succes // ignore: cast_nullable_to_non_nullable
+success: freezed == success ? _self.success : success // ignore: cast_nullable_to_non_nullable
 as bool?,message: freezed == message ? _self.message : message // ignore: cast_nullable_to_non_nullable
 as String?,error: freezed == error ? _self.error : error // ignore: cast_nullable_to_non_nullable
 as ErrorModel?,data: freezed == data ? _self.data : data // ignore: cast_nullable_to_non_nullable
@@ -180,10 +180,10 @@ return $default(_that);case _:
 /// }
 /// ```
 
-@optionalTypeArgs TResult maybeWhen<TResult extends Object?>(TResult Function( bool? succes,  String? message,  ErrorModel? error,  RecommendedTendersData? data)?  $default,{required TResult orElse(),}) {final _that = this;
+@optionalTypeArgs TResult maybeWhen<TResult extends Object?>(TResult Function( bool? success,  String? message,  ErrorModel? error,  RecommendedTendersData? data)?  $default,{required TResult orElse(),}) {final _that = this;
 switch (_that) {
 case _RecommendedTendersResponse() when $default != null:
-return $default(_that.succes,_that.message,_that.error,_that.data);case _:
+return $default(_that.success,_that.message,_that.error,_that.data);case _:
   return orElse();
 
 }
@@ -201,10 +201,10 @@ return $default(_that.succes,_that.message,_that.error,_that.data);case _:
 /// }
 /// ```
 
-@optionalTypeArgs TResult when<TResult extends Object?>(TResult Function( bool? succes,  String? message,  ErrorModel? error,  RecommendedTendersData? data)  $default,) {final _that = this;
+@optionalTypeArgs TResult when<TResult extends Object?>(TResult Function( bool? success,  String? message,  ErrorModel? error,  RecommendedTendersData? data)  $default,) {final _that = this;
 switch (_that) {
 case _RecommendedTendersResponse():
-return $default(_that.succes,_that.message,_that.error,_that.data);case _:
+return $default(_that.success,_that.message,_that.error,_that.data);case _:
   throw StateError('Unexpected subclass');
 
 }
@@ -221,10 +221,10 @@ return $default(_that.succes,_that.message,_that.error,_that.data);case _:
 /// }
 /// ```
 
-@optionalTypeArgs TResult? whenOrNull<TResult extends Object?>(TResult? Function( bool? succes,  String? message,  ErrorModel? error,  RecommendedTendersData? data)?  $default,) {final _that = this;
+@optionalTypeArgs TResult? whenOrNull<TResult extends Object?>(TResult? Function( bool? success,  String? message,  ErrorModel? error,  RecommendedTendersData? data)?  $default,) {final _that = this;
 switch (_that) {
 case _RecommendedTendersResponse() when $default != null:
-return $default(_that.succes,_that.message,_that.error,_that.data);case _:
+return $default(_that.success,_that.message,_that.error,_that.data);case _:
   return null;
 
 }
@@ -236,10 +236,10 @@ return $default(_that.succes,_that.message,_that.error,_that.data);case _:
 
 @JsonSerializable(explicitToJson: true)
 class _RecommendedTendersResponse implements RecommendedTendersResponse {
-  const _RecommendedTendersResponse({required this.succes, required this.message, required this.error, required this.data});
+  const _RecommendedTendersResponse({required this.success, required this.message, required this.error, required this.data});
   factory _RecommendedTendersResponse.fromJson(Map<String, dynamic> json) => _$RecommendedTendersResponseFromJson(json);
 
-@override final  bool? succes;
+@override final  bool? success;
 @override final  String? message;
 @override final  ErrorModel? error;
 @override final  RecommendedTendersData? data;
@@ -257,16 +257,16 @@ Map<String, dynamic> toJson() {
 
 @override
 bool operator ==(Object other) {
-  return identical(this, other) || (other.runtimeType == runtimeType&&other is _RecommendedTendersResponse&&(identical(other.succes, succes) || other.succes == succes)&&(identical(other.message, message) || other.message == message)&&(identical(other.error, error) || other.error == error)&&(identical(other.data, data) || other.data == data));
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is _RecommendedTendersResponse&&(identical(other.success, success) || other.success == success)&&(identical(other.message, message) || other.message == message)&&(identical(other.error, error) || other.error == error)&&(identical(other.data, data) || other.data == data));
 }
 
 @JsonKey(includeFromJson: false, includeToJson: false)
 @override
-int get hashCode => Object.hash(runtimeType,succes,message,error,data);
+int get hashCode => Object.hash(runtimeType,success,message,error,data);
 
 @override
 String toString() {
-  return 'RecommendedTendersResponse(succes: $succes, message: $message, error: $error, data: $data)';
+  return 'RecommendedTendersResponse(success: $success, message: $message, error: $error, data: $data)';
 }
 
 
@@ -277,7 +277,7 @@ abstract mixin class _$RecommendedTendersResponseCopyWith<$Res> implements $Reco
   factory _$RecommendedTendersResponseCopyWith(_RecommendedTendersResponse value, $Res Function(_RecommendedTendersResponse) _then) = __$RecommendedTendersResponseCopyWithImpl;
 @override @useResult
 $Res call({
- bool? succes, String? message, ErrorModel? error, RecommendedTendersData? data
+ bool? success, String? message, ErrorModel? error, RecommendedTendersData? data
 });
 
 
@@ -294,9 +294,9 @@ class __$RecommendedTendersResponseCopyWithImpl<$Res>
 
 /// Create a copy of RecommendedTendersResponse
 /// with the given fields replaced by the non-null parameter values.
-@override @pragma('vm:prefer-inline') $Res call({Object? succes = freezed,Object? message = freezed,Object? error = freezed,Object? data = freezed,}) {
+@override @pragma('vm:prefer-inline') $Res call({Object? success = freezed,Object? message = freezed,Object? error = freezed,Object? data = freezed,}) {
   return _then(_RecommendedTendersResponse(
-succes: freezed == succes ? _self.succes : succes // ignore: cast_nullable_to_non_nullable
+success: freezed == success ? _self.success : success // ignore: cast_nullable_to_non_nullable
 as bool?,message: freezed == message ? _self.message : message // ignore: cast_nullable_to_non_nullable
 as String?,error: freezed == error ? _self.error : error // ignore: cast_nullable_to_non_nullable
 as ErrorModel?,data: freezed == data ? _self.data : data // ignore: cast_nullable_to_non_nullable

lib/data/services/model/recommended_tenders_response/recommended_tenders_response.g.dart

@@ -9,7 +9,7 @@ part of 'recommended_tenders_response.dart';
 _RecommendedTendersResponse _$RecommendedTendersResponseFromJson(
   Map<String, dynamic> json,
 ) => _RecommendedTendersResponse(
-  succes: json['succes'] as bool?,
+  success: json['success'] as bool?,
   message: json['message'] as String?,
   error:
       json['error'] == null
@@ -26,7 +26,7 @@ _RecommendedTendersResponse _$RecommendedTendersResponseFromJson(
 Map<String, dynamic> _$RecommendedTendersResponseToJson(
   _RecommendedTendersResponse instance,
 ) => <String, dynamic>{
-  'succes': instance.succes,
+  'success': instance.success,
   'message': instance.message,
   'error': instance.error?.toJson(),
   'data': instance.data?.toJson(),

lib/data/services/model/tender_submission/tender_submission.dart

@@ -0,0 +1,235 @@
+import 'package:tm_app/core/utils/date_utils.dart';
+import 'package:tm_app/data/services/model/tender_data/tender_data.dart';
+
+class TenderSubmissionResponse {
+  const TenderSubmissionResponse({
+    required this.success,
+    required this.message,
+    required this.data,
+  });
+
+  final bool success;
+  final String? message;
+  final TenderSubmission? data;
+
+  factory TenderSubmissionResponse.fromJson(Map<String, dynamic> json) {
+    final data = json['data'];
+    return TenderSubmissionResponse(
+      success: json['success'] == true,
+      message: json['message'] as String?,
+      data:
+          data is Map<String, dynamic> ? TenderSubmission.fromJson(data) : null,
+    );
+  }
+}
+
+class TenderSubmissionsResponse {
+  const TenderSubmissionsResponse({
+    required this.success,
+    required this.message,
+    required this.data,
+    required this.meta,
+  });
+
+  final bool success;
+  final String? message;
+  final List<TenderSubmission> data;
+  final TenderSubmissionsMeta? meta;
+
+  factory TenderSubmissionsResponse.fromJson(Map<String, dynamic> json) {
+    final items = json['data'];
+    return TenderSubmissionsResponse(
+      success: json['success'] == true,
+      message: json['message'] as String?,
+      data:
+          items is List
+              ? items
+                  .whereType<Map>()
+                  .map(
+                    (item) => TenderSubmission.fromJson(
+                      Map<String, dynamic>.from(item),
+                    ),
+                  )
+                  .toList()
+              : const [],
+      meta:
+          json['meta'] is Map
+              ? TenderSubmissionsMeta.fromJson(
+                Map<String, dynamic>.from(json['meta'] as Map),
+              )
+              : null,
+    );
+  }
+}
+
+class TenderSubmission {
+  const TenderSubmission({
+    required this.id,
+    required this.tenderId,
+    required this.companyId,
+    required this.customerId,
+    required this.status,
+    required this.stage,
+    required this.submissionMode,
+    required this.statusHistory,
+    required this.createdAt,
+    required this.updatedAt,
+    required this.tender,
+  });
+
+  final String id;
+  final String tenderId;
+  final String? companyId;
+  final String? customerId;
+  final String status;
+  final String stage;
+  final String? submissionMode;
+  final List<TenderSubmissionHistory> statusHistory;
+  final int? createdAt;
+  final int? updatedAt;
+  final TenderData? tender;
+
+  bool get isTerminal =>
+      status == 'rejected' || status == 'contract' || status == 'not_applied';
+
+  factory TenderSubmission.fromJson(Map<String, dynamic> json) {
+    final history = json['status_history'];
+    final tenderJson = json['tender'];
+    return TenderSubmission(
+      id: json['id']?.toString() ?? '',
+      tenderId: json['tender_id']?.toString() ?? '',
+      companyId: json['company_id']?.toString(),
+      customerId: json['customer_id']?.toString(),
+      status: json['status']?.toString() ?? 'opportunity',
+      stage: json['stage']?.toString() ?? 'opportunity',
+      submissionMode: json['submission_mode']?.toString(),
+      statusHistory:
+          history is List
+              ? history
+                  .whereType<Map>()
+                  .map(
+                    (item) => TenderSubmissionHistory.fromJson(
+                      Map<String, dynamic>.from(item),
+                    ),
+                  )
+                  .toList()
+              : const [],
+      createdAt: unixTimestampFromJson(json['created_at']),
+      updatedAt: unixTimestampFromJson(json['updated_at']),
+      tender:
+          tenderJson is Map
+              ? TenderData.fromJson(Map<String, dynamic>.from(tenderJson))
+              : null,
+    );
+  }
+}
+
+class TenderSubmissionHistory {
+  const TenderSubmissionHistory({
+    required this.status,
+    required this.reason,
+    required this.changedBy,
+    required this.changedAt,
+    required this.description,
+  });
+
+  final String status;
+  final String? reason;
+  final String? changedBy;
+  final int? changedAt;
+  final String? description;
+
+  factory TenderSubmissionHistory.fromJson(Map<String, dynamic> json) {
+    return TenderSubmissionHistory(
+      status: json['status']?.toString() ?? '',
+      reason: json['reason']?.toString(),
+      changedBy: json['changed_by']?.toString(),
+      changedAt: unixTimestampFromJson(json['changed_at']),
+      description: json['description']?.toString(),
+    );
+  }
+}
+
+class TenderSubmissionsMeta {
+  const TenderSubmissionsMeta({
+    required this.total,
+    required this.limit,
+    required this.offset,
+    required this.page,
+    required this.pages,
+    required this.hasMore,
+  });
+
+  final int total;
+  final int limit;
+  final int offset;
+  final int page;
+  final int pages;
+  final bool hasMore;
+
+  factory TenderSubmissionsMeta.fromJson(Map<String, dynamic> json) {
+    int number(String key) => (json[key] as num?)?.toInt() ?? 0;
+    return TenderSubmissionsMeta(
+      total: number('total'),
+      limit: number('limit'),
+      offset: number('offset'),
+      page: number('page'),
+      pages: number('pages'),
+      hasMore: json['has_more'] == true,
+    );
+  }
+}
+
+class TenderSubmissionStatsResponse {
+  const TenderSubmissionStatsResponse({
+    required this.success,
+    required this.data,
+  });
+
+  final bool success;
+  final TenderSubmissionStats? data;
+
+  factory TenderSubmissionStatsResponse.fromJson(Map<String, dynamic> json) {
+    return TenderSubmissionStatsResponse(
+      success: json['success'] == true,
+      data:
+          json['data'] is Map
+              ? TenderSubmissionStats.fromJson(
+                Map<String, dynamic>.from(json['data'] as Map),
+              )
+              : null,
+    );
+  }
+}
+
+class TenderSubmissionStats {
+  const TenderSubmissionStats({
+    required this.companyId,
+    required this.total,
+    required this.byStage,
+    required this.byStatus,
+    required this.lastUpdated,
+  });
+
+  final String? companyId;
+  final int total;
+  final Map<String, int> byStage;
+  final Map<String, int> byStatus;
+  final int? lastUpdated;
+
+  factory TenderSubmissionStats.fromJson(Map<String, dynamic> json) {
+    Map<String, int> counts(value) =>
+        value is Map
+            ? value.map(
+              (key, value) => MapEntry(key.toString(), (value as num).toInt()),
+            )
+            : const {};
+    return TenderSubmissionStats(
+      companyId: json['company_id']?.toString(),
+      total: (json['total'] as num?)?.toInt() ?? 0,
+      byStage: counts(json['by_stage']),
+      byStatus: counts(json['by_status']),
+      lastUpdated: unixTimestampFromJson(json['last_updated']),
+    );
+  }
+}

lib/data/services/tender_submissions_service.dart

@@ -0,0 +1,84 @@
+import 'package:tm_app/core/network/network_manager.dart';
+import 'package:tm_app/core/utils/result.dart';
+import 'package:tm_app/data/services/api/tender_submissions_api.dart';
+import 'package:tm_app/data/services/model/tender_submission/tender_submission.dart';
+
+class TenderSubmissionsService {
+  TenderSubmissionsService({required NetworkManager networkManager})
+    : _networkManager = networkManager;
+
+  final NetworkManager _networkManager;
+
+  Future<Result<TenderSubmissionsResponse>> getSubmissions({
+    List<String>? statuses,
+    List<String>? stages,
+    int? createdFrom,
+    int? createdTo,
+    int limit = 20,
+    int offset = 0,
+    String sortBy = 'updated_at',
+    String sortOrder = 'desc',
+  }) {
+    return _networkManager.makeRequest(
+      TenderSubmissionsApi.list,
+      TenderSubmissionsResponse.fromJson,
+      queryParameters: {
+        if (statuses?.isNotEmpty == true) 'status': statuses,
+        if (stages?.isNotEmpty == true) 'stage': stages,
+        if (createdFrom != null) 'created_from': createdFrom,
+        if (createdTo != null) 'created_to': createdTo,
+        'limit': limit,
+        'offset': offset,
+        'sort_by': sortBy,
+        'sort_order': sortOrder,
+      },
+    );
+  }
+
+  Future<Result<TenderSubmissionResponse>> getById(String id) =>
+      _networkManager.makeRequest(
+        TenderSubmissionsApi.byId(id),
+        TenderSubmissionResponse.fromJson,
+      );
+
+  Future<Result<TenderSubmissionResponse>> getByTender(String tenderId) =>
+      _networkManager.makeRequest(
+        TenderSubmissionsApi.byTender(tenderId),
+        TenderSubmissionResponse.fromJson,
+      );
+
+  Future<Result<TenderSubmissionResponse>> ensure(
+    String tenderId, {
+    String? companyId,
+  }) => _networkManager.makeRequest(
+    TenderSubmissionsApi.ensure(tenderId),
+    TenderSubmissionResponse.fromJson,
+    method: 'POST',
+    queryParameters: {
+      if (companyId?.isNotEmpty == true) 'company_id': companyId,
+    },
+  );
+
+  Future<Result<TenderSubmissionResponse>> updateStatus({
+    required String id,
+    required String status,
+    String? reason,
+    String? description,
+  }) => _networkManager.makeRequest(
+    TenderSubmissionsApi.status(id),
+    TenderSubmissionResponse.fromJson,
+    method: 'PATCH',
+    data: {
+      'status': status,
+      if (reason?.trim().isNotEmpty == true) 'reason': reason!.trim(),
+      if (description?.trim().isNotEmpty == true)
+        'description': description!.trim(),
+    },
+  );
+
+  Future<Result<TenderSubmissionStatsResponse>> getStats() =>
+      _networkManager.makeRequest(
+        TenderSubmissionsApi.stats,
+        TenderSubmissionStatsResponse.fromJson,
+      );
+}

lib/view_models/ai_recommendations_view_model.dart

@@ -0,0 +1,100 @@
+import 'package:flutter/foundation.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/recommended_tenders_response/recommended_tenders_response.dart';
+import 'package:tm_app/data/services/model/tender_data/tender_data.dart';
+
+/// Drives the "Recommended" tab in the tenders section.
+///
+/// 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,
+    required HomeRepository homeRepository,
+  }) : _companyAiRepository = companyAiRepository,
+       _homeRepository = homeRepository;
+
+  final CompanyAiRepository _companyAiRepository;
+  final HomeRepository _homeRepository;
+
+  /// How long after onboarding an empty result is treated as "still learning".
+  static const Duration _stillLearningWindow = Duration(minutes: 30);
+  static const int _pageSize = 20;
+
+  bool _isLoading = false;
+  String? _errorMessage;
+  List<TenderData> _recommendedTenders = const [];
+  bool _stillLearning = false;
+  bool _hasLoaded = false;
+
+  bool get isLoading => _isLoading;
+  String? get errorMessage => _errorMessage;
+  List<TenderData> get recommendedTenders => _recommendedTenders;
+  bool get stillLearning => _stillLearning;
+
+  /// True once a load has completed (used to distinguish "no results" from
+  /// "not loaded yet").
+  bool get hasLoaded => _hasLoaded;
+
+  /// True when there is nothing to show and we're not loading or erroring.
+  bool get isEmpty =>
+      !_isLoading &&
+      _errorMessage == null &&
+      _recommendedTenders.isEmpty;
+
+  /// Loads recommendations if they haven't been loaded yet this session.
+  Future<void> loadIfNeeded() async {
+    if (_hasLoaded || _isLoading) {
+      return;
+    }
+    await loadRecommendations();
+  }
+
+  /// Loads recommended tenders for the Recommended tab.
+  Future<void> loadRecommendations() async {
+    _isLoading = true;
+    _errorMessage = null;
+    _stillLearning = false;
+    notifyListeners();
+
+    final result = await _homeRepository.getHomeRecommendedTenders(
+      limit: _pageSize,
+      offset: 0,
+    );
+
+    var loadedSuccessfully = false;
+
+    switch (result) {
+      case Ok<RecommendedTendersResponse>():
+        _recommendedTenders =
+            result.value.data?.tenders.whereType<TenderData>().toList() ??
+            const [];
+        if (_recommendedTenders.isEmpty) {
+          _stillLearning = _onboardingWasRecent();
+        }
+        loadedSuccessfully = true;
+      case Error<RecommendedTendersResponse>():
+        _recommendedTenders = const [];
+        _errorMessage = result.error.toString();
+    }
+
+    _isLoading = false;
+    _hasLoaded = loadedSuccessfully;
+    notifyListeners();
+  }
+
+  /// Pull-to-refresh: always re-fetches.
+  Future<void> refresh() => loadRecommendations();
+
+  bool _onboardingWasRecent() {
+    final startedAt = _companyAiRepository.lastOnboardingStartedAt();
+    if (startedAt == null) {
+      return false;
+    }
+    final elapsed = DateTime.now().millisecondsSinceEpoch - startedAt;
+    return elapsed >= 0 && elapsed <= _stillLearningWindow.inMilliseconds;
+  }
+}

lib/view_models/home_view_model.dart

@@ -4,6 +4,8 @@ import 'package:tm_app/data/services/model/recommended_tenders_response/recommen
 import 'package:tm_app/data/services/model/tender_approvals_response/tender_approvals_response.dart';
 import 'package:tm_app/data/services/model/tender_approvals_stats_response/tender_approvals_stats_response.dart';
 import 'package:tm_app/data/services/model/tender_data/tender_data.dart';
+import 'package:tm_app/data/services/model/feedback_stats_response/feedback_stat_response.dart';
+import 'package:tm_app/data/services/model/tender_submission/tender_submission.dart';
 
 import '../data/repositories/home_repository.dart';
 import '../data/services/model/home/home_response/home_response_model.dart';
@@ -44,6 +46,7 @@ class HomeViewModel with ChangeNotifier {
 
   RecommendedTendersResponse? _recommendedTendersResponse;
   TenderApprovalsStatsResponse? tenderApprovalsStateResponse;
+  TenderSubmissionStats? tenderSubmissionStats;
   int userLikedTendersCount = 0;
   final List<TenderData> _tenders = [];
   final int _pageSize = 10;
@@ -71,11 +74,15 @@ class HomeViewModel with ChangeNotifier {
     _isRecommendedMode = false;
     data = null;
     tenderApprovalsStateResponse = null;
+    tenderSubmissionStats = null;
     notifyListeners();
 
-    await getApprovedStates();
-    await getYourTenders(reset: true);
-    await loadUserLikedTendersCount();
+    await Future.wait([
+      getApprovedStates(),
+      getYourTenders(reset: true),
+      loadUserLikedTendersCount(),
+      loadSubmissionStats(),
+    ]);
 
     if (_errorMessage != null) {
       _isLoading = false;
@@ -199,19 +206,38 @@ class HomeViewModel with ChangeNotifier {
   }
 
   Future<void> loadUserLikedTendersCount() async {
-    final result = await _homeRepository.getUserLikedTendersCount();
+    final result = await _homeRepository.getCustomerFeedbackStats();
 
     switch (result) {
-      case Ok<int>():
-        userLikedTendersCount = result.value;
+      case Ok<FeedbackStatResponse>():
+        userLikedTendersCount = result.value.data?.totalLikes ?? 0;
         break;
-      case Error<int>():
+      case Error<FeedbackStatResponse>():
         userLikedTendersCount = 0;
         break;
     }
     notifyListeners();
   }
 
+  Future<void> loadSubmissionStats() async {
+    final result = await _homeRepository.getSubmissionStats();
+    switch (result) {
+      case Ok<TenderSubmissionStatsResponse>():
+        tenderSubmissionStats = result.value.data;
+        break;
+      case Error<TenderSubmissionStatsResponse>():
+        tenderSubmissionStats = null;
+        break;
+    }
+    notifyListeners();
+  }
+
+  int get approvedTendersCount =>
+      tenderApprovalsStateResponse?.data?.submittedTenders ?? 0;
+
+  int get submittedTendersCount =>
+      tenderSubmissionStats?.byStage['submitted'] ?? 0;
+
   double get partnershipCount {
     return tenderApprovalsStateResponse?.data?.partnershipCount?.toDouble() ??
         0.0;

lib/view_models/notification_view_model.dart

@@ -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,

lib/view_models/profile_view_model.dart

@@ -1,5 +1,8 @@
+import 'dart:async';
+
 import 'package:flutter/material.dart';
 import 'package:tm_app/data/repositories/auth_repository.dart';
+import 'package:tm_app/data/repositories/company_ai_repository.dart';
 import 'package:tm_app/data/services/model/company_profile_data/company_profile_data.dart';
 import 'package:tm_app/data/services/model/company_profile_response/company_profile_response.dart';
 import 'package:tm_app/data/services/model/profile_data/profile_data.dart';
@@ -12,12 +15,15 @@ import '../data/services/model/profile_response/profile_response.dart';
 class ProfileViewModel with ChangeNotifier {
   final ProfileRepository _profileRepository;
   final AuthRepository _authRepository;
+  final CompanyAiRepository _companyAiRepository;
 
   ProfileViewModel({
     required ProfileRepository profileRepository,
     required AuthRepository authRepository,
+    required CompanyAiRepository companyAiRepository,
   }) : _profileRepository = profileRepository,
-       _authRepository = authRepository;
+       _authRepository = authRepository,
+       _companyAiRepository = companyAiRepository;
 
   bool _isLoading = false;
   String? _errorMessage;
@@ -62,6 +68,7 @@ class ProfileViewModel with ChangeNotifier {
     switch (result) {
       case Ok<CompanyProfileResponse>():
         _companyProfileData = result.value.data;
+        _maybeStartAiOnboarding(_companyProfileData);
         break;
       case Error<CompanyProfileResponse>():
         _errorMessage = result.error.toString();
@@ -73,6 +80,22 @@ class ProfileViewModel with ChangeNotifier {
     notifyListeners();
   }
 
+  /// Best-effort AI onboarding once the company profile is ready. Fire-and-
+  /// forget: onboarding is asynchronous on the AI side and the fingerprint
+  /// guard in [CompanyAiRepository] keeps it from re-running unnecessarily, so
+  /// the profile screen never blocks or surfaces errors for it.
+  void _maybeStartAiOnboarding(CompanyProfileData? company) {
+    if (company == null) {
+      return;
+    }
+    unawaited(
+      _companyAiRepository.maybeStartOnboarding(
+        documentFileIds: company.documentFileIds ?? const [],
+        website: company.website,
+      ),
+    );
+  }
+
   Future<void> logout() async {
     _errorMessage = null;
     notifyListeners();

lib/view_models/tenders_view_model.dart

@@ -2,6 +2,7 @@ import 'package:flutter/material.dart';
 import 'package:intl/intl.dart';
 import 'package:tm_app/core/utils/device_utils.dart';
 import 'package:tm_app/core/utils/logger.dart';
+import 'package:tm_app/core/network/app_exceptions.dart';
 import 'package:tm_app/data/repositories/tenders_repository.dart';
 import 'package:tm_app/data/services/model/feedback_data/feedback_data.dart';
 import 'package:tm_app/data/services/model/feedback_response/feedback_response.dart';
@@ -36,6 +37,12 @@ class TendersViewModel with ChangeNotifier {
   String? get searchQuery => _searchQuery;
 
   List<FeedbackData> feedbacks = [];
+  final Set<String> _hydratedFeedbackTenderIds = <String>{};
+  final Set<String> _feedbackHydrationsInFlight = <String>{};
+  final Set<String> _feedbackRequestsInFlight = <String>{};
+
+  bool isFeedbackLoading(String tenderId) =>
+      _feedbackRequestsInFlight.contains(tenderId);
 
   static const int _pageSize = 10;
 
@@ -207,8 +214,7 @@ class TendersViewModel with ChangeNotifier {
           _currentOffset = meta!.offset!;
         }
         final tenders = _tendersResponse?.data?.tenders ?? [];
-        _hasMoreData =
-            meta?.hasMore ?? (tenders.length >= _pageSize);
+        _hasMoreData = meta?.hasMore ?? (tenders.length >= _pageSize);
         if (tenders.isNotEmpty) {
           if (fetchAllFeedbacks) {
             for (final tender in tenders) {
@@ -263,8 +269,13 @@ class TendersViewModel with ChangeNotifier {
             data: result.value.data?.copyWith(tenders: combined),
           );
           final newMeta = result.value.meta;
-          _hasMoreData =
-              newMeta?.hasMore ?? (newTenders.length >= _pageSize);
+          _hasMoreData = newMeta?.hasMore ?? (newTenders.length >= _pageSize);
+          for (final tender in newTenders) {
+            final id = tender.id;
+            if (id != null && !_hydratedFeedbackTenderIds.contains(id)) {
+              getTenderFeedback(id);
+            }
+          }
         } else {
           _hasMoreData = false;
         }
@@ -283,14 +294,18 @@ class TendersViewModel with ChangeNotifier {
   }
 
   Future<void> getTenderFeedback(String tenderId) async {
-    _errorMessage = null;
-    notifyListeners();
+    if (_hydratedFeedbackTenderIds.contains(tenderId) ||
+        _feedbackHydrationsInFlight.contains(tenderId)) {
+      return;
+    }
+    _feedbackHydrationsInFlight.add(tenderId);
 
     final result = await _tendersRepository.getTenderFeedback(
       tenderId: tenderId,
     );
     switch (result) {
       case Ok<FeedbackResponse>():
+        _hydratedFeedbackTenderIds.add(tenderId);
         _feedbackData = result.value.data;
         if (_feedbackData != null) {
           final index = feedbacks.indexWhere(
@@ -311,19 +326,33 @@ class TendersViewModel with ChangeNotifier {
         }
         break;
       case Error<FeedbackResponse>():
-        _errorMessage = result.error.toString();
+        if (result.error is NotFoundException) {
+          // A 404 is the expected representation of neutral feedback state.
+          feedbacks.removeWhere((feedback) => feedback.tenderId == tenderId);
+          _hydratedFeedbackTenderIds.add(tenderId);
+        } else {
+          _feedbackErrorMessage = result.error.toString();
+        }
         break;
     }
+    _feedbackHydrationsInFlight.remove(tenderId);
     notifyListeners();
-    _errorMessage = null;
-    notifyListeners();
+    if (_feedbackErrorMessage != null) {
+      _feedbackErrorMessage = null;
+      notifyListeners();
+    }
   }
 
-  Future<void> toogleFeedback({
+  Future<void> toggleFeedback({
     required String tenderId,
     required String feedbackType,
   }) async {
+    if (_feedbackRequestsInFlight.contains(tenderId)) {
+      return;
+    }
+
     _feedbackErrorMessage = null;
+    _feedbackRequestsInFlight.add(tenderId);
 
     final existingFeedback = getFeedbackForTender(tenderId);
     final existingFeedbackIndex = feedbacks.indexWhere(
@@ -335,13 +364,13 @@ class TendersViewModel with ChangeNotifier {
     if (existingFeedback == null) {
       optimisticFeedback = FeedbackData(
         companyId: null,
-        createdAt: DateTime.now().millisecondsSinceEpoch,
+        createdAt: DateTime.now().millisecondsSinceEpoch ~/ 1000,
         customerId: null,
         feedbackType: feedbackType,
         id: null,
         tenderId: tenderId,
         tender: null,
-        updatedAt: DateTime.now().millisecondsSinceEpoch,
+        updatedAt: DateTime.now().millisecondsSinceEpoch ~/ 1000,
       );
       feedbacks.add(optimisticFeedback);
     } else {
@@ -353,7 +382,7 @@ class TendersViewModel with ChangeNotifier {
       } else {
         optimisticFeedback = existingFeedback.copyWith(
           feedbackType: feedbackType,
-          updatedAt: DateTime.now().millisecondsSinceEpoch,
+          updatedAt: DateTime.now().millisecondsSinceEpoch ~/ 1000,
         );
         if (existingFeedbackIndex != -1) {
           feedbacks[existingFeedbackIndex] = optimisticFeedback;
@@ -371,9 +400,13 @@ class TendersViewModel with ChangeNotifier {
     switch (result) {
       case Ok<FeedbackResponse>():
         _feedbackData = result.value.data;
-        if (_feedbackData != null) {
+        final responseType = _feedbackData?.feedbackType;
+        if (responseType == 'unlike' || responseType == 'undislike') {
+          feedbacks.removeWhere((feedback) => feedback.tenderId == tenderId);
+          _feedbackData = null;
+        } else if (_feedbackData != null) {
           final index = feedbacks.indexWhere(
-            (f) => f.tender == _feedbackData!.tender,
+            (feedback) => feedback.tenderId == tenderId,
           );
           if (index != -1) {
             feedbacks[index] = _feedbackData!;
@@ -383,6 +416,7 @@ class TendersViewModel with ChangeNotifier {
         } else {
           feedbacks.removeWhere((f) => f.tenderId == tenderId);
         }
+        _hydratedFeedbackTenderIds.add(tenderId);
         break;
       case Error<FeedbackResponse>():
         if (existingFeedback == null) {
@@ -401,13 +435,24 @@ class TendersViewModel with ChangeNotifier {
         break;
     }
 
+    _feedbackRequestsInFlight.remove(tenderId);
     notifyListeners();
     _feedbackErrorMessage = null;
     notifyListeners();
   }
 
+  /// Kept temporarily for callers compiled against the old misspelled API.
+  @Deprecated('Use toggleFeedback')
+  Future<void> toogleFeedback({
+    required String tenderId,
+    required String feedbackType,
+  }) => toggleFeedback(tenderId: tenderId, feedbackType: feedbackType);
+
   void clearFeedbacks() {
     feedbacks.clear();
+    _hydratedFeedbackTenderIds.clear();
+    _feedbackHydrationsInFlight.clear();
+    _feedbackRequestsInFlight.clear();
     _feedbackData = null;
     _feedbackErrorMessage = null;
     notifyListeners();

lib/view_models/your_tenders_view_model.dart

@@ -3,9 +3,11 @@ import 'package:intl/intl.dart';
 import 'package:tm_app/core/theme/colors.dart';
 import 'package:tm_app/core/utils/error_utils.dart';
 import 'package:tm_app/core/utils/result.dart';
+import 'package:tm_app/core/network/app_exceptions.dart';
 import 'package:tm_app/data/repositories/your_tenders_repository.dart';
 import 'package:tm_app/data/services/model/liked_tenders_response/liked_tenders_response.dart';
 import 'package:tm_app/data/services/model/tender_approvals_response/tender_approvals_response.dart';
+import 'package:tm_app/data/services/model/tender_submission/tender_submission.dart';
 import 'package:tm_app/views/your_tenders/strings/your_tenders_strings.dart';
 
 import '../core/constants/assets.dart';
@@ -22,6 +24,21 @@ class YourTendersViewModel with ChangeNotifier {
   String? errorMessage;
   TenderApprovalsResponse? data;
   LikedTendersResponse? likedTendersData;
+  TenderSubmissionsResponse? submissionsData;
+  TenderSubmissionStats? submissionStats;
+  String selectedSubmissionStage = 'opportunity';
+  String? updatingSubmissionId;
+  String? submissionActionError;
+
+  bool get isSubmissionWorkflow =>
+      selectedStatus == TenderApprovalStatus.submitted.value;
+
+  static const submissionStages = <String>[
+    'opportunity',
+    'in_progress',
+    'submitted',
+    'not_applied',
+  ];
 
   // Pagination state for feedback lists
   bool isLoadingMore = false;
@@ -247,6 +264,8 @@ class YourTendersViewModel with ChangeNotifier {
     // Clear main data
     data = null;
     likedTendersData = null;
+    submissionsData = null;
+    submissionStats = null;
 
     // Clear loading states
     isLoading = false;
@@ -269,6 +288,7 @@ class YourTendersViewModel with ChangeNotifier {
   Future<void> callWithFilter() async {
     likedTendersData = null;
     data = null;
+    submissionsData = null;
     isLoading = true;
     notifyListeners();
 
@@ -282,14 +302,8 @@ class YourTendersViewModel with ChangeNotifier {
       );
       await getTenders(requestModel: requestModel, reset: true);
     } else if (selectedStatus == TenderApprovalStatus.submitted.value) {
-      final requestModel = GetTendersRequestModel(
-        status: TenderApprovalStatus.submitted.value,
-        createdFrom: startDateUnix,
-        createdTo: endDateUnix,
-        limit: _tendersLimit,
-        offset: _tendersOffset,
-      );
-      await getTenders(requestModel: requestModel, reset: true);
+      selectedSubmissionStage = 'submitted';
+      await loadSubmissions();
     } else if (selectedStatus == TenderFeedback.liked.value) {
       await getTendersFeedback(
         feedbackType: TenderFeedback.liked.value,
@@ -318,6 +332,11 @@ class YourTendersViewModel with ChangeNotifier {
   int currentPage = 1;
 
   int get totalPages {
+    if (isSubmissionWorkflow && submissionsData?.meta != null) {
+      return submissionsData!.meta!.pages == 0
+          ? 1
+          : submissionsData!.meta!.pages;
+    }
     if (likedTendersData?.data?.meta?.pages != null) {
       return likedTendersData!.data!.meta!.pages!;
     }
@@ -329,6 +348,10 @@ class YourTendersViewModel with ChangeNotifier {
 
   Future<void> jumpToPage(int page) async {
     currentPage = page;
+    if (isSubmissionWorkflow) {
+      await loadSubmissions(offset: (page - 1) * 20);
+      return;
+    }
     _offset = (page - 1) * _limit;
     _tendersOffset = (page - 1) * _tendersLimit;
 
@@ -340,6 +363,94 @@ class YourTendersViewModel with ChangeNotifier {
     await callWithFilter();
   }
 
+  Future<void> selectSubmissionStage(String stage) async {
+    if (!submissionStages.contains(stage) || stage == selectedSubmissionStage) {
+      return;
+    }
+    selectedSubmissionStage = stage;
+    submissionActionError = null;
+    currentPage = 1;
+    notifyListeners();
+    await loadSubmissions();
+  }
+
+  Future<void> loadSubmissions({int offset = 0}) async {
+    isLoading = true;
+    errorMessage = null;
+    notifyListeners();
+
+    final result = await yourTendersRepository.getSubmissions(
+      stage: selectedSubmissionStage,
+      limit: 20,
+      offset: offset,
+    );
+    switch (result) {
+      case Ok<TenderSubmissionsResponse>():
+        submissionsData = result.value;
+        currentPage = result.value.meta?.page ?? 1;
+      case Error<TenderSubmissionsResponse>():
+        errorMessage = ErrorUtils.getErrorMessage(result.error);
+    }
+
+    final statsResult = await yourTendersRepository.getSubmissionStats();
+    switch (statsResult) {
+      case Ok<TenderSubmissionStatsResponse>():
+        submissionStats = statsResult.value.data;
+      case Error<TenderSubmissionStatsResponse>():
+        // The list remains useful when stats are temporarily unavailable.
+        break;
+    }
+
+    isLoading = false;
+    notifyListeners();
+  }
+
+  Future<bool> updateSubmissionStatus({
+    required TenderSubmission submission,
+    required String status,
+    String? reason,
+    String? description,
+  }) async {
+    if (submission.id.isEmpty || submission.isTerminal) {
+      return false;
+    }
+
+    updatingSubmissionId = submission.id;
+    submissionActionError = null;
+    notifyListeners();
+    final result = await yourTendersRepository.updateSubmissionStatus(
+      id: submission.id,
+      status: status,
+      reason: reason,
+      description: description,
+    );
+
+    switch (result) {
+      case Ok<TenderSubmissionResponse>():
+        updatingSubmissionId = null;
+        await loadSubmissions();
+        return true;
+      case Error<TenderSubmissionResponse>():
+        updatingSubmissionId = null;
+        if (result.error is AppException &&
+            (result.error as AppException).statusCode == 409) {
+          await loadSubmissions();
+          submissionActionError =
+              'This submission changed elsewhere. The latest state has been loaded; please try again.';
+          notifyListeners();
+          return false;
+        }
+        submissionActionError = ErrorUtils.getErrorMessage(result.error);
+        notifyListeners();
+        return false;
+    }
+  }
+
+  void dismissSubmissionActionError() {
+    submissionActionError = null;
+    notifyListeners();
+  }
+
   Color getBackGroundColorByStatus(String status) {
     if (status == TenderFeedback.liked.value ||
         status == TenderApprovalStatus.submitted.value) {

lib/views/board/pages/board_screen.dart

@@ -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!),

lib/views/detail/widgets/tender_detail_header.dart

@@ -141,7 +141,7 @@ class TenderDetailHeader extends StatelessWidget {
     );
   }
 
-  Widget _titleText() => Text(
+  Widget _titleText() => SelectableText(
     detail.title ?? '',
     style: TextStyle(
       color: AppColors.grey80,

lib/views/home/pages/d_home_page.dart

@@ -1,4 +1,5 @@
 import 'package:flutter/material.dart';
+import 'package:go_router/go_router.dart';
 import 'package:provider/provider.dart';
 import 'package:tm_app/core/constants/assets.dart';
 import 'package:tm_app/core/routes/app_routes.dart';
@@ -67,7 +68,7 @@ class DesktopHomePage extends StatelessWidget {
                                 ),
                               ),
                               SizedBox(height: 32.0.h()),
-                              _yourTenderText(homeViewModel),
+                              _yourTenderText(context, homeViewModel),
                               SizedBox(height: 8.0.h()),
                               _bottomListView(homeViewModel),
                             ],
@@ -126,13 +127,7 @@ class DesktopHomePage extends StatelessWidget {
             backgroundColor: AppColors.primary20,
             iconPath: AssetsManager.arrows,
             title: HomeStrings.tenderSubmitted,
-            amount:
-                (homeViewModel
-                            .tenderApprovalsStateResponse
-                            ?.data
-                            ?.submittedTenders ??
-                        0)
-                    .toString(),
+            amount: homeViewModel.submittedTendersCount.toString(),
 
             textColor: AppColors.mainBlue,
             enableTap: true,
@@ -151,7 +146,7 @@ class DesktopHomePage extends StatelessWidget {
             backgroundColor: AppColors.primary10,
             iconPath: AssetsManager.approve,
             title: HomeStrings.approvedTenders,
-            amount: '0',
+            amount: homeViewModel.approvedTendersCount.toString(),
             textColor: AppColors.jellyBean,
             enableTap: true,
             width: 178,
@@ -164,52 +159,49 @@ class DesktopHomePage extends StatelessWidget {
           ),
         ),
         const SizedBox(width: 10),
-        TenderCard(
-          backgroundColor: AppColors.orange10,
-          iconPath: AssetsManager.shield,
-          title: HomeStrings.tenderValue,
-          amount: '0',
-          textColor: AppColors.orange,
-          enableTap: true,
-          width: 178,
-          height: 148,
-          onTap: () {},
-        ),
-        const SizedBox(width: 10),
-        TenderCard(
-          backgroundColor: AppColors.grey10,
-          iconPath: AssetsManager.thumbLike,
-          title: HomeStrings.likedTenders,
-          amount: homeViewModel.userLikedTendersCount.toString(),
-          textColor: AppColors.grey50,
-          enableTap: true,
-          width: 178,
-          height: 148,
-          onTap: () {
-            const LikedTendersRouteData().push(context).then((value) {
-              homeViewModel.init();
-            });
-          },
+        Expanded(
+          child: TenderCard(
+            backgroundColor: AppColors.grey10,
+            iconPath: AssetsManager.thumbLike,
+            title: HomeStrings.likedTenders,
+            amount: homeViewModel.userLikedTendersCount.toString(),
+            textColor: AppColors.grey50,
+            enableTap: true,
+            width: 178,
+            height: 148,
+            onTap: () {
+              const LikedTendersRouteData().push(context).then((value) {
+                homeViewModel.init();
+              });
+            },
+          ),
         ),
       ],
     );
   }
 
-  Widget _yourTenderText(HomeViewModel homeViewModel) {
+  Widget _yourTenderText(BuildContext context, HomeViewModel homeViewModel) {
     final isYourTenders =
         (homeViewModel.data?.data?.tenders?.isNotEmpty ?? false);
     return ConstrainedBox(
       constraints: const BoxConstraints(maxWidth: 740),
       child: Align(
         alignment: AlignmentDirectional.centerStart,
-        child: Text(
-          isYourTenders
-              ? HomeStrings.yourTenders
-              : HomeStrings.recommendedTenders,
-          style: TextStyle(
-            fontSize: 18.0.sp(),
-            fontWeight: FontWeight.w700,
-            color: AppColors.grey80,
+        child: GestureDetector(
+          behavior: HitTestBehavior.opaque,
+          onTap:
+              isYourTenders
+                  ? null
+                  : () => context.go('/tenders?tab=recommended'),
+          child: Text(
+            isYourTenders
+                ? HomeStrings.yourTenders
+                : HomeStrings.recommendedTenders,
+            style: TextStyle(
+              fontSize: 18.0.sp(),
+              fontWeight: FontWeight.w700,
+              color: AppColors.grey80,
+            ),
           ),
         ),
       ),

lib/views/home/pages/m_home_page.dart

@@ -1,10 +1,10 @@
 import 'package:flutter/material.dart';
+import 'package:go_router/go_router.dart';
 import 'package:provider/provider.dart';
 import 'package:tm_app/core/constants/assets.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_approvals_stats_response/tender_approvals_stats_response.dart';
 import 'package:tm_app/view_models/home_view_model.dart';
 import 'package:tm_app/views/shared/tender_app_bar.dart';
 
@@ -43,14 +43,11 @@ class MobileHomePage extends StatelessWidget {
                     SizedBox(height: 32.0.h()),
                     _progressBarsRow(homeViewModel),
                     SizedBox(height: 32.0.h()),
-                    _firstTenderCardsRow(
-                      context,
-                      homeViewModel.tenderApprovalsStateResponse!,
-                    ),
+                    _firstTenderCardsRow(context, homeViewModel),
                     SizedBox(height: 8.0.h()),
                     _secondTenderCardsRow(homeViewModel, context),
                     SizedBox(height: 40.0.h()),
-                    _yourTenderText(homeViewModel),
+                    _yourTenderText(context, homeViewModel),
                     _bottomListView(homeViewModel),
                   ],
                 ),
@@ -92,7 +89,7 @@ class MobileHomePage extends StatelessWidget {
 
   Widget _firstTenderCardsRow(
     BuildContext context,
-    TenderApprovalsStatsResponse tenderApprovalsStateResponse,
+    HomeViewModel homeViewModel,
   ) {
     return Padding(
       padding: EdgeInsets.symmetric(horizontal: 24.0.w()),
@@ -103,9 +100,7 @@ class MobileHomePage extends StatelessWidget {
             backgroundColor: AppColors.primary20,
             iconPath: AssetsManager.arrows,
             title: HomeStrings.tenderSubmitted,
-            amount:
-                (tenderApprovalsStateResponse.data?.submittedTenders ?? 0)
-                    .toString(),
+            amount: homeViewModel.submittedTendersCount.toString(),
             textColor: AppColors.mainBlue,
             enableTap: true,
             onTap: () {
@@ -118,7 +113,7 @@ class MobileHomePage extends StatelessWidget {
             backgroundColor: AppColors.primary10,
             iconPath: AssetsManager.approve,
             title: HomeStrings.approvedTenders,
-            amount: '0',
+            amount: homeViewModel.approvedTendersCount.toString(),
 
             textColor: AppColors.jellyBean,
             enableTap: true,
@@ -142,46 +137,45 @@ class MobileHomePage extends StatelessWidget {
       child: Row(
         mainAxisAlignment: MainAxisAlignment.spaceBetween,
         children: [
-          TenderCard(
-            backgroundColor: AppColors.orange10,
-            iconPath: AssetsManager.shield,
-            title: HomeStrings.tenderValue,
-            amount: '0',
-            textColor: AppColors.orange,
-            enableTap: true,
-            onTap: () {},
-          ),
-          TenderCard(
-            backgroundColor: AppColors.grey10,
-            iconPath: AssetsManager.thumbLike,
-            title: HomeStrings.likedTenders,
-            amount: homeViewModel.userLikedTendersCount.toString(),
-            textColor: AppColors.grey50,
-            enableTap: true,
-            onTap: () {
-              const LikedTendersRouteData().push(context).then((value) {
-                homeViewModel.init();
-              });
-            },
+          Expanded(
+            child: TenderCard(
+              backgroundColor: AppColors.grey10,
+              iconPath: AssetsManager.thumbLike,
+              title: HomeStrings.likedTenders,
+              amount: homeViewModel.userLikedTendersCount.toString(),
+              textColor: AppColors.grey50,
+              enableTap: true,
+              width: double.infinity,
+              onTap: () {
+                const LikedTendersRouteData().push(context).then((value) {
+                  homeViewModel.init();
+                });
+              },
+            ),
           ),
         ],
       ),
     );
   }
 
-  Widget _yourTenderText(HomeViewModel homeViewModel) {
+  Widget _yourTenderText(BuildContext context, HomeViewModel homeViewModel) {
     final isYourTenders =
         (homeViewModel.data?.data?.tenders?.isNotEmpty ?? false);
     return Padding(
       padding: EdgeInsets.symmetric(horizontal: 24.0.w()),
-      child: Text(
-        isYourTenders
-            ? HomeStrings.yourTenders
-            : HomeStrings.recommendedTenders,
-        style: TextStyle(
-          fontSize: 18.0.sp(),
-          fontWeight: FontWeight.w700,
-          color: AppColors.grey80,
+      child: GestureDetector(
+        behavior: HitTestBehavior.opaque,
+        onTap:
+            isYourTenders ? null : () => context.go('/tenders?tab=recommended'),
+        child: Text(
+          isYourTenders
+              ? HomeStrings.yourTenders
+              : HomeStrings.recommendedTenders,
+          style: TextStyle(
+            fontSize: 18.0.sp(),
+            fontWeight: FontWeight.w700,
+            color: AppColors.grey80,
+          ),
         ),
       ),
     );

lib/views/home/pages/t_home_page.dart

@@ -1,9 +1,9 @@
 import 'package:flutter/material.dart';
+import 'package:go_router/go_router.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_approvals_stats_response/tender_approvals_stats_response.dart';
 import 'package:tm_app/view_models/home_view_model.dart';
 import 'package:tm_app/views/shared/tablet_navigation_widget.dart';
 
@@ -58,14 +58,11 @@ class TabletHomePage extends StatelessWidget {
                       SizedBox(height: 40.0.h()),
                       _progressBarsRow(homeViewModel),
                       SizedBox(height: 32.0.h()),
-                      _firstTenderCardsRow(
-                        context,
-                        homeViewModel.tenderApprovalsStateResponse!,
-                      ),
+                      _firstTenderCardsRow(context, homeViewModel),
                       SizedBox(height: 8.0.h()),
                       _secondTenderCardsRow(homeViewModel, context),
                       SizedBox(height: 32.0.h()),
-                      _yourTenderText(homeViewModel),
+                      _yourTenderText(context, homeViewModel),
                       SizedBox(height: 8.0.h()),
                       _bottomListView(homeViewModel),
                     ],
@@ -112,7 +109,7 @@ class TabletHomePage extends StatelessWidget {
 
   Widget _firstTenderCardsRow(
     BuildContext context,
-    TenderApprovalsStatsResponse tenderApprovalsStateResponse,
+    HomeViewModel homeViewModel,
   ) {
     return Row(
       mainAxisAlignment: MainAxisAlignment.spaceBetween,
@@ -122,9 +119,7 @@ class TabletHomePage extends StatelessWidget {
             backgroundColor: AppColors.primary20,
             iconPath: AssetsManager.arrows,
             title: HomeStrings.tenderSubmitted,
-            amount:
-                (tenderApprovalsStateResponse.data?.submittedTenders ?? 0)
-                    .toString(),
+            amount: homeViewModel.submittedTendersCount.toString(),
 
             textColor: AppColors.mainBlue,
             enableTap: true,
@@ -143,7 +138,7 @@ class TabletHomePage extends StatelessWidget {
             backgroundColor: AppColors.primary10,
             iconPath: AssetsManager.approve,
             title: HomeStrings.approvedTenders,
-            amount: '0',
+            amount: homeViewModel.approvedTendersCount.toString(),
             textColor: AppColors.jellyBean,
             enableTap: true,
             width: double.infinity,
@@ -166,20 +161,6 @@ class TabletHomePage extends StatelessWidget {
     return Row(
       mainAxisAlignment: MainAxisAlignment.spaceBetween,
       children: [
-        Expanded(
-          child: TenderCard(
-            backgroundColor: AppColors.orange10,
-            iconPath: AssetsManager.shield,
-            title: HomeStrings.tenderValue,
-            amount: '0',
-            textColor: AppColors.orange,
-            enableTap: true,
-            width: double.infinity,
-            height: 148,
-            onTap: () {},
-          ),
-        ),
-        const SizedBox(width: 16.0),
         Expanded(
           child: TenderCard(
             backgroundColor: AppColors.grey10,
@@ -201,15 +182,22 @@ class TabletHomePage extends StatelessWidget {
     );
   }
 
-  Widget _yourTenderText(HomeViewModel homeViewModel) {
+  Widget _yourTenderText(BuildContext context, HomeViewModel homeViewModel) {
     final isYourTenders =
         (homeViewModel.data?.data?.tenders?.isNotEmpty ?? false);
-    return Text(
-      isYourTenders ? HomeStrings.yourTenders : HomeStrings.recommendedTenders,
-      style: TextStyle(
-        fontSize: 18.0.sp(),
-        fontWeight: FontWeight.w700,
-        color: AppColors.grey80,
+    return GestureDetector(
+      behavior: HitTestBehavior.opaque,
+      onTap:
+          isYourTenders ? null : () => context.go('/tenders?tab=recommended'),
+      child: Text(
+        isYourTenders
+            ? HomeStrings.yourTenders
+            : HomeStrings.recommendedTenders,
+        style: TextStyle(
+          fontSize: 18.0.sp(),
+          fontWeight: FontWeight.w700,
+          color: AppColors.grey80,
+        ),
       ),
     );
   }

lib/views/home/strings/home_strings.dart

@@ -5,11 +5,11 @@ class HomeStrings {
   static const String partnership = 'Partnership';
   static const String selfApply = 'Self-apply';
   static const String contracting = 'Contracting';
-  static const String tenderSubmitted = 'Tenders submitted';
+  static const String tenderSubmitted = 'Submitted tenders';
   static const String approvedTenders = 'Approved tenders';
   static const String tenderValue = 'Tender Value';
   static const String thunderStatus = 'Thunder status';
-  static const String likedTenders = 'Liked Tenders';
+  static const String likedTenders = 'Liked tenders';
   static const String yourTenders = 'Your tenders';
   static const String recommendation = 'Recommendation';
   static const String welcome = 'Welcome';

lib/views/home/tenders_list_item.dart

@@ -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,

lib/views/liked_tenders/widgets/liked_tenders_list_item.dart

@@ -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,

lib/views/notification/widgets/notification_more_dialog.dart

@@ -75,6 +75,35 @@ class NotificationMoreDialog extends StatelessWidget {
                 ),
               ),
             ),
+            Visibility(
+              visible: notification.link != null && notification.link != '',
+              child: Padding(
+                padding: EdgeInsets.only(left: 28.0.w(), top: 8.0.h()),
+                child: Row(
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    Icon(
+                      Icons.link,
+                      size: 16.0.sp(),
+                      color: AppColors.mainBlue,
+                    ),
+                    SizedBox(width: 4.0.w()),
+                    Expanded(
+                      child: SelectableText(
+                        notification.link ?? '',
+                        style: TextStyle(
+                          fontSize: 13.0.sp(),
+                          fontWeight: FontWeight.w400,
+                          color: AppColors.mainBlue,
+                          decoration: TextDecoration.underline,
+                          decorationColor: AppColors.mainBlue,
+                        ),
+                      ),
+                    ),
+                  ],
+                ),
+              ),
+            ),
             SizedBox(height: 12.0.h()),
             Padding(
               padding: EdgeInsets.only(left: 28.0.w()),

lib/views/profile/pages/profile_screen.dart

@@ -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

@@ -1,25 +1,17 @@
-import 'dart:async';
-
 import 'package:flutter/material.dart';
-import 'package:flutter_svg/svg.dart';
 import 'package:provider/provider.dart';
-import 'package:tm_app/core/constants/assets.dart';
 import 'package:tm_app/core/theme/colors.dart';
 import 'package:tm_app/core/utils/size_config.dart';
 import 'package:tm_app/view_models/tenders_view_model.dart';
-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/tenders_filter_dialog.dart';
-import 'package:tm_app/views/tenders/widgets/tenders_sort_dialog.dart';
+import 'package:tm_app/views/tenders/widgets/recommended_tenders_view.dart';
 
-import '../../../core/constants/common_strings.dart';
 import '../../../core/utils/app_toast.dart';
-import '../../../view_models/auth_view_model.dart';
 
 class DesktopTendersPage extends StatefulWidget {
-  const DesktopTendersPage({super.key});
+  const DesktopTendersPage({required this.initialSelectedTab, super.key});
+
+  final int initialSelectedTab;
 
   @override
   State<DesktopTendersPage> createState() => _DesktopTendersPageState();
@@ -49,47 +41,31 @@ class _DesktopTendersPageState extends State<DesktopTendersPage> {
 
   @override
   Widget build(BuildContext context) {
-    final userRole = context.watch<AuthViewModel>().userRole;
     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(),
-            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,
-                        ),
-                      ),
-                    ),
-                  );
-                },
+            SizedBox(height: 24.0.h()),
+            // Tab bar hidden while tenders only shows recommendations.
+            // SizedBox(
+            //   width: 740,
+            //   child: TendersTabBar(
+            //     selectedIndex: 1,
+            //     onChanged: (index) {},
+            //   ),
+            // ),
+            // SizedBox(height: 24.0.h()),
+            // All tenders controls are hidden while the All tab is disabled.
+            // if (userRole == Role.analyst) const _SearchBox(),
+            // if (userRole == Role.analyst) const _ActionButtons(),
+            const Expanded(
+              child: Center(
+                child: SizedBox(
+                  width: 740,
+                  child: RecommendedTendersView(isDesktop: true),
+                ),
               ),
             ),
           ],
@@ -98,156 +74,3 @@ class _DesktopTendersPageState extends State<DesktopTendersPage> {
     );
   }
 }
-
-class _SearchBox extends StatefulWidget {
-  const _SearchBox();
-
-  @override
-  State<_SearchBox> createState() => _SearchBoxState();
-}
-
-class _SearchBoxState extends State<_SearchBox> {
-  final TextEditingController _searchController = TextEditingController();
-  Timer? _debounceTimer;
-
-  @override
-  void dispose() {
-    _searchController.dispose();
-    _debounceTimer?.cancel();
-    super.dispose();
-  }
-
-  void _onSearchChanged(String query) {
-    _debounceTimer?.cancel();
-    _debounceTimer = Timer(const Duration(milliseconds: 500), () {
-      final viewModel = context.read<TendersViewModel>();
-      viewModel.searchTenders(query);
-    });
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return SizedBox(
-      height: 48.0.h(),
-      width: 680,
-      child: TextField(
-        controller: _searchController,
-        onChanged: _onSearchChanged,
-        style: TextStyle(fontSize: 16.0.sp(), color: AppColors.grey60),
-        decoration: InputDecoration(
-          hintText: TendersStrings.search,
-          hintStyle: TextStyle(fontSize: 16.0.sp(), color: AppColors.grey60),
-          prefixIcon: Padding(
-            padding: EdgeInsets.all(12.0.w()),
-            child: SvgPicture.asset(
-              AssetsManager.normalSearch,
-              width: 24.0.w(),
-              height: 24.0.h(),
-            ),
-          ),
-          filled: true,
-          fillColor: AppColors.grey0,
-          contentPadding: EdgeInsets.symmetric(
-            horizontal: 12.0.w(),
-            vertical: 12.0.h(),
-          ),
-          border: OutlineInputBorder(
-            borderRadius: BorderRadius.circular(12.0.w()),
-            borderSide: const BorderSide(color: AppColors.mainBlue, width: 1),
-          ),
-          enabledBorder: OutlineInputBorder(
-            borderRadius: BorderRadius.circular(12.0.w()),
-            borderSide: BorderSide(color: AppColors.grey40, width: 1),
-          ),
-          focusedBorder: OutlineInputBorder(
-            borderRadius: BorderRadius.circular(12.0.w()),
-            borderSide: const BorderSide(color: AppColors.grey, width: 1.5),
-          ),
-        ),
-      ),
-    );
-  }
-}
-
-class _ActionButtons extends StatelessWidget {
-  const _ActionButtons();
-
-  @override
-  Widget build(BuildContext context) {
-    final viewModel = context.read<TendersViewModel>();
-    return Container(
-      margin: EdgeInsets.only(top: 25.0.h()),
-      height: 40.0.h(),
-      width: 680,
-      child: Row(
-        children: [
-          BaseButton(
-            width: 178.0.w(),
-            isEnabled: true,
-            onPressed: () {
-              showDialog(
-                context: context,
-                builder:
-                    (_) => Dialog(
-                      backgroundColor: AppColors.backgroundColor,
-                      shape: RoundedRectangleBorder(
-                        borderRadius: BorderRadius.circular(16),
-                      ),
-                      child: SizedBox(
-                        width: 560,
-                        child: TendersFilterDialog(
-                          viewModel: viewModel,
-                          onFilterChanged: (dateRange, status) {
-                            viewModel.setDateRange(dateRange);
-                            viewModel.setStatus(status!);
-                            viewModel.callWithSortAndStatus();
-                          },
-                        ),
-                      ),
-                    ),
-              );
-            },
-            text: TendersStrings.filter,
-            icon: AssetsManager.filter,
-            iconColor: AppColors.textBlue,
-            backgroundColor: AppColors.primary20,
-            textColor: AppColors.textBlue,
-          ),
-          SizedBox(width: 10.0.w()),
-          BaseButton(
-            width: 178.0.w(),
-            isEnabled: true,
-            onPressed: () {
-              showDialog(
-                context: context,
-                builder:
-                    (_) => Dialog(
-                      backgroundColor: AppColors.backgroundColor,
-                      shape: RoundedRectangleBorder(
-                        borderRadius: BorderRadius.circular(16),
-                      ),
-                      child: SizedBox(
-                        width: 560,
-                        child: TendersSortDialog(
-                          viewModel: viewModel,
-                          onConfirm: (sort) {
-                            viewModel.setSort(sort);
-                            viewModel.callWithSortAndStatus();
-                          },
-                        ),
-                      ),
-                    ),
-              );
-            },
-            text: TendersStrings.sort,
-            icon: AssetsManager.sort,
-            iconColor: AppColors.textBlue,
-            backgroundColor: AppColors.primary20,
-            textColor: AppColors.textBlue,
-          ),
-        ],
-      ),
-    );
-  }
-}
-

lib/views/tenders/pages/m_tenders_page.dart

@@ -1,17 +1,17 @@
 import 'package:flutter/material.dart';
 import 'package:provider/provider.dart';
-import 'package:tm_app/core/utils/size_config.dart';
 import 'package:tm_app/view_models/tenders_view_model.dart';
 
-import '../../../core/constants/common_strings.dart';
 import '../../../core/theme/colors.dart';
 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';
 
 class MobileTendersPage extends StatefulWidget {
-  const MobileTendersPage({super.key});
+  const MobileTendersPage({required this.initialSelectedTab, super.key});
+
+  final int initialSelectedTab;
 
   @override
   State<MobileTendersPage> createState() => _MobileTendersPageState();
@@ -19,6 +19,7 @@ class MobileTendersPage extends StatefulWidget {
 
 class _MobileTendersPageState extends State<MobileTendersPage> {
   late final TendersViewModel viewModel;
+
   @override
   void initState() {
     super.initState();
@@ -43,33 +44,22 @@ class _MobileTendersPageState extends State<MobileTendersPage> {
     return Scaffold(
       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 ?? [],
-                ),
-              ),
-            );
-          },
+      body: const SafeArea(
+        child: Column(
+          children: [
+            // Tab bar hidden while tenders only shows recommendations.
+            // Padding(
+            //   padding: EdgeInsets.symmetric(
+            //     horizontal: 24.0.w(),
+            //     vertical: 12.0.h(),
+            //   ),
+            //   child: TendersTabBar(
+            //     selectedIndex: 1,
+            //     onChanged: (index) {},
+            //   ),
+            // ),
+            Expanded(child: RecommendedTendersView()),
+          ],
         ),
       ),
     );

lib/views/tenders/pages/t_tenders_page.dart

@@ -4,14 +4,15 @@ import 'package:tm_app/core/theme/colors.dart';
 import 'package:tm_app/core/utils/size_config.dart';
 import 'package:tm_app/view_models/tenders_view_model.dart';
 import 'package:tm_app/views/shared/tablet_navigation_widget.dart';
-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';
 
 class TabletTendersPage extends StatefulWidget {
-  const TabletTendersPage({super.key});
+  const TabletTendersPage({required this.initialSelectedTab, super.key});
+
+  final int initialSelectedTab;
 
   @override
   State<TabletTendersPage> createState() => _TabletTendersPageState();
@@ -38,33 +39,19 @@ 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: const Column(
+          children: [
+            // Tab bar hidden while tenders only shows recommendations.
+            // TendersTabBar(
+            //   selectedIndex: 1,
+            //   onChanged: (index) {},
+            // ),
+            // SizedBox(height: 24.0.h()),
+            Expanded(child: RecommendedTendersView()),
+          ],
+        ),
       ),
     );
   }

lib/views/tenders/pages/tenders_screen.dart

@@ -10,7 +10,9 @@ import 'm_tenders_page.dart';
 import 't_tenders_page.dart';
 
 class TendersScreen extends StatefulWidget {
-  const TendersScreen({super.key});
+  const TendersScreen({this.initialTab, super.key});
+
+  final String? initialTab;
 
   @override
   State<TendersScreen> createState() => _TendersScreenState();
@@ -48,10 +50,11 @@ class _TendersScreenState extends State<TendersScreen> {
   @override
   Widget build(BuildContext context) {
     SizeConfig.init(context);
-    return const ResponsiveBuilder(
-      mobile: MobileTendersPage(),
-      tablet: TabletTendersPage(),
-      desktop: DesktopTendersPage(),
+    final initialSelectedTab = widget.initialTab == 'recommended' ? 1 : 0;
+    return ResponsiveBuilder(
+      mobile: MobileTendersPage(initialSelectedTab: initialSelectedTab),
+      tablet: TabletTendersPage(initialSelectedTab: initialSelectedTab),
+      desktop: DesktopTendersPage(initialSelectedTab: initialSelectedTab),
     );
   }
 }

lib/views/tenders/strings/tenders_strings.dart

@@ -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/animated_feedback_button.dart

@@ -8,6 +8,7 @@ class AnimatedFeedbackButton extends StatefulWidget {
   final Color activeColor;
   final Color inactiveColor;
   final bool isActive;
+  final bool isLoading;
   final VoidCallback onTap;
   final String tooltip;
 
@@ -18,6 +19,7 @@ class AnimatedFeedbackButton extends StatefulWidget {
     required this.isActive,
     required this.onTap,
     required this.tooltip,
+    this.isLoading = false,
     super.key,
   });
 
@@ -63,6 +65,9 @@ class _AnimatedFeedbackButtonState extends State<AnimatedFeedbackButton>
   }
 
   void _handleTap() {
+    if (widget.isLoading) {
+      return;
+    }
     _clickController.forward().then((_) {
       _clickController.reverse();
     });
@@ -75,7 +80,7 @@ class _AnimatedFeedbackButtonState extends State<AnimatedFeedbackButton>
       message: widget.tooltip,
       child: InkWell(
         splashColor: Colors.transparent,
-        onTap: _handleTap,
+        onTap: widget.isLoading ? null : _handleTap,
         child: AnimatedBuilder(
           animation: _clickController,
           builder: (context, child) {
@@ -94,15 +99,23 @@ class _AnimatedFeedbackButtonState extends State<AnimatedFeedbackButton>
                   duration: const Duration(milliseconds: 100),
                   curve: Curves.easeInOut,
                   builder: (context, color, child) {
-                    return SvgPicture.asset(
+                    return SizedBox(
                       width: 24.0.w(),
                       height: 24.0.w(),
-                      fit: BoxFit.cover,
-                      widget.iconPath,
-                      colorFilter: ColorFilter.mode(
-                        color ?? widget.inactiveColor,
-                        BlendMode.srcATop,
-                      ),
+                      child:
+                          widget.isLoading
+                              ? CircularProgressIndicator(
+                                strokeWidth: 2,
+                                color: color ?? widget.inactiveColor,
+                              )
+                              : SvgPicture.asset(
+                                fit: BoxFit.cover,
+                                widget.iconPath,
+                                colorFilter: ColorFilter.mode(
+                                  color ?? widget.inactiveColor,
+                                  BlendMode.srcATop,
+                                ),
+                              ),
                     );
                   },
                 ),

lib/views/tenders/widgets/main_tenders_slider.dart

@@ -41,6 +41,52 @@ class _MainTendersSliderState extends State<MainTendersSlider> {
     if (widget.isDesktop) {
       _scrollController.addListener(_onScroll);
     }
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      if (mounted) {
+        _hydrateRenderedFeedback();
+      }
+    });
+  }
+
+  @override
+  void didUpdateWidget(covariant MainTendersSlider oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    final oldIds = oldWidget.tenders.map((tender) => tender.id).toList();
+    final newIds = widget.tenders.map((tender) => tender.id).toList();
+    if (oldIds.length != newIds.length ||
+        !Iterable<int>.generate(
+          newIds.length,
+        ).every((index) => oldIds[index] == newIds[index])) {
+      WidgetsBinding.instance.addPostFrameCallback((_) {
+        if (mounted) {
+          _hydrateRenderedFeedback();
+        }
+      });
+    }
+  }
+
+  void _hydrateRenderedFeedback() {
+    if (widget.tenders.isEmpty) {
+      return;
+    }
+
+    final viewModel = context.read<TendersViewModel>();
+    final tendersToHydrate =
+        widget.isDesktop
+            ? widget.tenders
+            : <TenderData>[
+              widget.tenders[(currentPage - 1).clamp(
+                0,
+                widget.tenders.length - 1,
+              )],
+            ];
+
+    for (final tender in tendersToHydrate) {
+      final id = tender.id;
+      if (id != null && id.isNotEmpty) {
+        viewModel.getTenderFeedback(id);
+      }
+    }
   }
 
   void _onScroll() {

lib/views/tenders/widgets/recommendation_card.dart

@@ -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

@@ -0,0 +1,170 @@
+import 'package:flutter/material.dart';
+import 'package:provider/provider.dart';
+import 'package:tm_app/core/theme/colors.dart';
+import 'package:tm_app/core/utils/size_config.dart';
+import 'package:tm_app/view_models/ai_recommendations_view_model.dart';
+
+import '../strings/tenders_strings.dart';
+import 'main_tenders_slider.dart';
+import 'tender_card_shimmer.dart';
+
+/// 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, this.isDesktop = false});
+
+  final bool isDesktop;
+
+  @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 _LoadingSkeleton(isDesktop: widget.isDesktop);
+        }
+        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.recommendedTenders.isNotEmpty) {
+          if (widget.isDesktop) {
+            return Padding(
+              padding: EdgeInsets.symmetric(vertical: 4.0.h()),
+              child: MainTendersSlider(
+                tenders: vm.recommendedTenders,
+                isDesktop: true,
+              ),
+            );
+          }
+
+          return SingleChildScrollView(
+            child: Padding(
+              padding: EdgeInsets.symmetric(vertical: 18.0.h()),
+              child: MainTendersSlider(tenders: vm.recommendedTenders),
+            ),
+          );
+        }
+        return _MessageState(
+          title: TendersStrings.recommendedEmptyTitle,
+          body: TendersStrings.recommendedEmptyBody,
+          onRetry: vm.refresh,
+        );
+      },
+    );
+  }
+}
+
+/// 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({required this.isDesktop});
+
+  final bool isDesktop;
+
+  @override
+  Widget build(BuildContext context) {
+    return ListView.separated(
+      padding: EdgeInsets.all(16.0.h()),
+      itemCount: isDesktop ? 3 : 2,
+      separatorBuilder:
+          (_, __) => SizedBox(height: isDesktop ? 20.0.h() : 52.0.h()),
+      itemBuilder: (context, index) => TenderCardShimmer(isDesktop: isDesktop),
+    );
+  }
+}

lib/views/tenders/widgets/tender_action_buttons_row.dart

@@ -48,6 +48,7 @@ class TenderActionButtonsRow extends StatelessWidget {
 
     final feedback = viewModel.getFeedbackForTender(tender.id!);
     final isDisliked = feedback?.feedbackType == TenderFeedback.disliked.value;
+    final isLoading = viewModel.isFeedbackLoading(tender.id!);
 
     return Column(
       children: [
@@ -56,9 +57,10 @@ class TenderActionButtonsRow extends StatelessWidget {
           activeColor: AppColors.errorColor,
           inactiveColor: AppColors.grey50,
           isActive: isDisliked,
+          isLoading: isLoading,
           tooltip: TendersStrings.dislike,
           onTap: () {
-            viewModel.toogleFeedback(
+            viewModel.toggleFeedback(
               tenderId: tender.id!,
               feedbackType: TenderFeedback.disliked.value,
             );
@@ -85,6 +87,7 @@ class TenderActionButtonsRow extends StatelessWidget {
 
     final feedback = viewModel.getFeedbackForTender(tender.id!);
     final isLiked = feedback?.feedbackType == TenderFeedback.liked.value;
+    final isLoading = viewModel.isFeedbackLoading(tender.id!);
 
     return Column(
       children: [
@@ -93,9 +96,10 @@ class TenderActionButtonsRow extends StatelessWidget {
           activeColor: AppColors.successColor,
           inactiveColor: AppColors.grey50,
           isActive: isLiked,
+          isLoading: isLoading,
           tooltip: TendersStrings.like,
           onTap: () {
-            viewModel.toogleFeedback(
+            viewModel.toggleFeedback(
               tenderId: tender.id!,
               feedbackType: TenderFeedback.liked.value,
             );

lib/views/tenders/widgets/tender_card.dart

@@ -198,7 +198,7 @@ class TenderCard extends StatelessWidget {
   }
 
   Widget _tenderTitle() {
-    return Text(
+    return SelectableText(
       tender.title ?? '',
       maxLines: isDesktop ? 2 : 4,
       style: TextStyle(

lib/views/tenders/widgets/tender_card_shimmer.dart

@@ -0,0 +1,173 @@
+import 'package:flutter/material.dart';
+import 'package:tm_app/core/theme/colors.dart';
+import 'package:tm_app/core/utils/size_config.dart';
+
+class TenderCardShimmer extends StatelessWidget {
+  const TenderCardShimmer({super.key, this.isDesktop = false});
+
+  final bool isDesktop;
+
+  @override
+  Widget build(BuildContext context) {
+    return _Shimmer(
+      child: Container(
+        width: double.infinity,
+        margin: EdgeInsets.symmetric(horizontal: 16.0.w()),
+        height: isDesktop ? 350.0.h() : 587.0.h(),
+        padding: EdgeInsets.all(16.0.w()),
+        decoration: BoxDecoration(
+          color: AppColors.grey0,
+          borderRadius: BorderRadius.circular(12),
+          border: Border.all(color: AppColors.grey30),
+        ),
+        child: Column(
+          crossAxisAlignment: CrossAxisAlignment.start,
+          children: [
+            _bar(width: isDesktop ? 120.0.w() : 140.0.w(), height: 14.0.h()),
+            SizedBox(height: 16.0.h()),
+            _block(height: isDesktop ? 58.0.h() : 70.0.h()),
+            SizedBox(height: isDesktop ? 12.0.h() : 20.0.h()),
+            _bar(width: double.infinity, height: 18.0.h()),
+            SizedBox(height: 8.0.h()),
+            _fractionBar(widthFactor: 0.72, height: 18.0.h()),
+            SizedBox(height: 16.0.h()),
+            _bar(width: double.infinity, height: 14.0.h()),
+            SizedBox(height: 8.0.h()),
+            _bar(width: double.infinity, height: 14.0.h()),
+            SizedBox(height: 8.0.h()),
+            _fractionBar(widthFactor: 0.55, height: 14.0.h()),
+            const Spacer(),
+            Row(
+              children: [
+                _circle(size: 24.0.h()),
+                SizedBox(width: 8.0.w()),
+                _bar(width: 60.0.w(), height: 14.0.h()),
+                const Spacer(),
+                _pill(width: 108.0.w(), height: 40.0.h()),
+              ],
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+
+  Widget _bar({required double width, required double height}) {
+    return Container(
+      width: width,
+      height: height,
+      decoration: BoxDecoration(
+        color: AppColors.grey20,
+        borderRadius: BorderRadius.circular(6),
+      ),
+    );
+  }
+
+  Widget _fractionBar({required double widthFactor, required double height}) {
+    return FractionallySizedBox(
+      widthFactor: widthFactor,
+      alignment: AlignmentDirectional.centerStart,
+      child: _bar(width: double.infinity, height: height),
+    );
+  }
+
+  Widget _block({required double height}) {
+    return Container(
+      width: double.infinity,
+      height: height,
+      decoration: BoxDecoration(
+        color: AppColors.grey20,
+        borderRadius: BorderRadius.circular(4),
+      ),
+    );
+  }
+
+  Widget _pill({required double width, required double height}) {
+    return Container(
+      width: width,
+      height: height,
+      decoration: BoxDecoration(
+        color: AppColors.grey20,
+        borderRadius: BorderRadius.circular(100),
+      ),
+    );
+  }
+
+  Widget _circle({required double size}) {
+    return Container(
+      width: size,
+      height: size,
+      decoration: BoxDecoration(
+        color: AppColors.grey20,
+        shape: BoxShape.circle,
+      ),
+    );
+  }
+}
+
+class _Shimmer extends StatefulWidget {
+  const _Shimmer({required this.child});
+
+  final Widget child;
+
+  @override
+  State<_Shimmer> createState() => _ShimmerState();
+}
+
+class _ShimmerState extends State<_Shimmer>
+    with SingleTickerProviderStateMixin {
+  late final AnimationController _controller;
+
+  @override
+  void initState() {
+    super.initState();
+    _controller = AnimationController(
+      vsync: this,
+      duration: const Duration(milliseconds: 1400),
+    )..repeat();
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return AnimatedBuilder(
+      animation: _controller,
+      child: widget.child,
+      builder: (context, child) {
+        return ShaderMask(
+          blendMode: BlendMode.srcATop,
+          shaderCallback: (bounds) {
+            final shimmerWidth = bounds.width * 0.8;
+            final offset = (bounds.width + shimmerWidth) * _controller.value;
+            return LinearGradient(
+              begin: Alignment.centerLeft,
+              end: Alignment.centerRight,
+              colors: [AppColors.grey20, AppColors.grey10, AppColors.grey20],
+              stops: const [0.25, 0.5, 0.75],
+              transform: _SlidingGradientTransform(
+                slidePercent: (offset - shimmerWidth) / bounds.width,
+              ),
+            ).createShader(bounds);
+          },
+          child: child,
+        );
+      },
+    );
+  }
+}
+
+class _SlidingGradientTransform extends GradientTransform {
+  const _SlidingGradientTransform({required this.slidePercent});
+
+  final double slidePercent;
+
+  @override
+  Matrix4 transform(Rect bounds, {TextDirection? textDirection}) {
+    return Matrix4.translationValues(bounds.width * slidePercent, 0, 0);
+  }
+}

lib/views/tenders/widgets/tenders_tab_bar.dart

@@ -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 for the tenders list.
+class TendersTabBar extends StatelessWidget {
+  const TendersTabBar({
+    required this.selectedIndex,
+    required this.onChanged,
+    super.key,
+  });
+
+  /// 1 = Recommended. The former All tab is intentionally hidden.
+  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: [
+          // All tenders is hidden for now.
+          // _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,
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+}

lib/views/your_tenders/pages/your_tenders_desktop_page.dart

@@ -11,6 +11,7 @@ import 'package:tm_app/views/your_tenders/strings/your_tenders_strings.dart';
 import 'package:tm_app/views/your_tenders/widgets/filter_button.dart';
 import 'package:tm_app/views/your_tenders/widgets/liked_disliked_tenders_list.dart';
 import 'package:tm_app/views/your_tenders/widgets/tenders_submitted.dart';
+import 'package:tm_app/views/your_tenders/widgets/submission_workflow.dart';
 
 import '../../shared/desktop_navigation_widget.dart';
 import '../../shared/page_selection_dialog.dart';
@@ -79,7 +80,9 @@ class _YourTendersDesktopPageState extends State<YourTendersDesktopPage>
 
                           Widget content;
 
-                          if (viewModel.selectedStatus ==
+                          if (viewModel.isSubmissionWorkflow) {
+                            content = const SubmissionWorkflow();
+                          } else if (viewModel.selectedStatus ==
                                   TenderFeedback.liked.value &&
                               viewModel.likedTendersData != null) {
                             content = LikedDislikedTendersList(
@@ -114,7 +117,8 @@ class _YourTendersDesktopPageState extends State<YourTendersDesktopPage>
                               Expanded(child: content),
                               SizedBox(height: 10.0.h()),
 
-                              _listPagesControll(context, viewModel),
+                              if (!viewModel.isSubmissionWorkflow)
+                                _listPagesControll(context, viewModel),
 
                               SizedBox(height: 30.0.h()),
                             ],

lib/views/your_tenders/pages/your_tenders_mobile_page.dart

@@ -7,6 +7,7 @@ import 'package:tm_app/views/your_tenders/strings/your_tenders_strings.dart';
 import 'package:tm_app/views/your_tenders/widgets/filter_button.dart';
 import 'package:tm_app/views/your_tenders/widgets/liked_disliked_tenders_list.dart';
 import 'package:tm_app/views/your_tenders/widgets/tenders_submitted.dart';
+import 'package:tm_app/views/your_tenders/widgets/submission_workflow.dart';
 
 import '../../../core/constants/tender_feedback.dart';
 
@@ -60,7 +61,9 @@ class _YourTendersMobilePageState extends State<YourTendersMobilePage> {
 
                   return Column(
                     children: [
-                      if (viewModel.selectedStatus ==
+                      if (viewModel.isSubmissionWorkflow)
+                        const Expanded(child: SubmissionWorkflow())
+                      else if (viewModel.selectedStatus ==
                               TenderFeedback.liked.value &&
                           viewModel.likedTendersData != null)
                         Expanded(

lib/views/your_tenders/pages/your_tenders_tablet_page.dart

@@ -9,6 +9,7 @@ import 'package:tm_app/views/shared/tablet_desktop_appbar.dart';
 import 'package:tm_app/views/your_tenders/widgets/filter_button.dart';
 import 'package:tm_app/views/your_tenders/widgets/liked_disliked_tenders_list.dart';
 import 'package:tm_app/views/your_tenders/widgets/tenders_submitted.dart';
+import 'package:tm_app/views/your_tenders/widgets/submission_workflow.dart';
 
 import '../../../core/constants/tender_feedback.dart';
 import '../../shared/tablet_navigation_widget.dart';
@@ -85,7 +86,9 @@ class _YourTendersTabletPageState extends State<YourTendersTabletPage>
 
                       Widget content;
 
-                      if (viewModel.selectedStatus ==
+                      if (viewModel.isSubmissionWorkflow) {
+                        content = const SubmissionWorkflow();
+                      } else if (viewModel.selectedStatus ==
                               TenderFeedback.liked.value &&
                           viewModel.likedTendersData != null) {
                         content = LikedDislikedTendersList(
@@ -120,7 +123,8 @@ class _YourTendersTabletPageState extends State<YourTendersTabletPage>
                           Expanded(child: content),
                           SizedBox(height: 10.0.h()),
 
-                          _listPagesControll(context, viewModel),
+                          if (!viewModel.isSubmissionWorkflow)
+                            _listPagesControll(context, viewModel),
 
                           const SizedBox(height: 30.0),
                         ],

lib/views/your_tenders/widgets/submission_workflow.dart

@@ -0,0 +1,511 @@
+import 'package:flutter/material.dart';
+import 'package:provider/provider.dart';
+import 'package:tm_app/core/theme/colors.dart';
+import 'package:tm_app/core/utils/date_utils.dart';
+import 'package:tm_app/data/services/model/tender_submission/tender_submission.dart';
+import 'package:tm_app/view_models/your_tenders_view_model.dart';
+
+class SubmissionWorkflow extends StatelessWidget {
+  const SubmissionWorkflow({super.key});
+
+  static const _stageLabels = <String, String>{
+    'opportunity': 'Opportunity',
+    'in_progress': 'In Progress',
+    'submitted': 'Submitted',
+    'not_applied': 'Not Applied',
+  };
+
+  @override
+  Widget build(BuildContext context) {
+    return Consumer<YourTendersViewModel>(
+      builder: (context, viewModel, _) {
+        final submissions = viewModel.submissionsData?.data ?? const [];
+        return Column(
+          children: [
+            SizedBox(
+              height: 54,
+              child: ListView(
+                scrollDirection: Axis.horizontal,
+                padding: const EdgeInsets.symmetric(
+                  horizontal: 16,
+                  vertical: 6,
+                ),
+                children:
+                    YourTendersViewModel.submissionStages.map((stage) {
+                      final selected =
+                          viewModel.selectedSubmissionStage == stage;
+                      final count =
+                          viewModel.submissionStats?.byStage[stage] ?? 0;
+                      return Padding(
+                        padding: const EdgeInsets.only(right: 8),
+                        child: ChoiceChip(
+                          selected: selected,
+                          onSelected:
+                              (_) => viewModel.selectSubmissionStage(stage),
+                          label: Text('${_stageLabels[stage]} ($count)'),
+                          selectedColor: AppColors.secondary20,
+                          side: BorderSide(
+                            color:
+                                selected
+                                    ? AppColors.secondary50
+                                    : AppColors.grey30,
+                          ),
+                        ),
+                      );
+                    }).toList(),
+              ),
+            ),
+            if (viewModel.submissionActionError != null)
+              Container(
+                width: double.infinity,
+                margin: const EdgeInsets.fromLTRB(16, 4, 16, 4),
+                padding: const EdgeInsets.fromLTRB(12, 8, 4, 8),
+                decoration: BoxDecoration(
+                  color: AppColors.red0,
+                  border: Border.all(color: AppColors.red10),
+                  borderRadius: BorderRadius.circular(8),
+                ),
+                child: Row(
+                  children: [
+                    Icon(Icons.error_outline, color: AppColors.error, size: 18),
+                    const SizedBox(width: 8),
+                    Expanded(
+                      child: Text(
+                        viewModel.submissionActionError!,
+                        style: TextStyle(color: AppColors.error, fontSize: 12),
+                      ),
+                    ),
+                    IconButton(
+                      visualDensity: VisualDensity.compact,
+                      onPressed: viewModel.dismissSubmissionActionError,
+                      icon: const Icon(Icons.close, size: 18),
+                    ),
+                  ],
+                ),
+              ),
+            if (viewModel.isLoading && submissions.isEmpty)
+              const Expanded(
+                child: Center(
+                  child: CircularProgressIndicator(
+                    color: AppColors.secondary50,
+                  ),
+                ),
+              )
+            else if (submissions.isEmpty)
+              Expanded(
+                child: Center(
+                  child: Text(
+                    'No ${_stageLabels[viewModel.selectedSubmissionStage]?.toLowerCase()} submissions.',
+                    style: TextStyle(color: AppColors.grey60),
+                  ),
+                ),
+              )
+            else
+              Expanded(
+                child: RefreshIndicator(
+                  onRefresh: viewModel.loadSubmissions,
+                  child: ListView.builder(
+                    physics: const AlwaysScrollableScrollPhysics(),
+                    padding: const EdgeInsets.fromLTRB(16, 8, 16, 24),
+                    itemCount: submissions.length,
+                    itemBuilder:
+                        (context, index) =>
+                            _SubmissionCard(submission: submissions[index]),
+                  ),
+                ),
+              ),
+            if ((viewModel.submissionsData?.meta?.pages ?? 1) > 1)
+              Padding(
+                padding: const EdgeInsets.fromLTRB(16, 0, 16, 12),
+                child: Row(
+                  mainAxisAlignment: MainAxisAlignment.center,
+                  children: [
+                    IconButton(
+                      tooltip: 'Previous page',
+                      onPressed:
+                          viewModel.currentPage > 1 && !viewModel.isLoading
+                              ? () => viewModel.jumpToPage(
+                                viewModel.currentPage - 1,
+                              )
+                              : null,
+                      icon: const Icon(Icons.chevron_left),
+                    ),
+                    Text(
+                      'Page ${viewModel.currentPage} of ${viewModel.totalPages}',
+                      style: TextStyle(color: AppColors.grey60),
+                    ),
+                    IconButton(
+                      tooltip: 'Next page',
+                      onPressed:
+                          viewModel.currentPage < viewModel.totalPages &&
+                                  !viewModel.isLoading
+                              ? () => viewModel.jumpToPage(
+                                viewModel.currentPage + 1,
+                              )
+                              : null,
+                      icon: const Icon(Icons.chevron_right),
+                    ),
+                  ],
+                ),
+              ),
+          ],
+        );
+      },
+    );
+  }
+}
+
+class _SubmissionCard extends StatelessWidget {
+  const _SubmissionCard({required this.submission});
+
+  final TenderSubmission submission;
+
+  static const _statusLabels = <String, String>{
+    'opportunity': 'Opportunity',
+    'validating': 'Validating',
+    'partner_pending': 'Partner Pending',
+    'applying': 'Applying',
+    'sent_waiting': 'Sent / Waiting',
+    'rejected': 'Lost',
+    'contract': 'Contract Awarded',
+    'not_applied': 'Not Applied',
+  };
+
+  @override
+  Widget build(BuildContext context) {
+    final viewModel = context.watch<YourTendersViewModel>();
+    final tender = submission.tender;
+    final busy = viewModel.updatingSubmissionId == submission.id;
+    final deadline = tender?.submissionDeadline ?? tender?.tenderDeadline;
+
+    return Card(
+      color: AppColors.cardBackground,
+      elevation: 0,
+      margin: const EdgeInsets.only(bottom: 12),
+      shape: RoundedRectangleBorder(
+        borderRadius: BorderRadius.circular(12),
+        side: BorderSide(color: AppColors.borderColor),
+      ),
+      child: Padding(
+        padding: const EdgeInsets.all(16),
+        child: Column(
+          crossAxisAlignment: CrossAxisAlignment.start,
+          children: [
+            Row(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                Expanded(
+                  child: Text(
+                    tender?.title?.trim().isNotEmpty == true
+                        ? tender!.title!
+                        : 'Tender ${submission.tenderId}',
+                    style: TextStyle(
+                      color: AppColors.grey80,
+                      fontSize: 16,
+                      fontWeight: FontWeight.w600,
+                    ),
+                  ),
+                ),
+                const SizedBox(width: 12),
+                _StatusBadge(
+                  label: _statusLabels[submission.status] ?? submission.status,
+                  status: submission.status,
+                ),
+              ],
+            ),
+            if (tender?.description?.trim().isNotEmpty == true) ...[
+              const SizedBox(height: 8),
+              Text(
+                tender!.description!,
+                maxLines: 2,
+                overflow: TextOverflow.ellipsis,
+                style: TextStyle(color: AppColors.grey70, height: 1.4),
+              ),
+            ],
+            const SizedBox(height: 12),
+            Wrap(
+              spacing: 16,
+              runSpacing: 6,
+              children: [
+                if (tender?.countryCode?.isNotEmpty == true)
+                  _Meta(
+                    icon: Icons.location_on_outlined,
+                    text: tender!.countryCode!,
+                  ),
+                if (deadline != null)
+                  _Meta(
+                    icon: Icons.event_outlined,
+                    text: 'Deadline ${timeConvertor(deadline)}',
+                  ),
+                if (tender?.buyerOrganization?.name?.isNotEmpty == true)
+                  _Meta(
+                    icon: Icons.business_outlined,
+                    text: tender!.buyerOrganization!.name!,
+                  ),
+              ],
+            ),
+            if (submission.statusHistory.isNotEmpty) ...[
+              const SizedBox(height: 4),
+              ExpansionTile(
+                tilePadding: EdgeInsets.zero,
+                childrenPadding: EdgeInsets.zero,
+                dense: true,
+                title: Text(
+                  'Activity (${submission.statusHistory.length})',
+                  style: TextStyle(color: AppColors.grey60, fontSize: 13),
+                ),
+                children:
+                    submission.statusHistory.reversed
+                        .map(
+                          (item) => ListTile(
+                            dense: true,
+                            contentPadding: EdgeInsets.zero,
+                            leading: const Icon(Icons.circle, size: 8),
+                            title: Text(
+                              _statusLabels[item.status] ?? item.status,
+                              style: TextStyle(color: AppColors.grey80),
+                            ),
+                            subtitle: Text(
+                              [
+                                timeConvertor(item.changedAt, hasTime: true),
+                                if (item.description?.isNotEmpty == true)
+                                  item.description!,
+                                if (item.reason?.isNotEmpty == true)
+                                  item.reason!,
+                              ].join(' · '),
+                            ),
+                          ),
+                        )
+                        .toList(),
+              ),
+            ],
+            if (!submission.isTerminal) ...[
+              const SizedBox(height: 12),
+              if (busy)
+                const LinearProgressIndicator(color: AppColors.secondary50)
+              else
+                _Actions(submission: submission),
+            ],
+          ],
+        ),
+      ),
+    );
+  }
+}
+
+class _Actions extends StatelessWidget {
+  const _Actions({required this.submission});
+
+  final TenderSubmission submission;
+
+  @override
+  Widget build(BuildContext context) {
+    final primary = <({String label, String status, String description})>[];
+    switch (submission.status) {
+      case 'opportunity':
+        primary.add((
+          label: 'Start validation',
+          status: 'validating',
+          description: 'User accepted tender',
+        ));
+      case 'validating':
+        if (submission.submissionMode == 'partnership') {
+          primary.add((
+            label: 'Wait for partner',
+            status: 'partner_pending',
+            description: 'Validation completed; waiting for partner documents',
+          ));
+        } else if (submission.submissionMode == 'self-apply') {
+          primary.add((
+            label: 'Start applying',
+            status: 'applying',
+            description: 'Validation completed',
+          ));
+        } else {
+          primary.addAll([
+            (
+              label: 'Start applying',
+              status: 'applying',
+              description: 'Validation completed',
+            ),
+            (
+              label: 'Wait for partner',
+              status: 'partner_pending',
+              description:
+                  'Validation completed; waiting for partner documents',
+            ),
+          ]);
+        }
+      case 'partner_pending':
+        primary.add((
+          label: 'Partner docs ready',
+          status: 'applying',
+          description: 'Partner documents received',
+        ));
+      case 'applying':
+        primary.add((
+          label: 'Submitted to buyer',
+          status: 'sent_waiting',
+          description: 'Application filed with procurement authority',
+        ));
+      case 'sent_waiting':
+        primary.addAll([
+          (
+            label: 'Mark won',
+            status: 'contract',
+            description: 'Contract awarded',
+          ),
+          (
+            label: 'Mark lost',
+            status: 'rejected',
+            description: 'Buyer rejected bid',
+          ),
+        ]);
+    }
+
+    return Wrap(
+      spacing: 8,
+      runSpacing: 8,
+      children: [
+        for (final action in primary)
+          FilledButton(
+            onPressed:
+                () => _confirmUpdate(
+                  context,
+                  status: action.status,
+                  label: action.label,
+                  description: action.description,
+                ),
+            style: FilledButton.styleFrom(
+              backgroundColor: AppColors.secondary50,
+            ),
+            child: Text(action.label),
+          ),
+        if (submission.status != 'sent_waiting')
+          OutlinedButton(
+            onPressed: () => _reject(context),
+            style: OutlinedButton.styleFrom(foregroundColor: AppColors.error),
+            child: const Text('Do not apply'),
+          ),
+      ],
+    );
+  }
+
+  Future<void> _confirmUpdate(
+    BuildContext context, {
+    required String status,
+    required String label,
+    required String description,
+  }) async {
+    final confirmed = await showDialog<bool>(
+      context: context,
+      builder:
+          (dialogContext) => AlertDialog(
+            title: Text(label),
+            content: const Text('Update this tender submission?'),
+            actions: [
+              TextButton(
+                onPressed: () => Navigator.pop(dialogContext, false),
+                child: const Text('Cancel'),
+              ),
+              FilledButton(
+                onPressed: () => Navigator.pop(dialogContext, true),
+                child: const Text('Confirm'),
+              ),
+            ],
+          ),
+    );
+    if (confirmed == true && context.mounted) {
+      await context.read<YourTendersViewModel>().updateSubmissionStatus(
+        submission: submission,
+        status: status,
+        description: description,
+      );
+    }
+  }
+
+  Future<void> _reject(BuildContext context) async {
+    final controller = TextEditingController();
+    final reason = await showDialog<String>(
+      context: context,
+      builder:
+          (dialogContext) => AlertDialog(
+            title: const Text('Do not apply'),
+            content: TextField(
+              controller: controller,
+              maxLength: 500,
+              maxLines: 3,
+              decoration: const InputDecoration(
+                labelText: 'Reason (optional)',
+                border: OutlineInputBorder(),
+              ),
+            ),
+            actions: [
+              TextButton(
+                onPressed: () => Navigator.pop(dialogContext),
+                child: const Text('Cancel'),
+              ),
+              FilledButton(
+                onPressed: () => Navigator.pop(dialogContext, controller.text),
+                child: const Text('Confirm'),
+              ),
+            ],
+          ),
+    );
+    controller.dispose();
+    if (reason != null && context.mounted) {
+      await context.read<YourTendersViewModel>().updateSubmissionStatus(
+        submission: submission,
+        status: 'not_applied',
+        reason: reason,
+      );
+    }
+  }
+}
+
+class _StatusBadge extends StatelessWidget {
+  const _StatusBadge({required this.label, required this.status});
+  final String label;
+  final String status;
+
+  @override
+  Widget build(BuildContext context) {
+    final terminal = status == 'rejected' || status == 'not_applied';
+    final won = status == 'contract';
+    final color =
+        terminal
+            ? AppColors.error
+            : (won ? AppColors.green30 : AppColors.blue10);
+    return Container(
+      padding: const EdgeInsets.symmetric(horizontal: 10, vertical: 5),
+      decoration: BoxDecoration(
+        color: color.withValues(alpha: .12),
+        borderRadius: BorderRadius.circular(20),
+      ),
+      child: Text(
+        label,
+        style: TextStyle(
+          color: color,
+          fontSize: 12,
+          fontWeight: FontWeight.w600,
+        ),
+      ),
+    );
+  }
+}
+
+class _Meta extends StatelessWidget {
+  const _Meta({required this.icon, required this.text});
+  final IconData icon;
+  final String text;
+
+  @override
+  Widget build(BuildContext context) => Row(
+    mainAxisSize: MainAxisSize.min,
+    children: [
+      Icon(icon, size: 16, color: AppColors.grey60),
+      const SizedBox(width: 4),
+      Text(text, style: TextStyle(color: AppColors.grey60, fontSize: 12)),
+    ],
+  );
+}

lib/views/your_tenders/widgets/tender_card.dart

@@ -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(),

test/data/repositories/company_ai_repository_test.dart

@@ -0,0 +1,92 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+import 'package:tm_app/core/constants/pref_keys.dart';
+import 'package:tm_app/core/network/network_manager.dart';
+import 'package:tm_app/core/utils/logger.dart';
+import 'package:tm_app/core/utils/result.dart';
+import 'package:tm_app/data/repositories/company_ai_repository.dart';
+import 'package:tm_app/data/services/company_ai_service.dart';
+import 'package:tm_app/data/services/model/onboarding_response/onboarding_response.dart';
+import 'package:tm_app/data/services/model/recommend_response/recommend_response.dart';
+
+void main() {
+  setUpAll(() {
+    appLogger.init();
+  });
+
+  group('CompanyAiRepository', () {
+    test('skips onboarding when company has no indexable data', () async {
+      SharedPreferences.setMockInitialValues({});
+      final prefs = await SharedPreferences.getInstance();
+      final service = _FakeCompanyAiService(prefs);
+      final repository = CompanyAiRepository(
+        companyAiService: service,
+        prefs: prefs,
+      );
+
+      final outcome = await repository.maybeStartOnboarding(
+        documentFileIds: const [],
+        website: ' ',
+      );
+
+      expect(outcome, AiOnboardingOutcome.skippedNoData);
+      expect(service.startOnboardingCalls, 0);
+      expect(prefs.getString(PrefKeys.onboardingFingerprint), isNull);
+    });
+
+    test('stores fingerprint and skips unchanged profile data', () async {
+      SharedPreferences.setMockInitialValues({});
+      final prefs = await SharedPreferences.getInstance();
+      final service = _FakeCompanyAiService(prefs);
+      final repository = CompanyAiRepository(
+        companyAiService: service,
+        prefs: prefs,
+      );
+
+      final firstOutcome = await repository.maybeStartOnboarding(
+        documentFileIds: const ['b', 'a'],
+        website: ' https://example.com ',
+      );
+      final secondOutcome = await repository.maybeStartOnboarding(
+        documentFileIds: const ['a', 'b'],
+        website: 'https://example.com',
+      );
+
+      expect(firstOutcome, AiOnboardingOutcome.started);
+      expect(secondOutcome, AiOnboardingOutcome.skippedUnchanged);
+      expect(service.startOnboardingCalls, 1);
+      expect(
+        prefs.getString(PrefKeys.onboardingFingerprint),
+        'a,b|https://example.com',
+      );
+      expect(prefs.getInt(PrefKeys.onboardingStartedAt), isNotNull);
+    });
+  });
+}
+
+class _FakeCompanyAiService extends CompanyAiService {
+  _FakeCompanyAiService(SharedPreferences prefs)
+    : super(networkManager: NetworkManager(prefs));
+
+  int startOnboardingCalls = 0;
+
+  @override
+  Future<Result<OnboardingResponse>> startOnboarding() async {
+    startOnboardingCalls += 1;
+    return const Result.ok(
+      OnboardingResponse(
+        data: null,
+        error: null,
+        message: 'started',
+        success: true,
+      ),
+    );
+  }
+
+  @override
+  Future<Result<RecommendResponse>> getRecommendations() async {
+    return const Result.ok(
+      RecommendResponse(data: [], error: null, message: 'ok', success: true),
+    );
+  }
+}

test/model/onboarding_response_test.dart

@@ -0,0 +1,51 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:tm_app/data/services/model/onboarding_response/onboarding_response.dart';
+
+void main() {
+  group('OnboardingResponse Model Test', () {
+    final mockJson = {
+      'success': true,
+      'message': 'AI onboarding started successfully',
+      'data': {'status': 'started'},
+      'error': {'message': null, 'code': null, 'details': null},
+    };
+
+    test('fromJson creates valid OnboardingResponse instance', () {
+      final response = OnboardingResponse.fromJson(mockJson);
+
+      expect(response.success, true);
+      expect(response.message, 'AI onboarding started successfully');
+      expect(response.data?.status, 'started');
+    });
+
+    test('handles null data gracefully', () {
+      final response = OnboardingResponse.fromJson({
+        'success': false,
+        'message': 'AI service not configured',
+        'data': null,
+        'error': {'message': 'unavailable', 'code': '503', 'details': null},
+      });
+
+      expect(response.success, false);
+      expect(response.data, isNull);
+      expect(response.error?.message, 'unavailable');
+    });
+
+    test('toJson round-trips status', () {
+      final response = OnboardingResponse.fromJson(mockJson);
+      final json = response.toJson();
+      final data = Map<String, dynamic>.from(json['data'] as Map);
+
+      expect(json['success'], true);
+      expect(data['status'], 'started');
+    });
+
+    test('equality and copyWith work as expected', () {
+      final response = OnboardingResponse.fromJson(mockJson);
+      final updated = response.copyWith(message: 'Updated');
+
+      expect(updated.message, 'Updated');
+      expect(updated != response, true);
+    });
+  });
+}

test/model/recommend_response_test.dart

@@ -0,0 +1,69 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:tm_app/data/services/model/recommend_response/recommend_response.dart';
+
+void main() {
+  group('RecommendResponse Model Test', () {
+    final mockJson = {
+      'success': true,
+      'message': 'AI recommendations retrieved successfully',
+      'data': [
+        {
+          'rank': '1',
+          'tender_id': '674a1b2c3d4e5f6789012345',
+          'analysis': 'Strong match based on company industry and CPV codes.',
+        },
+        {
+          'rank': '2',
+          'tender_id': '674a1b2c3d4e5f6789012346',
+          'analysis': 'Relevant scope and geographic fit.',
+        },
+      ],
+      'error': {'message': null, 'code': null, 'details': null},
+    };
+
+    test('fromJson parses the ranked recommendation list', () {
+      final response = RecommendResponse.fromJson(mockJson);
+
+      expect(response.success, true);
+      expect(response.data, isNotNull);
+      expect(response.data!.length, 2);
+      expect(response.data!.first.rank, '1');
+      expect(response.data!.first.tenderId, '674a1b2c3d4e5f6789012345');
+      expect(
+        response.data!.first.analysis,
+        'Strong match based on company industry and CPV codes.',
+      );
+    });
+
+    test('handles empty data (AI still indexing)', () {
+      final response = RecommendResponse.fromJson({
+        'success': true,
+        'message': 'AI recommendations retrieved successfully',
+        'data': <dynamic>[],
+        'error': null,
+      });
+
+      expect(response.success, true);
+      expect(response.data, isEmpty);
+    });
+
+    test('toJson round-trips the nested items', () {
+      final response = RecommendResponse.fromJson(mockJson);
+      final json = response.toJson();
+      final data = (json['data'] as List).cast<Map<String, dynamic>>();
+
+      expect(json['success'], true);
+      expect(data.length, 2);
+      expect(data[1]['tender_id'], '674a1b2c3d4e5f6789012346');
+      expect(data[1]['rank'], '2');
+    });
+
+    test('equality and copyWith work as expected', () {
+      final response = RecommendResponse.fromJson(mockJson);
+      final updated = response.copyWith(message: 'Updated');
+
+      expect(updated.message, 'Updated');
+      expect(updated != response, true);
+    });
+  });
+}

test/model/tender_submission_test.dart

@@ -0,0 +1,90 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:tm_app/data/services/model/tender_submission/tender_submission.dart';
+
+void main() {
+  group('TenderSubmissionsResponse', () {
+    test('parses root pagination metadata and a reduced tender payload', () {
+      final response = TenderSubmissionsResponse.fromJson({
+        'success': true,
+        'message': 'Tender submissions retrieved successfully',
+        'data': [
+          {
+            'id': 'submission-1',
+            'tender_id': 'tender-1',
+            'company_id': 'company-1',
+            'customer_id': 'customer-1',
+            'status': 'validating',
+            'stage': 'in_progress',
+            'created_at': 1710000000,
+            'updated_at': 1710003600,
+            'status_history': [
+              {
+                'status': 'validating',
+                'changed_at': 1710003600,
+                'description': 'User accepted tender',
+              },
+            ],
+            'tender': {
+              'id': 'tender-1',
+              'title': 'IT Infrastructure Services',
+              'description': 'A reduced tender payload',
+              'submission_deadline': 1714000000,
+              'country_code': 'DE',
+              'status': 'active',
+            },
+          },
+        ],
+        'meta': {
+          'total': 42,
+          'limit': 20,
+          'offset': 0,
+          'page': 1,
+          'pages': 3,
+          'has_more': true,
+        },
+      });
+
+      expect(response.success, isTrue);
+      expect(response.data, hasLength(1));
+      expect(response.data.single.status, 'validating');
+      expect(response.data.single.stage, 'in_progress');
+      expect(response.data.single.tender?.title, 'IT Infrastructure Services');
+      expect(response.data.single.statusHistory.single.changedAt, 1710003600);
+      expect(response.meta?.total, 42);
+      expect(response.meta?.hasMore, isTrue);
+    });
+
+    test('keeps a submission when its tender is null', () {
+      final response = TenderSubmissionResponse.fromJson({
+        'success': true,
+        'data': {
+          'id': 'submission-2',
+          'tender_id': 'tender-2',
+          'status': 'not_applied',
+          'stage': 'not_applied',
+          'tender': null,
+        },
+      });
+
+      expect(response.data?.tender, isNull);
+      expect(response.data?.isTerminal, isTrue);
+    });
+  });
+
+  test('parses company stats maps', () {
+    final response = TenderSubmissionStatsResponse.fromJson({
+      'success': true,
+      'data': {
+        'company_id': 'company-1',
+        'total': 15,
+        'by_stage': {'opportunity': 3, 'in_progress': 5},
+        'by_status': {'validating': 2, 'contract': 2},
+        'last_updated': 1710003600,
+      },
+    });
+
+    expect(response.data?.total, 15);
+    expect(response.data?.byStage['in_progress'], 5);
+    expect(response.data?.byStatus['contract'], 2);
+  });
+}

test/view_models/ai_recommendations_view_model_test.dart

@@ -0,0 +1,209 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+import 'package:tm_app/core/network/network_manager.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/company_ai_service.dart';
+import 'package:tm_app/data/services/home_service.dart';
+import 'package:tm_app/data/services/liked_tenders_service.dart';
+import 'package:tm_app/data/services/model/recommended_tenders_data/recommended_tenders_data.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';
+import 'package:tm_app/data/services/your_tenders_service.dart';
+import 'package:tm_app/data/services/tender_submissions_service.dart';
+import 'package:tm_app/view_models/ai_recommendations_view_model.dart';
+
+void main() {
+  group('AiRecommendationsViewModel', () {
+    test(
+      'loads recommended tenders from GET /api/v1/tenders/recommend',
+      () async {
+        final prefs = await _prefs();
+        final homeRepository = _FakeHomeRepository(
+          prefs,
+          result: Result.ok(
+            RecommendedTendersResponse(
+              success: true,
+              message: 'ok',
+              error: null,
+              data: RecommendedTendersData(
+                tenders: [
+                  _sampleTender(id: 'tender-1', title: 'Bridge repair'),
+                ],
+                metadata: null,
+              ),
+            ),
+          ),
+        );
+        final viewModel = AiRecommendationsViewModel(
+          companyAiRepository: _FakeCompanyAiRepository(prefs),
+          homeRepository: homeRepository,
+        );
+
+        await viewModel.loadRecommendations();
+
+        expect(viewModel.hasLoaded, isTrue);
+        expect(viewModel.errorMessage, isNull);
+        expect(homeRepository.recommendedTendersCalls, 1);
+        expect(viewModel.recommendedTenders.single.id, 'tender-1');
+      },
+    );
+
+    test('keeps failed transient loads retryable for loadIfNeeded', () async {
+      final prefs = await _prefs();
+      final homeRepository = _FakeHomeRepository(
+        prefs,
+        results: [
+          Result.error(Exception('network failed')),
+          Result.ok(
+            RecommendedTendersResponse(
+              success: true,
+              message: 'ok',
+              error: null,
+              data: RecommendedTendersData(
+                tenders: [
+                  _sampleTender(id: 'tender-1', title: 'Bridge repair'),
+                ],
+                metadata: null,
+              ),
+            ),
+          ),
+        ],
+      );
+      final viewModel = AiRecommendationsViewModel(
+        companyAiRepository: _FakeCompanyAiRepository(prefs),
+        homeRepository: homeRepository,
+      );
+
+      await viewModel.loadRecommendations();
+      await viewModel.loadIfNeeded();
+
+      expect(homeRepository.recommendedTendersCalls, 2);
+      expect(viewModel.hasLoaded, isTrue);
+      expect(viewModel.errorMessage, isNull);
+      expect(viewModel.recommendedTenders.single.id, 'tender-1');
+    });
+
+    test(
+      'marks empty results as still learning after recent onboarding',
+      () async {
+        final prefs = await _prefs();
+        final viewModel = AiRecommendationsViewModel(
+          companyAiRepository: _FakeCompanyAiRepository(
+            prefs,
+            lastOnboardingStartedAt: DateTime.now().millisecondsSinceEpoch,
+          ),
+          homeRepository: _FakeHomeRepository(prefs),
+        );
+
+        await viewModel.loadRecommendations();
+
+        expect(viewModel.hasLoaded, isTrue);
+        expect(viewModel.stillLearning, isTrue);
+        expect(viewModel.isEmpty, isTrue);
+      },
+    );
+  });
+}
+
+Future<SharedPreferences> _prefs() async {
+  SharedPreferences.setMockInitialValues({});
+  return SharedPreferences.getInstance();
+}
+
+class _FakeCompanyAiRepository extends CompanyAiRepository {
+  _FakeCompanyAiRepository(
+    SharedPreferences prefs, {
+    int? lastOnboardingStartedAt,
+  }) : _lastOnboardingStartedAt = lastOnboardingStartedAt,
+       super(companyAiService: _UnusedCompanyAiService(prefs), prefs: prefs);
+
+  final int? _lastOnboardingStartedAt;
+
+  @override
+  int? lastOnboardingStartedAt() => _lastOnboardingStartedAt;
+}
+
+class _FakeHomeRepository extends HomeRepository {
+  _FakeHomeRepository(
+    SharedPreferences prefs, {
+    List<Result<RecommendedTendersResponse>>? results,
+    Result<RecommendedTendersResponse>? result,
+  }) : _results =
+           results ??
+           [
+             result ??
+                 const Result.ok(
+                   RecommendedTendersResponse(
+                     success: true,
+                     message: 'ok',
+                     error: null,
+                     data: RecommendedTendersData(tenders: [], metadata: null),
+                   ),
+                 ),
+           ],
+       super(
+         homeService: HomeService(networkManager: NetworkManager(prefs)),
+         yourTendersService: YourTendersService(
+           networkManager: NetworkManager(prefs),
+         ),
+         likedTendersService: LikedTendersService(
+           networkManager: NetworkManager(prefs),
+         ),
+         tenderSubmissionsService: TenderSubmissionsService(
+           networkManager: NetworkManager(prefs),
+         ),
+       );
+
+  final List<Result<RecommendedTendersResponse>> _results;
+  int recommendedTendersCalls = 0;
+
+  @override
+  Future<Result<RecommendedTendersResponse>> getHomeRecommendedTenders({
+    required int limit,
+    required int offset,
+  }) async {
+    final index = recommendedTendersCalls;
+    recommendedTendersCalls += 1;
+    return _results[index];
+  }
+}
+
+class _UnusedCompanyAiService extends CompanyAiService {
+  _UnusedCompanyAiService(SharedPreferences prefs)
+    : super(networkManager: NetworkManager(prefs));
+}
+
+TenderData _sampleTender({required String id, required String title}) {
+  return TenderData(
+    success: null,
+    message: null,
+    id: id,
+    tenderId: id,
+    noticePublicationId: null,
+    noticeTypeCode: null,
+    formType: null,
+    noticeLanguageCode: null,
+    issueDate: null,
+    issueTime: null,
+    publicationDate: null,
+    title: title,
+    description: null,
+    procurementTypeCode: null,
+    procedureCode: null,
+    estimatedValue: null,
+    currency: null,
+    duration: null,
+    tenderDeadline: null,
+    submissionDeadline: null,
+    applicationDeadline: null,
+    submissionUrl: null,
+    countryCode: null,
+    durationUnit: null,
+    buyerOrganization: null,
+    lots: null,
+    officialLanguages: null,
+    status: null,
+  );
+}