init biliup-next

docs/vision.md

@@ -0,0 +1,54 @@
+# Vision
+
+## Goal
+
+将当前基于目录监听和脚本拼接的流水线，重构为一个模块化、可扩展、可观测、可运维的单体系统。
+
+系统负责：
+
+- 接收本地视频任务
+- 执行转录、识歌、切歌、上传、评论、合集归档
+- 记录任务状态、产物、错误和外部结果
+- 提供统一配置和管理入口
+
+系统不负责：
+
+- 直播录制
+- 完整版视频的外部发布流程
+- 多账号复杂运营后台
+- 分布式调度
+
+## Users
+
+- 运维者：部署、启动、排查、重试任务
+- 内容生产者：投放视频、观察任务状态
+- 开发者：新增模块、替换外部依赖、扩展功能
+
+## Problems In Current Project
+
+- 状态分散在目录名、flag 文件、日志中，缺少单一事实来源
+- 业务逻辑和运维逻辑耦合严重
+- 配置项散落在多个脚本和常量中
+- 同类逻辑重复实现，例如 B 站列表解析、合集处理、任务扫描
+- 可观测性不足，失败后需要人工翻日志定位
+- 扩展新能力时只能继续加脚本，结构会越来越乱
+
+## Target Characteristics
+
+- 模块化单体，而不是脚本集合
+- 显式任务状态机
+- 统一配置系统
+- 外部依赖适配器化
+- 结构化任务存储
+- 插件式扩展点
+- Web 管理台
+- 文档优先
+
+## Milestones
+
+1. 定义架构、领域模型、模块接口和 API。
+2. 建立新系统骨架，不影响旧系统运行。
+3. 落地统一配置、任务状态存储和最小管理 API。
+4. 按模块迁移旧能力：转录、识歌、切歌、上传、评论、合集。
+5. 接入 Web 管理台。
+6. 逐步切换生产流量，最终替换旧脚本体系。