@goplusvn/core 0.1.70 → 0.1.71

package/templates/starter-app/src/app/api/users/route.ts

@@ -0,0 +1,139 @@
+import { NextResponse } from "next/server"
+import bcrypt from "bcryptjs"
+
+import { apiHandler } from "@/lib/api-handler"
+import { serverError } from "@/lib/errors/server-error"
+import { db } from "@/lib/prisma"
+import { getUsersList } from "@/server/services/user-service"
+
+/**
+ * /api/users — danh sách + tạo người dùng.
+ *
+ * Đơn giản hóa so với vinhhoa: không có profile (phòng ban/chức danh/SĐT),
+ * không sync better-auth riêng — mật khẩu nằm ở Account providerId="credential"
+ * (nơi DUY NHẤT Better Auth đọc, xem prisma/schema/auth.prisma). Các field
+ * vinhhoa-specific mà UnifiedProfileDialog của core vẫn gửi lên (phone,
+ * address, departmentId, jobTitleId, supplierId, userType…) được BỎ QUA.
+ */
+
+export const GET = apiHandler(
+  async (req) => {
+    try {
+      const sp = new URL(req.url).searchParams
+      const result = await getUsersList({
+        search: sp.get("search")?.trim() || sp.get("q")?.trim() || undefined,
+        roleCode: sp.get("role")?.trim() || undefined,
+        status: sp.get("status")?.trim() || undefined,
+      })
+      return NextResponse.json(result)
+    } catch (error) {
+      return serverError(error, req, { message: "Lỗi tải danh sách người dùng" })
+    }
+  },
+  { resource: "user", action: "view" },
+)
+
+export const POST = apiHandler(
+  async (req) => {
+    try {
+      const body = await req.json()
+      const name = typeof body.name === "string" ? body.name.trim() : ""
+      const email =
+        typeof body.email === "string" ? body.email.toLowerCase().trim() : ""
+      const password = typeof body.password === "string" ? body.password : ""
+      const isActive = body.status ? body.status === "active" : true
+      const roleCodes: string[] = Array.isArray(body.roleCodes)
+        ? body.roleCodes
+        : []
+      const branchIds: string[] = Array.isArray(body.branchIds)
+        ? body.branchIds
+        : []
+
+      if (!name) {
+        return NextResponse.json(
+          { error: "Tên là bắt buộc", field: "name" },
+          { status: 400 },
+        )
+      }
+      // Template dùng email làm định danh đăng nhập (User.email là unique).
+      if (!email) {
+        return NextResponse.json(
+          { error: "Email là bắt buộc", field: "email" },
+          { status: 400 },
+        )
+      }
+      if (password && password.length < 6) {
+        return NextResponse.json(
+          { error: "Mật khẩu phải có ít nhất 6 ký tự", field: "password" },
+          { status: 400 },
+        )
+      }
+
+      const existing = await db.user.findUnique({ where: { email } })
+      if (existing) {
+        return NextResponse.json(
+          { error: "Email đã tồn tại", field: "email" },
+          { status: 400 },
+        )
+      }
+
+      const hashedPassword = password ? await bcrypt.hash(password, 10) : null
+
+      const created = await db.$transaction(async (tx) => {
+        const user = await tx.user.create({
+          data: { name, email, isActive, emailVerified: true },
+        })
+
+        // Không có mật khẩu = không có Account credential = không đăng nhập
+        // được (vẫn tạo được để gán vai trò trước).
+        if (hashedPassword) {
+          await tx.account.create({
+            data: {
+              userId: user.id,
+              providerId: "credential",
+              accountId: user.id,
+              password: hashedPassword,
+            },
+          })
+        }
+
+        if (roleCodes.length > 0) {
+          await tx.userRole.createMany({
+            data: roleCodes.map((roleCode, index) => ({
+              userId: user.id,
+              roleCode,
+              isPrimary: index === 0,
+            })),
+            skipDuplicates: true,
+          })
+        }
+
+        if (branchIds.length > 0) {
+          const defaultBranchId =
+            typeof body.defaultBranchId === "string" &&
+            branchIds.includes(body.defaultBranchId)
+              ? body.defaultBranchId
+              : branchIds[0]
+          await tx.userBranch.createMany({
+            data: branchIds.map((branchId) => ({
+              userId: user.id,
+              branchId,
+              isDefault: branchId === defaultBranchId,
+            })),
+            skipDuplicates: true,
+          })
+        }
+
+        return user
+      })
+
+      return NextResponse.json(
+        { id: created.id, name: created.name, email: created.email },
+        { status: 201 },
+      )
+    } catch (error) {
+      return serverError(error, req, { message: "Lỗi tạo người dùng" })
+    }
+  },
+  { resource: "user", action: "create" },
+)

package/templates/starter-app/src/app/global-error.tsx

@@ -0,0 +1,135 @@
+"use client"
+
+/**
+ * Lưới an toàn CUỐI CÙNG — bắt lỗi ném từ chính root layout
+ * (`app/[lang]/layout.tsx`, nơi gọi `getSession` + `getSystemCompany` nên một
+ * cú nghẽn DB là đủ để cả app sập).
+ *
+ * PHẢI nằm ở `app/global-error.tsx`. Next chỉ đọc convention này ở GỐC cây
+ * route (`create-component-tree.tsx`: `isRoot ? getConventionPathByType(…,
+ * 'global-error') : undefined`) — bản cũ đặt ở `app/[lang]/global-error.tsx`
+ * chưa từng được nạp, nên mọi lần app sập người dùng chỉ thấy trang trắng với
+ * dòng "Application error: a server-side exception has occurred".
+ *
+ * Cố ý KHÔNG import `globals.css`, `@goerp/core/ui` hay bất cứ thứ gì khác:
+ * global-error thay luôn root layout, và nó thường chạy đúng lúc app đang hỏng
+ * (chunk lỗi, CSS chưa tải, provider chết). Style nội tuyến + thẻ HTML thuần là
+ * thứ duy nhất chắc chắn hiển thị được trong hoàn cảnh đó. Đừng "dọn cho đẹp"
+ * bằng cách kéo design system vào đây.
+ */
+export default function GlobalError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string }
+  reset: () => void
+}) {
+  return (
+    <html lang="vi">
+      <body
+        style={{
+          margin: 0,
+          minHeight: "100vh",
+          display: "flex",
+          alignItems: "center",
+          justifyContent: "center",
+          padding: "16px",
+          background: "#f8fafc",
+          color: "#0f172a",
+          fontFamily:
+            'system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", sans-serif',
+        }}
+      >
+        <div
+          style={{
+            width: "100%",
+            maxWidth: "480px",
+            background: "#ffffff",
+            border: "1px solid #e2e8f0",
+            borderRadius: "8px",
+            padding: "24px",
+            boxShadow: "0 1px 3px rgba(15, 23, 42, 0.08)",
+          }}
+        >
+          <h1
+            style={{
+              margin: "0 0 12px",
+              fontSize: "18px",
+              fontWeight: 700,
+              color: "#b91c1c",
+            }}
+          >
+            Hệ thống đang gặp sự cố
+          </h1>
+          <p
+            style={{
+              margin: "0 0 16px",
+              fontSize: "14px",
+              lineHeight: 1.6,
+              color: "#475569",
+            }}
+          >
+            Không dựng được giao diện. Dữ liệu của bạn vẫn an toàn — đây là lỗi
+            kỹ thuật tạm thời. Vui lòng thử lại; nếu vẫn lỗi, gửi mã bên dưới
+            cho quản trị viên.
+          </p>
+
+          {error.digest ? (
+            <p
+              style={{
+                margin: "0 0 16px",
+                padding: "8px 12px",
+                borderRadius: "6px",
+                background: "#f1f5f9",
+                fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
+                fontSize: "12px",
+                color: "#334155",
+                wordBreak: "break-all",
+              }}
+            >
+              Mã lỗi: {error.digest}
+            </p>
+          ) : null}
+
+          <div style={{ display: "flex", flexWrap: "wrap", gap: "8px" }}>
+            <button
+              type="button"
+              onClick={() => reset()}
+              style={{
+                padding: "8px 16px",
+                borderRadius: "6px",
+                border: "none",
+                background: "#4f46e5",
+                color: "#ffffff",
+                fontSize: "14px",
+                fontWeight: 500,
+                cursor: "pointer",
+              }}
+            >
+              Thử lại
+            </button>
+            {/* CỐ Ý dùng <a> chứ không phải next/link: ở đây app đang hỏng, và
+                điều hướng client-side sẽ giữ nguyên cái cây React đã chết. Tải
+                lại cả tài liệu mới thật sự thoát được. */}
+            {/* eslint-disable-next-line @next/next/no-html-link-for-pages */}
+            <a
+              href="/"
+              style={{
+                padding: "8px 16px",
+                borderRadius: "6px",
+                border: "1px solid #cbd5e1",
+                background: "#ffffff",
+                color: "#334155",
+                fontSize: "14px",
+                fontWeight: 500,
+                textDecoration: "none",
+              }}
+            >
+              Về trang chủ
+            </a>
+          </div>
+        </div>
+      </body>
+    </html>
+  )
+}

package/templates/starter-app/src/app/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <!-- Favicon mặc định của starter-app — thay bằng icon thương hiệu của bạn.
+       Đặt ở src/app/icon.svg là Next tự phục vụ /icon (App Router metadata). -->
+  <rect width="64" height="64" rx="14" fill="#4f46e5"/>
+  <text x="32" y="43" text-anchor="middle" font-family="ui-sans-serif, system-ui, -apple-system, sans-serif" font-size="34" font-weight="700" fill="#ffffff">G</text>
+</svg>

package/templates/starter-app/src/app/manifest.ts

@@ -0,0 +1,26 @@
+import type { MetadataRoute } from "next"
+
+import { tenant } from "@/configs/tenant"
+
+/**
+ * Web App Manifest — mức PWA "cài được lên màn hình chính" (Add to Home
+ * Screen), sinh động theo tenant config. Offline/service-worker CHƯA nằm ở
+ * đây — app cần chạy không mạng (nhà máy sóng yếu) thì thêm serwist ở tầng
+ * app, đó là quyết định riêng từng dự án.
+ */
+export default function manifest(): MetadataRoute.Manifest {
+  const name = tenant.branding?.companyName ?? tenant.name
+  return {
+    name,
+    short_name: tenant.name,
+    description: tenant.branding?.tagline || name,
+    start_url: "/",
+    display: "standalone",
+    background_color: "#ffffff",
+    theme_color: "#4f46e5",
+    icons: [
+      // Next tự phục vụ src/app/icon.svg tại /icon — thay icon là đổi luôn ở đây.
+      { src: "/icon", sizes: "any", type: "image/svg+xml", purpose: "any" },
+    ],
+  }
+}

package/templates/starter-app/src/configs/entities/index.ts

@@ -1,11 +1,15 @@
 import type { EntityConfig } from "@goerp/core/types"
 
 import { departmentConfig } from "./department.config"
+import { jobTitlesConfig } from "./job-titles.config"
+import { systemAlertsConfig } from "./system-alerts.config"
 
 // Đăng ký entity → cấu hình. Khóa = số nhiều, khớp URL /crud/<key> + apiEndpoint.
-// Thêm entity mới: import config rồi thêm 1 dòng ở đây.
+// Thêm entity mới: import config rồi thêm 1 dòng ở đây (kèm MODEL_MAP ở src/lib/crud).
 export const entityConfigs: Record<string, EntityConfig> = {
   departments: departmentConfig,
+  "job-titles": jobTitlesConfig,
+  "system-alerts": systemAlertsConfig,
 }
 
 export function getEntityConfig(entity: string): EntityConfig | undefined {

package/templates/starter-app/src/configs/entities/job-titles.config.ts

@@ -0,0 +1,119 @@
+import { Briefcase } from "lucide-react"
+
+import type { EntityConfig } from "@goerp/core/types"
+
+/** Chức danh trong tổ chức — entity CRUD generic. URL: /crud/job-titles. */
+export const jobTitlesConfig: EntityConfig = {
+  name: "jobTitle",
+  permissionResource: "job-title",
+  label: "Chức danh",
+  pluralLabel: "Chức danh",
+  icon: Briefcase,
+  description: "Quản lý danh sách chức danh trong tổ chức",
+  apiEndpoint: "/api/crud/job-titles",
+  idField: "id",
+  displayField: "name",
+
+  fields: [
+    {
+      name: "id",
+      label: "ID",
+      type: "text",
+      hideInForm: true,
+      hideInTable: true,
+    },
+    {
+      name: "code",
+      label: "Mã chức danh",
+      type: "text",
+      required: true,
+      placeholder: "VD: DIRECTOR, MANAGER, STAFF",
+      filterable: true,
+      width: 140,
+    },
+    {
+      name: "name",
+      label: "Tên chức danh",
+      type: "text",
+      required: true,
+      placeholder: "Nhập tên chức danh",
+      filterable: true,
+    },
+    {
+      name: "description",
+      label: "Mô tả",
+      type: "textarea",
+      placeholder: "Nhập mô tả chức danh",
+      hideInTable: true,
+    },
+    {
+      name: "level",
+      label: "Cấp bậc",
+      type: "number",
+      required: true,
+      defaultValue: 0,
+      placeholder: "Cấp bậc (số lớn = cao hơn)",
+      width: 100,
+    },
+    {
+      name: "status",
+      label: "Trạng thái",
+      type: "switch",
+      required: true,
+      defaultValue: "active",
+      filterable: true,
+      options: [
+        { label: "Hoạt động", value: "active" },
+        { label: "Vô hiệu hóa", value: "inactive" },
+      ],
+    },
+    {
+      name: "createdAt",
+      label: "Ngày tạo",
+      type: "datetime",
+      hideInForm: true,
+      width: 120,
+      renderCell: (value) =>
+        new Date(value as string).toLocaleDateString("vi-VN", {
+          timeZone: "Asia/Ho_Chi_Minh",
+        }),
+    },
+  ],
+
+  filters: [
+    {
+      name: "search",
+      label: "Tìm kiếm",
+      type: "text",
+      field: "name",
+      operator: "contains",
+    },
+    {
+      name: "status",
+      label: "Trạng thái",
+      type: "select",
+      field: "status",
+      operator: "eq",
+      options: [
+        { label: "Hoạt động", value: "active" },
+        { label: "Vô hiệu hóa", value: "inactive" },
+      ],
+    },
+  ],
+
+  permissions: {
+    create: true,
+    read: true,
+    update: true,
+    delete: true,
+    export: true,
+    import: true,
+  },
+
+  features: {
+    search: true,
+    bulkActions: true,
+    export: true,
+    import: true,
+  },
+}

package/templates/starter-app/src/configs/entities/system-alerts.config.ts

@@ -0,0 +1,91 @@
+import { Bell } from "lucide-react"
+
+import type { EntityConfig } from "@goerp/core/types"
+
+/**
+ * Cảnh báo hệ thống — ví dụ entity CRUD generic viết config TỪ ĐẦU (department
+ * là ví dụ kế thừa config core). URL: /crud/system-alerts.
+ */
+export const systemAlertsConfig: EntityConfig = {
+  name: "system-alert",
+  permissionResource: "system-alert",
+  label: "Cảnh báo hệ thống",
+  pluralLabel: "Cảnh báo hệ thống",
+  icon: Bell,
+  description: "Quản lý các thông báo và cảnh báo hệ thống",
+  apiEndpoint: "/api/crud/system-alerts",
+  idField: "id",
+  displayField: "title",
+
+  fields: [
+    {
+      name: "id",
+      label: "ID",
+      type: "text",
+      hideInForm: true,
+      hideInTable: true,
+    },
+    {
+      name: "title",
+      label: "Tiêu đề",
+      type: "text",
+      required: true,
+      filterable: true,
+    },
+    {
+      name: "message",
+      label: "Nội dung",
+      type: "textarea",
+      required: true,
+    },
+    {
+      name: "type",
+      label: "Loại",
+      type: "select",
+      filterable: true,
+      defaultValue: "info",
+      options: [
+        { label: "Thông tin", value: "info" },
+        { label: "Cảnh báo", value: "warning" },
+        { label: "Lỗi", value: "error" },
+        { label: "Thành công", value: "success" },
+      ],
+    },
+    {
+      name: "status",
+      label: "Trạng thái",
+      type: "select",
+      filterable: true,
+      defaultValue: "pending",
+      options: [
+        { label: "Chờ gửi", value: "pending" },
+        { label: "Đã gửi", value: "sent" },
+        { label: "Đã đọc", value: "read" },
+      ],
+    },
+    {
+      name: "createdAt",
+      label: "Ngày tạo",
+      type: "datetime",
+      hideInForm: true,
+      renderCell: (value) =>
+        new Date(value as string).toLocaleString("vi-VN", {
+          timeZone: "Asia/Ho_Chi_Minh",
+        }),
+    },
+  ],
+
+  permissions: {
+    create: true,
+    read: true,
+    update: true,
+    delete: true,
+    export: true,
+  },
+
+  features: {
+    search: true,
+    bulkActions: true,
+    export: true,
+  },
+}

package/templates/starter-app/src/configs/entities/users.config.ts

@@ -0,0 +1,67 @@
+import type { EntityConfig } from "@goerp/core/types"
+
+/**
+ * Cấu hình entity cho trang /users (UsersClientPage của core).
+ *
+ * KHÔNG đăng ký vào `entityConfigs` (src/configs/entities/index.ts): người
+ * dùng không đi qua CRUD engine generic (/crud/users) — tạo/sửa phải qua
+ * /api/users để còn hash mật khẩu vào Account credential + gán vai trò/chi
+ * nhánh trong transaction.
+ *
+ * Toàn bộ giá trị ở đây là PURE DATA (không icon component, không hàm) nên
+ * truyền thẳng từ server page xuống client không cần bước serialize như
+ * vinhhoa.
+ */
+export const usersConfig: EntityConfig = {
+  name: "user",
+  permissionResource: "user",
+  label: "Người dùng",
+  pluralLabel: "Người dùng",
+  iconName: "Users",
+  description: "Quản lý tài khoản đăng nhập, vai trò và chi nhánh",
+  apiEndpoint: "/api/users",
+  idField: "id",
+  displayField: "name",
+
+  fields: [
+    { name: "id", label: "ID", type: "text", hideInForm: true, hideInTable: true },
+    { name: "name", label: "Họ tên", type: "text", required: true },
+    { name: "email", label: "Email", type: "email", required: true, width: 200 },
+    {
+      name: "roleNames",
+      label: "Vai trò",
+      type: "text",
+      hideInForm: true,
+      width: 150,
+    },
+    {
+      name: "branchNames",
+      label: "Chi nhánh",
+      type: "text",
+      hideInForm: true,
+      width: 150,
+    },
+    {
+      name: "status",
+      label: "Trạng thái",
+      type: "select",
+      hideInForm: true,
+      options: [
+        { label: "Hoạt động", value: "active" },
+        { label: "Đã khóa", value: "inactive" },
+      ],
+      width: 120,
+    },
+  ],
+
+  permissions: {
+    create: true,
+    read: true,
+    update: true,
+    delete: true,
+    // Toolbar user của core export qua /api/crud/users/export — endpoint đó
+    // không tồn tại trong template (users không nằm trong CRUD engine).
+    export: false,
+    import: false,
+  },
+}

package/templates/starter-app/src/configs/permissions/index.ts

@@ -43,3 +43,40 @@ export function getRegistryResourceCodes(): string[] {
 export function isLookupOpenToAuthenticated(code: string): boolean {
   return resourceByCode.get(code)?.lookupPolicy === "authenticated"
 }
+
+/** Metadata action cho trang phân quyền / catalog (nhãn tiếng Việt). */
+export interface ActionMetaEntry {
+  label?: string
+  description?: string
+}
+
+const BASE_ACTION_META: Record<string, ActionMetaEntry> = {
+  view: { label: "Xem" },
+  create: { label: "Tạo" },
+  update: { label: "Sửa" },
+  delete: { label: "Xóa" },
+  export: { label: "Xuất" },
+  import: { label: "Nhập" },
+}
+
+let actionMetaCache: Record<string, ActionMetaEntry> | null = null
+
+export function getActionMetaMap(): Record<string, ActionMetaEntry> {
+  if (actionMetaCache) return actionMetaCache
+  const map: Record<string, ActionMetaEntry> = { ...BASE_ACTION_META }
+  for (const feature of permissionRegistry) {
+    for (const a of feature.customActions ?? []) {
+      map[a.code] = { label: a.name, description: a.description }
+    }
+  }
+  actionMetaCache = map
+  return map
+}
+
+export function getLookupPolicyMap(): Record<string, LookupPolicy> {
+  const map: Record<string, LookupPolicy> = {}
+  resourceByCode.forEach((r, code) => {
+    map[code] = r.lookupPolicy ?? "view-only"
+  })
+  return map
+}

package/templates/starter-app/src/configs/permissions/master-data.permissions.ts

@@ -25,6 +25,17 @@ const masterDataPermissions: FeaturePermissions = {
         staff: ["view", "export"],
       },
     },
+    {
+      code: "job-title",
+      name: "Chức danh",
+      group: "Danh mục",
+      icon: "Briefcase",
+      order: 2,
+      actions: ["view", "create", "update", "delete", "export", "import"],
+      // Chức danh đổ vào picker hồ sơ nhân sự.
+      lookupPolicy: "authenticated",
+      defaultGrants: { admin: "*", staff: ["view"] },
+    },
   ],
 }