feat: enhance Letzshop jobs and order management

- Add job cancellation and retry functionality
- Improve jobs table with better status display
- Add background task improvements
- Update Letzshop order service
- Update documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

app/services/letzshop/order_service.py

@@ -619,6 +619,11 @@ class LetzshopOrderService:
         """
         jobs = []
 
+        # Fetch vendor info once for all jobs
+        vendor = self.get_vendor(vendor_id)
+        vendor_name = vendor.name if vendor else None
+        vendor_code = vendor.vendor_code if vendor else None
+
         # Historical order imports from letzshop_historical_import_jobs
         if job_type in (None, "historical_import"):
             hist_query = self.db.query(LetzshopHistoricalImportJob).filter(
@@ -646,6 +651,9 @@ class LetzshopOrderService:
                         "records_succeeded": (job.orders_imported or 0)
                         + (job.orders_updated or 0),
                         "records_failed": job.orders_skipped or 0,
+                        "vendor_id": vendor_id,
+                        "vendor_name": vendor_name,
+                        "vendor_code": vendor_code,
                         "current_phase": job.current_phase,
                         "error_message": job.error_message,
                     }
@@ -679,6 +687,9 @@ class LetzshopOrderService:
                         "records_succeeded": (job.imported_count or 0)
                         + (job.updated_count or 0),
                         "records_failed": job.error_count or 0,
+                        "vendor_id": vendor_id,
+                        "vendor_name": vendor_name,
+                        "vendor_code": vendor_code,
                     }
                 )
 
@@ -705,6 +716,9 @@ class LetzshopOrderService:
                         "records_processed": log.records_processed or 0,
                         "records_succeeded": log.records_succeeded or 0,
                         "records_failed": log.records_failed or 0,
+                        "vendor_id": vendor_id,
+                        "vendor_name": vendor_name,
+                        "vendor_code": vendor_code,
                         "error_details": log.error_details,
                     }
                 )
@@ -734,6 +748,9 @@ class LetzshopOrderService:
                         "records_processed": log.records_processed or 0,
                         "records_succeeded": log.records_succeeded or 0,
                         "records_failed": log.records_failed or 0,
+                        "vendor_id": vendor_id,
+                        "vendor_name": vendor_name,
+                        "vendor_code": vendor_code,
                         "error_details": log.error_details,  # Include export file details
                     }
                 )

app/tasks/background_tasks.py

@@ -5,6 +5,7 @@ import logging
 from datetime import UTC, datetime
 
 from app.core.database import SessionLocal
+from app.services.admin_notification_service import admin_notification_service
 from app.utils.csv_processor import CSVProcessor
 from models.database.marketplace_import_job import MarketplaceImportJob
 from models.database.vendor import Vendor
@@ -88,6 +89,16 @@ async def process_marketplace_import(
             job.status = "completed_with_errors"
             job.error_message = f"{result['errors']} rows had errors"
 
+            # Notify admin if error count is significant
+            if result.get("errors", 0) >= 5:
+                admin_notification_service.notify_import_failure(
+                    db=db,
+                    vendor_name=vendor.name,
+                    job_id=job_id,
+                    error_message=f"Import completed with {result['errors']} errors out of {result['total_processed']} rows",
+                    vendor_id=vendor_id,
+                )
+
         db.commit()
         logger.info(
             f"Import job {job_id} completed: "
@@ -102,6 +113,17 @@ async def process_marketplace_import(
                 job.status = "failed"
                 job.error_message = str(e)
                 job.completed_at = datetime.now(UTC)
+
+                # Create admin notification for import failure
+                vendor_name = vendor.name if vendor else f"Vendor {vendor_id}"
+                admin_notification_service.notify_import_failure(
+                    db=db,
+                    vendor_name=vendor_name,
+                    job_id=job_id,
+                    error_message=str(e)[:200],  # Truncate long errors
+                    vendor_id=vendor_id,
+                )
+
                 db.commit()
             except Exception as commit_error:
                 logger.error(f"Failed to update job status: {commit_error}")

app/tasks/letzshop_tasks.py

@@ -6,6 +6,7 @@ from datetime import UTC, datetime
 from typing import Callable
 
 from app.core.database import SessionLocal
+from app.services.admin_notification_service import admin_notification_service
 from app.services.letzshop import LetzshopClientError
 from app.services.letzshop.credentials_service import LetzshopCredentialsService
 from app.services.letzshop.order_service import LetzshopOrderService
@@ -207,6 +208,20 @@ def process_historical_import(job_id: int, vendor_id: int):
                 job.status = "failed"
                 job.error_message = f"Letzshop API error: {e}"
                 job.completed_at = datetime.now(UTC)
+
+                # Get vendor name for notification
+                order_service = _get_order_service(db)
+                vendor = order_service.get_vendor(vendor_id)
+                vendor_name = vendor.name if vendor else f"Vendor {vendor_id}"
+
+                # Create admin notification for sync failure
+                admin_notification_service.notify_order_sync_failure(
+                    db=db,
+                    vendor_name=vendor_name,
+                    error_message=f"Historical import failed: {str(e)[:150]}",
+                    vendor_id=vendor_id,
+                )
+
                 db.commit()
 
                 creds_service = _get_credentials_service(db)
@@ -222,6 +237,20 @@ def process_historical_import(job_id: int, vendor_id: int):
                 job.status = "failed"
                 job.error_message = str(e)
                 job.completed_at = datetime.now(UTC)
+
+                # Get vendor name for notification
+                order_service = _get_order_service(db)
+                vendor = order_service.get_vendor(vendor_id)
+                vendor_name = vendor.name if vendor else f"Vendor {vendor_id}"
+
+                # Create admin notification for critical error
+                admin_notification_service.notify_critical_error(
+                    db=db,
+                    error_type="Historical Import",
+                    error_message=f"Import job {job_id} failed for {vendor_name}: {str(e)[:150]}",
+                    details={"job_id": job_id, "vendor_id": vendor_id, "vendor_name": vendor_name},
+                )
+
                 db.commit()
             except Exception as commit_error:
                 logger.error(f"Job {job_id}: Failed to update job status: {commit_error}")

app/templates/admin/partials/letzshop-jobs-table.html

@@ -52,6 +52,7 @@
                 <thead>
                     <tr class="text-xs font-semibold tracking-wide text-left text-gray-500 uppercase border-b dark:border-gray-700 bg-gray-50 dark:text-gray-400 dark:bg-gray-700">
                         <th class="px-4 py-3">ID</th>
+                        <th class="px-4 py-3">Vendor</th>
                         <th class="px-4 py-3">Type</th>
                         <th class="px-4 py-3">Status</th>
                         <th class="px-4 py-3">Records</th>
@@ -63,7 +64,7 @@
                 <tbody class="bg-white divide-y dark:divide-gray-700 dark:bg-gray-800">
                     <template x-if="loadingJobs && jobs.length === 0">
                         <tr>
-                            <td colspan="7" class="px-4 py-8 text-center text-gray-500 dark:text-gray-400">
+                            <td colspan="8" class="px-4 py-8 text-center text-gray-500 dark:text-gray-400">
                                 <span x-html="$icon('spinner', 'w-6 h-6 mx-auto mb-2')"></span>
                                 <p>Loading jobs...</p>
                             </td>
@@ -71,7 +72,7 @@
                     </template>
                     <template x-if="!loadingJobs && jobs.length === 0">
                         <tr>
-                            <td colspan="7" class="px-4 py-8 text-center text-gray-500 dark:text-gray-400">
+                            <td colspan="8" class="px-4 py-8 text-center text-gray-500 dark:text-gray-400">
                                 <span x-html="$icon('collection', 'w-12 h-12 mx-auto mb-2 text-gray-300')"></span>
                                 <p class="font-medium">No jobs found</p>
                                 <p class="text-sm mt-1">Import products or sync orders to see job history</p>
@@ -83,6 +84,9 @@
                             <td class="px-4 py-3 text-sm font-medium">
                                 <span x-text="'#' + job.id"></span>
                             </td>
+                            <td class="px-4 py-3 text-sm">
+                                <span x-text="job.vendor_code || job.vendor_name || '-'"></span>
+                            </td>
                             <td class="px-4 py-3">
                                 <span
                                     class="px-2 py-1 text-xs font-medium rounded-full"
@@ -154,26 +158,59 @@
             </table>
         </div>
 
-        <!-- Pagination -->
+        <!-- Numbered Pagination -->
-        <div x-show="jobsPagination.total > jobsPagination.per_page" class="flex items-center justify-between mt-4 pt-4 border-t dark:border-gray-700">
+        <div x-show="jobsPagination.total > jobsPagination.per_page" class="flex flex-col sm:flex-row items-center justify-between gap-4 mt-4 pt-4 border-t dark:border-gray-700">
             <span class="text-sm text-gray-600 dark:text-gray-400">
                 Showing <span x-text="((jobsPagination.page - 1) * jobsPagination.per_page) + 1"></span>-<span x-text="Math.min(jobsPagination.page * jobsPagination.per_page, jobsPagination.total)"></span> of <span x-text="jobsPagination.total"></span> jobs
             </span>
-            <div class="flex items-center gap-2">
+            <div class="flex items-center gap-1">
+                {# First page #}
+                <button
+                    @click="jobsPagination.page = 1; loadJobs()"
+                    :disabled="jobsPagination.page <= 1"
+                    class="px-2 py-1 text-sm font-medium text-gray-700 dark:text-gray-300 bg-white dark:bg-gray-700 border border-gray-300 dark:border-gray-600 rounded-md hover:bg-gray-50 dark:hover:bg-gray-600 disabled:opacity-50 disabled:cursor-not-allowed"
+                    title="First page"
+                >
+                    <span x-html="$icon('chevron-double-left', 'w-4 h-4')"></span>
+                </button>
+                {# Previous page #}
                 <button
                     @click="jobsPagination.page--; loadJobs()"
                     :disabled="jobsPagination.page <= 1"
-                    class="px-3 py-1 text-sm font-medium text-gray-700 dark:text-gray-300 bg-white dark:bg-gray-700 border border-gray-300 dark:border-gray-600 rounded-md hover:bg-gray-50 dark:hover:bg-gray-600 disabled:opacity-50"
+                    class="px-2 py-1 text-sm font-medium text-gray-700 dark:text-gray-300 bg-white dark:bg-gray-700 border border-gray-300 dark:border-gray-600 rounded-md hover:bg-gray-50 dark:hover:bg-gray-600 disabled:opacity-50 disabled:cursor-not-allowed"
+                    title="Previous page"
                 >
                     <span x-html="$icon('chevron-left', 'w-4 h-4')"></span>
                 </button>
+                {# Page numbers #}
+                <template x-for="p in getPageNumbers()" :key="p">
+                    <button
+                        @click="goToPage(p)"
+                        class="px-3 py-1 text-sm font-medium rounded-md border transition-colors"
+                        :class="p === jobsPagination.page
+                            ? 'bg-purple-600 text-white border-purple-600 dark:bg-purple-500 dark:border-purple-500'
+                            : 'text-gray-700 dark:text-gray-300 bg-white dark:bg-gray-700 border-gray-300 dark:border-gray-600 hover:bg-gray-50 dark:hover:bg-gray-600'"
+                        x-text="p"
+                    ></button>
+                </template>
+                {# Next page #}
                 <button
                     @click="jobsPagination.page++; loadJobs()"
-                    :disabled="jobsPagination.page * jobsPagination.per_page >= jobsPagination.total"
+                    :disabled="jobsPagination.page >= jobsTotalPages"
-                    class="px-3 py-1 text-sm font-medium text-gray-700 dark:text-gray-300 bg-white dark:bg-gray-700 border border-gray-300 dark:border-gray-600 rounded-md hover:bg-gray-50 dark:hover:bg-gray-600 disabled:opacity-50"
+                    class="px-2 py-1 text-sm font-medium text-gray-700 dark:text-gray-300 bg-white dark:bg-gray-700 border border-gray-300 dark:border-gray-600 rounded-md hover:bg-gray-50 dark:hover:bg-gray-600 disabled:opacity-50 disabled:cursor-not-allowed"
+                    title="Next page"
                 >
                     <span x-html="$icon('chevron-right', 'w-4 h-4')"></span>
                 </button>
+                {# Last page #}
+                <button
+                    @click="jobsPagination.page = jobsTotalPages; loadJobs()"
+                    :disabled="jobsPagination.page >= jobsTotalPages"
+                    class="px-2 py-1 text-sm font-medium text-gray-700 dark:text-gray-300 bg-white dark:bg-gray-700 border border-gray-300 dark:border-gray-600 rounded-md hover:bg-gray-50 dark:hover:bg-gray-600 disabled:opacity-50 disabled:cursor-not-allowed"
+                    title="Last page"
+                >
+                    <span x-html="$icon('chevron-double-right', 'w-4 h-4')"></span>
+                </button>
             </div>
         </div>
     </div>

docs/implementation/letzshop-jobs-improvements.md

@@ -2,10 +2,14 @@
 
 Implementation plan for improving the Letzshop management page jobs display and table harmonization.
 
-## Status: In Progress
+## Status: Completed
 
 ### Completed
 - [x] Phase 1: Job Details Modal (commit cef80af)
+- [x] Phase 2: Add vendor column to jobs table
+- [x] Phase 3: Platform settings system (rows per page)
+- [x] Phase 4: Numbered pagination for jobs table
+- [x] Phase 5: Admin customer management page
 
 ---
 

models/schema/letzshop.py

@@ -436,11 +436,18 @@ class LetzshopJobItem(BaseModel):
     records_processed: int = 0
     records_succeeded: int = 0
     records_failed: int = 0
+    # Vendor info
+    vendor_id: int | None = Field(None, description="Vendor ID")
+    vendor_name: str | None = Field(None, description="Vendor name")
+    vendor_code: str | None = Field(None, description="Vendor code")
     # Historical import specific fields
     current_phase: str | None = Field(
         None, description="Current phase for historical imports"
     )
     error_message: str | None = Field(None, description="Error message if failed")
+    error_details: dict[str, Any] | None = Field(
+        None, description="Error details or export file info"
+    )
 
 
 class LetzshopJobsListResponse(BaseModel):

static/admin/js/marketplace-letzshop.js

@@ -1375,6 +1375,44 @@ function adminMarketplaceLetzshop() {
         // JOBS TABLE
         // ═══════════════════════════════════════════════════════════════
 
+        /**
+         * Get total pages for jobs pagination
+         */
+        get jobsTotalPages() {
+            return Math.ceil(this.jobsPagination.total / this.jobsPagination.per_page);
+        },
+
+        /**
+         * Get array of page numbers to display for jobs pagination
+         */
+        getPageNumbers() {
+            const total = this.jobsTotalPages;
+            const current = this.jobsPagination.page;
+            const maxVisible = 5;
+
+            if (total <= maxVisible) {
+                return Array.from({length: total}, (_, i) => i + 1);
+            }
+
+            const half = Math.floor(maxVisible / 2);
+            let start = Math.max(1, current - half);
+            let end = Math.min(total, start + maxVisible - 1);
+
+            if (end - start < maxVisible - 1) {
+                start = Math.max(1, end - maxVisible + 1);
+            }
+
+            return Array.from({length: end - start + 1}, (_, i) => start + i);
+        },
+
+        /**
+         * Go to specific page for jobs
+         */
+        goToPage(page) {
+            this.jobsPagination.page = page;
+            this.loadJobs();
+        },
+
         /**
          * Load jobs for selected vendor
          * Note: Jobs are vendor-specific, so we need a vendor selected to show them