refactor: comprehensive codebase cleanup and architecture hardening

- Sprint 1 (Quick Wins): Remove dead analytics modules, fix 4 unresolved
  imports, replace 3 console.warn with logger, remove mock-crc import
- Sprint 2 (Architecture): Create MascotChatRepository, AnalysisRepository,
  3 Zod schemas (mascot-chat, analysis, voice), deduplicate error classes,
  move 3 SQL queries from routes to repository
- Sprint 3 (Complexity): Replace 7 any types with proper interfaces,
  extract 6 helpers from prepareMediaMessage (CC 85 -> ~15)
- Sprint 4 (Config): Remove 22 dead env vars from .env, add 30 missing
  vars to .env.example, standardize naming

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

services/backend/src/modules/messages/messages.service.ts

@@ -46,12 +46,33 @@ export class MessagesService {
     return messagesRepository.getAttachmentsByChannel(channelId, query);
   }
 
+  async markForReanalysis(id: string): Promise<void> {
+    if (!id) {
+      throw new ValidationError("message ID is required");
+    }
+
+    logger.debug({ id }, "Marking message for re-analysis");
+    await messagesRepository.markForReanalysis(id);
+  }
+
+  async getReviewMessages(
+    channelId?: string,
+    limit?: number,
+  ): Promise<Record<string, unknown>[]> {
+    logger.debug({ channelId, limit }, "Getting review messages");
+    return messagesRepository.getReviewMessages(channelId, limit);
+  }
+
   async reanalyzeErrorBatch(opts: {
     guildId?: string;
     channelId?: string;
     messageIds?: string[];
   }) {
-    if (!opts.guildId && !opts.channelId && (!opts.messageIds || opts.messageIds.length === 0)) {
+    if (
+      !opts.guildId &&
+      !opts.channelId &&
+      (!opts.messageIds || opts.messageIds.length === 0)
+    ) {
       throw new ValidationError(
         "At least one of guildId, channelId, or messageIds[] is required",
       );