docs: update docs_v1.0/ documentation

- Fix markdown lint issues (MD030, MD047, MD051, MD028, MD005)
- Update AI agents, architecture, implementation docs
- Add new identity, face recognition, and API documentation
- Remove deprecated face/person API guides

docs_v1.0/ARCHITECTURE/PROCESSING_PIPELINE.md

@@ -2,8 +2,8 @@
 document_type: "architecture_design"
 service: "MOMENTRY_CORE"
 title: "Video Processing Pipeline - 處理流程"
-date: "2026-03-22"
-version: "V1.0"
+date: "2026-04-27"
+version: "V1.2"
 status: "active"
 owner: "Warren"
 created_by: "OpenCode"
@@ -12,10 +12,12 @@ tags:
   - "video"
   - "pipeline"
   - "處理流程"
+  - "processing_status"
 ai_query_hints:
   - "查詢 Video Processing Pipeline - 處理流程 的內容"
   - "Video Processing Pipeline - 處理流程 的主要目的是什麼？"
   - "如何操作或實施 Video Processing Pipeline - 處理流程？"
+  - "processing_status 字段與 status 的關係"
 ---
 
 # Video Processing Pipeline - 處理流程
@@ -24,7 +26,7 @@ ai_query_hints:
 |------|------|
 | 建立者 | Warren |
 | 建立時間 | 2026-03-22 |
-| 文件版本 | V1.1 |
+| 文件版本 | V1.2 |
 
 ---
 
@@ -34,6 +36,7 @@ ai_query_hints:
 |------|------|------|--------|-----------|
 | V1.0 | 2026-03-22 | 創建文件 | Warren | OpenCode |
 | V1.1 | 2026-03-26 | 更新流程圖文字 (media_url→file_path) | OpenCode | deepseek-reasoner |
+| V1.2 | 2026-04-27 | 添加 processing_status 字段說明 | OpenCode | GLM-5 |
 
 ---
 
@@ -265,9 +268,16 @@ let query_vector = embedder.embed_query("搜索查詢").await?;
 ### PostgreSQL 狀態欄位
 
 ```sql
--- 影片處理狀態
+-- 影片處理狀態（基本狀態）
 videos.status: 'pending' | 'processing' | 'completed' | 'failed'
 
+-- 影片處理狀態（詳細狀態）
+videos.processing_status: 'REGISTERED' | 'PENDING' | 'PROBING' | 'ASR' | 'OCR' | 'YOLO' | 'FACE' | 'POSE' | 'CUT' | 'ASRX' | 'COMPLETED' | 'FAILED' | 'PAUSED' | 'RESUMING'
+
+-- 說明：
+-- status：基本狀態，用於 API 查詢過濾（is_processed=true → status='completed'）
+-- processing_status：詳細狀態，用於 Portal 顯示和作業追蹤
+
 -- 檔案處理狀態
 videos.fs_json: true/false
 videos.fs_chunks: true/false
@@ -307,6 +317,46 @@ curl http://localhost:3002/api/v1/progress/{uuid}
 }
 ```
 
+### Agent 進度追蹤（V1.2 起）
+
+從 V1.2 起，Agent 任務透過 `processing_status` JSONB 的 `agents` 字段追蹤。
+
+#### Agent 進度字段
+
+| Agent | JSONB 路徑 | 說明 |
+|-------|-----------|------|
+| 5W1H | `processing_status->agents->5w1h` | 場景摘要 Agent |
+| Translation | `processing_status->agents->translation` | 翻譯 Agent |
+
+#### Agent 狀態結構
+
+```json
+{
+  "agents": {
+    "5w1h": {
+      "status": "running",
+      "scenes_processed": 5,
+      "scenes_total": 1332,
+      "progress_pct": 0.4,
+      "started_at": "2026-04-27T05:45:00Z"
+    }
+  }
+}
+```
+
+#### SQL 查詢 Agent 進度
+
+```sql
+SELECT 
+  uuid,
+  processing_status->'agents'->'5w1h'->>'status' as status,
+  processing_status->'agents'->'5w1h'->>'scenes_processed' as processed
+FROM videos 
+WHERE processing_status->'agents'->'5w1h'->>'status' = 'running';
+```
+
+詳細規範請參考: `REFERENCE/PROCESSING_STATUS_JSONB_SPEC.md`
+
 ---
 
 ## 下一步