@goplusvn/core 0.1.70 → 0.1.72

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"] },
+    },
   ],
 }
 

package/templates/starter-app/src/configs/permissions/menu-tree.ts

@@ -0,0 +1,37 @@
+import { navigations } from "@/data/navigations"
+
+/**
+ * CÂY MENU cho các màn phân quyền (RoleFormPage, ResourceCatalogPage) — dựng
+ * từ navigations. PURE DATA (serializable), dùng được cả server lẫn client.
+ */
+export interface MenuTreeItem {
+  title: string
+  href?: string
+  icon?: string
+  resource: string
+}
+export interface MenuTreeSection {
+  title: string
+  icon?: string
+  items: MenuTreeItem[]
+}
+
+export const MENU_TREE: MenuTreeSection[] = navigations
+  .map((section) => ({
+    title: section.title,
+    icon: (section as { iconName?: string }).iconName,
+    items: ((section.items ?? []) as unknown as Array<Record<string, unknown>>)
+      .filter((item) => item.resource && item.href)
+      .map((item) => ({
+        title: item.title as string,
+        href: item.href as string,
+        icon: item.iconName as string | undefined,
+        resource: item.resource as string,
+      })),
+  }))
+  .filter((s) => s.items.length > 0)
+
+/** resource → href của trang chính (ActionCatalogPage dùng để link chéo). */
+export const RESOURCE_PAGES: Record<string, string> = Object.fromEntries(
+  MENU_TREE.flatMap((s) => s.items.map((i) => [i.resource, i.href ?? ""]))
+)

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

@@ -64,6 +64,35 @@ const systemPermissions: FeaturePermissions = {
     },
 
     // ── Cấu hình ─────────────────────────────────────────────────────────
+    {
+      code: "system-category",
+      name: "Danh mục hệ thống",
+      group: "Hệ thống",
+      icon: "FolderTree",
+      order: 17,
+      actions: ["view", "create", "update", "delete"],
+      // Danh mục dùng chung đổ vào form/picker toàn app.
+      lookupPolicy: "authenticated",
+      defaultGrants: { admin: "*" },
+    },
+    {
+      code: "system-alert",
+      name: "Cảnh báo hệ thống",
+      group: "Hệ thống",
+      icon: "Bell",
+      order: 18,
+      actions: ["view", "create", "update", "delete", "export"],
+      defaultGrants: { admin: "*" },
+    },
+    {
+      code: "system-cache",
+      name: "Bộ nhớ đệm",
+      group: "Hệ thống",
+      icon: "Database",
+      order: 19,
+      actions: ["view", "update"],
+      defaultGrants: { admin: "*" },
+    },
     {
       code: "system-setting",
       name: "Cấu hình chung",

package/templates/starter-app/src/configs/tenant.ts

@@ -10,7 +10,8 @@ export const tenant: TenantConfig = {
   branding: {
     // logo: "/logo.png",
     companyName: "GoERP Starter",
-    tagline: "Powered by @goerp/core",
+    // Dòng phụ dưới tên app ở sidebar/đăng nhập — để "" là ẩn hẳn.
+    tagline: "",
     // primaryColor: "262 83% 58%", // HSL triple → reskins --primary at runtime
     // favicon: "/favicon.ico",
   },

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

@@ -1,8 +1,81 @@
 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,78 @@ 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: "Vai trò", iconName: "ShieldCheck", href: "/roles", resource: "role" },
+      {
+        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,25 @@
+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")
+  if (!checkPermission(session, resource, action)) {
+    throw new Error(`Forbidden: ${resource}:${action}`)
+  }
+  return session
+}

package/templates/starter-app/src/lib/api-handler.ts

@@ -15,13 +15,11 @@
 import { NextResponse } from "next/server"
 import { withAuditContext } from "@goerp/core/audit"
 import { checkPermission as coreCheckPermission } from "@goerp/core/auth"
-import {
-  createApiHandler,
-  type ApiHandlerMiddleware,
-} from "@goerp/core/auth/api-handler"
+import { createApiHandler } from "@goerp/core/auth/api-handler"
 
-import type { NextRequest } from "next/server"
 import type { Session } from "@/types/session"
+import type { ApiHandlerMiddleware } from "@goerp/core/auth/api-handler"
+import type { NextRequest } from "next/server"
 
 import { getRegistryResource } from "@/configs/permissions"
 import { getSession } from "@/lib/auth"
@@ -40,7 +38,7 @@ interface HandlerContext<TParams = Record<string, string>> {
 
 type Handler<TParams = Record<string, string>> = (
   req: NextRequest,
-  ctx: HandlerContext<TParams>,
+  ctx: HandlerContext<TParams>
 ) => Promise<Response>
 
 interface ApiHandlerOptions {
@@ -70,7 +68,10 @@ function assertResourceDeclared(resource: string) {
  * trong lib/prisma.ts đọc context này; thiếu nó thì mọi dòng audit_logs đều
  * ghi tác nhân rỗng.
  */
-const auditContext: ApiHandlerMiddleware<Session> = async (next, { req, session }) => {
+const auditContext: ApiHandlerMiddleware<Session> = async (
+  next,
+  { req, session }
+) => {
   if (!session) return next()
   const ip =
     req.headers.get("x-forwarded-for")?.split(",")[0]?.trim() ||
@@ -78,7 +79,7 @@ const auditContext: ApiHandlerMiddleware<Session> = async (next, { req, session
     undefined
   return (await withAuditContext(
     { userId: session.user.id, userName: session.user.name, ip },
-    () => next(),
+    () => next()
   )) as Response
 }
 
@@ -87,11 +88,14 @@ const auditContext: ApiHandlerMiddleware<Session> = async (next, { req, session
  * biết user được xem chi nhánh nào. Phạm vi được tính LƯỜI — request không đụng
  * model nào bị guard thì `resolve` không bao giờ chạy.
  */
-const branchScope: ApiHandlerMiddleware<Session> = async (next, { session }) => {
+const branchScope: ApiHandlerMiddleware<Session> = async (
+  next,
+  { session }
+) => {
   if (!session) return next()
   return (await runWithBranchScope(
     { resolve: () => getBranchScope(session) },
-    () => next(),
+    () => next()
   )) as Response
 }
 
@@ -108,7 +112,8 @@ async function onApiError(error: unknown, req: Request): Promise<Response> {
     userAgent: req.headers.get("user-agent") || undefined,
   })
 
-  const message = error instanceof Error ? error.message : "Internal Server Error"
+  const message =
+    error instanceof Error ? error.message : "Internal Server Error"
   return NextResponse.json(
     {
       error: message,
@@ -116,9 +121,14 @@ async function onApiError(error: unknown, req: Request): Promise<Response> {
       // đang in — production thì tuyệt đối không lộ.
       ...(process.env.NODE_ENV === "production"
         ? {}
-        : { debug: { message, stack: error instanceof Error ? error.stack : undefined } }),
+        : {
+            debug: {
+              message,
+              stack: error instanceof Error ? error.stack : undefined,
+            },
+          }),
     },
-    { status: 500 },
+    { status: 500 }
   )
 }
 
@@ -128,9 +138,7 @@ const coreApiHandler = createApiHandler<Session>({
     const session = await getSession()
     return session?.user ? session : null
   },
-  checkPermission: (session, resource, action) =>
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    coreCheckPermission(session as any, resource, action),
+  checkPermission: coreCheckPermission,
   assertResource: assertResourceDeclared,
   wrap: [auditContext, branchScope],
   onError: onApiError,
@@ -138,7 +146,7 @@ const coreApiHandler = createApiHandler<Session>({
 
 export function apiHandler<TParams = Record<string, string>>(
   handler: Handler<TParams>,
-  options?: ApiHandlerOptions,
+  options?: ApiHandlerOptions
 ) {
   const route = coreApiHandler(
     (req, ctx) =>
@@ -147,11 +155,11 @@ export function apiHandler<TParams = Record<string, string>>(
         session: ctx.session ?? ({} as Session),
         params: ctx.params as Promise<TParams>,
       }),
-    options,
+    options
   )
   return async (
     req: NextRequest,
     // Route tĩnh (không có segment động) được Next gọi mà không kèm ctx.
-    routeCtx?: { params: Promise<TParams> },
+    routeCtx?: { params: Promise<TParams> }
   ): Promise<Response> => route(req, routeCtx as never)
 }

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

@@ -50,7 +50,9 @@ export const getSession = cache(async (): Promise<Session | null> => {
   return {
     user: result.user,
     expires:
-      expiresAt instanceof Date ? expiresAt.toISOString() : String(expiresAt ?? ""),
+      expiresAt instanceof Date
+        ? expiresAt.toISOString()
+        : String(expiresAt ?? ""),
   } as unknown 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/branch-scope.ts

@@ -27,7 +27,7 @@ import type { Session } from "@/types/session"
 export function canViewAllBranches(session: Session): boolean {
   return Boolean(
     session.user?.roles?.includes("admin") ||
-      checkPermission(session as never, "branch", "view-all-branches"),
+      checkPermission(session, "branch", "view-all-branches")
   )
 }
 

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

@@ -1,13 +1,8 @@
-import { createServerCrudService, getModelName } from "@goerp/core/crud/server"
+import { createServerCrudService } from "@goerp/core/crud/server"
 
 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",
-}
-
-export const crudService = createServerCrudService({
-  prisma: db,
-  getModelName: (entity) => getModelName(entity, MODEL_MAP),
-})
+// Engine CRUD generic ở CORE — app chỉ tiêm prisma. Tên model Prisma khai
+// ngay trong từng entity config (`modelName: "jobTitle"`…), không còn
+// MODEL_MAP song song ở đây.
+export const crudService = createServerCrudService({ prisma: db })

package/templates/starter-app/src/lib/errors/log-server-error.ts

@@ -1,7 +1,8 @@
-import {
-  createErrorLogger,
-  type ErrorLoggerDb,
-  type ServerErrorContext,
+import { createErrorLogger } from "@goerp/core/errors/server-error"
+
+import type {
+  ErrorLoggerDb,
+  ServerErrorContext,
 } from "@goerp/core/errors/server-error"
 
 import { db } from "@/lib/prisma"

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

@@ -12,9 +12,12 @@ type LogContext = Record<string, unknown>
  * được stack — bọc lại ở đây thay vì bắt mỗi call site tự trải ra.
  */
 export const logger = {
-  info: (message: string, context?: LogContext) => coreLogger.info(message, context),
-  warn: (message: string, context?: LogContext) => coreLogger.warn(message, context),
-  debug: (message: string, context?: LogContext) => coreLogger.debug(message, context),
+  info: (message: string, context?: LogContext) =>
+    coreLogger.info(message, context),
+  warn: (message: string, context?: LogContext) =>
+    coreLogger.warn(message, context),
+  debug: (message: string, context?: LogContext) =>
+    coreLogger.debug(message, context),
   error: (message: string, error?: unknown, context?: LogContext) =>
     coreLogger.error(message, {
       ...context,
@@ -22,7 +25,11 @@ export const logger = {
         ? {
             error:
               error instanceof Error
-                ? { name: error.name, message: error.message, stack: error.stack }
+                ? {
+                    name: error.name,
+                    message: error.message,
+                    stack: error.stack,
+                  }
                 : error,
           }
         : {}),

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

@@ -22,14 +22,13 @@ import { getSession } from "@/lib/auth"
 export async function requirePageAccess(
   lang: string,
   resource: string,
-  action = "view",
+  action = "view"
 ): Promise<Session> {
   const session = await getSession()
   const locale = lang || i18n.defaultLocale
 
   if (!session?.user) redirect(`/${locale}/sign-in`)
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  if (!checkPermission(session as any, resource, action)) redirect(`/${locale}`)
+  if (!checkPermission(session, resource, action)) redirect(`/${locale}`)
 
   return session
 }

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

@@ -1,8 +1,8 @@
-import { PrismaPg } from "@prisma/adapter-pg"
-import { Prisma, PrismaClient } from "@prisma/client"
 import { createAuditExtension } from "@goerp/core/audit"
 import { createBranchGuardExtension } from "@goerp/core/branch-scope"
 import { configureSettingsService } from "@goerp/core/system/services/settings-service"
+import { PrismaPg } from "@prisma/adapter-pg"
+import { Prisma, PrismaClient } from "@prisma/client"
 
 /**
  * COMPOSITION ROOT của app — nơi duy nhất tạo Prisma client và cắm dây cho các
@@ -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 }
 
@@ -70,10 +71,18 @@ export const db = rawClient
       rawClient,
       // Bảng ghi rất nhiều mà không có giá trị điều tra thì loại ra, kẻo dấu vết
       // nghiệp vụ bị nhấn chìm (vinhhoa đo được 1 bảng chiếm 64% số dòng audit).
-      skipModels: ["AuditLog", "ErrorLog", "Session", "Account", "Verification"],
-    }),
+      skipModels: [
+        "AuditLog",
+        "ErrorLog",
+        "Session",
+        "Account",
+        "Verification",
+      ],
+    })
   )
-  .$extends(createBranchGuardExtension({ models: GUARDED_MODELS })) as unknown as PrismaClient
+  .$extends(
+    createBranchGuardExtension({ models: GUARDED_MODELS })
+  ) as unknown as PrismaClient
 
 // Core đọc SystemConfig qua service này. Thiếu dòng dưới thì mọi getSettings()
 // lặng lẽ trả giá trị mặc định và saveSettings() ném lỗi.