Add remote path mapping for qBittorrent integration

Implements remote-to-local path mapping for qBittorrent downloads, allowing the app to handle differing filesystem paths between qBittorrent and the local environment (e.g., remote seedboxes, Docker). Adds UI controls in admin settings and setup wizard, validates mapping configuration, and applies path transformation in download and import processors. Updates documentation, API routes, and data models to support the new feature. Also improves library scan logic to remove stale records and reset orphaned audiobooks and requests. Increases minimum torrent score threshold from 30 to 50 in search and ranking logic, and exposes torrent source URLs in the admin UI.

src/lib/processors/monitor-download.processor.ts

@@ -8,6 +8,8 @@ import { MonitorDownloadPayload, getJobQueueService } from '../services/job-queu
 import { prisma } from '../db';
 import { getQBittorrentService } from '../integrations/qbittorrent.service';
 import { createJobLogger, JobLogger } from '../utils/job-logger';
+import { PathMapper } from '../utils/path-mapper';
+import { getConfigService } from '../services/config.service';
 
 /**
  * Helper function to retry getTorrent with exponential backoff
@@ -94,16 +96,32 @@ export async function processMonitorDownload(payload: MonitorDownloadPayload): P
       // Determine actual content path for file organization
       // Priority 1: Use content_path if provided by qBittorrent (most reliable)
       // Priority 2: Construct path using path.join() for proper normalization
-      const organizePath = torrent.content_path
+      const qbPath = torrent.content_path
         ? torrent.content_path
         : path.join(torrent.save_path, torrent.name);
 
+      // Load path mapping configuration
+      const configService = getConfigService();
+      const pathMappingConfig = await configService.getMany([
+        'download_client_remote_path_mapping_enabled',
+        'download_client_remote_path',
+        'download_client_local_path',
+      ]);
+
+      // Apply remote-to-local path transformation if enabled
+      const organizePath = PathMapper.transform(qbPath, {
+        enabled: pathMappingConfig.download_client_remote_path_mapping_enabled === 'true',
+        remotePath: pathMappingConfig.download_client_remote_path || '',
+        localPath: pathMappingConfig.download_client_local_path || '',
+      });
+
       await logger?.info(`Download completed`, {
         filesCount: files.length,
         torrentName: torrent.name,
         savePath: torrent.save_path,
         contentPath: torrent.content_path || '(not provided)',
-        organizePath,
+        qbittorrentPath: qbPath,
+        organizePath: organizePath !== qbPath ? `${organizePath} (mapped)` : organizePath,
       });
 
       // Update download history to completed