@goplusvn/core 0.1.69 → 0.1.71

package/src/ui/errors/error-view.tsx

@@ -0,0 +1,164 @@
+"use client"
+
+import { useEffect, useState } from "react"
+import Link from "next/link"
+import {
+  Button,
+  Card,
+  CardContent,
+  CardHeader,
+  CardTitle,
+} from "../index"
+import { AlertTriangle, Check, Copy, Home, RefreshCw } from "lucide-react"
+
+
+interface ErrorViewProps {
+  error: Error & { digest?: string }
+  /** `reset` của error boundary — dựng lại đúng segment bị lỗi, không tải lại trang. */
+  reset?: () => void
+  title?: string
+  /** Đoạn giải thích cho người dùng cuối. Mặc định là câu trấn an + hướng xử lý. */
+  description?: string
+  /** Nút "Về trang chủ" — tắt ở boundary đã nằm sẵn trong vỏ app (có sidebar). */
+  showHome?: boolean
+  /** Bọc giữa màn hình (dùng cho boundary thay CẢ vỏ app). */
+  fullScreen?: boolean
+}
+
+/**
+ * Màn hình lỗi dùng chung cho mọi `error.tsx`. Có ba việc mà một trang lỗi phải
+ * làm, và trước đây app làm thiếu:
+ *
+ * 1. **Nói mã lỗi cho người dùng đọc được.** `error.digest` là thứ DUY NHẤT nối
+ *    được màn hình của khách với dòng log trong `error_logs` — không hiện ra thì
+ *    báo lỗi cho quản trị viên chỉ còn "trang bị lỗi".
+ * 2. **Cho lối thoát.** `reset()` dựng lại segment; nếu vẫn hỏng thì còn "Tải
+ *    lại trang" và "Về trang chủ" — chứ không phải ngõ cụt như trang trắng.
+ * 3. **Ghi lại lỗi CHỈ Ở PHÍA CLIENT.** Lỗi ném từ server đã có `digest` và đã
+ *    được `onRequestError` (instrumentation.ts) ghi kèm stack thật; ở client
+ *    `error.message` bị Next thay bằng câu chung chung nên ghi thêm chỉ đẻ rác.
+ *    Vì vậy chỉ POST khi KHÔNG có digest — đó mới là lỗi runtime trình duyệt,
+ *    khoảng trống mà server không thấy.
+ */
+export function ErrorView({
+  error,
+  reset,
+  title = "Đã xảy ra lỗi",
+  description = "Hệ thống gặp sự cố khi hiển thị nội dung này. Đây là lỗi kỹ thuật tạm thời — dữ liệu và quyền truy cập của bạn không thay đổi. Vui lòng thử lại; nếu vẫn lỗi, gửi mã lỗi bên dưới cho quản trị viên.",
+  showHome = true,
+  fullScreen = false,
+}: ErrorViewProps) {
+  const [copied, setCopied] = useState(false)
+
+  useEffect(() => {
+    console.error("[ErrorView] Trang gặp lỗi", error, { digest: error.digest })
+
+    if (error.digest) return
+    // Fire-and-forget: ghi log KHÔNG bao giờ được làm hỏng thêm trang lỗi.
+    void fetch("/api/error-logs", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        message: error.message || "Lỗi client không rõ nguyên nhân",
+        detail: error.stack,
+        context: "ErrorView",
+        url: window.location.href,
+        severity: "error",
+      }),
+    }).catch(() => {})
+  }, [error])
+
+  const handleCopy = async () => {
+    try {
+      await navigator.clipboard.writeText(error.digest ?? error.message)
+      setCopied(true)
+      setTimeout(() => setCopied(false), 2000)
+    } catch {
+      // Trình duyệt chặn clipboard (http, quyền) — người dùng vẫn đọc/chép tay được.
+    }
+  }
+
+  const card = (
+    <Card className="w-full max-w-lg">
+      <CardHeader>
+        <CardTitle className="flex items-center gap-2 text-destructive">
+          <AlertTriangle className="h-5 w-5 shrink-0" />
+          {title}
+        </CardTitle>
+      </CardHeader>
+      <CardContent className="space-y-4">
+        <p className="text-sm text-muted-foreground">{description}</p>
+
+        {error.digest ? (
+          <div className="flex items-center gap-2 rounded-md border border-border bg-muted/40 px-3 py-2">
+            <span className="text-xs text-muted-foreground">Mã lỗi</span>
+            <code className="flex-1 truncate font-mono text-xs text-foreground">
+              {error.digest}
+            </code>
+            <Button
+              variant="ghost"
+              size="icon"
+              className="h-7 w-7 shrink-0"
+              onClick={handleCopy}
+              title="Sao chép mã lỗi"
+            >
+              {copied ? (
+                <Check className="h-3.5 w-3.5 text-emerald-600" />
+              ) : (
+                <Copy className="h-3.5 w-3.5" />
+              )}
+            </Button>
+          </div>
+        ) : null}
+
+        {/* Chi tiết kỹ thuật chỉ mở ở máy dev. Trên production Next đã thay
+            `message` bằng câu chung chung nên hiện ra cũng không giúp gì, mà
+            còn dễ lộ đường dẫn nội bộ. */}
+        {process.env.NODE_ENV === "development" && error.stack ? (
+          <details className="rounded-md border border-border bg-muted/40 p-3">
+            <summary className="cursor-pointer text-xs font-medium text-muted-foreground">
+              Chi tiết kỹ thuật (chỉ hiện khi chạy dev)
+            </summary>
+            <pre className="mt-2 max-h-64 overflow-auto whitespace-pre-wrap break-all text-[11px] leading-relaxed text-muted-foreground">
+              {error.stack}
+            </pre>
+          </details>
+        ) : null}
+
+        <div className="flex flex-wrap gap-2">
+          {reset ? (
+            <Button onClick={reset}>
+              <RefreshCw className="mr-2 h-4 w-4" />
+              Thử lại
+            </Button>
+          ) : null}
+          <Button variant="outline" onClick={() => window.location.reload()}>
+            Tải lại trang
+          </Button>
+          {showHome ? (
+            <Button variant="ghost" asChild>
+              <Link href="/">
+                <Home className="mr-2 h-4 w-4" />
+                Về trang chủ
+              </Link>
+            </Button>
+          ) : null}
+        </div>
+      </CardContent>
+    </Card>
+  )
+
+  if (!fullScreen) {
+    return (
+      <div className="flex min-h-0 flex-1 items-center justify-center p-4">
+        {card}
+      </div>
+    )
+  }
+
+  return (
+    <div className="flex min-h-screen items-center justify-center bg-background p-4">
+      {card}
+    </div>
+  )
+}

package/src/ui/errors/index.ts

@@ -0,0 +1,2 @@
+export { NotFoundView } from "./not-found-view";
+export { ErrorView } from "./error-view";

package/src/ui/errors/not-found-view.tsx

@@ -0,0 +1,44 @@
+"use client"
+import Link from "next/link"
+import { Button } from "../index"
+import { FileQuestion } from "lucide-react"
+
+import { cn } from "../../utils"
+
+/**
+ * Màn "không tìm thấy" cho `not-found.tsx`. Tách khỏi `NotFoundPage` của core vì
+ * bản core là tiếng Anh, `min-h-screen` (tràn khi nằm trong vỏ app có sidebar)
+ * và phụ thuộc một file SVG minh hoạ.
+ *
+ * Đây là màn cho `notFound()` gọi TỪ TRONG trang — chứng từ bị xoá, id sai, hết
+ * quyền xem. Khác với URL gõ sai: cái đó do `[lang]/[...not-found]/page.tsx` lo.
+ */
+export function NotFoundView({
+  title = "Không tìm thấy nội dung",
+  description = "Bản ghi bạn mở không còn tồn tại, đã bị xoá, hoặc đường dẫn không đúng.",
+  homeHref = "/",
+  fullScreen = false,
+}: {
+  title?: string
+  description?: string
+  homeHref?: string
+  fullScreen?: boolean
+}) {
+  return (
+    <div
+      className={cn(
+        "flex flex-col items-center justify-center gap-4 p-8 text-center",
+        fullScreen ? "min-h-screen bg-background" : "min-h-0 flex-1"
+      )}
+    >
+      <FileQuestion className="h-12 w-12 text-muted-foreground" />
+      <div className="space-y-1">
+        <h1 className="text-xl font-bold">{title}</h1>
+        <p className="max-w-md text-sm text-muted-foreground">{description}</p>
+      </div>
+      <Button asChild>
+        <Link href={homeHref}>Về trang chủ</Link>
+      </Button>
+    </div>
+  )
+}

package/src/ui/index.tsx

@@ -10,6 +10,7 @@ export * from "./primitives/client";
 export * from "./forms";
 export * from "./data-display";
 export * from "./feedback";
+export * from "./errors";
 export * from "./filters";
 export * from "./layout";
 export * from "./auth";

package/src/ui/layout/logo.tsx

@@ -7,10 +7,37 @@ import { cn } from "../../utils";
 
 // Defaults used when neither props nor a TenantProvider supply branding — keeps
 // the component working out of the box (and backward compatible).
-const DEFAULT_LOGO_SRC = "/images/logos/goeat_logo.png";
 const DEFAULT_COMPANY = "GoERP";
 const DEFAULT_TAGLINE = "ERP System";
 
+/**
+ * KHÔNG có logo cấu hình → monogram chữ cái đầu, KHÔNG trỏ vào một file magic
+ * trong public/. Bản cũ default "/images/logos/goeat_logo.png" (di sản goeat)
+ * làm mọi app mới init 400 ảnh trên từng trang vì template không ship file đó.
+ */
+function Monogram({
+  name,
+  size,
+  className,
+}: {
+  name: string;
+  size: number;
+  className?: string;
+}) {
+  return (
+    <span
+      aria-hidden
+      className={cn(
+        "flex shrink-0 items-center justify-center rounded-md bg-primary font-bold text-primary-foreground",
+        className,
+      )}
+      style={{ width: size, height: size, fontSize: Math.round(size * 0.5) }}
+    >
+      {(name.trim()[0] ?? "G").toUpperCase()}
+    </span>
+  );
+}
+
 interface LogoProps {
   className?: string;
   size?: "sm" | "md" | "lg" | "xl" | "2xl";
@@ -40,21 +67,25 @@ export function Logo({
   tagline,
 }: LogoProps) {
   const branding = useOptionalTenant()?.branding;
-  const src = logoSrc ?? branding?.logo ?? DEFAULT_LOGO_SRC;
+  const src = logoSrc ?? branding?.logo;
   const name = companyName ?? branding?.companyName ?? DEFAULT_COMPANY;
   const sub = tagline ?? branding?.tagline ?? DEFAULT_TAGLINE;
   const dimensions = sizeMap[size];
 
   return (
     <div className={cn("flex items-center gap-2", className)}>
-      <Image
-        src={src}
-        alt={`${name} Logo`}
-        width={dimensions.width}
-        height={dimensions.height}
-        className="object-contain"
-        priority
-      />
+      {src ? (
+        <Image
+          src={src}
+          alt={`${name} Logo`}
+          width={dimensions.width}
+          height={dimensions.height}
+          className="object-contain"
+          priority
+        />
+      ) : (
+        <Monogram name={name} size={dimensions.height} />
+      )}
       {showText && !collapsed && (
         <div className="flex flex-col leading-none">
           <span className="text-base font-bold text-foreground">{name}</span>
@@ -77,19 +108,23 @@ export function LogoCompact({
   companyName?: string;
 }) {
   const branding = useOptionalTenant()?.branding;
-  const src = logoSrc ?? branding?.logo ?? DEFAULT_LOGO_SRC;
+  const src = logoSrc ?? branding?.logo;
   const name = companyName ?? branding?.companyName ?? DEFAULT_COMPANY;
 
   return (
     <div className={cn("flex items-center justify-center", className)}>
-      <Image
-        src={src}
-        alt={name}
-        width={32}
-        height={32}
-        className="object-contain"
-        priority
-      />
+      {src ? (
+        <Image
+          src={src}
+          alt={name}
+          width={32}
+          height={32}
+          className="object-contain"
+          priority
+        />
+      ) : (
+        <Monogram name={name} size={32} />
+      )}
     </div>
   );
 }

package/src/user/pages/users-client-page.tsx

@@ -212,7 +212,7 @@ export function UsersClientPage({
   };
 
   return (
-    <div className="flex flex-col gap-4 relative">
+    <div className="flex h-full flex-col gap-4 relative">
       <UserStats stats={stats} />
 
       <UserToolbar
@@ -227,7 +227,10 @@ export function UsersClientPage({
         permissions={permissions}
       />
 
-      <div className="min-h-[400px] flex flex-col">
+      {/* flex-1 + min-h-0: khu nội dung chiếm hết chiều cao còn lại (cùng
+          chuỗi flex với crud-page) để thanh phân trang nằm SÁT ĐÁY, không
+          lửng giữa trang khi ít dữ liệu. */}
+      <div className="flex flex-1 min-h-0 flex-col">
         {viewMode === "table" ? (
           <UsersTable
             data={pageData}
@@ -240,11 +243,13 @@ export function UsersClientPage({
           />
         ) : (
           <>
-            <UsersCardView
-              data={pageData}
-              onSelect={handleSelectUser}
-              onViewPermissions={menuTree ? setPermUser : undefined}
-            />
+            <div className="flex-1 min-h-0 overflow-auto">
+              <UsersCardView
+                data={pageData}
+                onSelect={handleSelectUser}
+                onViewPermissions={menuTree ? setPermUser : undefined}
+              />
+            </div>
             {/* Cùng thanh phân trang với chế độ bảng (bảng tự vẽ trong khung
                 DataTable) — card view vẽ dưới lưới, giống trang khách hàng. */}
             {total > 0 && (

package/templates/starter-app/.env.example

@@ -23,3 +23,7 @@ BETTER_AUTH_URL="http://localhost:3010"
 # clone; bỏ đi khi đã seed tài khoản thật. Đặt trên production cũng vô hiệu —
 # cả app lẫn core đều chặn cứng khi NODE_ENV=production.
 # BYPASS_AUTH=1
+
+# `pnpm migration:new` tự tạo/xoá DB shadow cạnh DB chính. Tài khoản DB không
+# có quyền CREATE DATABASE thì tạo sẵn một DB trống rồi trỏ vào đây.
+# SHADOW_DATABASE_URL="postgresql://user:password@localhost:5432/starter_app_shadow"

package/templates/starter-app/README.md

@@ -96,10 +96,13 @@ Xong. Không viết route, không viết engine.
 ## Lấy thêm tính năng từ core
 
 ```bash
-pnpm goerp-features list          # các feature core có sẵn
-pnpm goerp-features add <name>    # chép schema + migration vào app
+pnpm goerp-features status              # feature nào đã materialize, feature nào chưa
+pnpm goerp-features sync                # chép schema fragment + migration của MỌI feature vào app
+pnpm goerp-features sync --only <name>  # chỉ một feature
 ```
 
+Sau `sync`: `pnpm prisma:deploy && pnpm prisma:generate`.
+
 Feature đã cắm sẵn trong template: `audit-logs`, `background-tasks`,
 `error-logs`, `notifications`, `system-jobs`.
 
@@ -114,6 +117,7 @@ Feature đã cắm sẵn trong template: `audit-logs`, `background-tasks`,
 | `pnpm test` | Ratchet kiến trúc. Chạy trước mỗi lần commit. |
 | `pnpm rbac-sync` | Đồng bộ Permission Registry → DB (idempotent, chạy lại vô hại). |
 | `pnpm prisma:deploy` | Áp migration đang chờ. **Cách duy nhất** đụng vào DB có dữ liệu thật. |
+| `pnpm migration:new <ten>` | Sinh migration mới từ diff schema (shadow DB tự tạo/xoá — Prisma 7 đã bỏ `--shadow-database-url`). |
 | `pnpm seed` | Vai trò + tài khoản admin + dữ liệu mẫu. Chạy TRƯỚC `rbac-sync`. |
 
 ---

package/templates/starter-app/husky/pre-commit

@@ -0,0 +1,10 @@
+echo "🔍 Type check..."
+pnpm exec tsc --noEmit
+
+# Ratchet kiến trúc (~1s). Bài học vinhhoa: guardrail chỉ chạy khi ai đó nhớ gõ
+# `pnpm test` thì âm thầm đỏ nhiều tuần — móc vào pre-commit để không ai quên.
+echo "🧱 Architecture guardrails..."
+pnpm exec vitest run src/__tests__/architecture.test.ts
+
+echo "💅 Lint staged..."
+pnpm exec lint-staged

package/templates/starter-app/package.json

@@ -17,20 +17,26 @@
     "rbac-sync": "tsx scripts/rbac-sync.ts",
     "goerp-features": "goerp-features",
     "lint": "eslint .",
-    "guardrails": "goerp-guardrails"
+    "guardrails": "goerp-guardrails",
+    "migration:new": "node scripts/migration-new.mjs",
+    "prepare": "husky || true"
   },
   "dependencies": {
-    "@goerp/core": "npm:@goplusvn/core@^0.1.59",
+    "@goerp/core": "npm:@goplusvn/core@^0.1.71",
+    "@hookform/resolvers": "3.9.0",
     "@prisma/adapter-pg": "^7.0.0",
     "@prisma/client": "^7.0.0",
     "bcryptjs": "^3.0.3",
     "better-auth": "1.6.23",
+    "date-fns": "^4.1.0",
+    "date-fns-tz": "^3.2.0",
     "lucide-react": "0.446.0",
     "next": "16.0.10",
     "next-themes": "^0.2.1",
     "pg": "^8.16.3",
     "react": "19.2.0",
     "react-dom": "19.2.0",
+    "react-hook-form": "^7.54.2",
     "server-only": "^0.0.1",
     "sonner": "2.0.2",
     "swr": "^2.3.6",
@@ -59,7 +65,9 @@
     "eslint-plugin-prettier": "5.2.3",
     "eslint-plugin-react-hooks": "^7.0.1",
     "globals": "16.5.0",
+    "husky": "^9.1.7",
     "jsdom": "^27.4.0",
+    "lint-staged": "^17.3.0",
     "prettier": "3.5.3",
     "prettier-plugin-tailwindcss": "0.6.11",
     "prisma": "^7.0.0",
@@ -68,5 +76,22 @@
     "tw-animate-css": "1.2.5",
     "typescript": "5.8.3",
     "vitest": "^4.0.16"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "@prisma/engines",
+      "esbuild",
+      "prisma",
+      "sharp"
+    ]
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,md,css}": [
+      "prettier --write"
+    ]
   }
 }

package/templates/starter-app/prisma/schema/organization.prisma

@@ -29,3 +29,23 @@ model UserBranch {
   @@index([userId])
   @@map("user_branches")
 }
+
+// Chức danh trong tổ chức — entity CRUD generic (/crud/job-titles). Chép từ
+// app chuẩn, BỎ relation profiles (template không có model Profile).
+model JobTitle {
+  id          String   @id @map("id")
+  code        String   @unique @map("code")
+  name        String   @map("name")
+  description String?  @map("description")
+  level       Int      @default(0) @map("level")
+  status      String   @default("active") @map("status")
+  createdAt   DateTime @default(now()) @map("created_at")
+  updatedAt   DateTime @updatedAt @map("updated_at")
+  createdBy   String?  @map("created_by")
+  updatedBy   String?  @map("updated_by")
+
+  @@index([code])
+  @@index([status])
+  @@index([level])
+  @@map("job_titles")
+}

package/templates/starter-app/prisma/schema/system.prisma

@@ -20,3 +20,77 @@ model SystemConfig {
 
   @@map("system_configs")
 }
+
+// Danh mục hệ thống: cặp bảng nhóm → mục, phục vụ trang /system-categories
+// (SystemCategoryPage của @goerp/core). Định nghĩa chép nguyên từ app chuẩn —
+// GIỮ tên bảng/cột để dữ liệu port qua lại được.
+model SystemCategory {
+  id          String   @id @map("id")
+  code        String   @unique @map("code")
+  name        String   @map("name")
+  groupCode   String   @map("group_code")
+  description String   @map("description")
+  status      String   @default("active") @map("status")
+  order       Int?     @map("order")
+  createdAt   DateTime @default(now()) @map("created_at")
+  createdBy   String   @map("created_by")
+  updatedAt   DateTime @map("updated_at")
+  updatedBy   String   @map("updated_by")
+
+  @@map("system_categories")
+}
+
+model SystemCategoryGroup {
+  id          String   @id @map("id")
+  code        String   @unique @map("code")
+  name        String   @map("name")
+  description String   @map("description")
+  status      String   @default("active") @map("status")
+  createdAt   DateTime @default(now()) @map("created_at")
+  createdBy   String   @map("created_by")
+  updatedAt   DateTime @map("updated_at")
+  updatedBy   String   @map("updated_by")
+
+  @@map("system_category_groups")
+}
+
+// Cảnh báo/thông báo hệ thống — entity CRUD generic (/crud/system-alerts).
+// App chuẩn KHÔNG có model riêng (map tạm vào system_logs); template khai
+// model thật khớp các field của system-alerts.config.ts.
+model SystemAlert {
+  id        String   @id @default(cuid()) @map("id")
+  title     String   @map("title")
+  message   String   @map("message")
+  type      String   @default("info") @map("type")
+  status    String   @default("pending") @map("status")
+  createdAt DateTime @default(now()) @map("created_at")
+  createdBy String?  @map("created_by")
+  updatedAt DateTime @updatedAt @map("updated_at")
+  updatedBy String?  @map("updated_by")
+
+  @@index([status])
+  @@index([type])
+  @@map("system_alerts")
+}
+
+/// Hồ sơ công ty gốc — MỘT dòng duy nhất, dùng cho biểu mẫu/hoá đơn/branding.
+/// (Đơn giản hoá từ vinhhoa: không quan hệ branches — Branch của template
+/// độc lập; app đa-công-ty tự thêm quan hệ sau.)
+model Company {
+  id         String   @id @default(cuid()) @map("id")
+  name       String   @map("name")
+  taxCode    String   @unique @map("tax_code")
+  address    String   @map("address")
+  phone      String   @map("phone")
+  email      String   @map("email")
+  logoUrl    String?  @map("logo_url")
+  systemName String?  @map("system_name")
+  status     String   @default("active") @map("status")
+  createdAt  DateTime @default(now()) @map("created_at")
+  createdBy  String   @default("system") @map("created_by")
+  updatedAt  DateTime @updatedAt @map("updated_at")
+  updatedBy  String   @default("system") @map("updated_by")
+
+  @@index([status])
+  @@map("companies")
+}

package/templates/starter-app/prisma/seed.ts

@@ -1,14 +1,16 @@
 /**
  * Seed dữ liệu khởi tạo — chạy được nhiều lần (toàn upsert).
  *
- *   pnpm prisma:deploy && pnpm rbac-sync && pnpm seed
+ *   pnpm prisma:deploy && pnpm seed && pnpm rbac-sync
  *
- * Phân công rõ ràng: `rbac-sync` sở hữu resource/action/grant mặc định (đọc từ
+ * THỨ TỰ `seed → rbac-sync` là BẮT BUỘC: rbac-sync chỉ cấp grant mặc định cho
+ * resource nó vừa TẠO MỚI, và grant cần VAI TRÒ (do seed tạo) tồn tại sẵn.
+ * Chạy rbac-sync trước seed thì grant bị bỏ qua VĨNH VIỄN trong im lặng —
+ * lối thoát duy nhất là `pnpm rbac-sync --force-grants`.
+ *
+ * Phân công: `rbac-sync` sở hữu resource/action/grant mặc định (đọc từ
  * Permission Registry); file này chỉ tạo những thứ registry không biết —
  * VAI TRÒ, tài khoản quản trị, chi nhánh, cấu hình và vài dòng dữ liệu mẫu.
- * Vì vậy hãy chạy rbac-sync TRƯỚC seed ở lần đầu... nhưng grant mặc định cần
- * vai trò tồn tại sẵn, nên seed cũng tạo vai trò và bạn chạy rbac-sync lần nữa
- * sau seed. Thứ tự an toàn nhất: seed → rbac-sync.
  */
 
 import { PrismaPg } from "@prisma/adapter-pg"