@goplusvn/core 0.1.70 → 0.1.71

package/templates/starter-app/src/app/[lang]/(main)/security/sessions/page.tsx

@@ -0,0 +1,24 @@
+import { SessionsPage } from "@goerp/core/security"
+
+import type { Metadata } from "next"
+
+import { requirePageAccess } from "@/lib/page-guard"
+
+export const metadata: Metadata = { title: "Quản lý phiên đăng nhập" }
+export const dynamic = "force-dynamic"
+
+/**
+ * Trang QUẢN TRỊ — quản lý phiên đăng nhập (Better Auth) của MỌI user.
+ * Màn hình sẵn của core; app chỉ gác quyền `user:view` (cùng resource với
+ * trang Người dùng) và cung cấp 3 endpoint /api/security/sessions.
+ */
+export default async function SecuritySessionsPage({
+  params,
+}: {
+  params: Promise<{ lang: string }>
+}) {
+  const { lang } = await params
+  await requirePageAccess(lang, "user")
+
+  return <SessionsPage />
+}

package/templates/starter-app/src/app/[lang]/(main)/system-categories/page.tsx

@@ -0,0 +1,30 @@
+import { SystemCategoryPage } from "@goerp/core/system/pages/system-category-page"
+import { getSystemCategoryGroupsData } from "@goerp/core/system/services/system-category-service"
+
+import type { Metadata } from "next"
+
+import { requirePageAccess } from "@/lib/page-guard"
+import { db } from "@/lib/prisma"
+
+export const metadata: Metadata = { title: "Danh mục hệ thống" }
+export const dynamic = "force-dynamic"
+
+/**
+ * Danh mục hệ thống — màn hình sẵn của core (sidebar nhóm + danh sách mục).
+ * Trang chỉ nạp danh sách nhóm ban đầu; mọi thao tác CRUD sau đó component
+ * core tự gọi /api/system-categories + /api/system-category-groups.
+ */
+export default async function SystemCategoriesPage({
+  params,
+}: {
+  params: Promise<{ lang: string }>
+}) {
+  const { lang } = await params
+  await requirePageAccess(lang, "system-category")
+
+  const { items: initialGroups } = await getSystemCategoryGroupsData(db, {
+    pageSize: 100, // nạp hết nhóm cho sidebar
+  })
+
+  return <SystemCategoryPage initialGroups={initialGroups} />
+}

package/templates/starter-app/src/app/[lang]/(main)/user/profile/actions.ts

@@ -0,0 +1,60 @@
+"use server"
+
+import { headers } from "next/headers"
+import { z } from "zod"
+
+import { getAuth } from "@/lib/better-auth"
+
+const schema = z
+  .object({
+    currentPassword: z.string().min(1, "Nhập mật khẩu hiện tại"),
+    newPassword: z.string().min(6, "Mật khẩu mới tối thiểu 6 ký tự"),
+    confirmPassword: z.string().min(1, "Nhập lại mật khẩu mới"),
+  })
+  .refine((d) => d.newPassword === d.confirmPassword, {
+    message: "Mật khẩu nhập lại không khớp",
+    path: ["confirmPassword"],
+  })
+
+export interface ChangePasswordState {
+  success?: boolean
+  message?: string
+}
+
+/**
+ * Đổi mật khẩu của CHÍNH người đang đăng nhập — đi qua Better Auth
+ * `changePassword` (tự verify mật khẩu cũ + hash bằng bcrypt đã cấu hình +
+ * thu hồi các phiên khác), không tự chế so bcrypt ở app.
+ */
+export async function changePassword(
+  _prev: ChangePasswordState,
+  formData: FormData,
+): Promise<ChangePasswordState> {
+  // Không getSession() trần ở đây (guardrail server-action-bare-session):
+  // auth.api.changePassword tự validate phiên từ headers — không phiên là ném.
+  const parsed = schema.safeParse({
+    currentPassword: formData.get("currentPassword"),
+    newPassword: formData.get("newPassword"),
+    confirmPassword: formData.get("confirmPassword"),
+  })
+  if (!parsed.success) {
+    return { message: parsed.error.issues[0]?.message ?? "Dữ liệu không hợp lệ" }
+  }
+
+  try {
+    await getAuth().api.changePassword({
+      headers: await headers(),
+      body: {
+        currentPassword: parsed.data.currentPassword,
+        newPassword: parsed.data.newPassword,
+        revokeOtherSessions: true,
+      },
+    })
+    return { success: true, message: "Đã đổi mật khẩu." }
+  } catch {
+    return {
+      message:
+        "Không đổi được mật khẩu — kiểm tra mật khẩu hiện tại, hoặc đăng nhập lại nếu phiên đã hết hạn.",
+    }
+  }
+}

package/templates/starter-app/src/app/[lang]/(main)/user/profile/page.tsx

@@ -0,0 +1,39 @@
+import { redirect } from "next/navigation"
+
+import type { Metadata } from "next"
+
+import { i18n } from "@/configs/i18n"
+import { getSession } from "@/lib/auth"
+import { db } from "@/lib/prisma"
+
+import { ProfileClientPage } from "./profile-client-page"
+
+export const metadata: Metadata = { title: "Hồ sơ cá nhân" }
+
+/**
+ * Hồ sơ NGƯỜI ĐANG ĐĂNG NHẬP — đích của mục "Hồ sơ" trong dropdown user của
+ * core MainLayout (/user/profile). Không cần quyền gì ngoài phiên hợp lệ:
+ * ai cũng được xem thông tin của chính mình.
+ */
+export default async function UserProfilePage() {
+  const session = await getSession()
+  if (!session?.user?.id) redirect(`/${i18n.defaultLocale}/sign-in`)
+
+  const user = await db.user.findUnique({
+    where: { id: session.user.id },
+    select: {
+      id: true,
+      name: true,
+      email: true,
+      image: true,
+      createdAt: true,
+      userRoles: { select: { roleCode: true, role: { select: { name: true } } } },
+      userBranches: {
+        select: { isDefault: true, branch: { select: { name: true } } },
+      },
+    },
+  })
+  if (!user) redirect(`/${i18n.defaultLocale}`)
+
+  return <ProfileClientPage user={user} />
+}

package/templates/starter-app/src/app/[lang]/(main)/user/profile/profile-client-page.tsx

@@ -0,0 +1,149 @@
+"use client"
+
+import * as React from "react"
+import { useActionState } from "react"
+import { toast } from "sonner"
+
+import {
+  Avatar,
+  AvatarFallback,
+  AvatarImage,
+  Badge,
+  Card,
+  CardContent,
+  CardHeader,
+  CardTitle,
+} from "@goerp/core/ui"
+import { Button } from "@goerp/core/ui/primitives/button"
+import { Input } from "@goerp/core/ui/primitives/input"
+import { Label } from "@goerp/core/ui/primitives/label"
+
+import { changePassword, type ChangePasswordState } from "./actions"
+
+interface ProfileUser {
+  id: string
+  name: string | null
+  email: string
+  image: string | null
+  createdAt: Date
+  userRoles: { roleCode: string; role: { name: string } }[]
+  userBranches: { isDefault: boolean; branch: { name: string } }[]
+}
+
+export function ProfileClientPage({ user }: { user: ProfileUser }) {
+  const [state, formAction, pending] = useActionState<
+    ChangePasswordState,
+    FormData
+  >(changePassword, {})
+  const formRef = React.useRef<HTMLFormElement>(null)
+
+  React.useEffect(() => {
+    if (!state.message) return
+    if (state.success) {
+      toast.success(state.message)
+      formRef.current?.reset()
+    } else {
+      toast.error(state.message)
+    }
+  }, [state])
+
+  return (
+    <div className="mx-auto flex w-full max-w-3xl flex-col gap-4 p-4 md:p-6">
+      <h1 className="text-2xl font-bold tracking-tight">Hồ sơ cá nhân</h1>
+
+      <Card>
+        <CardHeader>
+          <CardTitle>Thông tin chung</CardTitle>
+        </CardHeader>
+        <CardContent className="flex flex-col gap-6">
+          <div className="flex items-center gap-4">
+            <Avatar className="size-14">
+              <AvatarImage src={user.image ?? undefined} alt={user.name ?? ""} />
+              <AvatarFallback>
+                {(user.name ?? user.email).slice(0, 2).toUpperCase()}
+              </AvatarFallback>
+            </Avatar>
+            <div>
+              <p className="font-medium">{user.name ?? "—"}</p>
+              <p className="text-sm text-muted-foreground">{user.email}</p>
+            </div>
+          </div>
+          <div className="grid gap-6 md:grid-cols-2">
+            <div className="space-y-2">
+              <Label>Vai trò</Label>
+              <div className="flex flex-wrap gap-2">
+                {user.userRoles.length ? (
+                  user.userRoles.map((ur) => (
+                    <Badge key={ur.roleCode} variant="secondary">
+                      {ur.role.name}
+                    </Badge>
+                  ))
+                ) : (
+                  <span className="text-sm text-muted-foreground">—</span>
+                )}
+              </div>
+            </div>
+            <div className="space-y-2">
+              <Label>Chi nhánh</Label>
+              <div className="flex flex-wrap gap-2">
+                {user.userBranches.length ? (
+                  user.userBranches.map((ub, i) => (
+                    <Badge key={i} variant="secondary">
+                      {ub.branch.name}
+                      {ub.isDefault ? " (mặc định)" : ""}
+                    </Badge>
+                  ))
+                ) : (
+                  <span className="text-sm text-muted-foreground">—</span>
+                )}
+              </div>
+            </div>
+          </div>
+        </CardContent>
+      </Card>
+
+      <Card>
+        <CardHeader>
+          <CardTitle>Đổi mật khẩu</CardTitle>
+        </CardHeader>
+        <CardContent>
+          <form ref={formRef} action={formAction} className="grid gap-4 md:max-w-md">
+            <div className="space-y-2">
+              <Label htmlFor="currentPassword">Mật khẩu hiện tại</Label>
+              <Input
+                id="currentPassword"
+                name="currentPassword"
+                type="password"
+                autoComplete="current-password"
+                required
+              />
+            </div>
+            <div className="space-y-2">
+              <Label htmlFor="newPassword">Mật khẩu mới</Label>
+              <Input
+                id="newPassword"
+                name="newPassword"
+                type="password"
+                autoComplete="new-password"
+                required
+              />
+            </div>
+            <div className="space-y-2">
+              <Label htmlFor="confirmPassword">Nhập lại mật khẩu mới</Label>
+              <Input
+                id="confirmPassword"
+                name="confirmPassword"
+                type="password"
+                autoComplete="new-password"
+                required
+              />
+            </div>
+            <Button type="submit" disabled={pending} className="w-fit">
+              {pending ? "Đang cập nhật..." : "Đổi mật khẩu"}
+            </Button>
+          </form>
+        </CardContent>
+      </Card>
+    </div>
+  )
+}

package/templates/starter-app/src/app/[lang]/(main)/users/page.tsx

@@ -0,0 +1,68 @@
+import { getCrudPermissions } from "@goerp/core/crud/server"
+import { getActiveRoles, getUserStats } from "@goerp/core/user"
+import { UsersClientPage } from "@goerp/core/user/client-page"
+
+import type { Metadata } from "next"
+
+import { usersConfig } from "@/configs/entities/users.config"
+import { getActionMetaMap } from "@/configs/permissions"
+import { MENU_TREE } from "@/configs/permissions/menu-tree"
+import { dictionary } from "@/data/dictionary"
+import { requirePageAccess } from "@/lib/page-guard"
+import { db } from "@/lib/prisma"
+import { getUsersList } from "@/server/services/user-service"
+
+export const metadata: Metadata = { title: "Người dùng" }
+export const dynamic = "force-dynamic"
+
+interface UsersPageProps {
+  params: Promise<{ lang: string }>
+  searchParams: Promise<{ [key: string]: string | string[] | undefined }>
+}
+
+/**
+ * Quản lý người dùng — màn hình sẵn của core (UsersClientPage), trang chỉ nạp
+ * dữ liệu và truyền props. Danh sách lọc theo ?search&role&status trên URL
+ * (toolbar của core ghi query), phân trang chạy phía client.
+ *
+ * Tạo/sửa đi qua /api/users (POST/PUT) — UnifiedProfileDialog của core tự gọi;
+ * không truyền onAssignRoles/onResetPassword vì vai trò + mật khẩu đã nằm
+ * trong payload PUT (dialog gửi cả roleCodes/branchIds/password một lượt).
+ */
+export default async function UsersPage({
+  params,
+  searchParams,
+}: UsersPageProps) {
+  const { lang } = await params
+  const session = await requirePageAccess(lang, "user")
+
+  const sp = await searchParams
+  const search = typeof sp.search === "string" ? sp.search.trim() : undefined
+  const role = typeof sp.role === "string" ? sp.role : undefined
+  const status = typeof sp.status === "string" ? sp.status : undefined
+
+  const [permissions, users, roles, stats] = await Promise.all([
+    getCrudPermissions(session, "user"),
+    getUsersList({
+      search: search || undefined,
+      roleCode: role && role !== "all" ? role : undefined,
+      status,
+    }),
+    getActiveRoles(db),
+    getUserStats(db),
+  ])
+
+  return (
+    <UsersClientPage
+      initialData={users.data}
+      config={usersConfig}
+      // export tắt cứng — xem ghi chú trong users.config.ts.
+      permissions={{ ...permissions, export: false }}
+      dictionary={dictionary}
+      roles={roles}
+      stats={stats}
+      menuTree={MENU_TREE}
+      actionMeta={getActionMetaMap()}
+    />
+  )
+}

package/templates/starter-app/src/app/[lang]/[...not-found]/page.tsx

@@ -0,0 +1,9 @@
+import { notFound } from "next/navigation"
+
+/**
+ * URL gõ sai bất kỳ dưới /[lang] rơi vào catch-all này → kích hoạt
+ * [lang]/not-found.tsx thay vì trang trắng mặc định của Next.
+ */
+export default function CatchAllNotFound() {
+  notFound()
+}

package/templates/starter-app/src/app/[lang]/error.tsx

@@ -0,0 +1,26 @@
+"use client"
+
+import { ErrorView } from "@goerp/core/ui"
+
+/**
+ * Boundary bắt LỖI CỦA LAYOUT: error.tsx chỉ bọc children của segment chứa nó,
+ * nên lỗi ném từ (main)/layout.tsx phải leo lên đây mới có người bắt. Boundary
+ * này thay CẢ vỏ app → fullScreen.
+ */
+export default function LangError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string }
+  reset: () => void
+}) {
+  return (
+    <ErrorView
+      error={error}
+      reset={reset}
+      title="Không tải được dữ liệu"
+      description="Hệ thống chưa lấy được dữ liệu cho trang này. Đây là lỗi kỹ thuật tạm thời — quyền truy cập của bạn không thay đổi. Vui lòng thử lại; nếu vẫn lỗi, báo quản trị viên kèm mã lỗi bên dưới."
+      fullScreen
+    />
+  )
+}

package/templates/starter-app/src/app/[lang]/not-found.tsx

@@ -0,0 +1,9 @@
+import { NotFoundView } from "@goerp/core/ui"
+
+/**
+ * `notFound()` gọi từ trang NGOÀI vỏ app (không sidebar) rơi vào đây —
+ * chiếm trọn màn hình. Trang trong vỏ đã có (main)/not-found.tsx giữ lại.
+ */
+export default function LangNotFound() {
+  return <NotFoundView fullScreen />
+}

package/templates/starter-app/src/app/api/branches/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 { db } from "@/lib/prisma"
+
+/**
+ * Lookup chi nhánh cho picker (UnifiedProfileDialog của core fetch cứng
+ * /api/branches). Registry khai `branch` với lookupPolicy "authenticated" —
+ * đăng nhập là đọc được, nên KHÔNG gác resource/action (quyền `branch:view`
+ * chỉ gate trang quản lý chi nhánh, không gate combo).
+ *
+ * Fetcher của dialog nhận `{ data: [...] }` (data.items || data.data || mảng).
+ */
+export const GET = apiHandler(async (req) => {
+  try {
+    const branches = await db.branch.findMany({
+      where: { isActive: true },
+      select: { id: true, code: true, name: true },
+      orderBy: { name: "asc" },
+    })
+    return NextResponse.json({ data: branches })
+  } catch (error) {
+    return serverError(error, req, { message: "Lỗi tải danh sách chi nhánh" })
+  }
+})

package/templates/starter-app/src/app/api/departments/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 { db } from "@/lib/prisma"
+
+/**
+ * Lookup phòng ban cho picker (UnifiedProfileDialog của core fetch cứng
+ * /api/departments?status=active). Registry khai `department` với lookupPolicy
+ * "authenticated" nên chỉ cần đăng nhập, không gác resource/action.
+ *
+ * Trang quản lý phòng ban vẫn đi qua /api/crud/departments (CRUD engine) —
+ * route này CHỈ phục vụ combo.
+ */
+export const GET = apiHandler(async (req) => {
+  try {
+    const departments = await db.department.findMany({
+      where: { status: "active" },
+      select: { id: true, code: true, name: true },
+      orderBy: { order: "asc" },
+    })
+    return NextResponse.json({ data: departments })
+  } catch (error) {
+    return serverError(error, req, { message: "Lỗi tải danh sách phòng ban" })
+  }
+})

package/templates/starter-app/src/app/api/job-titles/route.ts

@@ -0,0 +1,46 @@
+import { NextResponse } from "next/server"
+
+import { apiHandler } from "@/lib/api-handler"
+import { db } from "@/lib/prisma"
+
+/**
+ * GET danh sách chức danh — endpoint đọc gọn cho picker/dataSource. Màn hình
+ * quản lý dùng CRUD generic (/crud/job-titles → /api/crud/job-titles).
+ */
+export const GET = apiHandler(
+  async (req) => {
+    const { searchParams } = new URL(req.url)
+    const page = Math.max(Number(searchParams.get("page") || 1), 1)
+    const pageSize = Math.min(Number(searchParams.get("pageSize") || 100), 100)
+    const search = (searchParams.get("q") || searchParams.get("search"))?.trim()
+    const status = searchParams.get("status")?.trim()
+
+    const where = {
+      AND: [
+        search
+          ? {
+              OR: [
+                { code: { contains: search, mode: "insensitive" as const } },
+                { name: { contains: search, mode: "insensitive" as const } },
+              ],
+            }
+          : {},
+        status && status !== "all" ? { status } : {},
+      ],
+    }
+
+    const [total, items] = await Promise.all([
+      db.jobTitle.count({ where }),
+      db.jobTitle.findMany({
+        where,
+        orderBy: [{ level: "desc" }, { name: "asc" }],
+        skip: (page - 1) * pageSize,
+        take: pageSize,
+      }),
+    ])
+
+    return NextResponse.json({ total, page, pageSize, items })
+  },
+  // Combo tra cứu — registry khai lookupPolicy "authenticated" cho job-title:
+  // ai đăng nhập cũng đổ được picker, không đòi quyền view của trang quản lý.
+)

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

@@ -0,0 +1,52 @@
+import { NextResponse } from "next/server"
+import { checkPermission } from "@goerp/core/auth"
+
+import { apiHandler } from "@/lib/api-handler"
+import { getAuth } from "@/lib/better-auth"
+import { serverError } from "@/lib/errors/server-error"
+import { db } from "@/lib/prisma"
+
+/**
+ * DELETE /api/security/sessions/[id] — thu hồi 1 phiên đăng nhập.
+ * - Phiên của mình: được thu hồi (trừ phiên HIỆN TẠI — dùng nút Đăng xuất).
+ * - Phiên user khác: cần quyền user:update (thao tác quản trị).
+ * Xóa row `sessions` = phiên chết ngay (session DB-backed).
+ */
+export const DELETE = apiHandler(async (req, { session, params }) => {
+  try {
+    const { id } = await params
+    const row = await db.session.findUnique({
+      where: { id },
+      select: { id: true, userId: true, token: true },
+    })
+    if (!row) {
+      return NextResponse.json(
+        { error: "Phiên không tồn tại" },
+        { status: 404 },
+      )
+    }
+
+    const isMine = row.userId === session.user.id
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    if (!isMine && !checkPermission(session as Parameters<typeof checkPermission>[0], "user", "update")) {
+      return NextResponse.json(
+        { error: "Bạn không có quyền thu hồi phiên của người dùng khác" },
+        { status: 403 },
+      )
+    }
+
+    // Không tự thu hồi phiên đang dùng (tránh tự bắn vào chân — dùng Đăng xuất)
+    const current = await getAuth().api.getSession({ headers: req.headers })
+    if (current?.session?.token && row.token === current.session.token) {
+      return NextResponse.json(
+        { error: "Không thể thu hồi phiên hiện tại — hãy dùng Đăng xuất" },
+        { status: 400 },
+      )
+    }
+
+    await db.session.delete({ where: { id } })
+    return NextResponse.json({ ok: true })
+  } catch (error) {
+    return serverError(error, req, { message: "Không thu hồi được phiên" })
+  }
+})

package/templates/starter-app/src/app/api/security/sessions/revoke-user/route.ts

@@ -0,0 +1,44 @@
+import { NextResponse } from "next/server"
+
+import { apiHandler } from "@/lib/api-handler"
+import { getAuth } from "@/lib/better-auth"
+import { serverError } from "@/lib/errors/server-error"
+import { db } from "@/lib/prisma"
+
+/**
+ * POST /api/security/sessions/revoke-user — QUẢN TRỊ: đăng xuất MỌI thiết bị
+ * của 1 người dùng (xóa toàn bộ row `sessions` của user đó → chết ngay).
+ * - Cần user:update (thao tác quản trị).
+ * - Nếu tự thu hồi chính mình: giữ lại phiên HIỆN TẠI (không tự bắn văng).
+ * Dùng khi: nghi ngờ lộ tài khoản, thu máy, cho nghỉ việc...
+ */
+export const POST = apiHandler(
+  async (req, { session }) => {
+    try {
+      const body = await req.json().catch(() => null)
+      const userId = typeof body?.userId === "string" ? body.userId : ""
+      if (!userId) {
+        return NextResponse.json({ error: "Thiếu userId" }, { status: 400 })
+      }
+
+      // Tự thu hồi chính mình → chừa phiên hiện tại
+      let excludeToken: string | undefined
+      if (userId === session.user.id) {
+        const current = await getAuth().api.getSession({ headers: req.headers })
+        excludeToken = current?.session?.token ?? undefined
+      }
+
+      const r = await db.session.deleteMany({
+        where: {
+          userId,
+          ...(excludeToken ? { token: { not: excludeToken } } : {}),
+        },
+      })
+
+      return NextResponse.json({ revoked: r.count })
+    } catch (error) {
+      return serverError(error, req, { message: "Không thu hồi được phiên" })
+    }
+  },
+  { resource: "user", action: "update" },
+)