diff --git a/backend/llm.txt b/backend/llm.txt index dc1bbd7..30250ec 100644 --- a/backend/llm.txt +++ b/backend/llm.txt @@ -199,6 +199,7 @@ In this case: 本项目使用 River(`github.com/riverqueue/river`)作为异步任务系统,并通过 `atomctl new job [--cron]` 生成 `backend/app/jobs/*.go`。 - MUST:任务入队(调用 `job.Add(...)` / `client.Insert(...)`)只能在 `service` / `controller` / `event` 层编写;其它位置(例如 `middlewares` / `database` / `models` / `providers` / `jobs` 的 worker 实现等)禁止写入任务,避免耦合与隐式副作用。 +- MUST:为避免 `services` 与 `jobs` 的循环依赖,JobArgs 定义固定放在 `backend/app/jobs/args/`;Worker 放在 `backend/app/jobs/`(Worker 可以依赖 `services`,但 args 包禁止依赖 `services`)。 ### Job(一次性任务)