refactor: migrate main.py to modular routers and add project roadmap

- Migrated monolithic main.py to feature-scoped routers in app/routers/
- Added GEMINI.md for project context and AI instructional guidelines
- Updated README.md with a comprehensive modernization plan (SQL migration, robust scraping DSL, frontend modernization)
- Improved authentication with cookie support and modular JS
- Updated test suite and documentation

app/routers/router_recommendations.py

@@ -0,0 +1,133 @@
+"""
+Recommendations and releases routes for Ohm Stream Downloader API.
+"""
+
+from datetime import datetime
+from typing import Optional
+
+from fastapi import APIRouter
+
+from app.recommendation_engine import RecommendationEngine
+
+router = APIRouter(prefix="/api", tags=["recommendations"])
+
+
+@router.get("/recommendations")
+async def get_recommendations(limit: int = 15):
+    """Get personalized anime recommendations based on download history"""
+    engine = RecommendationEngine(download_dir="downloads")
+
+    try:
+        recommendations = await engine.get_personalized_recommendations(limit=limit)
+
+        return {"recommendations": recommendations, "count": len(recommendations)}
+    except Exception as e:
+        from fastapi import HTTPException
+
+        raise HTTPException(status_code=500, detail=str(e))
+    finally:
+        await engine.close()
+
+
+@router.get("/releases/latest")
+async def get_latest_releases(limit: int = 20):
+    """Get latest anime releases"""
+    from app.recommendations import get_latest_releases_with_info
+
+    try:
+        releases = await get_latest_releases_with_info(limit=limit)
+
+        return {
+            "releases": releases,
+            "count": len(releases),
+            "updated": datetime.now().isoformat(),
+        }
+    except Exception as e:
+        from fastapi import HTTPException
+
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/releases/seasonal")
+async def get_seasonal_anime(
+    year: Optional[int] = None,
+    season: Optional[str] = None,
+):
+    """Get current/previously seasonal anime"""
+    from app.recommendations import AnimeReleasesFetcher
+
+    fetcher = AnimeReleasesFetcher()
+
+    try:
+        anime = await fetcher.get_seasonal_anime(year, season)
+
+        return {
+            "anime": anime,
+            "count": len(anime),
+            "year": year or datetime.now().year,
+            "season": season or "current",
+        }
+    except Exception as e:
+        from fastapi import HTTPException
+
+        raise HTTPException(status_code=500, detail=str(e))
+    finally:
+        await fetcher.close()
+
+
+@router.get("/releases/scheduled")
+async def get_scheduled_anime(day: Optional[str] = None):
+    """Get anime scheduled for a specific day"""
+    from app.recommendations import AnimeReleasesFetcher
+
+    fetcher = AnimeReleasesFetcher()
+
+    try:
+        anime = await fetcher.get_scheduled_anime(day)
+
+        return {"anime": anime, "count": len(anime), "day": day or "today"}
+    except Exception as e:
+        from fastapi import HTTPException
+
+        raise HTTPException(status_code=500, detail=str(e))
+    finally:
+        await fetcher.close()
+
+
+@router.get("/releases/top")
+async def get_top_anime(
+    type: str = "tv",
+    limit: int = 15,
+):
+    """Get top rated anime"""
+    from app.recommendations import AnimeReleasesFetcher
+
+    fetcher = AnimeReleasesFetcher()
+
+    try:
+        anime = await fetcher.get_top_anime(type=type, limit=limit)
+
+        return {"anime": anime, "count": len(anime)}
+    except Exception as e:
+        from fastapi import HTTPException
+
+        raise HTTPException(status_code=500, detail=str(e))
+    finally:
+        await fetcher.close()
+
+
+@router.get("/stats/downloads")
+async def get_download_statistics():
+    """Get download statistics and preferences"""
+    engine = RecommendationEngine(download_dir="downloads")
+
+    try:
+        stats = await engine.get_download_stats()
+
+        return stats
+    except Exception as e:
+        from fastapi import HTTPException
+
+        raise HTTPException(status_code=500, detail=str(e))
+    finally:
+        await engine.close()