Initial setup of project files and directory structure.

07-全局配置_路径配置.md

@@ -0,0 +1,59 @@
+## 07 - 全局配置: 路径配置
+
+### 1. 功能概述
+
+- **功能名称**：全局路径配置
+- **核心逻辑**：通过配置一个**全局根目录 (WorkDir)**，自动派生出音频处理流水线（汇聚 -> 转换 -> 去重 -> 繁简转换 -> 整理 -> 入库）中各个阶段所需的标准子目录。
+- **设计目标**：一键配置，全流程自动化运行，减少用户在每个环节手动输入路径的操作。
+
+### 2. 全局根路径设计
+
+用户只需在设置界面指定一个 `根路径 (BasePath)`，系统将自动在该路径下维护以下结构：
+
+| 目录名称 | 变量名示例 | 物理路径 (假设根为 `/MusicWork`) | 用途说明 |
+| :--- | :--- | :--- | :--- |
+| **Input** | `SRC_ACC_DIR` | `/MusicWork/Input` | 默认存放待处理的原始杂乱音频 |
+| **Staging_Aggregated** | `DST_ACC_DIR` | `/MusicWork/Staging_Aggregated` | 扁平化汇聚后的核心工作区 |
+| **Staging_Format_Issues**| `DST_CONV_ISSUE` | `/MusicWork/Staging_Format_Issues` | 存放转换失败或格式不达标的文件 |
+| **Staging_Duplicates** | `DST_DEDUP_TRASH`| `/MusicWork/Staging_Duplicates` | 存放被识别为重复的文件 |
+| **Staging_T2S_Output** | `DST_ZH_CONV` | `/MusicWork/Staging_T2S_Output` | 存放完成繁简转换后的文件 |
+| **Staging_Organized** | `DST_ORG_DIR` | `/MusicWork/Staging_Organized` | 存放最终按 A-Z 结构整理好的文件 |
+| **Library_Final** | `DST_LIB_FINAL` | `/MusicWork/Library_Final` | 最终入库合并的目标主库 |
+
+### 3. 各模块路径映射关系 (Pipeline)
+
+根据流水线顺序，各模块的路径使用逻辑如下：
+
+1.  **音频文件汇聚 (01)**
+    - **源目录**：`${ROOT}/Input` (用户可自定义修改，默认从此开始)
+    - **目标目录**：`${ROOT}/Staging_Aggregated` (固定)
+2.  **音频格式智能处理 (02)**
+    - **源目录**：`${ROOT}/Staging_Aggregated` (固定，使用汇聚后的结果)
+    - **转换后异常目录**：`${ROOT}/Staging_Format_Issues` (固定)
+3.  **音乐去重 (03)**
+    - **源目录**：`${ROOT}/Staging_Aggregated` (固定)
+    - **重复文件存放目录**：`${ROOT}/Staging_Duplicates` (固定)
+4.  **元数据繁简转换 (04)**
+    - **源目录**：`${ROOT}/Staging_Aggregated` (固定)
+    - **转换后输出目录**：`${ROOT}/Staging_T2S_Output` (固定)
+5.  **音乐整理 (05)**
+    - **源目录**：`${ROOT}/Staging_Aggregated` (或根据流程选择输出目录)
+    - **整理后固定目录**：`${ROOT}/Staging_Organized` (固定)
+6.  **整理入库 (06)**
+    - **源目录**：`${ROOT}/Staging_Organized` (固定，取自音乐整理的输出)
+    - **主库固定目录**：`${ROOT}/Library_Final` (固定)
+
+### 4. 前端交互设计
+
+- **配置入口**：全局设置 (Settings) 页面。
+- **交互流程**：
+    1. 用户点击“选择根目录”。
+    2. 系统展示派生出的子目录预览列表。
+    3. 点击“保存”，系统自动创建尚未存在的子目录。
+    4. 各功能页面的路径输入框默认填充上述对应的自动路径。
+
+### 5. 后端实现建议
+
+- **ConfigService**: 负责保存 `BasePath` 并提供获取各子路径的方法（如 `getAggregatedDir()`）。
+- **初始化逻辑**: 在保存 `BasePath` 时，调用 `Files.createDirectories()` 确保整个工作流目录结构就绪。
+- **路径解析**: 使用 `Paths.get(basePath, subDirName)` 确保跨平台路径兼容。