常见业务场景

三个常见改法，每个只点出落点，细节回后端对应章节；不展开表结构。

列表加搜索

在 Repository 的列表查询上，从 $this->query() 起手后按请求参数追加 where / like 条件，再交给既有分页。查询一律经 query()，不要绕开数据权限。见 Repository 与 架构设计。

提交后发一条队列消息

写操作包在 Service 的 runInTransaction() 里；投递队列放在 afterCommit() 回调中，确保事务真正提交后再发。见 Service。队列进程随 php start.php start 一并拉起，见 快速开始。

按 created_by 做数据权限

在对应 Repository 声明 $dataScoped 与 $ownerColumn（常用 created_by），所有查询仍从 $this->query() 起手，由全局作用域按当前管理员范围过滤；create() 可自动填创建人列。见 Repository。