feat: add local files provider with indexing and rescan functionality

- Implemented LocalFilesProvider to manage local video files.
- Added LocalIndex for in-memory and SQLite-backed indexing of video files.
- Introduced scanning functionality to detect video files and extract metadata.
- Added API endpoints for listing collections, genres, and series based on provider capabilities.
- Enhanced existing routes to check for provider capabilities before processing requests.
- Updated frontend to utilize provider capabilities for conditional rendering of UI elements.
- Implemented rescan functionality to refresh the local files index.
- Added database migration for local files index schema.

k-tv-backend/api/src/main.rs

@@ -10,7 +10,7 @@ use axum::http::{HeaderName, HeaderValue};
 use std::sync::Arc;
 use tower_http::cors::{AllowHeaders, AllowMethods, AllowOrigin, CorsLayer};
 
-use domain::{ChannelService, IMediaProvider, ScheduleEngineService, UserService};
+use domain::{ChannelService, IMediaProvider, ProviderCapabilities, ScheduleEngineService, StreamingProtocol, UserService};
 use infra::factory::{build_channel_repository, build_schedule_repository, build_user_repository};
 use infra::run_migrations;
 use k_core::http::server::{ServerConfig, apply_standard_middleware};
@@ -72,8 +72,52 @@ async fn main() -> anyhow::Result<()> {
     let user_service = UserService::new(user_repo);
     let channel_service = ChannelService::new(channel_repo.clone());
 
-    // Build media provider — Jellyfin if configured, no-op fallback otherwise.
-    let media_provider: Arc<dyn IMediaProvider> = build_media_provider(&config);
+    // Build media provider — Jellyfin → local-files → noop, first match wins.
+    #[cfg(feature = "local-files")]
+    let mut local_index: Option<Arc<infra::LocalIndex>> = None;
+
+    let mut maybe_provider: Option<Arc<dyn IMediaProvider>> = None;
+
+    #[cfg(feature = "jellyfin")]
+    if let (Some(base_url), Some(api_key), Some(user_id)) = (
+        &config.jellyfin_base_url,
+        &config.jellyfin_api_key,
+        &config.jellyfin_user_id,
+    ) {
+        tracing::info!("Media provider: Jellyfin at {}", base_url);
+        maybe_provider = Some(Arc::new(infra::JellyfinMediaProvider::new(infra::JellyfinConfig {
+            base_url: base_url.clone(),
+            api_key: api_key.clone(),
+            user_id: user_id.clone(),
+        })));
+    }
+
+    #[cfg(feature = "local-files")]
+    if maybe_provider.is_none() {
+        if let Some(dir) = &config.local_files_dir {
+            if let k_core::db::DatabasePool::Sqlite(ref sqlite_pool) = db_pool {
+                tracing::info!("Media provider: local files at {:?}", dir);
+                let lf_cfg = infra::LocalFilesConfig {
+                    root_dir: dir.clone(),
+                    base_url: config.base_url.clone(),
+                };
+                let idx = Arc::new(infra::LocalIndex::new(&lf_cfg, sqlite_pool.clone()).await);
+                local_index = Some(Arc::clone(&idx));
+                let scan_idx = Arc::clone(&idx);
+                tokio::spawn(async move { scan_idx.rescan().await; });
+                maybe_provider = Some(Arc::new(infra::LocalFilesProvider::new(idx, lf_cfg)));
+            } else {
+                tracing::warn!("local-files requires SQLite; ignoring LOCAL_FILES_DIR");
+            }
+        }
+    }
+
+    let media_provider: Arc<dyn IMediaProvider> = maybe_provider.unwrap_or_else(|| {
+        tracing::warn!(
+            "No media provider configured. Set JELLYFIN_BASE_URL / LOCAL_FILES_DIR."
+        );
+        Arc::new(NoopMediaProvider)
+    });
 
     let bg_channel_repo = channel_repo.clone();
     let schedule_engine = ScheduleEngineService::new(
@@ -82,7 +126,8 @@ async fn main() -> anyhow::Result<()> {
         schedule_repo,
     );
 
-    let state = AppState::new(
+    #[allow(unused_mut)]
+    let mut state = AppState::new(
         user_service,
         channel_service,
         schedule_engine,
@@ -91,6 +136,11 @@ async fn main() -> anyhow::Result<()> {
     )
     .await?;
 
+    #[cfg(feature = "local-files")]
+    {
+        state.local_index = local_index;
+    }
+
     let server_config = ServerConfig {
         cors_origins: config.cors_allowed_origins.clone(),
     };
@@ -141,31 +191,6 @@ async fn main() -> anyhow::Result<()> {
     Ok(())
 }
 
-/// Build the media provider from config.
-/// Falls back to a no-op provider that returns an informative error when
-/// Jellyfin env vars are not set, so other API features still work in dev.
-fn build_media_provider(config: &Config) -> Arc<dyn IMediaProvider> {
-    #[cfg(feature = "jellyfin")]
-    if let (Some(base_url), Some(api_key), Some(user_id)) = (
-        &config.jellyfin_base_url,
-        &config.jellyfin_api_key,
-        &config.jellyfin_user_id,
-    ) {
-        tracing::info!("Media provider: Jellyfin at {}", base_url);
-        return Arc::new(infra::JellyfinMediaProvider::new(infra::JellyfinConfig {
-            base_url: base_url.clone(),
-            api_key: api_key.clone(),
-            user_id: user_id.clone(),
-        }));
-    }
-
-    tracing::warn!(
-        "No media provider configured. Set JELLYFIN_BASE_URL, JELLYFIN_API_KEY, \
-         and JELLYFIN_USER_ID to enable schedule generation."
-    );
-    Arc::new(NoopMediaProvider)
-}
-
 /// Stand-in provider used when no real media source is configured.
 /// Returns a descriptive error for every call so schedule endpoints fail
 /// gracefully rather than panicking at startup.
@@ -173,14 +198,25 @@ struct NoopMediaProvider;
 
 #[async_trait::async_trait]
 impl IMediaProvider for NoopMediaProvider {
+    fn capabilities(&self) -> ProviderCapabilities {
+        ProviderCapabilities {
+            collections: false,
+            series: false,
+            genres: false,
+            tags: false,
+            decade: false,
+            search: false,
+            streaming_protocol: StreamingProtocol::DirectFile,
+            rescan: false,
+        }
+    }
+
     async fn fetch_items(
         &self,
         _: &domain::MediaFilter,
     ) -> domain::DomainResult<Vec<domain::MediaItem>> {
         Err(domain::DomainError::InfrastructureError(
-            "No media provider configured. Set JELLYFIN_BASE_URL, JELLYFIN_API_KEY, \
-             and JELLYFIN_USER_ID."
-                .into(),
+            "No media provider configured. Set JELLYFIN_BASE_URL or LOCAL_FILES_DIR.".into(),
         ))
     }