# video_register

影片元數據註冊服務

## 功能

- 讀取 `.probe.json` 文件（由 video_probe 生成）
- 根據檔案路徑自動生成 UUID 作為檔案 ID
- 將影片元數據註冊到 PostgreSQL 資料庫
- 支援 SQL 查詢搜尋影片元數據
- 註冊後將檔案複製為 UUID 命名（測試期間保留原始檔）

## 安裝

```bash
pip install -r requirements.txt
```

## 配置

在專案根目錄創建 `.env` 文件：

```env
DATABASE_URL=postgresql://accusys@localhost:5432/video_register
```

## 使用方式

### CLI 命令

#### 註冊影片

```bash
python cli.py register <probe.json 路徑>
```

選項：
- `--dry-run`: 測試模式，不實際複製檔案

範例：
```bash
python cli.py register ../test_video/Old_Time_Movie_Show_-_Charade_1963.HD.probe.json
python cli.py register ../test_video/Old_Time_Movie_Show_-_Charade_1963.HD.probe.json --dry-run
```

#### 驗證已註冊的影片

```bash
python cli.py verify <UUID>
```

範例：
```bash
python cli.py verify 1636719d-c31f-78ac-f1dd-8ab0b0b36c66
```

### API 服務

啟動 FastAPI 服務：

```bash
uvicorn app.main:app --reload
```

API 文件：http://localhost:8000/docs

## probe.json 格式

輸入的 `probe.json` 必須包含 `video_path` 欄位：

```json
{
  "video_path": "/absolute/path/to/video.mov",
  "probed_at": "2026-03-10T23:26:04",
  "format": { ... },
  "video_stream": { ... },
  "audio_streams": [...],
  "subtitle_streams": [...]
}
```

## UUID 生成規則

UUID 透過 SHA-256 雜湊檔案路徑生成，確保：
- 相同路徑產生相同的 UUID
- 可從 UUID 反向計算驗證

## 資料庫結構

### videos 表
- `id`: UUID (主鍵)
- `file_path`: 原始檔案路徑
- `file_name`: 檔案名稱（不含副檔名）
- `file_extension`: 副檔名
- `file_size`: 檔案大小
- `format_name`: 格式名稱
- `duration`: 時長
- `title`: 標題
- `artist`: 藝術家

### video_streams 表
- `video_id`: 關聯的 videos ID
- `codec_name`: 編碼名稱
- `width`, `height`: 解析度
- `color_space`: 色彩空間
- `color_range`: 色彩範圍

### audio_streams 表
- `video_id`: 關聯的 videos ID
- `codec_name`: 編碼名稱
- `channels`: 聲道數
- `sample_rate`: 取樣率
- `language`: 語言

### subtitle_streams 表
- `video_id`: 關聯的 videos ID
- `codec_name`: 編碼名稱
- `language`: 語言