*.cron.ts
Mỗi file *.cron.ts là một job manh.run gọi theo lịch, không cần ai mở app, với lịch viết theo cú pháp cron 5 trường giờ UTC.
app/orders/
├── repository.ts
├── cancel-stale.cron.ts # job "cancel-stale"
└── daily-digest.cron.ts # job "daily-digest"Vai trò
Tên file bỏ .cron.ts là tên job. File đặt ở thư mục nào cũng được, thường cạnh repository.ts của resource mà job xử lý. Job gọi hàm trong repository như handler, nên quy tắc nghiệp vụ chỉ viết một chỗ.
Export
schedule: chuỗi cron 5 trường, giờ UTC. Giờ Việt Nam trừ 7: 08:00 mỗi ngày là"0 1 * * *".default: hàmasynckhông tham số. Không trả response.
Ví dụ
app/orders/daily-digest.cron.ts
import { email } from "manh/email";
import { ordersSince } from "./repository";
export const schedule = "0 1 * * *"; // 08:00 giờ Việt Nam
export default async function () {
const recent = await ordersSince(Date.now() - 24 * 3600 * 1000);
await email({
to: "chu-cua-hang@example.com",
subject: `Hôm qua có ${recent.length} đơn`,
html: `<meta charset="utf-8"><p>Hôm qua có ${recent.length} đơn mới.</p>`,
});
}Cần biết
- Khoảng cách nhỏ nhất là 1 phút. Mỗi app tối đa 20 lịch khác nhau; nhiều job có thể dùng chung một lịch.
- Mỗi lần chạy có 30 giây CPU. Lần chạy lỗi được thử lại, tổng cộng tối đa 3 lần. Lần chạy trước chưa xong thì lượt kế tiếp bị bỏ qua.
- Vì có thể chạy lại, job phải an toàn khi chạy hai lần: chỉ xử lý dòng chưa xử lý, đánh dấu sau khi làm xong.
- Job không đi qua
middleware.ts, không cócvà không có người dùng. Truyền những gì cần vào hàm repository. - Thứ trong tuần: 0 hoặc 7 là Chủ nhật, 1 là thứ Hai. Giới hạn cả ngày trong tháng lẫn thứ thì job chạy khi một trong hai khớp.
- Tạm dừng hoặc chạy ngay một job ở Vận hành › Cron của project. Agent làm được việc này qua MCP.
Bước tiếp theo
- Việc chạy định kỳ — đổi giờ chạy, chỉ xử lý phần mới, chạy lại vẫn an toàn.
- *.job.ts — đẩy việc nặng của job sang chạy nền để không quá 30 giây CPU.
- Email, AI, kho file — gửi báo cáo qua email từ job.
Cập nhật