@goplusvn/core 0.1.59 → 0.1.61

package/templates/starter-app/prisma/migrations/20260801091818_goerp_system_jobs_0001_init/migration.sql

@@ -0,0 +1,47 @@
+-- goerp feature: system-jobs — bước 0001 (idempotent). 2 bảng cho engine cron
+-- có trạng thái DB (@goerp/core/cron, configureCronManager) + trang admin
+-- SystemJobsPage: cấu hình job (bật/tắt, lịch) và lịch sử từng lần chạy.
+-- Tên index/constraint giữ đúng bản Prisma sinh ra để app đã có bảng (vinhhoa)
+-- chạy lại là no-op, không đẻ index trùng.
+CREATE TABLE IF NOT EXISTS "system_jobs" (
+    "id" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "cron_time" TEXT NOT NULL,
+    "enabled" BOOLEAN NOT NULL DEFAULT true,
+    "last_run" TIMESTAMP(3),
+    "next_run" TIMESTAMP(3),
+    "status" TEXT NOT NULL DEFAULT 'idle',
+    "error" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+    "metadata" JSONB,
+
+    CONSTRAINT "system_jobs_pkey" PRIMARY KEY ("id")
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS "system_jobs_name_key" ON "system_jobs"("name");
+
+CREATE TABLE IF NOT EXISTS "job_execution_logs" (
+    "id" TEXT NOT NULL,
+    "job_name" TEXT NOT NULL,
+    "started_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "finished_at" TIMESTAMP(3),
+    "duration_ms" INTEGER,
+    "status" TEXT NOT NULL DEFAULT 'running',
+    "error" TEXT,
+    "actions" JSONB,
+    "summary" TEXT,
+
+    CONSTRAINT "job_execution_logs_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX IF NOT EXISTS "job_execution_logs_job_name_idx" ON "job_execution_logs"("job_name");
+CREATE INDEX IF NOT EXISTS "job_execution_logs_started_at_idx" ON "job_execution_logs"("started_at");
+
+-- FK: PG không có ADD CONSTRAINT IF NOT EXISTS → DO-block kiểm tra pg_constraint.
+DO $$ BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'job_execution_logs_job_name_fkey') THEN
+    ALTER TABLE "job_execution_logs" ADD CONSTRAINT "job_execution_logs_job_name_fkey"
+      FOREIGN KEY ("job_name") REFERENCES "system_jobs"("name") ON DELETE CASCADE ON UPDATE CASCADE;
+  END IF;
+END $$;

package/templates/starter-app/prisma/schema/auth.prisma

@@ -0,0 +1,87 @@
+// ============================================================
+// NGƯỜI DÙNG + BẢNG CỦA BETTER AUTH
+//
+// Better Auth cần đúng 4 model: User, Session, Account, Verification.
+// Tên model map trong src/lib/better-auth.ts. App greenfield đặt tên bảng
+// gọn (`sessions`/`accounts`); app migrate từ NextAuth thì thêm tiền tố
+// (vinhhoa dùng `ba_*`) để chạy song song rồi mới drop bảng cũ.
+//
+// `password` nằm ở Account (providerId="credential") — đó là nơi Better Auth
+// đọc/ghi. Đừng tự thêm cột password vào User rồi tự so bcrypt.
+// ============================================================
+
+model User {
+  id            String    @id @default(cuid()) @map("id")
+  email         String    @unique @map("email")
+  name          String?   @map("name")
+  image         String?   @map("image")
+  emailVerified Boolean   @default(false) @map("email_verified")
+  isActive      Boolean   @default(true) @map("is_active")
+  lastLoginAt   DateTime? @map("last_login_at")
+  createdAt     DateTime  @default(now()) @map("created_at")
+  updatedAt     DateTime  @updatedAt @map("updated_at")
+
+  accounts     Account[]
+  sessions     Session[]
+  userRoles    UserRole[]
+  userBranches UserBranch[]
+
+  // Back-relation của các feature core (goerp-*.prisma). Prisma bắt buộc khai
+  // hai chiều — bỏ feature nào thì xóa dòng tương ứng, thêm feature nào thì
+  // đọc features/<name>/README.md trong core xem cần thêm dòng gì.
+  notifications     Notification[]
+  pushSubscriptions PushSubscription[]
+  auditLogs         AuditLog[]
+
+  @@index([email])
+  @@index([isActive])
+  @@map("users")
+}
+
+model Session {
+  id        String   @id @default(cuid()) @map("id")
+  userId    String   @map("user_id")
+  token     String   @unique @map("token")
+  expiresAt DateTime @map("expires_at")
+  ipAddress String?  @map("ip_address")
+  userAgent String?  @map("user_agent")
+  createdAt DateTime @default(now()) @map("created_at")
+  updatedAt DateTime @updatedAt @map("updated_at")
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@map("sessions")
+}
+
+model Account {
+  id                    String    @id @default(cuid()) @map("id")
+  userId                String    @map("user_id")
+  accountId             String    @map("account_id")
+  providerId            String    @map("provider_id")
+  password              String?   @map("password")
+  accessToken           String?   @map("access_token")
+  refreshToken          String?   @map("refresh_token")
+  idToken               String?   @map("id_token")
+  accessTokenExpiresAt  DateTime? @map("access_token_expires_at")
+  refreshTokenExpiresAt DateTime? @map("refresh_token_expires_at")
+  scope                 String?   @map("scope")
+  createdAt             DateTime  @default(now()) @map("created_at")
+  updatedAt             DateTime  @updatedAt @map("updated_at")
+  user                  User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([providerId, accountId])
+  @@index([userId])
+  @@map("accounts")
+}
+
+model Verification {
+  id         String   @id @default(cuid()) @map("id")
+  identifier String   @map("identifier")
+  value      String   @map("value")
+  expiresAt  DateTime @map("expires_at")
+  createdAt  DateTime @default(now()) @map("created_at")
+  updatedAt  DateTime @updatedAt @map("updated_at")
+
+  @@index([identifier])
+  @@map("verifications")
+}

package/templates/starter-app/prisma/schema/domain.prisma

@@ -0,0 +1,24 @@
+// ============================================================
+// NGHIỆP VỤ CỦA APP — chỗ duy nhất bạn thật sự phải viết.
+//
+// Department ở đây chỉ là ví dụ mẫu, đi kèm
+// src/configs/entities/department.config.ts và phục vụ ở /crud/departments.
+// Xóa nó đi và khai model của mình theo đúng khuôn: mỗi entity một
+// EntityConfig, một dòng trong CRUD model map, một mục navigation, một
+// resource trong Permission Registry.
+// ============================================================
+
+model Department {
+  id          String   @id @default(cuid()) @map("id")
+  code        String   @unique @map("code")
+  name        String   @map("name")
+  description String?  @map("description")
+  parentId    String?  @map("parent_id")
+  order       Int      @default(0) @map("order")
+  status      String   @default("active") @map("status")
+  createdAt   DateTime @default(now()) @map("created_at")
+  updatedAt   DateTime @updatedAt @map("updated_at")
+
+  @@index([status])
+  @@map("departments")
+}

package/templates/starter-app/prisma/schema/goerp-audit-logs.prisma

@@ -0,0 +1,23 @@
+// GENERATED từ @goerp/core (features/audit-logs/schema.prisma) — ĐỪNG sửa tay.
+// Nâng cấp core xong chạy: pnpm goerp-features sync
+
+model AuditLog {
+  id          String   @id @default(cuid()) @map("id")
+  userId      String?  @map("user_id")
+  action      String   @map("action")
+  resource    String   @map("resource")
+  resourceId  String?  @map("resource_id")
+  oldData     Json?    @map("old_data")
+  newData     Json?    @map("new_data")
+  ipAddress   String?  @map("ip_address")
+  userAgent   String?  @map("user_agent")
+  description String?  @map("description")
+  createdAt   DateTime @default(now()) @map("created_at")
+  user        User?    @relation(fields: [userId], references: [id])
+
+  @@index([userId])
+  @@index([action])
+  @@index([resource])
+  @@index([createdAt])
+  @@map("audit_logs")
+}

package/templates/starter-app/prisma/schema/goerp-background-tasks.prisma

@@ -0,0 +1,25 @@
+// GENERATED từ @goerp/core (features/background-tasks/schema.prisma) — ĐỪNG sửa tay.
+// Nâng cấp core xong chạy: pnpm goerp-features sync
+
+// Tác vụ nền (export/import lớn…): hàng đợi trong DB, worker in-process.
+// status: pending → running → success | error.
+// result: { fileKey?, fileName?, rowCount?, errorFileKey?, summary? }.
+model BackgroundTask {
+  id         String    @id @default(cuid()) @map("id")
+  type       String    @map("type")
+  title      String    @map("title")
+  status     String    @default("pending") @map("status")
+  progress   Int       @default(0) @map("progress")
+  params     Json?     @map("params")
+  result     Json?     @map("result")
+  error      String?   @map("error")
+  createdBy  String    @map("created_by")
+  branchId   String?   @map("branch_id")
+  createdAt  DateTime  @default(now()) @map("created_at")
+  startedAt  DateTime? @map("started_at")
+  finishedAt DateTime? @map("finished_at")
+
+  @@index([createdBy, createdAt])
+  @@index([status])
+  @@map("background_tasks")
+}

package/templates/starter-app/prisma/schema/goerp-error-logs.prisma

@@ -0,0 +1,31 @@
+// GENERATED từ @goerp/core (features/error-logs/schema.prisma) — ĐỪNG sửa tay.
+// Nâng cấp core xong chạy: pnpm goerp-features sync
+
+model ErrorLog {
+  id              String   @id @default(dbgenerated("gen_random_uuid()")) @map("id")
+  errorId         String   @map("error_id")
+  fingerprint     String?  @map("fingerprint")
+  code            String?  @map("code")
+  message         String   @map("message")
+  detail          String?  @map("detail")
+  context         String?  @map("context")
+  module          String?  @map("module")
+  userId          String?  @map("user_id")
+  url             String?  @map("url")
+  userAgent       String?  @map("user_agent")
+  severity        String   @default("error") @map("severity")
+  resolved        Boolean  @default(false) @map("resolved")
+  occurrenceCount Int      @default(1) @map("occurrence_count")
+  lastSeenAt      DateTime @default(now()) @map("last_seen_at") @db.Timestamptz(6)
+  createdAt       DateTime @default(now()) @map("created_at") @db.Timestamptz(6)
+
+  @@index([code], map: "idx_error_logs_code")
+  @@index([createdAt], map: "idx_error_logs_created_at")
+  @@index([errorId], map: "idx_error_logs_error_id")
+  @@index([fingerprint], map: "idx_error_logs_fingerprint")
+  @@index([module], map: "idx_error_logs_module")
+  @@index([resolved], map: "idx_error_logs_resolved")
+  @@index([severity], map: "idx_error_logs_severity")
+  @@index([userId], map: "idx_error_logs_user_id")
+  @@map("error_logs")
+}

package/templates/starter-app/prisma/schema/goerp-notifications.prisma

@@ -0,0 +1,49 @@
+// GENERATED từ @goerp/core (features/notifications/schema.prisma) — ĐỪNG sửa tay.
+// Nâng cấp core xong chạy: pnpm goerp-features sync
+
+/// Thông báo in-app cho NHÂN VIÊN (khác ZaloNotification / TriAnhZnsMessage — đó
+/// là ZNS gửi KHÁCH). Mỗi row là 1 tin gửi tới 1 user (fan-out ở tầng service,
+/// không broadcast 1-row-nhiều-người). Best-effort: emit không được chặn nghiệp vụ.
+model Notification {
+  id           String    @id @default(cuid()) @map("id")
+  userId       String    @map("user_id") // người NHẬN
+  type         String    @default("info") @map("type") // info | success | warning | error | approval
+  category     String?   @map("category") // sales-order | payment | payment-request | misa | purchase-order | system
+  title        String    @map("title")
+  content      String    @map("content") @db.Text
+  url          String?   @map("url") // deep-link tới đối tượng
+  iconName     String?   @map("icon_name") // lucide icon cho dropdown
+  resourceType String?   @map("resource_type") // "SalesOrder" | "PaymentRequest" | "PurchaseOrder"…
+  resourceId   String?   @map("resource_id")
+  isRead       Boolean   @default(false) @map("is_read")
+  readAt       DateTime? @map("read_at")
+  createdBy    String?   @map("created_by") // actor gây ra sự kiện (null = hệ thống)
+  meta         Json?     @map("meta")
+  createdAt    DateTime  @default(now()) @map("created_at")
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId, isRead])
+  @@index([userId, createdAt])
+  @@index([resourceType, resourceId])
+  @@map("notifications")
+}
+
+/// Web Push subscription của 1 thiết bị (PWA iOS/Android/desktop). 1 user nhiều
+/// row = nhiều thiết bị. `endpoint` (URL APNs/FCM) là khoá dedup tự nhiên; push
+/// service trả 404/410 → XÓA row (chuẩn giao thức), không dùng cờ active.
+model PushSubscription {
+  id        String   @id @default(cuid()) @map("id")
+  userId    String   @map("user_id")
+  endpoint  String   @unique @map("endpoint")
+  p256dh    String   @map("p256dh") // khoá mã hoá payload (từ PushSubscription.toJSON)
+  auth      String   @map("auth")
+  userAgent String?  @map("user_agent") // nhận diện thiết bị khi user quản lý danh sách
+  createdAt DateTime @default(now()) @map("created_at")
+  updatedAt DateTime @updatedAt @map("updated_at")
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@map("push_subscriptions")
+}

package/templates/starter-app/prisma/schema/goerp-system-jobs.prisma

@@ -0,0 +1,45 @@
+// GENERATED từ @goerp/core (features/system-jobs/schema.prisma) — ĐỪNG sửa tay.
+// Nâng cấp core xong chạy: pnpm goerp-features sync
+
+/// Job định kỳ có TRẠNG THÁI TRONG DB (engine `@goerp/core/cron`). DB là nguồn
+/// sự thật của cờ enabled + lịch chạy: admin tắt job thì deploy mới không tự
+/// bật lại, và restart tiến trình không mất cấu hình. `name` trùng tên đăng ký
+/// trong code (`cronManager.addJob({ name })`) nên là khoá tự nhiên.
+model SystemJob {
+  id            String            @id @default(cuid()) @map("id")
+  name          String            @unique @map("name")
+  cronTime      String            @map("cron_time") // "5m" | "1h" | "0 * * * *"
+  enabled       Boolean           @default(true) @map("enabled")
+  lastRun       DateTime?         @map("last_run")
+  nextRun       DateTime?         @map("next_run")
+  status        String            @default("idle") @map("status") // idle | running | failed
+  error         String?           @map("error") // lỗi lần chạy gần nhất (xoá khi chạy lại được)
+  createdAt     DateTime          @default(now()) @map("created_at")
+  updatedAt     DateTime          @updatedAt @map("updated_at")
+  metadata      Json?             @map("metadata")
+  executionLogs JobExecutionLog[]
+
+  @@map("system_jobs")
+}
+
+/// Một LẦN chạy của job: mở row lúc bắt đầu (status=running) và đóng lúc kết
+/// thúc. `actions` là nhật ký diễn biến do chính job ghi qua
+/// `getJobExecutionContext().log()` — thứ giúp admin biết job "chạy rồi" đã
+/// làm được gì, không chỉ thành công/thất bại.
+model JobExecutionLog {
+  id         String    @id @default(cuid()) @map("id")
+  jobName    String    @map("job_name")
+  startedAt  DateTime  @default(now()) @map("started_at")
+  finishedAt DateTime? @map("finished_at")
+  durationMs Int?      @map("duration_ms")
+  status     String    @default("running") @map("status") // running | success | failed
+  error      String?   @map("error")
+  actions    Json?     @map("actions") // [{ time, action, details? }]
+  summary    String?   @map("summary")
+
+  job SystemJob @relation(fields: [jobName], references: [name], onDelete: Cascade)
+
+  @@index([jobName])
+  @@index([startedAt])
+  @@map("job_execution_logs")
+}

package/templates/starter-app/prisma/schema/organization.prisma

@@ -0,0 +1,31 @@
+// Chi nhánh + gán người dùng vào chi nhánh. Giữ ngay từ đầu dù app một chi
+// nhánh: thêm sau thì phải sửa lại mọi chứng từ đã phát sinh. `isDefault`
+// quyết định chi nhánh mở sẵn khi đăng nhập.
+model Branch {
+  id        String   @id @default(cuid()) @map("id")
+  code      String   @unique @map("code")
+  name      String   @map("name")
+  address   String?  @map("address")
+  phone     String?  @map("phone")
+  isActive  Boolean  @default(true) @map("is_active")
+  createdAt DateTime @default(now()) @map("created_at")
+  updatedAt DateTime @updatedAt @map("updated_at")
+
+  userBranches UserBranch[]
+
+  @@map("branches")
+}
+
+model UserBranch {
+  id        String   @id @default(cuid()) @map("id")
+  userId    String   @map("user_id")
+  branchId  String   @map("branch_id")
+  isDefault Boolean  @default(false) @map("is_default")
+  createdAt DateTime @default(now()) @map("created_at")
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  branch    Branch   @relation(fields: [branchId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, branchId])
+  @@index([userId])
+  @@map("user_branches")
+}

package/templates/starter-app/prisma/schema/rbac.prisma

@@ -0,0 +1,100 @@
+// ============================================================
+// RBAC — HÌNH DẠNG BẮT BUỘC, core đọc thẳng mấy model này.
+//
+// `@goerp/core/rbac` query đúng chuỗi:
+//   userRole.findMany({ where: { userId }, select: { roleCode, role: {
+//     select: { rolePermissions: { select: { resourceCode, actionCode } } } } } })
+// Đổi tên field/model ở đây là gãy permission-service, RoleListPage và
+// createRolesCollectionHandlers. Tên BẢNG thì đổi thoải mái qua @@map.
+//
+// Quyền = cặp (resourceCode, actionCode) gán cho ROLE, người dùng nhận qua
+// UserRole. Không có bảng "quyền gán thẳng cho user" — cố tình, để chỗ cấp
+// quyền chỉ có một.
+// ============================================================
+
+model Role {
+  id          String   @id @default(cuid()) @map("id")
+  code        String   @unique @map("code")
+  name        String   @unique @map("name")
+  description String   @default("") @map("description")
+  status      String   @default("active") @map("status")
+  createdAt   DateTime @default(now()) @map("created_at")
+  createdBy   String   @default("system") @map("created_by")
+  updatedAt   DateTime @updatedAt @map("updated_at")
+  updatedBy   String   @default("system") @map("updated_by")
+
+  rolePermissions RolePermission[]
+  userRoles       UserRole[]
+
+  @@index([code])
+  @@index([status])
+  @@map("roles")
+}
+
+model Resource {
+  id          String   @id @default(cuid()) @map("id")
+  code        String   @unique @map("code")
+  name        String   @map("name")
+  group       String?  @map("group")
+  description String?  @map("description")
+  status      String   @default("active") @map("status")
+  parentCode  String?  @map("parent_code")
+  order       Int?     @map("order")
+  type        String?  @map("type")
+  icon        String?  @map("icon")
+  path        String?  @map("path")
+  // JSON chuỗi. Khóa `actions` = danh sách hành động HIỆN trên ma trận phân
+  // quyền của core cho resource này; scripts/rbac-sync.ts ghi khóa đó từ
+  // registry và giữ nguyên các khóa admin tự thêm.
+  config      String?  @map("config")
+  createdAt   DateTime @default(now()) @map("created_at")
+  updatedAt   DateTime @updatedAt @map("updated_at")
+
+  rolePermissions RolePermission[]
+
+  @@map("resources")
+}
+
+model Action {
+  id          String   @id @default(cuid()) @map("id")
+  code        String   @unique @map("code")
+  name        String   @map("name")
+  description String?  @map("description")
+  status      String   @default("active") @map("status")
+  isDefault   Boolean  @default(false) @map("is_default")
+  createdAt   DateTime @default(now()) @map("created_at")
+  updatedAt   DateTime @updatedAt @map("updated_at")
+
+  rolePermissions RolePermission[]
+
+  @@map("actions")
+}
+
+model RolePermission {
+  id           String   @id @default(cuid()) @map("id")
+  roleCode     String   @map("role_code")
+  resourceCode String   @map("resource_code")
+  actionCode   String   @map("action_code")
+  role         Role     @relation(fields: [roleCode], references: [code], onDelete: Cascade)
+  resource     Resource @relation(fields: [resourceCode], references: [code], onDelete: Cascade)
+  action       Action   @relation(fields: [actionCode], references: [code], onDelete: Cascade)
+
+  @@unique([roleCode, resourceCode, actionCode])
+  @@index([roleCode])
+  @@map("role_permissions")
+}
+
+model UserRole {
+  id        String   @id @default(cuid()) @map("id")
+  userId    String   @map("user_id")
+  roleCode  String   @map("role_code")
+  isPrimary Boolean  @default(false) @map("is_primary")
+  createdAt DateTime @default(now()) @map("created_at")
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  role      Role     @relation(fields: [roleCode], references: [code], onDelete: Cascade)
+
+  @@unique([userId, roleCode])
+  @@index([userId])
+  @@index([roleCode])
+  @@map("user_roles")
+}

package/templates/starter-app/prisma/schema/schema.prisma

@@ -0,0 +1,8 @@
+// Datasource + generator. URL nằm ở prisma.config.ts (Prisma 7), không ở đây.
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+}

package/templates/starter-app/prisma/schema/system.prisma

@@ -0,0 +1,22 @@
+// Kho cấu hình key/value của app. `@goerp/core/system/services/settings-service`
+// đọc/ghi thẳng model này (findUnique theo `key`, upsert `value`) — nối dây một
+// lần bằng configureSettingsService(db) trong src/lib/prisma.ts.
+model SystemConfig {
+  id          String   @id @default(cuid()) @map("id")
+  key         String   @unique @map("key")
+  value       String   @map("value")
+  type        String   @default("string") @map("type")
+  category    String   @default("general") @map("category")
+  description String?  @map("description")
+  isReadOnly  Boolean  @default(false) @map("is_read_only")
+  // Giá trị nhạy cảm (API key, secret): API che thành •••••••• khi trả về danh
+  // sách. Giao diện cấu hình của core đọc cờ này để hiện ô dạng mật khẩu.
+  isEncrypted Boolean  @default(false) @map("is_encrypted")
+  status      String   @default("active") @map("status")
+  createdAt   DateTime @default(now()) @map("created_at")
+  createdBy   String   @default("system") @map("created_by")
+  updatedAt   DateTime @updatedAt @map("updated_at")
+  updatedBy   String   @default("system") @map("updated_by")
+
+  @@map("system_configs")
+}

package/templates/starter-app/prisma/seed.ts

@@ -0,0 +1,127 @@
+/**
+ * Seed dữ liệu khởi tạo — chạy được nhiều lần (toàn upsert).
+ *
+ *   pnpm prisma:deploy && pnpm rbac-sync && pnpm seed
+ *
+ * Phân công rõ ràng: `rbac-sync` sở hữu resource/action/grant mặc định (đọc từ
+ * Permission Registry); file này chỉ tạo những thứ registry không biết —
+ * VAI TRÒ, tài khoản quản trị, chi nhánh, cấu hình và vài dòng dữ liệu mẫu.
+ * Vì vậy hãy chạy rbac-sync TRƯỚC seed ở lần đầu... nhưng grant mặc định cần
+ * vai trò tồn tại sẵn, nên seed cũng tạo vai trò và bạn chạy rbac-sync lần nữa
+ * sau seed. Thứ tự an toàn nhất: seed → rbac-sync.
+ */
+
+import { PrismaPg } from "@prisma/adapter-pg"
+import { PrismaClient } from "@prisma/client"
+import bcrypt from "bcryptjs"
+import "dotenv/config"
+
+const connectionString = process.env.DATABASE_URL
+if (!connectionString) throw new Error("DATABASE_URL chưa được set (xem .env.example)")
+const prisma = new PrismaClient({ adapter: new PrismaPg({ connectionString }) })
+
+const ADMIN_EMAIL = process.env.SEED_ADMIN_EMAIL ?? "admin@example.com"
+const ADMIN_PASSWORD = process.env.SEED_ADMIN_PASSWORD ?? "admin123"
+
+async function main() {
+  // ── Vai trò ────────────────────────────────────────────────────────────
+  // "admin" là mã core coi là toàn quyền (ADMIN_ROLE_CODE) — đổi mã này thì
+  // phải đổi cả trong core, đừng đổi.
+  const roles = [
+    { code: "admin", name: "Quản trị hệ thống", description: "Toàn quyền" },
+    { code: "staff", name: "Nhân viên", description: "Quyền xem cơ bản" },
+  ]
+  for (const r of roles) {
+    await prisma.role.upsert({ where: { code: r.code }, update: {}, create: r })
+  }
+  console.log(`✓ ${roles.length} vai trò`)
+
+  // ── Chi nhánh ──────────────────────────────────────────────────────────
+  const branch = await prisma.branch.upsert({
+    where: { code: "HQ" },
+    update: {},
+    create: { code: "HQ", name: "Trụ sở chính" },
+  })
+  console.log(`✓ chi nhánh ${branch.code}`)
+
+  // ── Tài khoản quản trị ─────────────────────────────────────────────────
+  const admin = await prisma.user.upsert({
+    where: { email: ADMIN_EMAIL },
+    update: {},
+    create: {
+      email: ADMIN_EMAIL,
+      name: "Quản trị viên",
+      emailVerified: true,
+      isActive: true,
+    },
+  })
+
+  // Mật khẩu nằm ở Account với providerId="credential" — đó là nơi DUY NHẤT
+  // Better Auth đọc. Thêm cột password vào User rồi tự so bcrypt sẽ không có
+  // tác dụng gì.
+  await prisma.account.upsert({
+    where: {
+      providerId_accountId: { providerId: "credential", accountId: admin.id },
+    },
+    update: {},
+    create: {
+      userId: admin.id,
+      providerId: "credential",
+      accountId: admin.id,
+      password: bcrypt.hashSync(ADMIN_PASSWORD, 10),
+    },
+  })
+
+  await prisma.userRole.upsert({
+    where: { userId_roleCode: { userId: admin.id, roleCode: "admin" } },
+    update: {},
+    create: { userId: admin.id, roleCode: "admin", isPrimary: true },
+  })
+  await prisma.userBranch.upsert({
+    where: { userId_branchId: { userId: admin.id, branchId: branch.id } },
+    update: {},
+    create: { userId: admin.id, branchId: branch.id, isDefault: true },
+  })
+  console.log(`✓ tài khoản quản trị: ${ADMIN_EMAIL} / ${ADMIN_PASSWORD}`)
+
+  // ── Cấu hình hệ thống ──────────────────────────────────────────────────
+  const configs = [
+    { key: "company_name", value: "Công ty của bạn", category: "company" },
+    { key: "company_address", value: "", category: "company" },
+    { key: "company_phone", value: "", category: "company" },
+  ]
+  for (const c of configs) {
+    await prisma.systemConfig.upsert({
+      where: { key: c.key },
+      update: {},
+      create: c,
+    })
+  }
+  console.log(`✓ ${configs.length} cấu hình hệ thống`)
+
+  // ── Dữ liệu mẫu (xoá khi bạn thay Department bằng entity thật) ─────────
+  const departments = [
+    { code: "BOD", name: "Ban giám đốc", order: 1 },
+    { code: "SALES", name: "Kinh doanh", order: 2 },
+    { code: "ACC", name: "Kế toán", order: 3 },
+    { code: "HR", name: "Nhân sự", order: 4 },
+    { code: "IT", name: "Công nghệ thông tin", order: 5 },
+  ]
+  for (const d of departments) {
+    await prisma.department.upsert({
+      where: { code: d.code },
+      update: {},
+      create: { ...d, status: "active" },
+    })
+  }
+  console.log(`✓ ${departments.length} phòng ban mẫu`)
+
+  console.log("\nTiếp theo: pnpm rbac-sync   (nạp resource/action/quyền từ registry)")
+}
+
+main()
+  .catch((e) => {
+    console.error(e)
+    process.exit(1)
+  })
+  .finally(() => prisma.$disconnect())

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

@@ -0,0 +1,20 @@
+import path from "node:path"
+
+import "dotenv/config"
+import { defineConfig } from "prisma/config"
+
+/**
+ * Prisma 7 đọc cấu hình từ file này, KHÔNG còn từ block `datasource.url` trong
+ * schema (schema chỉ khai provider). Schema để dạng THƯ MỤC nhiều file: mỗi
+ * phân hệ một `.prisma`, và `goerp-features sync` thả fragment của core vào
+ * cùng chỗ (`goerp-*.prisma`) — đừng sửa tay mấy file đó.
+ */
+export default defineConfig({
+  schema: path.join(__dirname, "prisma/schema"),
+  migrations: {
+    path: path.join(__dirname, "prisma/migrations"),
+  },
+  datasource: {
+    url: process.env.DATABASE_URL!,
+  },
+})

package/templates/starter-app/public/.gitkeep

@@ -0,0 +1,2 @@
+# File tĩnh của app (favicon, ảnh, manifest…). Dockerfile COPY cả thư mục này
+# nên đừng xoá — mất nó là build image gãy ở bước COPY.