Domain 层与 UseCase 调用链

约 654 字大约 2 分钟

2026-03-20

1. 背景与目标

如果你把 SleepIn 的代码看成一条流水线，那么 UseCase 就是中间的“业务工位”。

ViewModel 把用户意图交给 UseCase。
UseCase 负责校验、规则判断、调用 Repository。
这样 UI 和数据存储可以彼此独立演进。

2. 相关模块与文件位置（先看树）

app/src/main/java/com/kurosu/sleepin/domain/
├─ model/                                         # 业务模型
├─ repository/                                    # 仓库接口
└─ usecase/
   ├─ course/                                     # 课程相关用例
   ├─ schedule/                                   # 作息模板相关用例
   ├─ timetable/                                  # 学期课表相关用例
   ├─ csv/                                        # CSV 导入导出用例
   └─ settings/                                   # 设置相关用例

示例文件：

app/src/main/java/com/kurosu/sleepin/domain/usecase/schedule/SaveScheduleUseCase.kt
app/src/main/java/com/kurosu/sleepin/domain/usecase/course/AddCourseUseCase.kt
app/src/main/java/com/kurosu/sleepin/domain/usecase/timetable/CreateTimetableUseCase.kt

3. UseCase 在本项目中的定位

UseCase 负责三类事情：

校验输入（例如名称为空、周数非法）。
执行业务规则（例如课节时间不能重叠）。
组织调用顺序（例如先创建课表，再导入 CSV）。

SleepIn 中大量 UseCase 使用 operator fun invoke，所以在 ViewModel 里可以像函数一样调用：

val result = saveScheduleUseCase(
    scheduleId = null,
    name = "春季作息",
    createdAt = null,
    periods = periods
)

4. 核心流程：`SaveScheduleUseCase`

sequenceDiagram
    participant UI as ScheduleEditorScreen
    participant VM as ScheduleEditorViewModel
    participant UC as SaveScheduleUseCase
    participant Repo as ScheduleRepository

    UI->>VM: 点击保存
    VM->>UC: invoke(scheduleId, name, periods)
    UC->>UC: 名称/编号/时间区间校验
    alt 校验失败
        UC-->>VM: ValidationError(message)
        VM-->>UI: 显示错误提示
    else 校验通过
        UC->>Repo: saveScheduleWithPeriods(schedule, periods)
        Repo-->>UC: savedId
        UC-->>VM: Success(savedId)
        VM-->>UI: 提示成功或返回上一页
    end