| name | busic-database |
| description | BuSic数据层规范。用于Drift表定义、迁移、Repository实现和Domain模型映射时快速确认主真源与联动检查项 |
| license | MIT |
| compatibility | opencode |
何时使用
- 新增或修改 Drift 表
- 调整
schemaVersion、迁移逻辑或 Repository 映射
- 想确认 Domain 模型、DB 表和 Repository 的职责边界
先看这些真源
表与迁移 checklist
改表时至少同步检查:
- 表定义文件
@DriftDatabase(tables: [...]) 注册
schemaVersion
onUpgrade
build_runner
命令:
dart run build_runner build
Agent 执行时,dart run ... 通常需要提权到沙箱外;完整分类见 busic-harness-workflow。
Repository 规则
- Repository 接口和实现都放在
data/ 层
- Domain 模型与 DB 表分离,由 Repository 负责映射
- Repository 不是业务状态容器;业务编排仍在 Notifier
- 需要长期存活的 Repository,再交给手动 Provider 管理
常见联动
- 下载链路不要只改任务表,记得回写
songs.localPath 与 songs.audioQuality
- 分享 / 备份不要把本地路径写进跨设备数据
- 数据库变更后,测试要优先验证真实表状态,而不是只断言中间变量
相关 Skill