🔍 Scanner — Modul Scanare & Monitorizare

🏠 Home · 📱 App

🎯 Scop

Monitorizează foldere pentru fișiere audio noi, le analizează automat, și le pregătește pentru organizare.

🔄 Scanner Flow

graph TD
    START["🟢 App Start"]
    START --> INIT["Inițializare chokidar<br/>pe watch folders"]
    INIT --> WATCH["👁️ Watching..."]
    
    WATCH -->|"fișier nou"| DETECT["🔔 Detect"]
    DETECT --> VALIDATE["✅ Validare<br/>Este audio? (.mp3, .flac, .wav, .aiff)"]
    VALIDATE -->|"nu"| IGNORE["❌ Ignoră"]
    VALIDATE -->|"da"| READ["📖 Read Metadata<br/>(ID3 tags, filename)"]
    READ --> ANALYZE["🔬 Analyze<br/>BPM, Key, Duration"]
    ANALYZE --> SUGGEST["💡 Suggest<br/>Genre, Energy, Folder"]
    SUGGEST --> QUEUE["📥 Adaugă în Queue"]
    QUEUE --> NOTIFY["🔔 Notificare utilizator"]
    
    WATCH -->|"fișier șters"| REMOVED["⚠️ File Removed"]
    REMOVED --> UPDATE_DB["📦 Update DB (mark removed)"]
    
    WATCH -->|"fișier modificat"| MODIFIED["🔄 File Modified"]
    MODIFIED --> REREAD["📖 Re-read metadata"]
    
    style DETECT fill:#fb923c,stroke:#ea580c,color:#000
    style QUEUE fill:#4ade80,stroke:#16a34a,color:#000

📋 Supported Formats

🏷️ Metadata Extraction

Din fiecare fișier extragem:

🧠 Genre Suggestion Logic

function suggestGenre(bpm: number): string {
  if (bpm >= 150) return 'Bounce';
  if (bpm >= 138) return 'Psytrance'; // or Hard Techno
  if (bpm >= 125) return 'Techno';    // or Acid
  if (bpm >= 122) return 'Tech House';
  if (bpm >= 85 && bpm <= 130) return 'Manele/Latino'; // ambiguous
  return 'Unknown';
}

Limitare: BPM singur nu e suficient pentru genuri românești vs. latino. AI tagging (v1.0) va îmbunătăți acuratețea.

⚙️ Configurare Watch Folders

interface WatchConfig {
  folders: {
    path: string;        // "H:\Music\_Inbox"
    recursive: boolean;  // true
    autoProcess: boolean; // false (manual confirm)
    ignorePatterns: string[]; // ["*.tmp", "*.part"]
  }[];
  scanInterval: number; // ms between checks
  notifyOnNew: boolean;
}

📊 Scanner Status UI

┌────────────────────────────────────────────────┐
│ 🔍 Scanner Status                              │
│                                                │
│ ✅ Watching: H:\Music\_Inbox\    (3 new)       │
│ ✅ Watching: H:\Music\DJ\        (up to date)  │
│ ⬜ Paused:   C:\Downloads\                      │
│                                                │
│ Last scan: 5 min ago                           │
│ Total scanned today: 15 files                  │
│ Queue: 3 tracks awaiting processing            │
│                                                │
│ [▶ Scan Now]  [⏸ Pause All]  [⚙️ Configure]   │
└────────────────────────────────────────────────┘

🏠 Home · 📱 App