# Release v0.4.0 封存記錄

| 項目 | 內容 |
|------|------|
| 建立者 | Warren |
| 建立時間 | 2026-04-30 |
| 文件版本 | V1.0 |

---

## 版本歷史

| 版本 | 日期 | 目的 | 操作人 | 工具/模型 |
|------|------|------|--------|-----------|
| V1.0 | 2026-04-30 | 建立 v0.4.0 獨立封存 | Warren | OpenCode |

---

## 1. 封存資訊

### 1.1 基本資訊

| 項目 | 內容 |
|------|------|
| **Release 版本** | v0.4.0 |
| **封存日期** | 2026-04-30 |
| **Binary 建置時間** | 2026-04-29 19:03 |
| **Git 狀態** | Uncommitted changes (592 files modified) |
| **封存位置** | `/Users/accusys/momentry_core_releases/v0.4.0-2026-04-30/` |

### 1.2 封存內容

| 檔案 | 大小 | 內容 |
|------|------|------|
| `binaries_v0.4.0.tar.gz` | 28MB | 3 個 binary + data 目錄 |
| `output_v0.4.0.tar.gz` | 6.9MB | output/ 目錄 (probe, asr, ocr json) |

### 1.3 包含的 Binary

| Binary | 大小 | 用途 |
|--------|------|------|
| `momentry` | 26MB | Production server (port 3002) |
| `momentry_playground` | 30MB | Development server (port 3003) |
| `momentry_player` | 7.5MB | Video player |

### 1.4 包含的 Data

| 項目 | 路徑 | 說明 |
|------|------|------|
| `data/` | `data/` | 同義詞、角色人臉、logo |
| `english_synonyms.json` | 12KB | 英文同義詞 (135 words) |
| `llm_synonyms.json` | 34KB | LLM 生成同義詞 (162 entries) |
| `domain_synonyms.json` | 133B | 領域同義詞 |
| `synonyms.json` | 348B | 基礎同義詞 |
| `cast_faces/` | - | 角色人臉圖片 (Charade/4808) |
| `logo_images/` | 56KB | Accusys Storage Logo |

---

## 2. 封存結構

```
/Users/accusys/momentry_core_releases/v0.4.0-2026-04-30/
├── binaries/
│   ├── momentry                    (26M) Production
│   ├── momentry_playground         (30M) Development
│   └── momentry_player             (7.5M) Player
├── data/
│   ├── cast_faces/
│   │   └── Charade/
│   │       └── 4808/
│   │           ├── Audrey_Hepburn.jpg
│   │           ├── Cary_Grant.jpg
│   │           ├── George_Kennedy.jpg
│   │           ├── James_Coburn.jpg
│   │           ├── Walter_Matthau.jpg
│   │           └── cast_data.json
│   ├── logo_images/
│   │   └── Accusys_Storage_Logo.png
│   ├── domain_synonyms.json
│   ├── english_synonyms.json
│   ├── llm_synonyms.json
│   └── synonyms.json
├── RELEASE_INFO.txt
├── binaries_v0.4.0.tar.gz          (28M)
└── output_v0.4.0.tar.gz            (6.9M)
```

---

## 3. 還原指南

### 3.1 還原 Binary

```bash
RELEASE_DIR="/Users/accusys/momentry_core_releases/v0.4.0-2026-04-30"

# 解壓縮 binary 與 data
cd "$RELEASE_DIR"
tar -xzf binaries_v0.4.0.tar.gz

# 使用 binary
./binaries/momentry --help
./binaries/momentry_playground --help
```

### 3.2 還原 Output

```bash
RELEASE_DIR="/Users/accusys/momentry_core_releases/v0.4.0-2026-04-30"

# 解壓縮 output
tar -xzf output_v0.4.0.tar.gz

# 檢查內容
ls output/
```

### 3.3 驗證 Binary

```bash
# 檢查 binary 資訊
file /Users/accusys/momentry_core_releases/v0.4.0-2026-04-30/binaries/momentry

# 測試啟動
cd /Users/accusys/momentry_core_releases/v0.4.0-2026-04-30
./binaries/momentry --version 2>/dev/null || echo "No version flag"
```

---

## 4. 對應的 Database Schema

### 4.1 此版本預期使用的 Schema

此 binary 建置時 (Apr 29 19:03) 對應的資料庫狀態：

| 資料庫 | Schema | 狀態 |
|--------|--------|------|
| PostgreSQL | `dev` | 部分使用 `video_uuid` (待修復) |
| MongoDB | `momentry_dev` | collections: `chunks`, `cache` |
| Qdrant | `momentry_dev_rule1` | 已存在 |
| Redis | `momentry_dev:` | 已隔離 |

### 4.2 已知問題

| 問題 | 影響 | 狀態 |
|------|------|------|
| `dev.videos.probe_json` 類型為 TEXT (應為 JSONB) | `GET /api/v1/files` 返回 500 | ⚠️ 待修復 |
| 10 張表仍使用 `video_uuid` | 術語不一致 | ⚠️ 待修復 |
| Rust 代碼 `server.rs:3982` 使用 `video_uuid` | DELETE 語句失敗 | ⚠️ 待修復 |
| Rust 代碼 `face_recognition.rs` 3 處使用 `video_uuid` | 臉部辨識失敗 | ⚠️ 待修復 |

---

## 5. Release 注意事項

### 5.1 Source Code 狀態

此版本 **沒有對應的 git commit**，因為 binary 是從有 uncommitted changes 的工作目錄建置的。

- Uncommitted changes: 592 筆
- 包含: config 修改、docs 刪除、feature 開發

### 5.2 使用建議

1. **僅供緊急回滾使用**: 此封存主要用於災難復原
2. **不應作為新版本基準**: 建議先解決已知問題再建立新版本
3. **Output 資料**: 包含的 output json 可能與當前資料庫狀態不同步

---

## 6. 後續待辦

| 任務 | 優先級 | 狀態 |
|------|--------|------|
| Fix `dev.videos.probe_json` 類型 | High | ⬜ |
| Rename `video_uuid` → `file_uuid` (10 tables) | High | ⬜ |
| Update Rust code (4 locations) | High | ⬜ |
| Configure output dir isolation | Medium | ⬜ |
| Update Python scripts default DB URL | Medium | ⬜ |
| Design API structure (v1.0 aligned) | Medium | ⬜ |
| Implement missing P1 APIs | Medium | ⬜ |

---

## 7. 封存驗證

```bash
# 檢查封存完整性
tar -tzf /Users/accusys/momentry_core_releases/v0.4.0-2026-04-30/binaries_v0.4.0.tar.gz | head -20
tar -tzf /Users/accusys/momentry_core_releases/v0.4.0-2026-04-30/output_v0.4.0.tar.gz | head -20

# 檢查目錄結構
ls -lhR /Users/accusys/momentry_core_releases/v0.4.0-2026-04-30/
```
