shared/
Thư mục app/shared/ chứa kiểu, hằng số, enum, vòng đời trạng thái và hàm thuần mà cả trang lẫn server cần, viết một lần.
app/
├── shared/
│ └── order.ts # OrderStatus, OrderFlow
├── orders/
│ ├── repository.ts # OrderFlow.assert(...)
│ ├── get.ts # z.enum(OrderStatus.values)
│ └── page.tsx # valueEnum: OrderStatus.valueEnumVai trò
Trang (.tsx) và server (.ts) không import file của nhau. app/shared/ là ngoại lệ duy nhất: cả hai phía cùng import nó. Một danh sách trạng thái viết ở đây thì bộ kiểm của API, cột bảng, ô chọn và email đều đọc cùng một chỗ.
Export
Tuỳ ý, miễn là thuần:
- kiểu TypeScript, hằng số, danh sách
as const - enum bằng
defineEnumtừmanh/enum:values,label(v),color(v),valueEnum,options - vòng đời bằng
defineFlow(def, Enum)từmanh/flow:assert(user, from, to),next(status, role),can(role, from, to),isFinal(status) - hàm thuần, ví dụ định dạng tiền
Ví dụ
app/shared/order.ts
import { defineEnum } from "manh/enum";
import { defineFlow } from "manh/flow";
export const OrderStatus = defineEnum({
new: ["Mới", "processing"], // [nhãn, màu]
done: ["Hoàn thành", "success"],
cancelled: ["Đã huỷ", "default"],
});
export type OrderStatus = (typeof OrderStatus.values)[number];
// trạng thái → trạng thái kế → vai được chuyển
export const OrderFlow = defineFlow({
new: { done: ["warehouse", "admin"], cancelled: ["sales", "admin"] },
done: {},
cancelled: {},
}, OrderStatus); // truyền enum để thông báo lỗi đọc "Mới" → "Hoàn thành" thay vì tên khoá- Server:
z.enum(OrderStatus.values)trongschema;OrderFlow.assert(user, row.status, to)trong repository trả 409 cho bước không tồn tại, 403 cho sai vai. - Trang:
valueEnum: OrderStatus.valueEnumtrên cột; nút chuyển trạng thái lấy từOrderFlow.next(row.status, user.role).
Cần biết
- File trong
app/shared/chỉ importapp/shared/*,manh/enum,manh/flowvàmanh/vn. Khôngzod,app/db,manh/env,hono,drizzle-orm,react.checkbáoshared.impure-import. - File là
.ts, không có JSX (shared.not-tsx), không dùngwindow,document,localStorage. - Không khai báo lại cùng danh sách trong trang hay handler.
- Có
app/auth.tsthì manh.run sinhapp/shared/auth-roles.tsvớiROLES,ADMIN_ROLE,DEFAULT_ROLE. Dùng nó cho menu và ô chọn vai.
Bước tiếp theo
- repository.ts — gọi
OrderFlow.asserttrước khi đổi trạng thái. <resource>-columns.tsx— dùngvalueEnumcủa enum cho cột trạng thái.
Cập nhật