Skip to Content

File sinh sẵn

app/db.ts, app/api.ts và app/hooks.ts do manh.run sinh lại ở mỗi lần build. Bạn import chúng nhưng không viết hay sửa chúng.

app/ ├── db.ts # [sinh sẵn] server ├── api.ts # [sinh sẵn] trình duyệt ├── hooks.ts # [sinh sẵn] trình duyệt └── orders/ ├── orders.table.ts # nguồn của db.ts └── get.ts post.ts # nguồn của api.ts

Vai trò

Các file này không nằm trong project. manh.run dựng chúng từ code của bạn: app/db.ts từ các file .table.ts, app/api.ts từ các file handler. Agent đọc được chúng bằng read_files để biết đúng tên hàm, khỏi phải đoán.

app/db.ts (server)

  • db: client database của app.
  • schemaOf(table): zod { insert, update } sinh từ cột của bảng.
  • listSchema(opts) và listOf(table, query, opts): danh sách phân trang trả { data, total }.
  • insertMany(table, rows): chèn nhiều dòng một lần. scopeBy(user, { role: where }): lọc dòng theo vai trò.
  • Hàm dựng bảng: sqliteTable, integer, text, real, blob, index, uniqueIndex, primaryKey, foreignKey, unique.
  • Toán tử: eq, ne, lt, lte, gt, gte, like, ilike, notLike, notIlike, and, or, not, isNull, isNotNull, inArray, notInArray, between, notBetween, exists, notExists, asc, desc, sql, count, countDistinct, sum, sumDistinct, avg, avgDistinct, min, max, alias.

Import một tên khác từ app/db thì check báo lỗi, vì build sẽ hỏng. Phép tính không có trong danh sách thì viết bằng sql.

app/api.ts (trình duyệt)

useApiClient() trả client có kiểu, mỗi handler một hàm. Hàm trả đúng thứ handler trả, không cần .data.

File handlerLời gọi
app/orders/get.tsapi.orders.list(params)
app/orders/post.tsapi.orders.create(body)
app/orders/[id:int]/get.tsapi.orders.detail(id)
app/orders/[id:int]/patch.tsapi.orders.update(id, body)
app/orders/[id:int]/delete.tsapi.orders.remove(id)
app/orders/[id:int]/status/post.tsapi.orders.status(id, body)
app/reports/sales/get.tsapi.reports.sales(params)
app/chat-messages/get.tsapi.chatMessages.list()

app/hooks.ts (trình duyệt)

  • useRequest(fn, opts): tải dữ liệu, trả { data, loading, error, run, refresh, mutate }.
  • tableRequest(api.orders.list): request cho một ProTable tự viết. Phân trang, sắp xếp, bộ lọc và ô tìm kiếm khớp với query của listOf.
  • optionsFrom(api.users.members, "name"): lựa chọn cho ô chọn. submit(fn, { done, reload, form }): onFinish cho form, báo thành công, tải lại bảng, gắn lỗi vào đúng trường.
  • useAction(fn, { ok, reload }): mọi nút hay form khác, trả true hoặc false.
  • useApi(): axios thô, chỉ cho API bên thứ ba. useRoutes(): danh sách route.
  • useLive(channel, onMessage): nhận tin broadcast() từ server để làm mới màn hình ngay.
  • Phiên đăng nhập: signIn, signOut, useSession, getUser, signInWith("google"); cấp thấp: setAuthToken, getAuthToken.

manh/shell (trình duyệt)

Module này không nằm trong project nhưng luôn có sẵn, như các file trên. AppShell là khung app: menu theo vai trò, nút đăng xuất, tiếng Việt, theme. ResourceList và ResourceDetail dựng trang danh sách và trang chi tiết từ file cột. Ngoài ra còn RecordPage, FlowActions, StatRow, ActivityLog, useStatusTabs, errorText.

Ví dụ

app/orders/page.tsx
import { useApiClient } from "app/api"; import { ResourceList } from "manh/shell"; import { OrderStatus } from "app/shared/order"; import { orderColumns } from "./orders-columns"; export default function OrdersPage() { const api = useApiClient(); // tab trạng thái có số đếm, tìm kiếm, phân trang, form thêm mới, link tới /orders/:id return <ResourceList api={api.orders} title="Đơn hàng" path="/orders" columns={orderColumns} status="status" statusEnum={OrderStatus} />; }

Cần biết

  • Sửa tay các file này sẽ mất ở lần build sau. Đổi schema bằng file .table.ts, đổi API bằng file handler.
  • app/db.ts không export bảng. Import bảng từ file .table.ts của nó.
  • Gọi một tên client không có, check từ chối và liệt kê tên đúng.
  • Hai handler ra cùng một tên thì cái sau có hậu tố 2. Tách chúng ra đường dẫn con.
  • Có app/auth.ts thì manh.run sinh thêm app/users/users.table.ts, app/shared/auth-roles.ts và các API /api/auth/*, /api/users. Xem auth.ts.

Bước tiếp theo

  • Gọi dữ liệu — dùng useApiClient() và các hook này trong trang.
  • <resource>.table.ts — khai báo bảng mà app/db đọc vào.
  • auth.ts — bật đăng nhập để có thêm bảng người dùng và API đăng nhập.
Cập nhật