@goplusvn/core 0.1.59 → 0.1.61

package/templates/starter-app/src/app/api/error-logs/[id]/route.ts

@@ -0,0 +1,23 @@
+import { NextResponse } from "next/server"
+
+import { apiHandler } from "@/lib/api-handler"
+import { serverError } from "@/lib/errors/server-error"
+import { db } from "@/lib/prisma"
+
+/** Đánh dấu đã/chưa xử lý một dòng lỗi. */
+export const PATCH = apiHandler(
+  async (req, { params }) => {
+    try {
+      const { id } = await params
+      const { resolved } = await req.json()
+      const log = await db.errorLog.update({
+        where: { id },
+        data: { resolved: Boolean(resolved) },
+      })
+      return NextResponse.json({ success: true, log })
+    } catch (error) {
+      return serverError(error, req, { message: "Không cập nhật được trạng thái lỗi" })
+    }
+  },
+  { resource: "error-log", action: "update" },
+)

package/templates/starter-app/src/app/api/error-logs/route.ts

@@ -0,0 +1,124 @@
+import { NextResponse } from "next/server"
+
+import type { NextRequest } from "next/server"
+
+import { apiHandler } from "@/lib/api-handler"
+import { serverError } from "@/lib/errors/server-error"
+import { db } from "@/lib/prisma"
+
+/**
+ * Nhật ký lỗi cho trang /admin/system/error-logs (ErrorLogsPage của core).
+ * Lỗi được GHI ở nơi khác (`serverError` / `onRequestError`); route này chỉ đọc
+ * và dọn.
+ */
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type Where = Record<string, any>
+
+export const GET = apiHandler(
+  async (req) => {
+    try {
+      const sp = new URL(req.url).searchParams
+      const search = sp.get("search") || undefined
+      const severity = sp.get("severity") || undefined
+      const module = sp.get("module") || undefined
+      const resolved = sp.get("resolved")
+      const startDate = sp.get("startDate")
+      const endDate = sp.get("endDate")
+      const skip = parseInt(sp.get("skip") || "0", 10)
+      const take = Math.min(parseInt(sp.get("take") || "50", 10), 100)
+
+      const where: Where = {}
+      if (search) {
+        where.OR = [
+          { message: { contains: search, mode: "insensitive" } },
+          { errorId: { contains: search, mode: "insensitive" } },
+          { code: { contains: search, mode: "insensitive" } },
+          { module: { contains: search, mode: "insensitive" } },
+        ]
+      }
+      if (severity && severity !== "all") where.severity = severity
+      if (module && module !== "all") where.module = module
+      if (resolved === "true") where.resolved = true
+      else if (resolved === "false") where.resolved = false
+      if (startDate || endDate) {
+        where.createdAt = {}
+        if (startDate) where.createdAt.gte = new Date(startDate)
+        if (endDate) where.createdAt.lte = new Date(endDate)
+      }
+
+      const startOfToday = new Date()
+      startOfToday.setHours(0, 0, 0, 0)
+
+      const [logs, total, todayCount, unresolvedCount, moduleStats] = await Promise.all([
+        db.errorLog.findMany({ where, orderBy: { lastSeenAt: "desc" }, skip, take }),
+        db.errorLog.count({ where }),
+        db.errorLog.count({ where: { createdAt: { gte: startOfToday } } }),
+        db.errorLog.count({ where: { resolved: false } }),
+        db.errorLog.groupBy({
+          by: ["module"],
+          _count: { module: true },
+          where: { resolved: false },
+          orderBy: { _count: { module: "desc" } },
+          take: 8,
+        }),
+      ])
+
+      // ErrorLog không có quan hệ tới User (lỗi có thể xảy ra khi chưa đăng
+      // nhập) — tra tên riêng thay vì include.
+      const userIds = [...new Set(logs.map((l) => l.userId).filter(Boolean))] as string[]
+      const nameById = new Map<string, string>()
+      if (userIds.length) {
+        const users = await db.user.findMany({
+          where: { id: { in: userIds } },
+          select: { id: true, name: true },
+        })
+        for (const u of users) nameById.set(u.id, u.name || u.id)
+      }
+
+      return NextResponse.json({
+        data: logs.map((l) => ({
+          ...l,
+          userName: l.userId ? (nameById.get(l.userId) ?? l.userId) : null,
+        })),
+        meta: {
+          total,
+          skip,
+          take,
+          hasMore: skip + take < total,
+          todayCount,
+          unresolvedCount,
+          moduleStats: moduleStats.map((m) => ({
+            module: m.module || "unknown",
+            count: m._count.module,
+          })),
+        },
+      })
+    } catch (error) {
+      return serverError(error, req, { message: "Không tải được nhật ký lỗi" })
+    }
+  },
+  { resource: "error-log", action: "view" },
+)
+
+/** Dọn log: ?mode=resolved (đã xử lý) hoặc ?mode=older_than&days=30. */
+export const DELETE = apiHandler(
+  async (req: NextRequest) => {
+    try {
+      const sp = new URL(req.url).searchParams
+      const mode = sp.get("mode")
+      const days = parseInt(sp.get("days") || "30", 10)
+
+      const where =
+        mode === "resolved"
+          ? { resolved: true }
+          : { createdAt: { lt: new Date(Date.now() - days * 864e5) } }
+
+      const { count } = await db.errorLog.deleteMany({ where })
+      return NextResponse.json({ success: true, deleted: count })
+    } catch (error) {
+      return serverError(error, req, { message: "Không xóa được nhật ký lỗi" })
+    }
+  },
+  { resource: "error-log", action: "delete" },
+)

package/templates/starter-app/src/app/api/files/[...key]/route.ts

@@ -0,0 +1,25 @@
+import { createFileProxyHandler } from "@/lib/storage"
+
+import { apiHandler } from "@/lib/api-handler"
+
+/**
+ * GET /api/files/[...key] — phục vụ tập tin từ kho qua app server.
+ *
+ * Đi qua app chứ không cho trình duyệt gọi thẳng vào kho, vì hai lẽ: MinIO/S3
+ * nội bộ thường không mở ra Internet, và mỗi object cần luật quyền riêng.
+ *
+ * Hiện tại chỉ gác PHIÊN. Khi kho có tập tin nhạy cảm, thêm seam `authorize`:
+ *
+ *   createFileProxyHandler<Session>({
+ *     authorize: ({ key, session }) => {
+ *       if (key.startsWith("hop-dong/")) {
+ *         return checkPermission(session, "contract", "view")
+ *       }
+ *       return true
+ *     },
+ *   })
+ *
+ * Trả `false` → 403; trả `{ status: 404 }` khi không muốn lộ cả sự tồn tại
+ * của key.
+ */
+export const GET = apiHandler<{ key: string[] }>(createFileProxyHandler())

package/templates/starter-app/src/app/api/notifications/read/route.ts

@@ -0,0 +1,29 @@
+import { NextResponse } from "next/server"
+
+import { apiHandler } from "@/lib/api-handler"
+import { serverError } from "@/lib/errors/server-error"
+import { markAllRead, markRead } from "@/server/services/notification-service"
+
+/**
+ * POST /api/notifications/read
+ *   { ids: string[] } → đánh dấu đã đọc các tin đó
+ *   { all: true }     → đánh dấu đã đọc tất cả
+ * Luôn scope theo session.user.id — không ai đọc hộ hộp thư người khác.
+ */
+export const POST = apiHandler(async (req, { session }) => {
+  try {
+    const body = await req.json().catch(() => ({}))
+    const userId = session.user.id
+
+    if (body?.all === true) {
+      return NextResponse.json({ count: await markAllRead(userId) })
+    }
+
+    const ids: string[] = Array.isArray(body?.ids)
+      ? body.ids.filter((id: unknown): id is string => typeof id === "string")
+      : []
+    return NextResponse.json({ count: await markRead(userId, ids) })
+  } catch (error) {
+    return serverError(error, req, { message: "Không cập nhật được thông báo" })
+  }
+})

package/templates/starter-app/src/app/api/notifications/route.ts

@@ -0,0 +1,26 @@
+import { NextResponse } from "next/server"
+
+import { apiHandler } from "@/lib/api-handler"
+import { serverError } from "@/lib/errors/server-error"
+import { listNotifications } from "@/server/services/notification-service"
+
+/**
+ * GET /api/notifications?cursor=&take=&filter=unread|all
+ * Hộp thư của CHÍNH người đang đăng nhập — luôn scope theo session.user.id,
+ * nên chỉ cần đăng nhập chứ không cần quyền trên resource nào.
+ */
+export const GET = apiHandler(async (req, { session }) => {
+  try {
+    const sp = new URL(req.url).searchParams
+    const takeRaw = Number(sp.get("take"))
+
+    const result = await listNotifications(session.user.id, {
+      cursor: sp.get("cursor") || undefined,
+      take: Number.isFinite(takeRaw) && takeRaw > 0 ? takeRaw : undefined,
+      filter: sp.get("filter") === "unread" ? "unread" : "all",
+    })
+    return NextResponse.json(result)
+  } catch (error) {
+    return serverError(error, req, { message: "Không tải được thông báo" })
+  }
+})

package/templates/starter-app/src/app/api/notifications/unread-count/route.ts

@@ -0,0 +1,14 @@
+import { NextResponse } from "next/server"
+
+import { apiHandler } from "@/lib/api-handler"
+import { serverError } from "@/lib/errors/server-error"
+import { getUnreadCount } from "@/server/services/notification-service"
+
+/** GET /api/notifications/unread-count → { count }. Endpoint nhẹ cho chuông poll. */
+export const GET = apiHandler(async (req, { session }) => {
+  try {
+    return NextResponse.json({ count: await getUnreadCount(session.user.id) })
+  } catch (error) {
+    return serverError(error, req, { message: "Không đếm được thông báo" })
+  }
+})

package/templates/starter-app/src/app/api/rbac/permissions-version/route.ts

@@ -0,0 +1,11 @@
+import { createPermissionsVersionHandler } from "@goerp/core/rbac/route-handlers"
+
+import { getSession } from "@/lib/auth"
+import { db } from "@/lib/prisma"
+
+/**
+ * GET /api/rbac/permissions-version — client poll (PermissionsVersionWatcher
+ * của core). Số version đổi ⇒ trình duyệt tự nạp lại phiên, nên admin sửa
+ * quyền là người dùng thấy ngay, không phải đăng xuất/đăng nhập lại.
+ */
+export const { GET } = createPermissionsVersionHandler({ prisma: db, getSession })

package/templates/starter-app/src/app/api/roles/[id]/route.ts

@@ -0,0 +1,14 @@
+import { getCrudPermissions } from "@goerp/core/crud/server"
+import { createRoleItemHandlers } from "@goerp/core/rbac/route-handlers"
+
+import { getSession } from "@/lib/auth"
+import { serverError } from "@/lib/errors/server-error"
+import { db } from "@/lib/prisma"
+
+/** GET / PUT (thay toàn bộ bộ quyền) / DELETE (chặn nếu còn người dùng). */
+export const { GET, PUT, DELETE } = createRoleItemHandlers({
+  prisma: db,
+  getSession,
+  getCrudPermissions,
+  onError: (error, req) => serverError(error, req, { message: "Lỗi xử lý vai trò" }),
+})

package/templates/starter-app/src/app/api/roles/route.ts

@@ -0,0 +1,18 @@
+import { getCrudPermissions } from "@goerp/core/crud/server"
+import { createRolesCollectionHandlers } from "@goerp/core/rbac/route-handlers"
+
+import { getSession } from "@/lib/auth"
+import { serverError } from "@/lib/errors/server-error"
+import { db } from "@/lib/prisma"
+
+/**
+ * GET (danh sách + số người dùng) và POST (tạo vai trò kèm bộ quyền) — cả hai
+ * đến từ factory của core, app chỉ tiêm prisma + nguồn session. Đổi vai trò
+ * cũng bump `permissions-version` để phiên đang mở tự nhận quyền mới.
+ */
+export const { GET, POST } = createRolesCollectionHandlers({
+  prisma: db,
+  getSession,
+  getCrudPermissions,
+  onError: (error, req) => serverError(error, req, { message: "Lỗi xử lý vai trò" }),
+})

package/templates/starter-app/src/app/api/tasks/[id]/download/route.ts

@@ -0,0 +1,52 @@
+import { NextResponse } from "next/server"
+
+import { apiHandler } from "@/lib/api-handler"
+import { serverError } from "@/lib/errors/server-error"
+import { db } from "@/lib/prisma"
+
+/**
+ * GET /api/tasks/[id]/download[?file=error] — tải file kết quả.
+ *
+ * CHỦ tác vụ mới tải được (`createdBy` trong mệnh đề where, không phải kiểm tra
+ * sau khi đọc): file xuất thường là dữ liệu kinh doanh, đừng để đoán id là lấy
+ * được. `?file=error` lấy file liệt kê dòng lỗi của tác vụ nhập.
+ */
+export const GET = apiHandler(async (req, { session, params }) => {
+  try {
+    const { id } = await params
+    const task = await db.backgroundTask.findFirst({
+      where: { id, createdBy: session.user.id },
+    })
+    if (!task || task.status !== "success") {
+      return NextResponse.json(
+        { error: "Không tìm thấy tác vụ hoặc tác vụ chưa hoàn tất" },
+        { status: 404 },
+      )
+    }
+
+    const result = (task.result ?? {}) as {
+      fileKey?: string
+      fileName?: string
+      contentType?: string
+      errorFileKey?: string
+      errorFileName?: string
+    }
+    const wantError = new URL(req.url).searchParams.get("file") === "error"
+    const fileKey = wantError ? result.errorFileKey : result.fileKey
+    const fileName = (wantError ? result.errorFileName : result.fileName) || "download"
+    if (!fileKey) {
+      return NextResponse.json({ error: "Tác vụ không có file kết quả" }, { status: 404 })
+    }
+
+    const { readTaskFile } = await import("@/server/tasks")
+    const buffer = await readTaskFile(fileKey)
+    return new NextResponse(new Uint8Array(buffer), {
+      headers: {
+        "Content-Type": result.contentType || "application/octet-stream",
+        "Content-Disposition": `attachment; filename="${encodeURIComponent(fileName)}"`,
+      },
+    })
+  } catch (error) {
+    return serverError(error, req, { message: "Không tải được file tác vụ" })
+  }
+})

package/templates/starter-app/src/app/api/tasks/route.ts

@@ -0,0 +1,37 @@
+import { NextResponse } from "next/server"
+
+import { apiHandler } from "@/lib/api-handler"
+import { serverError } from "@/lib/errors/server-error"
+import { db } from "@/lib/prisma"
+
+/**
+ * GET /api/tasks?take=20 — tác vụ nền của CHÍNH người đang đăng nhập, mới nhất
+ * trước. Không khai resource: đây là dữ liệu cá nhân, chỉ cần đăng nhập; phạm
+ * vi được ép bằng `createdBy` chứ không bằng quyền.
+ */
+export const GET = apiHandler(async (req, { session }) => {
+  try {
+    const takeRaw = Number(new URL(req.url).searchParams.get("take"))
+    const take = Number.isFinite(takeRaw) && takeRaw > 0 ? Math.min(takeRaw, 100) : 20
+
+    const tasks = await db.backgroundTask.findMany({
+      where: { createdBy: session.user.id },
+      orderBy: { createdAt: "desc" },
+      take,
+      select: {
+        id: true,
+        type: true,
+        title: true,
+        status: true,
+        progress: true,
+        result: true,
+        error: true,
+        createdAt: true,
+        finishedAt: true,
+      },
+    })
+    return NextResponse.json({ tasks })
+  } catch (error) {
+    return serverError(error, req, { message: "Không tải được danh sách tác vụ" })
+  }
+})

package/templates/starter-app/src/app/api/upload/route.ts

@@ -0,0 +1,15 @@
+import { createUploadHandler } from "@/lib/storage"
+
+import { apiHandler } from "@/lib/api-handler"
+
+/**
+ * POST /api/upload — nhận tập tin đính kèm, trả `{ url, key }`.
+ *
+ * Engine ở `@goerp/core/storage`: giới hạn 25MB, whitelist đuôi, làm sạch tên
+ * (giữ dấu tiếng Việt), gom theo thư mục ngày. URL trả về LUÔN là
+ * `/api/files/<key>` dù kho đang là đĩa local hay S3 — đổi kho về sau không
+ * làm hỏng URL đã lưu trong DB.
+ *
+ * Đổi hạn mức/định dạng: `createUploadHandler({ maxBytes, allowedExtensions })`.
+ */
+export const POST = apiHandler(createUploadHandler())

package/templates/starter-app/src/app/globals.css

@@ -0,0 +1,15 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+
+/* The whole design system (Radix → shadcn → Plane tokens, status, charts,
+   sidebar, scrollbar) comes from core in one import. */
+@import "@goerp/core/styles/base.css";
+
+/* Tailwind v4 must scan core's component classes (this app's own src is
+   auto-scanned). */
+@source "../../node_modules/@goerp/core/src/**/*.tsx";
+@source "../../node_modules/@goplusvn/core/src/**/*.tsx";
+
+/* App brand overrides. Core's default brand is indigo. Re-skin either here
+   statically, or at runtime via `branding.primaryColor` on <TenantProvider>. */
+/* :root { --primary: 262 83% 58%; --sidebar-background: 262 60% 20%; } */

package/templates/starter-app/src/app/layout.tsx

@@ -0,0 +1,16 @@
+import type { ReactNode } from "react"
+
+import "./globals.css"
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="vi" suppressHydrationWarning>
+      <body
+        suppressHydrationWarning
+        className="bg-background text-foreground antialiased"
+      >
+        {children}
+      </body>
+    </html>
+  )
+}

package/templates/starter-app/src/app/page.tsx

@@ -0,0 +1,8 @@
+import { redirect } from "next/navigation"
+
+import { i18n } from "@/configs/i18n"
+
+// Root → default locale. All app pages live under /[lang]/(main)/.
+export default function RootRedirect() {
+  redirect(`/${i18n.defaultLocale}`)
+}

package/templates/starter-app/src/components/layout/main-layout-wrapper.tsx

@@ -0,0 +1,30 @@
+'use client'
+
+import type { NavigationType } from '@goerp/core/types'
+import { NotificationBell } from '@goerp/core/notification/ui'
+import { MainLayout } from '@goerp/core/ui'
+
+export function MainLayoutWrapper({
+  children,
+  dictionary,
+  navigation,
+}: {
+  children: React.ReactNode
+  dictionary: Record<string, unknown>
+  navigation: NavigationType[]
+}) {
+  return (
+    <MainLayout
+      dictionary={dictionary}
+      navigation={navigation}
+      onGlobalSearch={async () => []}
+      searchResults={[]}
+      searchLoading={false}
+      // Chuông đọc /api/notifications* — bỏ prop này thì người dùng không có
+      // đường nào thấy thông báo mà notify() đã ghi.
+      notificationSlot={<NotificationBell />}
+    >
+      {children}
+    </MainLayout>
+  )
+}

package/templates/starter-app/src/configs/entities/department.config.ts

@@ -0,0 +1,24 @@
+import { departmentsConfig } from "@goerp/core/configs/entities"
+
+import type { EntityConfig } from "@goerp/core/types"
+
+const CRUD_ENDPOINT = "/api/crud/departments"
+
+/**
+ * Reuse core's canonical "Phòng ban" config; override only what's app-specific.
+ * Feed this to the core CRUD engine (@goerp/core/crud) to get a full
+ * table/form/import/export page for the Department entity.
+ */
+export const departmentConfig: EntityConfig = {
+  ...departmentsConfig,
+  // Trỏ vào route CRUD generic (/api/crud/[entity]) — được phục vụ bởi engine core
+  // qua src/lib/crud + src/app/api/crud. Đổi nếu bạn tự viết route riêng.
+  apiEndpoint: CRUD_ENDPOINT,
+  // Repoint the self-referencing "parent department" dropdown at the same
+  // generic endpoint (core's default points at /api/departments).
+  fields: departmentsConfig.fields.map((field) =>
+    field.dataSource?.type === "api"
+      ? { ...field, dataSource: { ...field.dataSource, endpoint: CRUD_ENDPOINT } }
+      : field,
+  ),
+}

package/templates/starter-app/src/configs/entities/index.ts

@@ -0,0 +1,13 @@
+import type { EntityConfig } from "@goerp/core/types"
+
+import { departmentConfig } from "./department.config"
+
+// Đăng ký entity → cấu hình. Khóa = số nhiều, khớp URL /crud/<key> + apiEndpoint.
+// Thêm entity mới: import config rồi thêm 1 dòng ở đây.
+export const entityConfigs: Record<string, EntityConfig> = {
+  departments: departmentConfig,
+}
+
+export function getEntityConfig(entity: string): EntityConfig | undefined {
+  return entityConfigs[entity]
+}

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

@@ -0,0 +1,12 @@
+export const i18n = {
+  defaultLocale: 'vi',
+  locales: ['vi', 'en'] as const,
+  localeDirection: {
+    vi: 'ltr',
+    en: 'ltr',
+  } as const,
+  localeNames: {
+    vi: 'vietnamese',
+    en: 'english',
+  } as const,
+} as const

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

@@ -0,0 +1,45 @@
+import masterDataPermissions from "./master-data.permissions"
+import systemPermissions from "./system.permissions"
+
+import type { FeaturePermissions, LookupPolicy, ResourceDeclaration } from "./types"
+
+export type { FeaturePermissions, LookupPolicy, ResourceDeclaration }
+
+/**
+ * Registry hợp nhất — thêm phân hệ mới thì import file khai báo và nối vào
+ * mảng dưới đây. Giữ file này DỮ LIỆU THUẦN (xem types.ts).
+ */
+export const permissionRegistry: readonly FeaturePermissions[] = [
+  systemPermissions,
+  masterDataPermissions,
+]
+
+const resourceByCode = new Map<string, ResourceDeclaration>()
+const featureByResourceCode = new Map<string, string>()
+for (const feature of permissionRegistry) {
+  for (const resource of feature.resources) {
+    const owner = featureByResourceCode.get(resource.code)
+    if (owner) {
+      // Trùng mã resource là lỗi cấu hình im lặng nguy hiểm nhất: hai phân hệ
+      // tưởng mình sở hữu cùng một quyền. Ném ngay lúc nạp module.
+      throw new Error(
+        `Permission registry: resource "${resource.code}" khai trùng ở "${feature.feature}" và "${owner}"`,
+      )
+    }
+    resourceByCode.set(resource.code, resource)
+    featureByResourceCode.set(resource.code, feature.feature)
+  }
+}
+
+export function getRegistryResource(code: string): ResourceDeclaration | undefined {
+  return resourceByCode.get(code)
+}
+
+export function getRegistryResourceCodes(): string[] {
+  return [...resourceByCode.keys()]
+}
+
+/** Resource nào cho phép mọi người đã đăng nhập đọc để đổ combo/picker. */
+export function isLookupOpenToAuthenticated(code: string): boolean {
+  return resourceByCode.get(code)?.lookupPolicy === "authenticated"
+}

package/templates/starter-app/src/configs/permissions/master-data.permissions.ts

@@ -0,0 +1,31 @@
+import type { FeaturePermissions } from "./types"
+
+/**
+ * Danh mục nghiệp vụ của app — MẪU. Xoá Department và khai resource của bạn
+ * theo đúng khuôn: mã resource ở đây phải trùng chuỗi bạn truyền vào
+ * checkPermission và trùng `permissionResource` trong EntityConfig, nếu không
+ * nút bấm sẽ ẩn vĩnh viễn mà không báo lỗi.
+ */
+const masterDataPermissions: FeaturePermissions = {
+  feature: "master-data",
+  description: "Danh mục dùng chung",
+  resources: [
+    {
+      code: "department",
+      name: "Phòng ban",
+      group: "Danh mục",
+      icon: "Building2",
+      order: 1,
+      actions: ["view", "create", "update", "delete", "export", "import"],
+      // Phòng ban xuất hiện trong nhiều combo (hồ sơ nhân sự, phân bổ chi phí…)
+      // nên cho mọi người đăng nhập đọc được danh sách để đổ picker.
+      lookupPolicy: "authenticated",
+      defaultGrants: {
+        admin: "*",
+        staff: ["view", "export"],
+      },
+    },
+  ],
+}
+
+export default masterDataPermissions