Skip to Content

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 repository

Vai 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 await gọ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ông await.
  • 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òn inArray vớ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 defineFlow trong shared/: gọi OrderFlow.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