init biliup-next

docs/domain-model.md

@@ -0,0 +1,135 @@
+# Domain Model
+
+## Task
+
+一个任务代表一条完整的视频处理链路。
+
+```json
+{
+  "id": "task_01",
+  "source_type": "local_file",
+  "source_path": "stage/example.mp4",
+  "title": "王海颖唱歌录播 03月29日 22时02分",
+  "status": "published",
+  "created_at": "2026-03-30T07:50:42+08:00",
+  "updated_at": "2026-03-30T07:56:13+08:00"
+}
+```
+
+### Fields
+
+- `id`: 内部唯一 ID
+- `source_type`: 输入来源，例如 `local_file`
+- `source_path`: 原始文件路径
+- `title`: 任务显示名称
+- `status`: 当前状态
+- `created_at`
+- `updated_at`
+
+## TaskStep
+
+一个任务中的单个处理步骤。
+
+### Step Names
+
+- `ingest`
+- `transcribe`
+- `song_detect`
+- `split`
+- `publish`
+- `comment`
+- `collection_a`
+- `collection_b`
+
+### Step Status
+
+- `pending`
+- `running`
+- `succeeded`
+- `failed_retryable`
+- `failed_manual`
+- `skipped`
+
+## Artifact
+
+任务产物。
+
+### Artifact Types
+
+- `source_video`
+- `subtitle_srt`
+- `songs_json`
+- `songs_txt`
+- `clip_video`
+- `publish_bvid`
+- `comment_record`
+- `collection_record`
+
+## PublishRecord
+
+记录上传结果。
+
+```json
+{
+  "task_id": "task_01",
+  "platform": "bilibili",
+  "aid": 123456,
+  "bvid": "BV1xxxx",
+  "title": "【王海颖 (歌曲纯享版)】_03月29日 22时02分 共18首歌",
+  "published_at": "2026-03-30T07:56:13+08:00"
+}
+```
+
+## CollectionBinding
+
+记录视频与合集之间的绑定关系。
+
+### Fields
+
+- `task_id`
+- `target`
+- `season_id`
+- `section_id`
+- `bvid`
+- `status`
+- `last_error`
+
+### Target Values
+
+- `full_video_collection`
+- `song_collection`
+
+## Settings
+
+统一配置项，按逻辑分组。
+
+### Example Groups
+
+- `runtime`
+- `paths`
+- `transcribe`
+- `song_detect`
+- `publish`
+- `comment`
+- `collection`
+
+## Domain Events
+
+### Core Events
+
+- `TaskCreated`
+- `TaskStepStarted`
+- `TaskStepSucceeded`
+- `TaskStepFailed`
+- `ArtifactCreated`
+- `PublishCompleted`
+- `CommentCompleted`
+- `CollectionSynced`
+
+## State Machine Rules
+
+- 同一时刻，一个步骤只能有一个 `running`
+- 失败必须记录 `error_code` 和 `error_message`
+- `published` 之前不能进入评论和合集步骤
+- `songs_detected` 之前不能进入切歌步骤
+- `transcribed` 之前不能进入识歌步骤