事实源

如果当前上下文中指名了 Jimmer 项目的源码的本地路径，应当以源码实现作为基准。如果有其他情况需要查阅 Jimmer 的具体实现，其代码仓库为 https://github.com/babyfish-ct/jimmer

本项目约定（XiaomiAlbumSyncer）

服务端为 Solon + Kotlin + Jimmer，不是 Spring；服务类用 @Managed 标记，依赖通过构造函数或 @Inject 注入
实体：server/src/main/kotlin/com/coooolfan/xiaomialbumsyncer/model/
DTO：server/src/main/dto/<Entity>.dto，KSP 生成于 ...model.dto
查询入口是注入的 KSqlClient，项目内习惯用 sql.executeQuery(Entity::class) { ... } / sql.executeDelete / sql.saveCommand(input, SaveMode.X)，而非 createQuery(...).execute()
Controller 返回实体时用 companion 中的 Fetcher<T> 常量 + @FetchBy 固定投影，Service 接受 fetcher: Fetcher<T> 参数
修改实体/DTO 后需执行 cd server && ./gradlew clean compileKotlin 验证 KSP 生成代码可编译
数据库表结构由 Flyway 迁移管理（server/src/main/resources 下的 migration），新增字段需同步添加迁移脚本