feat: Add v2 architecture with multi-state support and orchestrator services

Major additions:
- Multi-state expansion: states table, StateSelector, NationalDashboard, StateHeatmap, CrossStateCompare
- Orchestrator services: trace service, error taxonomy, retry manager, proxy rotator
- Discovery system: dutchie discovery service, geo validation, city seeding scripts
- Analytics infrastructure: analytics v2 routes, brand/pricing/stores intelligence pages
- Local development: setup-local.sh starts all 5 services (postgres, backend, cannaiq, findadispo, findagram)
- Migrations 037-056: crawler profiles, states, analytics indexes, worker metadata

Frontend pages added:
- Discovery, ChainsDashboard, IntelligenceBrands, IntelligencePricing, IntelligenceStores
- StateHeatmap, CrossStateCompare, SyncInfoPanel

Components added:
- StateSelector, OrchestratorTraceModal, WorkflowStepper

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

backend/src/utils/image-storage.ts

@@ -18,7 +18,18 @@ import * as path from 'path';
 import { createHash } from 'crypto';
 
 // Base path for image storage - configurable via env
-const IMAGES_BASE_PATH = process.env.IMAGES_PATH || '/app/public/images';
+// Uses project-relative paths by default, NOT /app or other privileged paths
+function getImagesBasePath(): string {
+  // Priority: IMAGES_PATH > STORAGE_BASE_PATH/images > ./storage/images
+  if (process.env.IMAGES_PATH) {
+    return process.env.IMAGES_PATH;
+  }
+  if (process.env.STORAGE_BASE_PATH) {
+    return path.join(process.env.STORAGE_BASE_PATH, 'images');
+  }
+  return './storage/images';
+}
+const IMAGES_BASE_PATH = getImagesBasePath();
 
 // Public URL base for serving images
 const IMAGES_PUBLIC_URL = process.env.IMAGES_PUBLIC_URL || '/images';
@@ -276,13 +287,29 @@ export async function deleteProductImages(
   }
 }
 
+// Track whether image storage is available
+let imageStorageReady = false;
+
+export function isImageStorageReady(): boolean {
+  return imageStorageReady;
+}
+
 /**
  * Initialize the image storage directories
+ * Does NOT throw on failure - logs warning and continues
  */
 export async function initializeImageStorage(): Promise<void> {
-  await ensureDir(path.join(IMAGES_BASE_PATH, 'products'));
-  await ensureDir(path.join(IMAGES_BASE_PATH, 'brands'));
-  console.log(`✅ Image storage initialized at ${IMAGES_BASE_PATH}`);
+  try {
+    await ensureDir(path.join(IMAGES_BASE_PATH, 'products'));
+    await ensureDir(path.join(IMAGES_BASE_PATH, 'brands'));
+    console.log(`✅ Image storage initialized at ${IMAGES_BASE_PATH}`);
+    imageStorageReady = true;
+  } catch (error: any) {
+    console.warn(`⚠️  WARNING: Could not initialize image storage at ${IMAGES_BASE_PATH}: ${error.message}`);
+    console.warn('   Image upload/processing is disabled. Server will continue without image features.');
+    imageStorageReady = false;
+    // Do NOT throw - server should still start
+  }
 }
 
 /**