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.tsVai 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 handler | Lời gọi |
|---|---|
app/orders/get.ts | api.orders.list(params) |
app/orders/post.ts | api.orders.create(body) |
app/orders/[id:int]/get.ts | api.orders.detail(id) |
app/orders/[id:int]/patch.ts | api.orders.update(id, body) |
app/orders/[id:int]/delete.ts | api.orders.remove(id) |
app/orders/[id:int]/status/post.ts | api.orders.status(id, body) |
app/reports/sales/get.ts | api.reports.sales(params) |
app/chat-messages/get.ts | api.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):requestcho mộtProTabletự viết. Phân trang, sắp xếp, bộ lọc và ô tìm kiếm khớp với query củalistOf.optionsFrom(api.users.members, "name"): lựa chọn cho ô chọn.submit(fn, { done, reload, form }):onFinishcho 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ảtruehoặcfalse.useApi(): axios thô, chỉ cho API bên thứ ba.useRoutes(): danh sách route.useLive(channel, onMessage): nhận tinbroadcast()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ụ
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.tskhông export bảng. Import bảng từ file.table.tscủa nó.- Gọi một tên client không có,
checktừ 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.tsthì manh.run sinh thêmapp/users/users.table.ts,app/shared/auth-roles.tsvà 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.