repository.ts
repository.ts giữ mọi lệnh database và quy tắc nghiệp vụ của một resource, để handler, cron và email cùng gọi một chỗ.
app/orders/
├── orders.table.ts
├── repository.ts # listOrders, getOrder, createOrder, moveOrder…
├── get.ts # gọi listOrders
├── post.ts # gọi createOrder
└── remind.cron.ts # gọi cùng repositoryVai trò
Đơn hàng có trạng thái, chỉ vài vai được chuyển trạng thái, tổng tiền do server tính, tồn kho không được âm. Mọi quy tắc đó nằm trong repository.ts. Handler chỉ kiểm input, gọi một hàm rồi trả kết quả.
Quy tắc sai thì ném lỗi bằng fail(status, message, code). Handler không cần try/catch; giao diện nhận { message, code } để hiện.
Export
Hàm tuỳ ý. Tên file cố định là repository.ts, đặt trong thư mục của resource.
Ví dụ
app/orders/repository.ts
import { db, eq, sql, listOf } from "app/db";
import { fail } from "manh/errors";
import { orders } from "./orders.table";
import { products } from "../products/products.table";
type Actor = { id: number; role: string };
export const listOrders = (user: Actor, query) =>
listOf(orders, query, {
search: [orders.customerName],
filters: { status: orders.status },
sort: { createdAt: orders.createdAt },
where: user.role === "sales" ? eq(orders.createdBy, user.id) : undefined, // sales chỉ thấy đơn của mình
});
export async function createOrder(user: Actor, input: { productId: number; quantity: number; customerName: string }) {
const [p] = await db.select().from(products).where(eq(products.id, input.productId));
if (!p) fail(404, "Sản phẩm không tồn tại", "NOT_FOUND");
if (p.stock < input.quantity) fail(409, `Chỉ còn ${p.stock} sản phẩm`, "OUT_OF_STOCK");
await db.update(products).set({ stock: sql`${products.stock} - ${input.quantity}` }).where(eq(products.id, p.id));
const [row] = await db.insert(orders).values({
...input, total: p.price * input.quantity, status: "new", createdBy: user.id, createdAt: Date.now(),
}).returning();
return row;
}Cần biết
- Request tới một app chạy lần lượt, nên đọc rồi ghi (kiểm tồn kho rồi trừ) không bị request khác chen vào. Ngoại lệ: một
awaitgọi ra ngoài (fetch, gửi email, gọi AI) cho request khác chạy. Gửi email sau khi ghi xong. - Không gọi
db.transaction(async …). Kiểm hết rồi mới ghi; cần nhiều lệnh ghi cùng thành hoặc cùng hỏng thì dùng callback đồng bộ, khôngawait. - Mỗi câu lệnh tối đa 100 giá trị. Lệnh chèn nhiều dòng được manh.run tự chia nhỏ trong một transaction (hoặc dùng
insertMany); còninArrayvới hơn 100 id thì đổi sang join hay truy vấn con. - Không để client gửi
status,createdBy, giá hay tổng tiền. Repository tự đặt. - Chuyển trạng thái theo vòng đời khai báo một lần bằng
defineFlowtrong shared/: gọiOrderFlow.assert(user, row.status, to)trước khi ghi.
Bước tiếp theo
- Làm một tính năng CRUD — ghép bảng, repository, handler và trang cho một resource.
- shared/ — khai báo vòng đời trạng thái bằng
defineFlowđể repository kiểm. - Database —
listOf, transaction và giới hạn câu lệnh.
Cập nhật