Add reported-issues, Goodreads sync & notifs

Introduce user-reported-issues and Goodreads shelf sync features and wire them into notifications. Adds Prisma migrations and schema changes (ReportedIssue, GoodreadsShelf, GoodreadsBookMapping), API endpoints for reporting (POST /audiobooks/[asin]/report-issue) and admin management (list, resolve/dismiss, replace), and an admin UI section to view/dismiss/replace reported issues. Adds a new notification event (issue_reported) with updates to notification schemas, docs and provider handling, plus a notification-events constants file. Refactors request creation to use createRequestForUser service, adds a Goodreads sync processor/service/hooks/UI modals, a scrape-resilience util, and related tests and minor integration updates.

src/lib/processors/audible-refresh.processor.ts

@@ -44,6 +44,12 @@ export async function processAudibleRefresh(payload: AudibleRefreshPayload): Pro
 
     // Fetch popular and new releases - 200 items each
     const popular = await audibleService.getPopularAudiobooks(200);
+
+    // Batch cooldown between popular and new releases to reduce detection
+    const batchCooldownMs = 15000 + Math.floor(Math.random() * 15000);
+    logger.info(`Batch cooldown: waiting ${Math.round(batchCooldownMs / 1000)}s before fetching new releases...`);
+    await new Promise(resolve => setTimeout(resolve, batchCooldownMs));
+
     const newReleases = await audibleService.getNewReleases(200);
 
     logger.info(`Fetched ${popular.length} popular, ${newReleases.length} new releases from Audible`);

src/lib/processors/send-notification.processor.ts

@@ -8,34 +8,28 @@
 
 import { getNotificationService } from '../services/notification';
 import { RMABLogger } from '../utils/logger';
+import type { SendNotificationPayload } from '../services/job-queue.service';
 
-export interface SendNotificationPayload {
-  jobId?: string;
-  event: 'request_pending_approval' | 'request_approved' | 'request_available' | 'request_error';
-  requestId: string;
-  title: string;
-  author: string;
-  userName: string;
-  message?: string;
-  timestamp: Date;
-}
+// Re-export for consumers that import from this module
+export type { SendNotificationPayload } from '../services/job-queue.service';
 
 /**
  * Process send notification job
  * Calls NotificationService to send notifications to all enabled backends
  */
 export async function processSendNotification(payload: SendNotificationPayload): Promise<void> {
-  const { event, requestId, title, author, userName, message, jobId } = payload;
+  const { event, requestId, issueId, title, author, userName, message, jobId } = payload;
 
   const logger = RMABLogger.forJob(jobId, 'SendNotification');
 
-  logger.info(`Processing notification: ${event}`, { requestId });
+  logger.info(`Processing notification: ${event}`, { requestId: requestId || issueId });
 
   try {
     const notificationService = getNotificationService();
     await notificationService.sendNotification({
       event,
       requestId,
+      issueId,
       title,
       author,
       userName,

src/lib/processors/sync-goodreads-shelves.processor.ts

@@ -0,0 +1,42 @@
+/**
+ * Component: Sync Goodreads Shelves Processor
+ * Documentation: documentation/backend/services/scheduler.md
+ *
+ * Dedicated processor for syncing Goodreads shelf RSS feeds.
+ * Resolves books to Audible ASINs and creates requests.
+ */
+
+import { RMABLogger } from '../utils/logger';
+
+export interface SyncGoodreadsShelvesPayload {
+  jobId?: string;
+  scheduledJobId?: string;
+  /** If set, only process this specific shelf (used for immediate sync on add) */
+  shelfId?: string;
+  /** Max Audible lookups per shelf. 0 = unlimited. */
+  maxLookupsPerShelf?: number;
+}
+
+export async function processSyncGoodreadsShelves(payload: SyncGoodreadsShelvesPayload): Promise<any> {
+  const { jobId, shelfId, maxLookupsPerShelf } = payload;
+  const logger = RMABLogger.forJob(jobId, 'SyncGoodreadsShelves');
+
+  logger.info(shelfId
+    ? `Starting immediate Goodreads sync for shelf ${shelfId}...`
+    : 'Starting scheduled Goodreads shelves sync...'
+  );
+
+  const { processGoodreadsShelves } = await import('../services/goodreads-sync.service');
+  const stats = await processGoodreadsShelves(logger, {
+    shelfId,
+    maxLookupsPerShelf: maxLookupsPerShelf ?? (shelfId ? 0 : undefined),
+  });
+
+  logger.info('Goodreads sync complete', { stats });
+
+  return {
+    success: true,
+    message: shelfId ? 'Goodreads shelf synced' : 'Goodreads shelves synced',
+    ...stats,
+  };
+}