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/app/api/admin/settings/download-client/route.ts

@@ -6,12 +6,21 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { requireAuth, requireAdmin, AuthenticatedRequest } from '@/lib/middleware/auth';
 import { prisma } from '@/lib/db';
+import { PathMapper } from '@/lib/utils/path-mapper';
 
 export async function PUT(request: NextRequest) {
   return requireAuth(request, async (req: AuthenticatedRequest) => {
     return requireAdmin(req, async () => {
       try {
-        const { type, url, username, password } = await request.json();
+        const {
+          type,
+          url,
+          username,
+          password,
+          remotePathMappingEnabled,
+          remotePath,
+          localPath,
+        } = await request.json();
 
         if (!type || !url || !username || !password) {
           return NextResponse.json(
@@ -28,6 +37,33 @@ export async function PUT(request: NextRequest) {
           );
         }
 
+        // Validate path mapping if enabled
+        if (remotePathMappingEnabled) {
+          if (!remotePath || !localPath) {
+            return NextResponse.json(
+              { error: 'Remote path and local path are required when path mapping is enabled' },
+              { status: 400 }
+            );
+          }
+
+          try {
+            PathMapper.validate({
+              enabled: true,
+              remotePath,
+              localPath,
+            });
+          } catch (validationError) {
+            return NextResponse.json(
+              {
+                error: validationError instanceof Error
+                  ? validationError.message
+                  : 'Invalid path mapping configuration',
+              },
+              { status: 400 }
+            );
+          }
+        }
+
         // Update configuration
         await prisma.configuration.upsert({
           where: { key: 'download_client_type' },
@@ -56,6 +92,28 @@ export async function PUT(request: NextRequest) {
           });
         }
 
+        // Save remote path mapping configuration
+        await prisma.configuration.upsert({
+          where: { key: 'download_client_remote_path_mapping_enabled' },
+          update: { value: remotePathMappingEnabled ? 'true' : 'false' },
+          create: {
+            key: 'download_client_remote_path_mapping_enabled',
+            value: remotePathMappingEnabled ? 'true' : 'false',
+          },
+        });
+
+        await prisma.configuration.upsert({
+          where: { key: 'download_client_remote_path' },
+          update: { value: remotePath || '' },
+          create: { key: 'download_client_remote_path', value: remotePath || '' },
+        });
+
+        await prisma.configuration.upsert({
+          where: { key: 'download_client_local_path' },
+          update: { value: localPath || '' },
+          create: { key: 'download_client_local_path', value: localPath || '' },
+        });
+
         console.log('[Admin] Download client settings updated');
 
         // Invalidate qBittorrent service singleton to force reload of credentials and URL