@goplusvn/core 0.1.69 → 0.1.71

package/templates/starter-app/src/data/dictionary.ts

@@ -1,8 +1,80 @@
 import type { DictionaryType } from "@goerp/core/hooks"
 
 /**
- * i18n dictionary for the shell. The sidebar falls back to the raw nav title
- * when a key is missing, so an empty object works to start. Grow it into
- * `{ navigation: { ... }, label: { ... } }` as you localize.
+ * i18n dictionary của shell + CRUD engine.
+ *
+ * Block `crud` là BẮT BUỘC có: engine CRUD của core tra nhãn qua các key
+ * `crud.common.*` / `crud.messages.*` — thiếu thì UI hiện nguyên raw key
+ * (vd chip trạng thái hiện "crud.common.options.active" thay vì "Hoạt động").
+ * Sidebar thì fall back về title trong navigations nên `navigation` để trống
+ * được; localize dần bằng cách thêm `{ navigation: {...}, label: {...} }`.
  */
-export const dictionary: DictionaryType = {}
+export const dictionary: DictionaryType = {
+  crud: {
+    common: {
+      create: "Tạo",
+      edit: "Sửa",
+      delete: "Xóa",
+      save: "Lưu",
+      saving: "Đang lưu...",
+      cancel: "Hủy",
+      submit: "Gửi",
+      update: "Cập nhật",
+      search: "Tìm kiếm...",
+      filter: "Lọc",
+      filters: "Bộ lọc",
+      export: "Xuất",
+      import: "Nhập",
+      reset: "Đặt lại",
+      clear: "Xóa",
+      clearAll: "Xóa tất cả",
+      actions: "Hành động",
+      noData: "Không có dữ liệu",
+      loading: "Đang tải...",
+      success: "Thành công",
+      error: "Lỗi",
+      confirm: "Xác nhận",
+      close: "Đóng",
+      detail: "Chi tiết",
+      selectAll: "Chọn tất cả",
+      selected: "đã chọn",
+      item: "mục",
+      items: "mục",
+      add: "Thêm",
+      creating: "Đang tạo...",
+      updating: "Đang cập nhật...",
+      deleting: "Đang xóa...",
+      savedSuccessfully: "Đã lưu thành công!",
+      createdSuccessfully: "Đã tạo thành công!",
+      updatedSuccessfully: "Đã cập nhật thành công!",
+      deleteSelected: "Xóa đã chọn",
+      addNew: "Thêm mới",
+      confirmDeleteTitle: "Xóa {{entity}}?",
+      confirmBulkDeleteTitle: "Xóa {{count}} {{entities}}?",
+      confirmDeleteDescription:
+        'Bạn có chắc chắn muốn xóa "{{name}}"? Hành động này không thể hoàn tác.',
+      confirmBulkDeleteDescription:
+        "Bạn có chắc chắn muốn xóa {{count}} {{entities}}? Hành động này không thể hoàn tác.",
+      cannotBeUndone: "Hành động này không thể hoàn tác.",
+      options: {
+        active: "Hoạt động",
+        inactive: "Tạm ngưng",
+      },
+    },
+    messages: {
+      created: "{{entity}} đã được tạo thành công",
+      updated: "{{entity}} đã được cập nhật thành công",
+      deleted: "{{entity}} đã được xóa thành công",
+      bulkDeleted: "{{count}} {{entities}} đã được xóa thành công",
+      deleteConfirm: "Bạn có chắc chắn muốn xóa {{entity}} này không?",
+      bulkDeleteConfirm: "Bạn có chắc chắn muốn xóa {{count}} {{entities}} không?",
+      deleteFailed: "Không thể xóa {{entity}}",
+      saveFailed: "Không thể lưu {{entity}}",
+      loadFailed: "Không thể tải dữ liệu. Vui lòng thử lại.",
+      exportSuccess: 'File "{{filename}}" đã được tải xuống thành công',
+      exportFailed: "Xuất dữ liệu thất bại. Vui lòng thử lại.",
+      importSuccess: "{{count}} {{entities}} đã được nhập thành công",
+      importFailed: "Nhập dữ liệu thất bại. Vui lòng thử lại.",
+    },
+  },
+}

package/templates/starter-app/src/data/navigations.ts

@@ -25,19 +25,68 @@ export const navigations: NavigationType[] = [
         href: "/crud/departments",
         resource: "department",
       },
+      {
+        title: "Chức danh",
+        iconName: "Briefcase",
+        href: "/crud/job-titles",
+        resource: "job-title",
+      },
     ],
   },
   {
     title: "Hệ thống",
     iconName: "ShieldCheck",
     items: [
+      { title: "Người dùng", iconName: "Users", href: "/users", resource: "user" },
+      {
+        title: "Phiên đăng nhập",
+        iconName: "KeyRound",
+        href: "/security/sessions",
+        resource: "user",
+      },
       { title: "Vai trò", iconName: "ShieldCheck", href: "/roles", resource: "role" },
+      {
+        title: "Tài nguyên",
+        iconName: "Boxes",
+        href: "/resources",
+        resource: "resource",
+      },
+      {
+        title: "Hành động",
+        iconName: "MousePointerClick",
+        href: "/actions",
+        resource: "action",
+      },
+      {
+        title: "Hồ sơ công ty",
+        iconName: "Building",
+        href: "/admin/system/company",
+        resource: "system-setting",
+      },
       {
         title: "Cấu hình",
         iconName: "Settings2",
         href: "/admin/system/settings",
         resource: "system-setting",
       },
+      {
+        title: "Danh mục hệ thống",
+        iconName: "FolderTree",
+        href: "/system-categories",
+        resource: "system-category",
+      },
+      {
+        title: "Cảnh báo hệ thống",
+        iconName: "Bell",
+        href: "/crud/system-alerts",
+        resource: "system-alert",
+      },
+      {
+        title: "Bộ nhớ đệm",
+        iconName: "Database",
+        href: "/admin/system/cache",
+        resource: "system-cache",
+      },
       {
         title: "Nhật ký hoạt động",
         iconName: "Scroll",

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

@@ -42,23 +42,12 @@ export async function register() {
 }
 
 /**
- * BẪY lịch chạy: bộ hẹn giờ của core quy cron về `setInterval` TỪ LÚC BOOT —
- * "0 1 * * *" thành "cứ 24 giờ kể từ khi khởi động", không phải "1 giờ sáng".
- * Container deploy vài lần một ngày thì job hằng ngày gần như không bao giờ
- * chạy đúng giờ mong muốn.
+ * Từ core 0.1.71, biểu thức cron 5 trường chạy ĐÚNG GIỜ ĐỊA PHƯƠNG của tiến
+ * trình ("0 1 * * *" = 1 giờ sáng thật — Dockerfile đã set TZ=Asia/Ho_Chi_Minh)
+ * nên job hằng ngày cứ khai lịch thẳng, KHÔNG cần mẹo gác giờ nữa.
  *
- * Cách chữa: hẹn MỖI GIỜ (`0 * * * *`) rồi tự gác bằng hàm này. Mỗi giờ đồng
- * hồ chỉ có đúng một tick nên không chạy trùng.
- *
- *   cronManager.addJob({
- *     name: "daily-report",
- *     cronTime: "0 * * * *",
- *     start: true,
- *     onTick: async () => {
- *       if (!isLocalHour(1)) return
- *       await sendDailyReport()
- *     },
- *   })
+ * Hàm dưới chỉ còn cho ca đặc thù: job muốn gác theo MỘT múi giờ KHÁC múi giờ
+ * tiến trình (vd server chạy UTC nhưng nghiệp vụ theo giờ VN).
  */
 export function isLocalHour(hour: number, timeZone = "Asia/Ho_Chi_Minh"): boolean {
   return (

package/templates/starter-app/src/lib/action-guard.ts

@@ -0,0 +1,26 @@
+import { checkPermission } from "@goerp/core/auth"
+
+import type { Session } from "@/types/session"
+
+import { getSession } from "@/lib/auth"
+
+/**
+ * Cổng cho SERVER ACTION — tương đương apiHandler({resource, action}) của tầng
+ * API. Action là endpoint POST thật sự (mọi client đã đăng nhập gọi được) nên
+ * PHẢI gác quyền; guardrail `auth/server-action-bare-session` cấm gọi
+ * getSession() trần trong file "use server" để ép đi qua đây.
+ *
+ *   const session = await requirePermission("system-setting", "update")
+ */
+export async function requirePermission(
+  resource: string,
+  action = "view",
+): Promise<Session> {
+  const session = await getSession()
+  if (!session?.user) throw new Error("Unauthorized")
+  const s = session as Parameters<typeof checkPermission>[0]
+  if (!checkPermission(s, resource, action)) {
+    throw new Error(`Forbidden: ${resource}:${action}`)
+  }
+  return session as Session
+}

package/templates/starter-app/src/lib/better-auth.ts

@@ -6,6 +6,7 @@ import { prismaAdapter } from "better-auth/adapters/prisma"
 import { APIError } from "better-auth/api"
 import { customSession } from "better-auth/plugins"
 
+import { tenant } from "@/configs/tenant"
 import { db } from "@/lib/prisma"
 import { loadUserAccess } from "@/lib/rbac/access"
 
@@ -28,6 +29,13 @@ function buildAuth() {
     secret: process.env.BETTER_AUTH_SECRET,
     database: prismaAdapter(db, { provider: "postgresql" }),
 
+    // Cookie mang tên riêng của app (`<tenant.id>.session_token`): cookie theo
+    // HOST không phân biệt port, nên dev nhiều app GoERP trên cùng localhost mà
+    // dùng tên mặc định `better-auth.*` là app này mở khoá proxy app kia.
+    // proxy.ts phải truyền CÙNG prefix vào getSessionCookie — đổi một nơi thì
+    // đổi cả hai.
+    advanced: { cookiePrefix: tenant.id },
+
     rateLimit: {
       enabled: true,
       window: 60,

package/templates/starter-app/src/lib/crud/index.ts

@@ -5,6 +5,8 @@ import { db } from "@/lib/prisma"
 // Engine CRUD generic ở CORE — app chỉ tiêm prisma + map entity(số nhiều)→model Prisma.
 const MODEL_MAP: Record<string, string> = {
   departments: "department",
+  "job-titles": "jobTitle",
+  "system-alerts": "systemAlert",
 }
 
 export const crudService = createServerCrudService({

package/templates/starter-app/src/lib/prisma.ts

@@ -14,8 +14,9 @@ import { configureSettingsService } from "@goerp/core/system/services/settings-s
  *  3. bọc branch-guard (lưới an toàn phạm vi chi nhánh cho thao tác ĐỌC);
  *  4. gọi configureSettingsService(db) để core đọc SystemConfig thật.
  *
- * Các seam còn lại (tasks / notifications / cron) cần import nặng hơn nên nằm ở
- * src/server/bootstrap.ts, chạy từ instrumentation.
+ * Các seam còn lại cấu hình ở chỗ chúng sống: tasks → src/server/tasks/,
+ * notifications → src/server/services/notification-service.ts, cron →
+ * src/lib/cron/db-cron-manager.ts (khởi động từ src/instrumentation.ts).
  */
 const globalForPrisma = globalThis as unknown as { prisma?: PrismaClient }
 

package/templates/starter-app/src/providers/mode-provider.tsx

@@ -1,31 +1,26 @@
 "use client"
 
 import { useEffect } from "react"
+import { useIsDarkMode } from "@goerp/core/hooks"
 
 import type { ReactNode } from "react"
 
+const MODES = ["light", "dark"]
+
 /**
- * Sáng/tối theo tuỳ chọn hệ điều hành. Cố ý viết bằng matchMedia thay vì kéo
- * thêm thư viện: starter càng ít phụ thuộc càng dễ nâng cấp. Muốn người dùng
- * tự chọn chế độ thì thay bằng next-themes và bỏ file này.
+ * Áp chế độ Sáng/Tối/Hệ thống mà người dùng chọn trong Customizer (bánh răng).
+ * `useIsDarkMode()` của core đã resolve settings.mode (lưu cookie) + theo dõi
+ * prefers-color-scheme khi chọn "Hệ thống" — ở đây chỉ việc gắn class lên <html>.
  */
-const MODES = ["light", "dark"] as const
-
 export function ModeProvider({ children }: { children: ReactNode }) {
-  useEffect(() => {
-    const query = window.matchMedia("(prefers-color-scheme: dark)")
+  const isDarkMode = useIsDarkMode()
+  const mode = isDarkMode ? "dark" : "light"
 
-    const apply = (isDark: boolean) => {
-      const root = document.documentElement
-      root.classList.remove(...MODES)
-      root.classList.add(isDark ? "dark" : "light")
-    }
-
-    apply(query.matches)
-    const onChange = (e: MediaQueryListEvent) => apply(e.matches)
-    query.addEventListener("change", onChange)
-    return () => query.removeEventListener("change", onChange)
-  }, [])
+  useEffect(() => {
+    const root = document.documentElement
+    root.classList.remove(...MODES)
+    root.classList.add(mode)
+  }, [mode])
 
   return <>{children}</>
 }

package/templates/starter-app/src/providers/theme-provider.tsx

@@ -1,21 +1,35 @@
-'use client'
+"use client"
 
-import { useEffect } from 'react'
+import { useEffect } from "react"
+import { useSettings } from "@goerp/core/hooks"
+import {
+  applyBrandThemeTokens,
+  THEME_PRESETS,
+} from "@goerp/core/providers/brand-theme"
 
-import type { ReactNode } from 'react'
-
-const DEFAULT_THEME = 'blue'
-const DEFAULT_RADIUS = 0.5
+import type { ReactNode } from "react"
 
+/**
+ * Áp màu thương hiệu người dùng chọn trong Customizer vào CSS token
+ * (--primary, --ring, --sidebar-background…). Bảng màu calibrate sẵn nằm ở
+ * core (`THEME_PRESETS`); app muốn nắn tay từng hue thì thay bằng bảng riêng
+ * (xem vinhhoa src/providers/theme-provider.tsx).
+ *
+ * Radius ("Bo góc") + density ("Mật độ") do SettingsProvider của core tự áp.
+ */
 export function ThemeProvider({ children }: { children: ReactNode }) {
+  const { settings } = useSettings()
+
   useEffect(() => {
-    const bodyElement = document.body
-    Array.from(bodyElement.classList)
-      .filter((c) => c.startsWith('theme-') || c.startsWith('radius-'))
-      .forEach((c) => bodyElement.classList.remove(c))
-    bodyElement.classList.add(`theme-${DEFAULT_THEME}`)
-    bodyElement.classList.add(`radius-${DEFAULT_RADIUS}`)
-  }, [])
+    const theme = THEME_PRESETS[settings.theme] ?? THEME_PRESETS.blue
+    const isDark =
+      settings.mode === "dark" ||
+      (settings.mode === "system" &&
+        typeof window !== "undefined" &&
+        !!window.matchMedia?.("(prefers-color-scheme: dark)").matches)
+
+    applyBrandThemeTokens(document.documentElement, theme, isDark)
+  }, [settings.theme, settings.mode])
 
   return <>{children}</>
 }

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

@@ -2,6 +2,7 @@ import { createAuthProxy } from "@goerp/core/auth/proxy-gate"
 import { getSessionCookie } from "better-auth/cookies"
 
 import { i18n } from "@/configs/i18n"
+import { tenant } from "@/configs/tenant"
 
 /**
  * Cổng xác thực DEFAULT-DENY, dùng thẳng proxy-gate của core.
@@ -19,14 +20,18 @@ const BYPASS =
   (process.env.BYPASS_AUTH === "true" || process.env.BYPASS_AUTH === "1")
 
 export const proxy = createAuthProxy({
-  // Thêm prefix vào đây khi có endpoint tự xác thực (webhook, token khách…).
-  publicApiPrefixes: ["/api/better-auth", "/api/public"],
+  // Thêm prefix vào đây khi có endpoint tự xác thực — webhook, token khách,
+  // và cả đường NGOÀI /api (máy móc không có cookie kiểu /pub, /iclock của
+  // máy chấm công). Mỗi entry phải ghi rõ nó tự bảo vệ bằng gì; guardrail
+  // `auth/route-outside-api-declared` sẽ bắt route ngoài /api chưa khai ở đây.
+  publicPrefixes: ["/api/better-auth", "/api/public"],
   publicPages: [...i18n.locales.map((l) => `/${l}/sign-in`), "/sign-in"],
   signInPath: `/${i18n.defaultLocale}/sign-in`,
   homePath: `/${i18n.defaultLocale}`,
+  // cookiePrefix PHẢI khớp advanced.cookiePrefix trong src/lib/better-auth.ts.
   getToken: BYPASS
     ? async () => ({ dev: true })
-    : async (req) => getSessionCookie(req),
+    : async (req) => getSessionCookie(req, { cookiePrefix: tenant.id }),
 })
 
 export default proxy

package/templates/starter-app/src/server/services/company-service.ts

@@ -0,0 +1,47 @@
+import { cache } from "react"
+
+import { tenant } from "@/configs/tenant"
+import { db } from "@/lib/prisma"
+
+/**
+ * Công ty "hệ thống" = dòng ĐẦU TIÊN của bảng companies. Chưa có dòng nào thì
+ * trả mặc định từ tenant config để biểu mẫu không trống — lưu lần đầu sẽ tạo.
+ */
+export const getSystemCompany = cache(async function getSystemCompany() {
+  const company = await db.company.findFirst({ orderBy: { createdAt: "asc" } })
+  if (company) return company
+  return {
+    id: null as string | null,
+    name: tenant.branding?.companyName ?? tenant.name,
+    taxCode: "",
+    address: "",
+    phone: "",
+    email: "",
+    logoUrl: null as string | null,
+    systemName: tenant.name,
+  }
+})
+
+export interface CompanyProfileInput {
+  name: string
+  taxCode: string
+  address: string
+  phone: string
+  email: string
+  logoUrl?: string | null
+  systemName?: string | null
+}
+
+export async function updateSystemCompany(
+  data: CompanyProfileInput,
+  updatedBy: string,
+) {
+  const existing = await db.company.findFirst({ orderBy: { createdAt: "asc" } })
+  if (existing) {
+    return db.company.update({
+      where: { id: existing.id },
+      data: { ...data, updatedBy },
+    })
+  }
+  return db.company.create({ data: { ...data, createdBy: updatedBy, updatedBy } })
+}

package/templates/starter-app/src/server/services/user-service.ts

@@ -0,0 +1,104 @@
+import { db } from "@/lib/prisma"
+
+/**
+ * Danh sách người dùng cho trang /users và GET /api/users.
+ *
+ * CỐ Ý không dùng `getUsersData` của @goerp/core/user: bản đó select các cột
+ * vinhhoa-specific (`userType`, quan hệ `profiles`/`supplier`) không tồn tại
+ * trong schema template — Prisma sẽ ném PrismaClientValidationError ngay
+ * request đầu tiên. Query ở đây chỉ đụng User/UserRole/UserBranch của template
+ * và trả đúng shape mà UsersTable/UsersCardView/UnifiedProfileDialog của core
+ * đọc: `status` ("active"/"inactive"), `roleNames`/`roleCodes`,
+ * `branchIds`/`branchNames`, `defaultBranchId`.
+ * (`getUserStats`/`getActiveRoles` của core thì an toàn — chỗ đếm theo
+ * `userType` đã có `.catch(() => 0)`.)
+ */
+export interface UsersListParams {
+  search?: string
+  /** Lọc theo mã vai trò (Role.code). */
+  roleCode?: string
+  /** "active" | "inactive" — map sang cột isActive. */
+  status?: string
+}
+
+import type { Prisma } from "@prisma/client"
+
+type Where = Prisma.UserWhereInput
+
+export async function getUsersList(params: UsersListParams = {}) {
+  const { search, roleCode, status } = params
+
+  const where: Where = {}
+  if (search) {
+    where.OR = [
+      { name: { contains: search, mode: "insensitive" } },
+      { email: { contains: search, mode: "insensitive" } },
+    ]
+  }
+  if (status === "active" || status === "inactive") {
+    where.isActive = status === "active"
+  }
+  if (roleCode) {
+    where.userRoles = { some: { roleCode } }
+  }
+
+  // Trả TOÀN BỘ danh sách đã lọc: UsersClientPage của core tự phân trang phía
+  // client theo ?page&pageSize (danh sách người dùng nội bộ đủ nhỏ).
+  const [users, total] = await Promise.all([
+    db.user.findMany({
+      where,
+      orderBy: { createdAt: "desc" },
+      select: {
+        id: true,
+        name: true,
+        email: true,
+        image: true,
+        isActive: true,
+        lastLoginAt: true,
+        createdAt: true,
+        updatedAt: true,
+        userRoles: {
+          select: { role: { select: { code: true, name: true } } },
+        },
+        userBranches: {
+          select: {
+            isDefault: true,
+            branch: { select: { id: true, name: true } },
+          },
+          orderBy: [{ isDefault: "desc" }, { createdAt: "asc" }],
+        },
+      },
+    }),
+    db.user.count({ where }),
+  ])
+
+  const data = users.map((user) => {
+    const branches = user.userBranches
+      .filter((ub) => ub.branch)
+      .map((ub) => ({
+        id: ub.branch.id,
+        name: ub.branch.name,
+        isDefault: ub.isDefault,
+      }))
+    return {
+      id: user.id,
+      name: user.name,
+      email: user.email,
+      image: user.image,
+      isActive: user.isActive,
+      status: user.isActive ? "active" : "inactive",
+      lastLoginAt: user.lastLoginAt,
+      createdAt: user.createdAt,
+      updatedAt: user.updatedAt,
+      roleNames: user.userRoles.map((ur) => ur.role.name),
+      roleCodes: user.userRoles.map((ur) => ur.role.code),
+      branches,
+      branchIds: branches.map((b) => b.id),
+      branchNames: branches.map((b) => b.name),
+      defaultBranchId:
+        branches.find((b) => b.isDefault)?.id ?? branches[0]?.id ?? null,
+    }
+  })
+
+  return { data, total }
+}

package/templates/starter-app/tsconfig.json

@@ -27,9 +27,11 @@
         "./src/*"
       ],
       "@goerp/core": [
+        "../../src",
         "./node_modules/@goerp/core/src"
       ],
       "@goerp/core/*": [
+        "../../src/*",
         "./node_modules/@goerp/core/src/*"
       ]
     }