一个现代化的 Web 应用，用于探索豆瓣电影和电视节目，配备强大的筛选和搜索功能。

本项目已部署至：https://douban-scout.kfstorm.com

无需自行部署，直接访问即可使用。

• 卡片网格视图：精美的海报卡片，展示评分、类型和年份
• 多维筛选：
  • 类型：全部 / 电影 / 电视节目
  • 评分范围：0-10 分，支持包含未评分作品
  • 年份范围：支持按上映年份区间筛选
  • 评分人数：支持设置最低评分人数阈值
  • 类型标签：支持多选（AND 逻辑）和排除（OR 逻辑）
  • 制片国家/地区：支持按国家或地区进行筛选
• 灵活排序：支持按评分、评分人数、年份进行升序或降序排列
• 实时搜索：支持标题实时搜索，内置防抖处理
• 无限滚动：流畅的加载体验，自动加载下一页
• 深色模式：支持浅色和深色主题切换
• 响应式设计：完美适配移动端和桌面端，提供专门的移动端筛选抽屉
• 海报代理：内置海报代理服务，支持多镜像回退，解决跨域及图片加载失败问题
• 数据导入：支持从豆瓣备份 SQLite 文件运行时导入数据
• 接口限流：内置灵活的限流机制，保护服务稳定性

• Node.js: v18 或更高版本
• Python: v3.11 或更高版本
• uv: 极速 Python 包管理器 (安装指南)

cd backend
uv sync
uv run uvicorn app.main:app --reload

cd frontend
npm install
npm run dev

• Web 界面: http://localhost:3000

使用 Docker Compose 部署完整应用栈：

# 1. 复制配置文件
cp docker-compose.example.yml docker-compose.yml

# 2. 编辑配置文件，更新 IMPORT_API_KEY 为安全的随机密钥
# 3. 启动服务
docker compose up -d

访问应用：Web 界面: http://localhost:3000

数据持久化: 数据库和缓存数据存储在 Docker volume backend-data 中。

本应用支持在运行时从 douban-idatabase 项目的备份 SQLite 文件导入数据。

curl -X POST http://localhost:3000/api/import \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{"source_path": "/absolute/path/to/your/backup.sqlite3"}'

1. 编辑 docker-compose.yml，将备份文件挂载到容器：

   volumes:
     - backend-data:/data
     - /path/to/your/backup:/import:ro

2. 触发导入（注意：使用容器内的挂载路径）：

   curl -X POST http://localhost:3000/api/import \
     -H "Content-Type: application/json" \
     -H "X-API-Key: your-api-key" \
     -d '{"source_path": "/import/backup.sqlite3"}'

查看导入进度：

curl -H "X-API-Key: your-api-key" http://localhost:3000/api/import/status

注意：导入在后台运行。数据库中的现有数据将被替换。

后端行为可以通过环境变量进行自定义：

限流字符串遵循 [次数]/[时间周期] 格式。示例：

• 10/minute (每分钟 10 次)
• 500/hour (每小时 500 次)
• 1/second (每秒 1 次)

支持的时间周期：second, minute, hour, day, month, year。

本项目采用 MIT License 许可。