@goplusvn/core 0.1.59 → 0.1.61

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

@@ -0,0 +1,45 @@
+import { createAuthProxy } from "@goerp/core/auth/proxy-gate"
+import { getSessionCookie } from "better-auth/cookies"
+
+import { i18n } from "@/configs/i18n"
+
+/**
+ * Cổng xác thực DEFAULT-DENY, dùng thẳng proxy-gate của core.
+ *
+ * Ý nghĩa: mọi đường dẫn /api đều đòi phiên đăng nhập TRỪ danh sách public bên
+ * dưới — nhờ vậy quên gọi getSession() trong một route mới cũng không thành lỗ
+ * hổng. Đây chỉ là rào authN thô; phân quyền chi tiết vẫn nằm ở từng route
+ * (checkPermission / CRUD engine).
+ *
+ * Middleware chạy ở Edge nên chỉ KIỂM TRA SỰ TỒN TẠI cookie phiên, không xác
+ * minh chữ ký (việc đó cần DB, làm ở route qua getSession).
+ */
+const BYPASS =
+  process.env.NODE_ENV !== "production" &&
+  (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"],
+  publicPages: [...i18n.locales.map((l) => `/${l}/sign-in`), "/sign-in"],
+  signInPath: `/${i18n.defaultLocale}/sign-in`,
+  homePath: `/${i18n.defaultLocale}`,
+  getToken: BYPASS
+    ? async () => ({ dev: true })
+    : async (req) => getSessionCookie(req),
+})
+
+export default proxy
+
+export const config = {
+  matcher: [
+    /*
+     * Khớp mọi đường dẫn TRỪ tài nguyên tĩnh. Lưu ý `api` KHÔNG bị loại — cổng
+     * default-deny ở trên phải chạy trước mọi API route.
+     * Loại trừ: _next/static, _next/image, thư mục asset, và mọi path kết thúc
+     * bằng đuôi tĩnh (thiếu vế này thì favicon/manifest/ảnh OG bị 307 về
+     * /sign-in và trình duyệt nhận HTML thay vì file).
+     */
+    "/((?!_next/static|_next/image|icons|images|.*\\.(?:png|jpg|jpeg|gif|svg|ico|webp|avif|json|xml|txt|webmanifest|wasm)$).*)",
+  ],
+}

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

@@ -0,0 +1,31 @@
+/**
+ * Thông báo trong ứng dụng (chuông ở thanh trên). Engine ở
+ * @goerp/core/notification, bảng `notifications` + `push_subscriptions` ship
+ * qua `goerp-features sync`. File này chỉ cắm db.
+ *
+ * Muốn đẩy Web Push tới thiết bị đã cài PWA: thêm `afterNotify` bên dưới và
+ * dynamic-import service push của bạn, để đường chỉ-ghi-DB không kéo thư viện
+ * push vào bundle. Core đã fire-and-forget + catch nên push lỗi không làm hỏng
+ * nghiệp vụ đang chạy.
+ */
+import {
+  configureNotificationService,
+  type NotificationDb,
+} from "@goerp/core/notification"
+
+import { db } from "@/lib/prisma"
+
+configureNotificationService({
+  db: db as unknown as NotificationDb,
+})
+
+export {
+  getUnreadCount,
+  listNotifications,
+  markAllRead,
+  markRead,
+  notify,
+  type ListParams,
+  type NotificationType,
+  type NotifyInput,
+} from "@goerp/core/notification"

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

@@ -0,0 +1,163 @@
+/**
+ * Nghiệp vụ của bảng `system_configs` — dùng chung cho 6 route dưới
+ * /api/admin/system/settings (trang SystemSettingsPage của core gọi tới).
+ *
+ * Gom vào một chỗ vì các quy tắc dưới đây phải giống nhau ở MỌI đường ghi:
+ *  - `isReadOnly` chặn sửa/xóa (cấu hình do hệ thống làm chủ),
+ *  - `isEncrypted` không bao giờ trả giá trị thật ra ngoài,
+ *  - mọi thay đổi phải `revalidateTag("system-settings")`, nếu không
+ *    `SettingsService` của core còn giữ bản cache cũ và người dùng tưởng lưu hụt.
+ */
+import { revalidateTag } from "next/cache"
+
+import { db } from "@/lib/prisma"
+
+const MASK = "••••••••"
+
+/** Sai lệch do người dùng nhập — route bắt và trả đúng mã HTTP. */
+export class ConfigError extends Error {
+  constructor(
+    message: string,
+    readonly status: number,
+  ) {
+    super(message)
+  }
+}
+
+/**
+ * Trả về mô tả lỗi để route dịch sang HTTP, hoặc null nếu là lỗi ngoài dự kiến
+ * (khi đó route phải để `serverError` ghi lại stack thật).
+ */
+export function configErrorInfo(
+  error: unknown,
+): { message: string; status: number } | null {
+  return error instanceof ConfigError
+    ? { message: error.message, status: error.status }
+    : null
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const mask = (config: any) => ({
+  ...config,
+  value: config.isEncrypted ? MASK : config.value,
+})
+
+function invalidate() {
+  revalidateTag("system-settings", "max")
+}
+
+async function requireConfig(key: string) {
+  const existing = await db.systemConfig.findUnique({ where: { key } })
+  if (!existing) throw new ConfigError("Cấu hình không tồn tại", 404)
+  return existing
+}
+
+export async function listConfigs() {
+  const configs = await db.systemConfig.findMany({
+    where: { status: "active" },
+    orderBy: [{ category: "asc" }, { key: "asc" }],
+  })
+  return configs.map(mask)
+}
+
+export interface ConfigInput {
+  key?: string
+  value?: string
+  type?: string
+  category?: string
+  description?: string | null
+  isEncrypted?: boolean
+  isReadOnly?: boolean
+}
+
+export async function createConfig(input: ConfigInput, userId: string) {
+  const key = input.key?.trim()
+  if (!key) throw new ConfigError("Thiếu key", 400)
+  // Key đi vào URL và code — giới hạn ký tự để không phải escape về sau.
+  if (!/^[a-zA-Z0-9._-]+$/.test(key)) {
+    throw new ConfigError(
+      "Key chỉ được chứa chữ, số, dấu chấm, gạch dưới và gạch ngang",
+      400,
+    )
+  }
+  if (await db.systemConfig.findUnique({ where: { key } })) {
+    throw new ConfigError("Cấu hình với key này đã tồn tại", 400)
+  }
+
+  const created = await db.systemConfig.create({
+    data: {
+      key,
+      value: input.value || "",
+      type: input.type || "string",
+      category: input.category || "general",
+      description: input.description || null,
+      isEncrypted: input.isEncrypted || false,
+      isReadOnly: input.isReadOnly || false,
+      status: "active",
+      createdBy: userId,
+      updatedBy: userId,
+    },
+  })
+  invalidate()
+  return mask(created)
+}
+
+/** Đổi MỖI giá trị — đường dùng nhiều nhất trên UI. */
+export async function updateConfigValue(key: string, value: unknown, userId: string) {
+  if (!key || value === undefined) throw new ConfigError("Thiếu key hoặc value", 400)
+  const existing = await requireConfig(key)
+  if (existing.isReadOnly) throw new ConfigError("Cấu hình này chỉ đọc", 403)
+
+  const updated = await db.systemConfig.update({
+    where: { key },
+    data: { value: String(value), updatedBy: userId },
+  })
+  invalidate()
+  return mask(updated)
+}
+
+/** Sửa toàn bộ thuộc tính (dialog "Sửa cấu hình"). */
+export async function updateConfigFull(input: ConfigInput, userId: string) {
+  const key = input.key
+  if (!key) throw new ConfigError("Thiếu key", 400)
+  const existing = await requireConfig(key)
+
+  const updated = await db.systemConfig.update({
+    where: { key },
+    data: {
+      value: input.value ?? existing.value,
+      type: input.type ?? existing.type,
+      category: input.category ?? existing.category,
+      description: input.description !== undefined ? input.description : existing.description,
+      isEncrypted: input.isEncrypted ?? existing.isEncrypted,
+      isReadOnly: input.isReadOnly ?? existing.isReadOnly,
+      updatedBy: userId,
+    },
+  })
+  invalidate()
+  return mask(updated)
+}
+
+export async function deleteConfig(key: string) {
+  if (!key) throw new ConfigError("Thiếu key", 400)
+  const existing = await requireConfig(key)
+  if (existing.isReadOnly) throw new ConfigError("Không thể xóa cấu hình được bảo vệ", 403)
+
+  await db.systemConfig.delete({ where: { key } })
+  invalidate()
+}
+
+export async function toggleConfigStatus(key: string, status: string, userId: string) {
+  if (!key) throw new ConfigError("Thiếu key", 400)
+  if (!["active", "inactive"].includes(status)) {
+    throw new ConfigError("status phải là 'active' hoặc 'inactive'", 400)
+  }
+  await requireConfig(key)
+
+  const updated = await db.systemConfig.update({
+    where: { key },
+    data: { status, updatedBy: userId },
+  })
+  invalidate()
+  return mask(updated)
+}

package/templates/starter-app/src/server/tasks/handlers/export-departments.ts

@@ -0,0 +1,58 @@
+/**
+ * MẪU tác vụ nền — xuất danh sách phòng ban ra CSV.
+ *
+ * Đây là khuôn để copy cho tác vụ thật của bạn. Ba điểm đáng chú ý:
+ *  1. Đọc theo TRANG rồi `setProgress` — 100k dòng không được nạp hết vào RAM.
+ *  2. Trả về `fileKey` từ `saveTaskFile` — UI tải file qua /api/tasks/[id]/file,
+ *     không lộ đường dẫn thật.
+ *  3. Ném lỗi thoải mái: engine bắt, ghi status=error kèm message và báo chuông.
+ */
+import { registerTaskHandler, saveTaskFile } from "../task-runner"
+
+import { db } from "@/lib/prisma"
+
+import type { TaskContext, TaskFileResult } from "@goerp/core/tasks"
+
+export const EXPORT_DEPARTMENTS_TASK = "export-departments"
+
+const PAGE_SIZE = 500
+
+/** CSV thủ công: bọc ngoặc kép + nhân đôi ngoặc bên trong (RFC 4180). */
+function csvCell(value: unknown): string {
+  if (value === null || value === undefined) return ""
+  const text = value instanceof Date ? value.toISOString() : String(value)
+  return `"${text.replace(/"/g, '""')}"`
+}
+
+registerTaskHandler(
+  EXPORT_DEPARTMENTS_TASK,
+  async ({ setProgress }: TaskContext): Promise<TaskFileResult> => {
+    const total = await db.department.count()
+    const rows: string[] = [["Mã", "Tên", "Mô tả", "Thứ tự", "Trạng thái"].join(",")]
+
+    for (let skip = 0; skip < total; skip += PAGE_SIZE) {
+      const page = await db.department.findMany({
+        skip,
+        take: PAGE_SIZE,
+        orderBy: { order: "asc" },
+      })
+      for (const d of page) {
+        rows.push(
+          [d.code, d.name, d.description, d.order, d.status].map(csvCell).join(","),
+        )
+      }
+      await setProgress(Math.round(((skip + page.length) / Math.max(total, 1)) * 100))
+    }
+
+    // BOM  để Excel bản tiếng Việt không đọc UTF-8 thành ký tự lỗi.
+    const buffer = Buffer.from(`${rows.join("\n")}`, "utf8")
+    const fileName = "phong-ban.csv"
+    const fileKey = await saveTaskFile(
+      buffer,
+      `${EXPORT_DEPARTMENTS_TASK}/${fileName}`,
+      "text/csv",
+    )
+
+    return { fileKey, fileName, contentType: "text/csv", rowCount: total }
+  },
+)

package/templates/starter-app/src/server/tasks/index.ts

@@ -0,0 +1,16 @@
+// Cổng vào của trung tâm tác vụ nền. Import file NÀY (đừng import thẳng
+// task-runner) để side-effect đăng ký handler luôn chạy trước khi enqueue —
+// enqueue một type chưa đăng ký sẽ ném lỗi ngay.
+import "./handlers/export-departments"
+
+export {
+  enqueueTask,
+  readTaskFile,
+  reclaimStaleTasks,
+  registerTaskHandler,
+  saveTaskFile,
+  type TaskContext,
+  type TaskFileResult,
+  type TaskHandler,
+} from "./task-runner"
+export { EXPORT_DEPARTMENTS_TASK } from "./handlers/export-departments"

package/templates/starter-app/src/server/tasks/task-runner.ts

@@ -0,0 +1,40 @@
+/**
+ * Tác vụ nền — engine ở @goerp/core/tasks (bảng `background_tasks` ship qua
+ * `goerp-features sync`). Hàng đợi nằm trong DB, worker chạy NGAY trong tiến
+ * trình đang phục vụ request; server restart giữa chừng thì
+ * `reclaimStaleTasks()` (gọi từ instrumentation) đánh dấu lỗi để user chạy lại.
+ *
+ * Đừng import file này ở nơi khác — import `@/server/tasks` để các handler
+ * được đăng ký trước khi có ai enqueue.
+ */
+import {
+  configureTaskRunner,
+  type TaskDb,
+  type TaskNotifyInput,
+} from "@goerp/core/tasks"
+
+import { db } from "@/lib/prisma"
+
+configureTaskRunner({
+  db: db as unknown as TaskDb,
+  // Dynamic import: đường chỉ-ghi-DB không kéo tầng thông báo vào bundle.
+  notify: async (input: TaskNotifyInput) => {
+    const { notify } = await import("@/server/services/notification-service")
+    return notify(input)
+  },
+  // Chưa cắm `storage` → core ghi file kết quả vào <cwd>/storage/task-files
+  // (THƯ MỤC RIÊNG, không nằm trong public/ — file xuất thường chứa dữ liệu
+  // nhạy cảm). Khi có S3/MinIO thì thêm `storage: { save, read }` ở đây; trả
+  // `null` từ `save` là cách nói "để core fallback local".
+})
+
+export {
+  enqueueTask,
+  readTaskFile,
+  reclaimStaleTasks,
+  registerTaskHandler,
+  saveTaskFile,
+  type TaskContext,
+  type TaskFileResult,
+  type TaskHandler,
+} from "@goerp/core/tasks"

package/templates/starter-app/src/types/session.ts

@@ -0,0 +1,29 @@
+/**
+ * Shape session của app. `@goerp/core` đọc đúng ba trường `id`, `roles`,
+ * `permissions` trên `session.user` để gate CRUD và UI — đổi tên chúng là
+ * toàn bộ phân quyền im lặng trả về "không có quyền". Thêm trường riêng của
+ * app thì thoải mái.
+ */
+
+export interface Permission {
+  resourceCode: string
+  actionCode: string
+}
+
+export interface SessionUser {
+  id: string
+  email: string | null
+  name: string
+  avatar: string | null
+  status: string
+  roles: string[]
+  branchId: string | null
+  branches: string[]
+  permissions: Permission[]
+}
+
+export interface Session {
+  user: SessionUser
+  /** ISO datetime hết hạn phiên */
+  expires: string
+}

package/templates/starter-app/tsconfig.json

@@ -0,0 +1,47 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": [
+        "./src/*"
+      ],
+      "@goerp/core": [
+        "./node_modules/@goerp/core/src"
+      ],
+      "@goerp/core/*": [
+        "./node_modules/@goerp/core/src/*"
+      ]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/templates/starter-app/vitest.config.ts

@@ -0,0 +1,17 @@
+import path from "path"
+
+import react from "@vitejs/plugin-react"
+import { defineConfig } from "vitest/config"
+
+export default defineConfig({
+  plugins: [react()],
+  test: {
+    environment: "jsdom",
+    globals: true,
+    include: ["src/**/*.test.{ts,tsx}", "src/**/__tests__/**/*.{ts,tsx}"],
+  },
+  resolve: {
+    // Phải khai lại alias của tsconfig: vitest không đọc tsconfig paths.
+    alias: { "@": path.resolve(__dirname, "./src") },
+  },
+})

package/src/infrastructure/cron/index.ts

@@ -1,6 +0,0 @@
-export {
-  cronJobManager,
-  CronJobManagerImpl,
-  SimpleCronJob,
-} from "./cron-manager";
-export type { CronJob, CronJobOptions, CronJobManager } from "./types";

package/src/infrastructure/event-bus/event-bus.ts

@@ -1,145 +0,0 @@
-import type {
-  EventBus as IEventBus,
-  EventHandler,
-  EventSubscription,
-} from "./types";
-import { createLogger } from "../logger";
-
-const logger = createLogger("EventBus");
-
-/**
- * Simple in-memory event bus for pub/sub pattern
- *
- * @example
- * ```typescript
- * import { eventBus } from '@goerp/core/infrastructure';
- *
- * // Subscribe
- * eventBus.on('order.created', async ({ orderId }) => {
- *   await notificationService.notify(orderId);
- * });
- *
- * // Publish
- * eventBus.emit('order.created', { orderId: '123' });
- *
- * // Async emit (wait for handlers)
- * await eventBus.emitAsync('order.approved', { orderId: '123' });
- * ```
- */
-class EventBusImpl implements IEventBus {
-  private handlers = new Map<string, Set<EventHandler<unknown>>>();
-  private onceHandlers = new Map<string, Set<EventHandler<unknown>>>();
-
-  on<T>(event: string, handler: EventHandler<T>): EventSubscription {
-    if (!this.handlers.has(event)) {
-      this.handlers.set(event, new Set());
-    }
-    this.handlers.get(event)!.add(handler as EventHandler<unknown>);
-
-    logger.debug(`Subscribed to event: ${event}`);
-
-    return {
-      unsubscribe: () => {
-        this.handlers.get(event)?.delete(handler as EventHandler<unknown>);
-      },
-    };
-  }
-
-  once<T>(event: string, handler: EventHandler<T>): EventSubscription {
-    if (!this.onceHandlers.has(event)) {
-      this.onceHandlers.set(event, new Set());
-    }
-    this.onceHandlers.get(event)!.add(handler as EventHandler<unknown>);
-
-    return {
-      unsubscribe: () => {
-        this.onceHandlers.get(event)?.delete(handler as EventHandler<unknown>);
-      },
-    };
-  }
-
-  emit<T>(event: string, data: T): void {
-    logger.debug(`Emitting event: ${event}`);
-
-    const handlers = this.handlers.get(event);
-    const onceHandlers = this.onceHandlers.get(event);
-
-    if (handlers) {
-      for (const handler of handlers) {
-        try {
-          handler(data);
-        } catch (error) {
-          logger.error(`Error in event handler for ${event}`, {
-            error: String(error),
-          });
-        }
-      }
-    }
-
-    if (onceHandlers) {
-      for (const handler of onceHandlers) {
-        try {
-          handler(data);
-        } catch (error) {
-          logger.error(`Error in once handler for ${event}`, {
-            error: String(error),
-          });
-        }
-      }
-      this.onceHandlers.delete(event);
-    }
-  }
-
-  async emitAsync<T>(event: string, data: T): Promise<void> {
-    logger.debug(`Emitting async event: ${event}`);
-
-    const handlers = this.handlers.get(event);
-    const onceHandlers = this.onceHandlers.get(event);
-    const promises: Promise<void>[] = [];
-
-    if (handlers) {
-      for (const handler of handlers) {
-        promises.push(
-          Promise.resolve(handler(data)).catch((error) => {
-            logger.error(`Error in async handler for ${event}`, {
-              error: String(error),
-            });
-          }),
-        );
-      }
-    }
-
-    if (onceHandlers) {
-      for (const handler of onceHandlers) {
-        promises.push(
-          Promise.resolve(handler(data)).catch((error) => {
-            logger.error(`Error in async once handler for ${event}`, {
-              error: String(error),
-            });
-          }),
-        );
-      }
-      this.onceHandlers.delete(event);
-    }
-
-    await Promise.all(promises);
-  }
-
-  off(event: string): void {
-    this.handlers.delete(event);
-    this.onceHandlers.delete(event);
-    logger.debug(`Removed all handlers for event: ${event}`);
-  }
-
-  removeAllListeners(): void {
-    this.handlers.clear();
-    this.onceHandlers.clear();
-    logger.debug("Removed all event listeners");
-  }
-}
-
-// Singleton instance
-export const eventBus = new EventBusImpl();
-
-// Export class for testing
-export { EventBusImpl };

package/src/infrastructure/event-bus/index.ts

@@ -1,2 +0,0 @@
-export { eventBus, EventBusImpl } from "./event-bus";
-export type { EventBus, EventHandler, EventSubscription } from "./types";

package/src/infrastructure/event-bus/types.ts

@@ -1,22 +0,0 @@
-// EventBus Types
-export type EventHandler<T = unknown> = (data: T) => void | Promise<void>;
-
-export interface EventSubscription {
-  /** Unsubscribe from the event */
-  unsubscribe(): void;
-}
-
-export interface EventBus {
-  /** Subscribe to an event */
-  on<T>(event: string, handler: EventHandler<T>): EventSubscription;
-  /** Subscribe to an event (fires only once) */
-  once<T>(event: string, handler: EventHandler<T>): EventSubscription;
-  /** Emit an event with data */
-  emit<T>(event: string, data: T): void;
-  /** Emit an event and wait for all handlers to complete */
-  emitAsync<T>(event: string, data: T): Promise<void>;
-  /** Remove all handlers for an event */
-  off(event: string): void;
-  /** Remove all handlers */
-  removeAllListeners(): void;
-}