npm - @goplusvn/core - Versions diffs - 0.1.71 → 0.1.73 - Mend

@goplusvn/core 0.1.71 → 0.1.73

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (150) hide show

package/src/branding/pwa.tsx ADDED Viewed

@@ -0,0 +1,146 @@
+import * as React from "react";
+import type { Metadata, MetadataRoute } from "next";
+import type { BrandingIdentity } from "./types";
+/**
+ * PWA "cài được lên màn hình chính" — mức mặc định cho mọi app dựng từ core.
+ *
+ * Ba mảnh phải khớp nhau, thiếu một là iOS lặng lẽ tạo web clip THƯỜNG (bấm ra
+ * mở Safari, mất thanh trạng thái riêng, mất standalone):
+ * 1. `buildAppManifest` — `/manifest.webmanifest`, icon lấy từ logo công ty.
+ * 2. `buildBrandingMetadata` — `icons` + `appleWebApp` cho Metadata API.
+ * 3. `<PwaMetaTags>` — render CỨNG trong shell, xem ghi chú bên dưới.
+ *
+ * Service worker/offline KHÔNG nằm ở đây: app chạy trong nhà máy sóng yếu thì
+ * tự thêm serwist ở tầng app, đó là quyết định riêng từng dự án.
+ */
+export interface AppManifestOptions {
+  /** Mô tả ngắn. Bỏ trống ⇒ dùng tagline, rồi tới tên app. */
+  description?: string;
+  display?: MetadataRoute.Manifest["display"];
+  orientation?: MetadataRoute.Manifest["orientation"];
+  /** `id` PHẢI ổn định — đổi nó là Android coi như một app KHÁC. */
+  id?: string;
+  scope?: string;
+}
+export function buildAppManifest(
+  identity: BrandingIdentity,
+  options: AppManifestOptions = {},
+): MetadataRoute.Manifest {
+  const { logoPath } = identity;
+  return {
+    id: options.id ?? "/",
+    name: identity.appName,
+    short_name: identity.appName,
+    description: options.description || identity.tagline || identity.appName,
+    // start_url có locale sẵn: "/" bắt mỗi lần mở app đi 2–3 chặng redirect
+    // server, mấy chặng đó không vẽ được gì ngoài màn trắng.
+    start_url: identity.startUrl,
+    // Mặc định scope là THƯ MỤC của start_url — khai tường minh, nếu không
+    // start_url "/vi/home" sẽ khoá app trong "/vi/".
+    scope: options.scope ?? "/",
+    display: options.display ?? "standalone",
+    orientation: options.orientation,
+    background_color: identity.backgroundColor,
+    theme_color: identity.themeColor,
+    icons: [
+      {
+        src: `${logoPath}?variant=icon`,
+        sizes: "512x512",
+        type: "image/png",
+        purpose: "any",
+      },
+      {
+        src: `${logoPath}?variant=maskable`,
+        sizes: "512x512",
+        type: "image/png",
+        purpose: "maskable",
+      },
+    ],
+  };
+}
+/**
+ * Phần `Metadata` phụ thuộc thương hiệu — trải vào `generateMetadata` của root
+ * layout. Khai `icons` ở đây khiến Next BỎ QUA file `app/icon.png` /
+ * `app/apple-icon.png`; ngược lại, còn hai file đó thì convention file-based
+ * THẮNG và favicon sẽ mãi là logo cũ.
+ */
+export function buildBrandingMetadata(identity: BrandingIdentity): Metadata {
+  const { logoPath, logoUrl } = identity;
+  const version = logoUrl.includes("?v=") ? `&${logoUrl.split("?")[1]}` : "";
+  return {
+    applicationName: identity.appName,
+    manifest: "/manifest.webmanifest",
+    icons: {
+      icon: [
+        { url: `${logoPath}?variant=favicon${version}`, type: "image/png" },
+      ],
+      shortcut: [{ url: `${logoPath}?variant=favicon${version}` }],
+      apple: [
+        {
+          url: `${logoPath}?variant=apple${version}`,
+          sizes: "180x180",
+          type: "image/png",
+        },
+      ],
+    },
+    appleWebApp: {
+      capable: true,
+      title: identity.appName,
+      statusBarStyle: "default",
+    },
+    openGraph: {
+      siteName: identity.appName,
+      images: [{ url: `${logoPath}?variant=og${version}`, width: 1200, height: 630 }],
+    },
+  };
+}
+/**
+ * Thẻ PWA render CỨNG trong shell (đặt ngay đầu `<body>` của root layout).
+ *
+ * Vì sao không trông vào Metadata API: từ khi layout stream qua `<Suspense>`,
+ * Next đẩy output của `generateMetadata` (phải chờ DB) xuống SAU vài chục KB
+ * đầu tiên của body. Safari lúc "Thêm vào MH chính" đọc `<head>` ở khoảnh khắc
+ * đó chưa thấy `<link rel="manifest">` nên tạo web clip thường. React hoist các
+ * thẻ này lên `<head>` ngay từ flush đầu.
+ *
+ * Next 16 cũng KHÔNG còn phát `apple-mobile-web-app-capable` từ
+ * `appleWebApp.capable` (chỉ phát bản `mobile-web-app-capable`) — thẻ apple-*
+ * chỉ tồn tại nhờ component này. Trùng thẻ với Metadata API là vô hại: thẻ đầu
+ * theo tree order thắng.
+ */
+export function PwaMetaTags({
+  manifestHref = "/manifest.webmanifest",
+  logoPath = "/api/branding/logo",
+  appName,
+  themeColor,
+}: {
+  manifestHref?: string;
+  logoPath?: string;
+  /** Tên trên biểu tượng iOS. Bỏ trống ⇒ để Metadata API lo. */
+  appName?: string;
+  themeColor?: string;
+}) {
+  // Không nhận `BrandingIdentity`: dựng identity phải chờ DB, mà root layout
+  // `await` là màn hình TRẮNG cho tới khi DB trả lời. Các thẻ ở đây cố ý là
+  // hằng số thuần.
+  return (
+    <>
+      <link rel="manifest" href={manifestHref} />
+      <meta name="apple-mobile-web-app-capable" content="yes" />
+      <meta name="mobile-web-app-capable" content="yes" />
+      {appName ? (
+        <meta name="apple-mobile-web-app-title" content={appName} />
+      ) : null}
+      {themeColor ? <meta name="theme-color" content={themeColor} /> : null}
+      <link rel="apple-touch-icon" href={`${logoPath}?variant=apple`} />
+    </>
+  );
+}

package/src/branding/types.ts ADDED Viewed

@@ -0,0 +1,45 @@
+/**
+ * Hồ sơ công ty ở mức core CẦN BIẾT — cố ý hẹp.
+ *
+ * Mỗi app có schema `companies` hơi khác nhau (vinhhoa/spartronics dùng cột
+ * `logo_url`, thingtodo dùng `logo`), nên core nhận cả hai tên và không đụng
+ * tới phần còn lại của bản ghi.
+ */
+export interface BrandingCompany {
+  /** Tên pháp lý — in trên hợp đồng/hoá đơn. */
+  name?: string | null;
+  /** Tên hiển thị trên app/PWA. Rỗng ⇒ rơi về `name`, rồi tới tenant. */
+  systemName?: string | null;
+  /** URL logo đã lưu: `/api/files/<key>`, `/uploads/...` hoặc http(s). */
+  logoUrl?: string | null;
+  /** Bí danh của `logoUrl` cho app đặt tên cột là `logo`. */
+  logo?: string | null;
+  /** Dùng làm `?v=` phá cache của URL logo. */
+  updatedAt?: Date | string | null;
+}
+/** Bản sắc thương hiệu đã hoà giải (DB đè lên tenant config tĩnh). */
+export interface BrandingIdentity {
+  /** Tên ngắn hiển thị sidebar/PWA. */
+  appName: string;
+  /** Tên pháp lý đầy đủ. */
+  companyName: string;
+  /** Dòng phụ dưới tên ở sidebar/đăng nhập. `""` = ẩn. */
+  tagline: string;
+  /** URL logo dùng chung cho MỌI bề mặt, đã kèm `?v=`. */
+  logoUrl: string;
+  /** Đường dẫn gốc của route logo (mặc định `/api/branding/logo`). */
+  logoPath: string;
+  themeColor: string;
+  backgroundColor: string;
+  /** `start_url` của manifest — PHẢI là đường đã có locale. */
+  startUrl: string;
+}
+/** Các biến thể kích thước mà route logo tự render. */
+export type BrandingLogoVariant =
+  | "favicon"
+  | "apple"
+  | "icon"
+  | "maskable"
+  | "og";

package/src/configs/entities/departments.config.ts CHANGED Viewed

@@ -17,6 +17,7 @@ export const departmentsConfig: EntityConfig = {
   icon: Building2,
   description: "Quản lý cơ cấu tổ chức phòng ban",
   apiEndpoint: "/api/departments",
+  modelName: "department",
   idField: "id",
   displayField: "name",

package/src/configs/entities/material-categories.config.ts CHANGED Viewed

@@ -11,6 +11,7 @@ export const materialCategoriesConfig: EntityConfig = {
   icon: FolderTree,
   description: "Quản lý danh mục nguyên vật liệu",
   apiEndpoint: "/api/material-categories",
+  modelName: "materialCategory",
   idField: "id",
   displayField: "name",

package/src/crud/components/crud-export-button.tsx CHANGED Viewed

@@ -53,8 +53,9 @@ export function CrudExportButton({
         search: activeSearch,
       });
-      // Always force format to xlsx
-      const url = `${endpoint}?${queryParams}&format=xlsx`;
+      // Always force format to xlsx. Endpoint từ getEntityEndpoints có thể đã
+      // mang sẵn query params — nối bằng "&" thay vì "?" thứ hai.
+      const url = `${endpoint}${endpoint.includes("?") ? "&" : "?"}${queryParams}&format=xlsx`;
       const response = await fetch(url);
       if (!response.ok) {

package/src/crud/components/crud-page.tsx CHANGED Viewed

@@ -32,6 +32,7 @@ import { useRouter, useParams } from "next/navigation";
 import { CrudBulkActions } from "./crud-bulk-actions";
 import { CrudDeleteDialog } from "./crud-delete-dialog";
 import { crudService } from "../lib/crud-service";
+import { getEntityEndpoints } from "../lib/entity-endpoints";
 import { usePrefetch } from "../../hooks";
 import type { DictionaryType } from "../../hooks";
@@ -618,31 +619,65 @@ function CrudPageContent({
         }
         default: {
-          // Custom handler: Get original config to access handler function
-          // NOTE: This logic is deprecated because Core package cannot import App configs directly.
-          // Custom handlers passed via config functions are lost during serialization.
-          // If you need custom actions with handlers, please implement them via `customActions` prop
-          // or a registered event handler mechanism.
+          // Action HTTP thuần data (urlTemplate + method) — sống sót qua
+          // serializeConfig nên khai được ngay trong entity config phía server.
+          if (rowAction.urlTemplate) {
+            // Fail-closed: khai permissionAction mà user không có quyền thì thôi
+            // (menu đã ẩn, đây là chốt chặn thứ hai).
+            if (
+              rowAction.permissionAction &&
+              !permissions[rowAction.permissionAction]
+            ) {
+              return;
+            }
+            if (
+              rowAction.confirmMessage &&
+              !window.confirm(rowAction.confirmMessage)
+            ) {
+              return;
+            }
+            const url = rowAction.urlTemplate.replace(
+              /\{id\}/g,
+              encodeURIComponent(rowId),
+            );
+            const response = await fetch(url, {
+              method: rowAction.method ?? "POST",
+            });
+            if (!response.ok) {
+              let message = `${response.status} ${response.statusText}`;
+              try {
+                const body = await response.json();
+                message = body.error || body.message || message;
+              } catch {
+                // body không phải JSON — giữ status text
+              }
+              throw new Error(message);
+            }
+            await fetchData(false);
+            toast.success(t("success", "Success"), {
+              description:
+                rowAction.successMessage ??
+                tMessage("updated", { entity: config.label }),
+            });
+            break;
+          }
+          // Custom handler qua config function bị serializeConfig strip —
+          // action không có urlTemplate thì phải đi qua customActions prop.
           console.warn(
-            `Action "${action}" has no built-in handler and custom handlers via config are not supported in this architecture. Please use customActions prop.`,
+            `Action "${action}" has no built-in handler and custom handlers via config are not supported in this architecture. Please use customActions prop or declare urlTemplate.`,
           );
-          /* Deprecated logic removed to fix build:
-          if (entityName) {
-            try {
-              const originalConfig = getEntityConfig(entityName)
-               ...
-            }
-          }
-          */
         }
       }
     } catch (error) {
       console.error(`Error executing ${action} action:`, error);
       globalError.emit({
         title: t("error", "Error"),
-        description: tMessage("saveFailed", { entity: rowAction.label }),
+        // Ưu tiên message từ API (đọc từ body JSON) — fallback câu chung.
+        description:
+          error instanceof Error && error.message
+            ? error.message
+            : tMessage("saveFailed", { entity: rowAction.label }),
         trace: error instanceof Error ? error.stack : undefined,
       });
     }
@@ -858,18 +893,14 @@ function CrudPageContent({
                     className="h-6 hidden sm:block"
                   />
                   <div className="flex items-center gap-2 flex-wrap sm:flex-nowrap">
+                    {/* Import/Export dùng CÙNG quy tắc endpoint từ config
+                        (getEntityEndpoints) — trước đây export hardcode
+                        /api/crud/... lệch với import → 404. */}
                     {permissions.import && config.features?.import && (
                       <Suspense fallback={null}>
                         <ImportDialog
                           config={config}
-                          apiUrl={(() => {
-                            // Handle endpoint with query params correctly
-                            const baseUrl = config.apiEndpoint.split("?")[0];
-                            const queryParams = config.apiEndpoint.includes("?")
-                              ? config.apiEndpoint.split("?")[1]
-                              : "";
-                            return `${baseUrl}/import${queryParams ? `?${queryParams}` : ""}`;
-                          })()}
+                          apiUrl={getEntityEndpoints(config).import}
                           canImport={permissions.import}
                         />
                       </Suspense>
@@ -877,7 +908,7 @@ function CrudPageContent({
                     {permissions.export && config.features?.export && (
                       <Suspense fallback={null}>
                         <CrudExportButton
-                          endpoint={`/api/crud/${entityName || config.name}/export`}
+                          endpoint={getEntityEndpoints(config).export}
                           filters={filters}
                           search={search}
                           canExport={permissions.export}

package/src/crud/components/crud-row-actions.tsx CHANGED Viewed

@@ -4,8 +4,11 @@ import {
   Archive,
   Copy,
   Eye,
+  History,
   MoreHorizontal,
   Pencil,
+  Pin,
+  SquareArrowOutUpRight,
   Trash2,
   CheckCircle2,
   XCircle,
@@ -81,8 +84,15 @@ export function CrudRowActions({
         return <CheckCircle2 className="mr-2 h-4 w-4" aria-hidden="true" />;
       case "reject":
         return <XCircle className="mr-2 h-4 w-4" aria-hidden="true" />;
+      case "set-default":
+        return <Pin className="mr-2 h-4 w-4" aria-hidden="true" />;
+      case "view-history":
+        return <History className="mr-2 h-4 w-4" aria-hidden="true" />;
       default:
-        return null;
+        // Action tự khai không có icon riêng — icon fallback trung tính.
+        return (
+          <SquareArrowOutUpRight className="mr-2 h-4 w-4" aria-hidden="true" />
+        );
     }
   };
@@ -139,9 +149,11 @@ export function CrudRowActions({
                 }
               };
-              // Check if user has permission for this custom action
-              const hasActionPermission =
-                action.action === "approve"
+              // Gate theo permissionAction khai trong config; không khai thì
+              // giữ special-case approve/reject cũ, còn lại luôn hiện.
+              const hasActionPermission = action.permissionAction
+                ? Boolean(permissions[action.permissionAction])
+                : action.action === "approve"
                   ? permissions.approve
                   : action.action === "reject"
                     ? permissions.reject