Skip to Content

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.valueEnum

Vai 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 defineEnum từ 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) trong schema; 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.valueEnum trê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ỉ import app/shared/*, manh/enum, manh/flow và manh/vn. Không zod, app/db, manh/env, hono, drizzle-orm, react. check báo shared.impure-import.
  • File là .ts, không có JSX (shared.not-tsx), không dùng window, document, localStorage.
  • Không khai báo lại cùng danh sách trong trang hay handler.
  • Có app/auth.ts thì manh.run sinh app/shared/auth-roles.ts với ROLES, ADMIN_ROLE, DEFAULT_ROLE. Dùng nó cho menu và ô chọn vai.

Bước tiếp theo

Cập nhật