feat: add metadata refresh job to re-download metadata for linked series

Adds a new job type that refreshes metadata from external providers for all series already linked via approved external_metadata_links. Tracks and displays per-field diffs (series and book level), respects locked fields, and provides a detailed change report in the job detail page. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-19 09:09:10 +01:00
parent 818bd82e0f
commit 163dc3698c
17 changed files with 1170 additions and 56 deletions
--- a/apps/backoffice/app/components/JobRow.tsx
+++ b/apps/backoffice/app/components/JobRow.tsx
@@ -4,7 +4,7 @@ import { useState } from "react";
 import Link from "next/link";
 import { useTranslation } from "../../lib/i18n/context";
 import { JobProgress } from "./JobProgress";
-import { StatusBadge, JobTypeBadge, Button, MiniProgressBar } from "./ui";
+import { StatusBadge, JobTypeBadge, Button, MiniProgressBar, Icon } from "./ui";

 interface JobRowProps {
  job: {
@@ -59,28 +59,11 @@ export function JobRow({ job, libraryName, highlighted, onCancel, formatDate, fo
  const isThumbnailJob = job.type === "thumbnail_rebuild" || job.type === "thumbnail_regenerate";
  const hasThumbnailPhase = isPhase2 || isThumbnailJob;

-  // Files column: index-phase stats only (Phase 1 discovery)
-  const filesDisplay =
-    job.status === "running" && !isPhase2
-      ? job.total_files != null
-        ? `${job.processed_files ?? 0}/${job.total_files}`
-        : scanned > 0
-          ? t("jobRow.scanned", { count: scanned })
-          : "-"
-      : job.status === "success" && (indexed > 0 || removed > 0 || errors > 0)
-        ? null // rendered below as ✓ / − / ⚠
-        : scanned > 0
-          ? t("jobRow.scanned", { count: scanned })
-          : "—";
+  const isMetadataBatch = job.type === "metadata_batch";
+  const isMetadataRefresh = job.type === "metadata_refresh";

-  // Thumbnails column (Phase 2: extracting_pages + generating_thumbnails)
+  // Thumbnails progress (Phase 2: extracting_pages + generating_thumbnails)
  const thumbInProgress = hasThumbnailPhase && (job.status === "running" || isPhase2);
-  const thumbDisplay =
-    thumbInProgress && job.total_files != null
-      ? `${job.processed_files ?? 0}/${job.total_files}`
-      : job.status === "success" && job.total_files != null && hasThumbnailPhase
-        ? `✓ ${job.total_files}`
-        : "—";

  return (
    <>
@@ -122,25 +105,67 @@ export function JobRow({ job, libraryName, highlighted, onCancel, formatDate, fo
        </td>
        <td className="px-4 py-3">
          <div className="flex flex-col gap-1">
-            {filesDisplay !== null ? (
-              <span className="text-sm text-foreground">{filesDisplay}</span>
-            ) : (
-              <div className="flex items-center gap-2 text-xs">
-                <span className="text-success">✓ {indexed}</span>
-                {removed > 0 && <span className="text-warning">− {removed}</span>}
-                {errors > 0 && <span className="text-error">⚠ {errors}</span>}
+            {/* Running progress */}
+            {isActive && job.total_files != null && (
+              <div className="flex flex-col gap-1">
+                <span className="text-sm text-foreground">{job.processed_files ?? 0}/{job.total_files}</span>
+                <MiniProgressBar value={job.processed_files ?? 0} max={job.total_files} className="w-24" />
              </div>
            )}
-            {job.status === "running" && !isPhase2 && job.total_files != null && (
-              <MiniProgressBar value={job.processed_files ?? 0} max={job.total_files} className="w-24" />
-            )}
-          </div>
-        </td>
-        <td className="px-4 py-3">
-          <div className="flex flex-col gap-1">
-            <span className="text-sm text-foreground">{thumbDisplay}</span>
-            {thumbInProgress && job.total_files != null && (
-              <MiniProgressBar value={job.processed_files ?? 0} max={job.total_files} className="w-24" />
+            {/* Completed stats with icons */}
+            {!isActive && (
+              <div className="flex items-center gap-3 text-xs">
+                {/* Files: indexed count */}
+                {indexed > 0 && (
+                  <span className="inline-flex items-center gap-1 text-success" title={t("jobRow.filesIndexed", { count: indexed })}>
+                    <Icon name="document" size="sm" />
+                    {indexed}
+                  </span>
+                )}
+                {/* Removed files */}
+                {removed > 0 && (
+                  <span className="inline-flex items-center gap-1 text-warning" title={t("jobRow.filesRemoved", { count: removed })}>
+                    <Icon name="trash" size="sm" />
+                    {removed}
+                  </span>
+                )}
+                {/* Thumbnails */}
+                {hasThumbnailPhase && job.total_files != null && job.total_files > 0 && (
+                  <span className="inline-flex items-center gap-1 text-primary" title={t("jobRow.thumbnailsGenerated", { count: job.total_files })}>
+                    <Icon name="image" size="sm" />
+                    {job.total_files}
+                  </span>
+                )}
+                {/* Metadata batch: series processed */}
+                {isMetadataBatch && job.total_files != null && job.total_files > 0 && (
+                  <span className="inline-flex items-center gap-1 text-info" title={t("jobRow.metadataProcessed", { count: job.total_files })}>
+                    <Icon name="tag" size="sm" />
+                    {job.total_files}
+                  </span>
+                )}
+                {/* Metadata refresh: links refreshed */}
+                {isMetadataRefresh && job.total_files != null && job.total_files > 0 && (
+                  <span className="inline-flex items-center gap-1 text-info" title={t("jobRow.metadataRefreshed", { count: job.total_files })}>
+                    <Icon name="tag" size="sm" />
+                    {job.total_files}
+                  </span>
+                )}
+                {/* Errors */}
+                {errors > 0 && (
+                  <span className="inline-flex items-center gap-1 text-error" title={t("jobRow.errors", { count: errors })}>
+                    <Icon name="warning" size="sm" />
+                    {errors}
+                  </span>
+                )}
+                {/* Scanned only (no other stats) */}
+                {indexed === 0 && removed === 0 && errors === 0 && !hasThumbnailPhase && !isMetadataBatch && !isMetadataRefresh && scanned > 0 && (
+                  <span className="text-sm text-muted-foreground">{t("jobRow.scanned", { count: scanned })}</span>
+                )}
+                {/* Nothing to show */}
+                {indexed === 0 && removed === 0 && errors === 0 && scanned === 0 && !hasThumbnailPhase && !isMetadataBatch && !isMetadataRefresh && (
+                  <span className="text-sm text-muted-foreground">—</span>
+                )}
+              </div>
            )}
          </div>
        </td>
@@ -172,7 +197,7 @@ export function JobRow({ job, libraryName, highlighted, onCancel, formatDate, fo
      </tr>
      {showProgress && isActive && (
        <tr>
-          <td colSpan={9} className="px-4 py-3 bg-muted/50">
+          <td colSpan={8} className="px-4 py-3 bg-muted/50">
            <JobProgress 
              jobId={job.id}
              onComplete={handleComplete}
--- a/apps/backoffice/app/components/JobsList.tsx
+++ b/apps/backoffice/app/components/JobsList.tsx
@@ -117,8 +117,7 @@ export function JobsList({ initialJobs, libraries, highlightJobId }: JobsListPro
              <th className="px-4 py-3 text-left text-xs font-semibold text-muted-foreground uppercase tracking-wider">{t("jobsList.library")}</th>
              <th className="px-4 py-3 text-left text-xs font-semibold text-muted-foreground uppercase tracking-wider">{t("jobsList.type")}</th>
              <th className="px-4 py-3 text-left text-xs font-semibold text-muted-foreground uppercase tracking-wider">{t("jobsList.status")}</th>
-              <th className="px-4 py-3 text-left text-xs font-semibold text-muted-foreground uppercase tracking-wider">{t("jobsList.files")}</th>
-              <th className="px-4 py-3 text-left text-xs font-semibold text-muted-foreground uppercase tracking-wider">{t("jobsList.thumbnails")}</th>
+              <th className="px-4 py-3 text-left text-xs font-semibold text-muted-foreground uppercase tracking-wider">{t("jobsList.stats")}</th>
              <th className="px-4 py-3 text-left text-xs font-semibold text-muted-foreground uppercase tracking-wider">{t("jobsList.duration")}</th>
              <th className="px-4 py-3 text-left text-xs font-semibold text-muted-foreground uppercase tracking-wider">{t("jobsList.created")}</th>
              <th className="px-4 py-3 text-left text-xs font-semibold text-muted-foreground uppercase tracking-wider">{t("jobsList.actions")}</th>
--- a/apps/backoffice/app/components/ui/Badge.tsx
+++ b/apps/backoffice/app/components/ui/Badge.tsx
@@ -114,6 +114,7 @@ export function JobTypeBadge({ type, className = "" }: JobTypeBadgeProps) {
    thumbnail_regenerate: t("jobType.thumbnail_regenerate"),
    cbr_to_cbz: t("jobType.cbr_to_cbz"),
    metadata_batch: t("jobType.metadata_batch"),
+    metadata_refresh: t("jobType.metadata_refresh"),
  };
  const label = jobTypeLabels[key] ?? type;
  return <Badge variant={variant} className={className}>{label}</Badge>;
--- a/apps/backoffice/app/components/ui/Icon.tsx
+++ b/apps/backoffice/app/components/ui/Icon.tsx
@@ -31,7 +31,9 @@ type IconName =
  | "play"
  | "stop"
  | "spinner"
-  | "warning";
+  | "warning"
+  | "tag"
+  | "document";

 type IconSize = "sm" | "md" | "lg" | "xl";

@@ -82,6 +84,8 @@ const icons: Record<IconName, string> = {
  stop: "M21 12a9 9 0 11-18 0 9 9 0 0118 0z M9 10a1 1 0 011-1h4a1 1 0 011 1v4a1 1 0 01-1 1h-4a1 1 0 01-1-1v-4z",
  spinner: "M4 4v5h.582m15.582 0A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15",
  warning: "M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z",
+  tag: "M7 7h.01M7 3h5a1.99 1.99 0 011.414.586l7 7a2 2 0 010 2.828l-7 7a2 2 0 01-2.828 0l-7-7A1.994 1.994 0 013 12V7a4 4 0 014-4z",
+  document: "M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z",
 };

 const colorClasses: Partial<Record<IconName, string>> = {