Implement full media crawler workflow with Flask backend and Vue frontend.

Add TMDB search and media detail pages, HDHive resource ingestion flow, unified error handling, Docker single-container runtime, and project docs/config updates for local deployment.

Co-authored-by: Cursor <cursoragent@cursor.com>

README.md

@@ -1,2 +1,81 @@
 # media_crawler
 
+资源爬取自动入库项目，采用前后端分层：
+
+- `frontend/`: Vue + JavaScript 页面
+- `backend/`: Python Flask API（编排 TMDB -> HDHIVE -> Emby -> CMS）
+
+## 本地启动
+
+### 1) 启动后端（Flask）
+
+```bash
+cd backend
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+cp .env.example .env
+python app.py
+```
+
+默认端口：
+- 后端：`14620`
+- 前端：`14621`
+
+后端 `.env` 中 `HDHIVE` 相关参数按 OpenAPI 文档配置：
+
+- `HDHIVE_BASE_URL` 例如 `https://hdhive.com`
+- `HDHIVE_API_KEY` 对应请求头 `X-API-Key`（必填）
+- `HDHIVE_ACCESS_TOKEN` 对应 `Authorization: Bearer ...`（按授权场景可选）
+
+后端 `CMS` 入库参数支持两种模式：
+
+- 直接给固定 token：`CMS_TOKEN`
+- 自动登录获取 token：`CMS_LOGIN_URL` + `CMS_USERNAME` + `CMS_PASSWORD`
+
+入库接口地址使用 `CMS_ADD_SHARE_URL`（或 `CMS_BASE_URL` 自动拼接 `/api/cloud/add_share_down`）。
+
+### 2) 启动前端（Vite）
+
+```bash
+cd frontend
+cp .env.example .env
+npm install
+npm run dev
+```
+
+## 页面能力
+
+- 主页面支持按关键词在 TMDB 搜索影视
+- 点击影视封面进入详情页，展示 HDHive 资源列表
+- 点击资源链接触发入库任务（按资源 slug 入库）
+- 任务中心位于二级页面 `/tasks`
+- 前端调用 Flask API：`POST /api/tasks`、`GET /api/tasks`、`GET /api/tasks/{taskId}/logs`
+- 前端新增接口：`GET /api/media/search`、`GET /api/media/{type}/{tmdbId}`
+- 任务状态、结果、错误和步骤日志展示
+- 后端使用 SQLite 保存任务、资源和日志，并按 `tmdb_id` 做幂等控制
+- 后端统一错误分类：`validation`、`authentication`、`authorization`、`rate_limit`、`not_found`、`business_rule`、`network`、`timeout`、`upstream`、`internal`
+
+## Docker 单容器运行
+
+项目提供了单容器运行前后端的 `Dockerfile`，容器内会同时启动：
+
+- Flask 后端：`14620`
+- 前端预览服务：`14621`
+
+### 构建镜像
+
+```bash
+docker build -t media-crawler:latest .
+```
+
+### 运行容器
+
+```bash
+docker run --rm -it \
+  -p 14620:14620 \
+  -p 14621:14621 \
+  --env-file backend/.env \
+  media-crawler:latest
+```
+