@wzyjs/cli 0.3.32 → 0.3.37

package/template/web/base/Dockerfile

@@ -0,0 +1,37 @@
+# ----------------------------
+# 构建阶段
+# ----------------------------
+FROM oven/bun:latest AS builder
+
+# 设置工作目录
+ARG ROOT=app
+WORKDIR /${ROOT}
+
+COPY . .
+
+# 替换 package.json 中的 workspace:* 为 *
+RUN sed -i 's/"workspace:\*"/"*"/g' package.json
+
+# 安装依赖
+RUN bun install -f
+
+# 构建
+RUN bun -bun run build
+
+# ----------------------------
+# 运行阶段
+# ----------------------------
+FROM oven/bun:latest AS runner
+
+ARG ROOT=app
+WORKDIR /${ROOT}
+
+# 只复制构建产物
+COPY --from=builder /${ROOT}/.next/standalone ./
+COPY --from=builder /${ROOT}/.next/static ./.next/static
+
+# 开放端口
+EXPOSE 3000
+
+# 启动服务
+CMD ["bun", "server.js"]

package/template/web/base/_env

@@ -0,0 +1,2 @@
+# 数据库配置
+DATABASE_URL=postgresql://root:password.@localhost:5432/demo

package/template/web/base/eslint.config.js

@@ -0,0 +1,94 @@
+import { defineConfig, globalIgnores } from 'eslint/config'
+import nextVitals from 'eslint-config-next/core-web-vitals'
+import nextTs from 'eslint-config-next/typescript'
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // 配置不参与 ESLint 检查的文件和目录
+  globalIgnores([
+    // 忽略 Next.js 构建产物目录
+    '.next/**',
+    // 忽略 Prisma 的 schema 文件
+    'prisma/**',
+    // 忽略其他构建产物目录
+    'build/**',
+    // 忽略 Next.js 自动生成的类型声明文件
+    'next-env.d.ts',
+    // 忽略自动生成的 API 代码
+    'src/server/generated/**',
+  ]),
+  {
+    // 指定这组规则生效的文件类型
+    files: ['**/*.{js,ts,tsx,mts,cts}'],
+    // 配置代码解析相关选项
+    languageOptions: {
+      // 配置解析器参数
+      parserOptions: {
+        // 让 TypeScript 按项目服务模式提供类型信息
+        projectService: true,
+      },
+    },
+    // 自定义需要关闭的 ESLint 规则
+    rules: {
+      // 允许匿名默认导出
+      'import/no-anonymous-default-export': 'off',
+      // 允许在 effect 里调用 setState
+      'react-hooks/set-state-in-effect': 'off',
+      // 不检查 hook 中的纯函数约束
+      'react-hooks/purity': 'off',
+      // 不限制 hook 中对 ref 的使用方式
+      'react-hooks/refs': 'off',
+      // 不强制 hook 中的数据保持不可变
+      'react-hooks/immutability': 'off',
+      // 不强制检查 effect 依赖项是否完整
+      'react-hooks/exhaustive-deps': 'off',
+      // 不强制组件设置 displayName
+      'react/display-name': 'off',
+      // 允许基础类型直接转成字符串
+      '@typescript-eslint/no-base-to-string': 'off',
+      // 不强制数组类型写法统一
+      '@typescript-eslint/array-type': 'off',
+      // 不强制统一使用 interface 或 type
+      '@typescript-eslint/consistent-type-definitions': 'off',
+      // 不强制统一使用 type import
+      '@typescript-eslint/consistent-type-imports': 'off',
+      // 不检查未使用的变量
+      '@typescript-eslint/no-unused-vars': 'off',
+      // 允许没有 await 的 async 函数
+      '@typescript-eslint/require-await': 'off',
+      // 不严格检查 Promise 的误用场景
+      '@typescript-eslint/no-misused-promises': 'off',
+      // 允许使用 any 类型
+      '@typescript-eslint/no-explicit-any': 'off',
+      // 不强制优先使用 ?? 运算符
+      '@typescript-eslint/prefer-nullish-coalescing': 'off',
+      // 不检查不安全的对象属性访问
+      '@typescript-eslint/no-unsafe-member-access': 'off',
+      // 不检查不安全的函数参数传递
+      '@typescript-eslint/no-unsafe-argument': 'off',
+      // 允许使用 ts 注释指令
+      '@typescript-eslint/ban-ts-comment': 'off',
+      // 不检查不安全的函数调用
+      '@typescript-eslint/no-unsafe-call': 'off',
+      // 不检查不安全的赋值
+      '@typescript-eslint/no-unsafe-assignment': 'off',
+      // 不强制处理所有悬空 Promise
+      '@typescript-eslint/no-floating-promises': 'off',
+      // 不检查不安全的返回值
+      '@typescript-eslint/no-unsafe-return': 'off',
+      // 不检查多余的类型断言
+      '@typescript-eslint/no-unnecessary-type-assertion': 'off',
+      // 不强制 Promise reject 使用 Error 对象
+      '@typescript-eslint/prefer-promise-reject-errors': 'off',
+      // 允许使用 namespace
+      '@typescript-eslint/no-namespace': 'off',
+      // 不强制索引对象写法统一
+      '@typescript-eslint/consistent-indexed-object-style': 'off',
+      // 允许显式声明可推断的类型
+      '@typescript-eslint/no-inferrable-types': 'off',
+    },
+  },
+])
+
+export default eslintConfig

package/template/web/base/next.config.js

@@ -0,0 +1,29 @@
+// 只要 Next 读取配置，这个文件就会先执行一次。如果环境变量缺了或格式不对，项目会尽早报错，而不是等运行到某个接口时才炸。
+import './src/env.js'
+
+/** @type {import('next').NextConfig} */
+const config = {
+  output: 'standalone', // 减小打包体积
+  logging: {
+    incomingRequests: false, // 控制台不显示每次请求的日志
+  },
+  poweredByHeader: false, // 响应头里不暴露 x-powered-by: Next.js
+  productionBrowserSourceMaps: false, // 生产环境不生成浏览器端的 .map 文件
+  // transpilePackages: [], // 即使这个包在 node_modules 里，也要把它当源码重新编译
+  experimental: {
+    serverSourceMaps: false, // 不生成服务端的 .map 文件
+  },
+  // 裁掉 Prisma 未使用的 wasm/edge runtime，保留 native query engine，减小 standalone 体积
+  outputFileTracingExcludes: {
+    '/**': [
+      'node_modules/.bun/@prisma+client@*/node_modules/@prisma/client/runtime/query_*',
+      'node_modules/.bun/@prisma+client@*/node_modules/@prisma/client/runtime/wasm-*',
+      'node_modules/.bun/@prisma+client@*/node_modules/@prisma/client/runtime/edge*',
+      'node_modules/.bun/@prisma+client@*/node_modules/.prisma/client/query_engine_bg.*',
+      'node_modules/.bun/@prisma+client@*/node_modules/.prisma/client/wasm*',
+      'node_modules/.bun/@prisma+client@*/node_modules/.prisma/client/edge.js',
+    ],
+  },
+}
+
+export default config

package/template/web/base/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "__WZYJS_APP_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev --turbopack",
+    "build": "NODE_ENV=production next build --turbopack",
+    "start": "next start",
+    "generate": "rm -rf src/server/generated && zenstack generate --output ./src/server/generated/.zenstack --no-compile --schema ./prisma/schema.zmodel",
+    "db:push": "prisma db push",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "check": "bun run lint && bun run typecheck",
+    "postinstall": "bun run generate"
+  },
+  "dependencies": {
+    "@prisma/client": "^6.14.0",
+    "@t3-oss/env-nextjs": "^0.10.1",
+    "@tanstack/react-query": "^5.50.0",
+    "@trpc/client": "^11.7.0",
+    "@trpc/next": "^11.7.0",
+    "@trpc/react-query": "^11.7.0",
+    "@trpc/server": "^11.7.0",
+    "@wzyjs/hooks": "workspace:*",
+    "@wzyjs/next": "workspace:*",
+    "@wzyjs/uis": "workspace:*",
+    "@wzyjs/utils": "workspace:*",
+    "@zenstackhq/runtime": "2.22.1",
+    "@zenstackhq/trpc": "2.22.1",
+    "antd": "^6.3.1",
+    "next": "^16.2.9",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "server-only": "^0.0.1",
+    "superjson": "^2.2.1",
+    "zenstack": "2.22.1",
+    "zod": "^3.23.3",
+    "zod-validation-error": "^3.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "@types/react": "19.1.10",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "^16.2.9",
+    "postcss": "^8.4.39",
+    "prisma": "^6.14.0",
+    "prisma-json-types-generator": "^3.3.0",
+    "tailwindcss": "^3.4.3",
+    "typescript": "^5"
+  }
+}

package/template/web/base/postcss.config.js

@@ -0,0 +1,5 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+  },
+}

package/template/web/base/prisma/models/demo/DemoItem.zmodel

@@ -0,0 +1,8 @@
+import "@wzyjs/next/Base"
+
+model DemoItem extends Base {
+  title       String
+  description String
+
+  @@allow('all', true)
+}

package/template/web/base/prisma/schema.prisma

@@ -0,0 +1,29 @@
+//////////////////////////////////////////////////////////////////////////////////////////////
+// DO NOT MODIFY THIS FILE                                                                  //
+// This file is automatically generated by ZenStack CLI and should not be manually updated. //
+//////////////////////////////////////////////////////////////////////////////////////////////
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+generator client {
+  provider = "prisma-client-js"
+  output   = "../src/server/generated/prisma-client"
+}
+
+generator json {
+  provider = "prisma-json-types-generator"
+}
+
+model DemoItem {
+  id          String    @id() @default(cuid())
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime? @updatedAt()
+  sort        Int?
+  enabled     Boolean   @default(true)
+  isDeleted   Boolean   @default(false)
+  title       String
+  description String
+}

package/template/web/base/prisma/schema.zmodel

@@ -0,0 +1 @@
+import "./models/demo/DemoItem"

package/template/web/base/src/app/api/trpc/[trpc]/route.ts

@@ -0,0 +1,24 @@
+import type { NextRequest } from 'next/server'
+import { fetchRequestHandler } from '@trpc/server/adapters/fetch'
+
+import { apiRouter } from '@/server/trpc'
+import { createTRPCContext } from '@/server/trpc/context'
+import { cors } from '@/server/utils'
+
+const handler = async (req: NextRequest) => {
+  const response = await fetchRequestHandler({
+    req,
+    router: apiRouter,
+    endpoint: '/api/trpc',
+    createContext: () => createTRPCContext({ req }),
+    onError: ({ path, error }) => {
+      console.error(666, `❌ ${req.method} ${req.nextUrl.pathname} failed on ${path ?? '<no-path>'}: ${error.message}`)
+    },
+  })
+
+  return cors.applyCorsHeaders(req, response)
+}
+
+const OPTIONS = cors.createCorsPreflightResponse
+
+export { handler as GET, handler as POST, OPTIONS }

package/template/web/base/src/app/auth/disabled/page.tsx

@@ -0,0 +1,29 @@
+'use client'
+
+import Link from 'next/link'
+
+import { Button, PanelPage, Result, StopOutlined, Typography } from '@/components'
+
+export default function DisabledPage() {
+  return (
+    <PanelPage eyebrow='Access Disabled' title='账号已禁用'>
+      <Result
+        status='403'
+        icon={<StopOutlined style={{ color: '#f5222d' }} />}
+        title='当前账号已被禁用'
+        subTitle={(
+          <Typography.Paragraph className='!mb-0 !text-sm !leading-6 !text-slate-600 dark:!text-slate-300'>
+            登录模块接入后，这里会展示当前账号在应用里的禁用状态。
+          </Typography.Paragraph>
+        )}
+        extra={(
+          <Link href='/auth/signin'>
+            <Button type='primary' danger className='!rounded-lg'>
+              返回登录页
+            </Button>
+          </Link>
+        )}
+      />
+    </PanelPage>
+  )
+}

package/template/web/base/src/app/auth/error/page.tsx

@@ -0,0 +1,47 @@
+'use client'
+
+import Link from 'next/link'
+import { useSearchParams } from 'next/navigation'
+
+import { Button, PanelPage, Result, Typography } from '@/components'
+
+const errorMessageMap: Record<string, string> = {
+  OAuthSignin: '无法发起登录，请稍后再试。',
+  OAuthCallback: '登录回调失败，请检查回调地址配置。',
+  OAuthCreateAccount: '创建登录账号失败，请稍后再试。',
+  EmailCreateAccount: '创建登录账号失败，请稍后再试。',
+  Callback: '登录流程中断，请重新发起登录。',
+  OAuthAccountNotLinked: '当前邮箱已绑定其他登录方式。',
+  EmailSignin: '邮件登录失败。',
+  CredentialsSignin: '账号校验失败。',
+  SessionRequired: '当前页面需要先登录。',
+  default: '登录失败，请稍后重试。',
+}
+
+export default function AuthErrorPage() {
+  const searchParams = useSearchParams()
+  const error = searchParams.get('error') || 'default'
+
+  return (
+    <PanelPage eyebrow='Authentication Exception' title='登录失败'>
+      <Result
+        status='error'
+        title='本次认证没有成功完成'
+        subTitle={errorMessageMap[error]}
+        extra={[
+          <Link href='/auth/signin' key='signin'>
+            <Button type='primary' className='!rounded-lg px-6'>
+              返回登录页
+            </Button>
+          </Link>,
+        ]}
+      />
+
+      <div className='mx-4 mb-4 rounded-lg bg-white/70 p-5 dark:bg-white/5 sm:mx-6'>
+        <Typography.Paragraph className='!mb-0 text-center !text-sm !leading-6 !text-slate-500 dark:!text-slate-300'>
+          登录模块接入后，请检查对应的客户端配置、回调地址和会话密钥。
+        </Typography.Paragraph>
+      </div>
+    </PanelPage>
+  )
+}

package/template/web/base/src/app/auth/signin/page.tsx

@@ -0,0 +1,53 @@
+'use client'
+
+import { Suspense } from 'react'
+
+import { useSearchParams } from 'next/navigation'
+
+import { Button, PanelPage, Space, Spin, Typography } from '@/components'
+
+const { Text } = Typography
+
+const SignInPage = () => {
+  const searchParams = useSearchParams()
+  const error = searchParams.get('error')
+
+  return (
+    <PanelPage
+      eyebrow='Secure Sign In'
+      title='账号登录'
+      description='登录模块接入后，这里会展示对应的登录入口。'
+    >
+      <Space orientation='vertical' size='large' className='w-full'>
+        {error ? (
+          <div className='rounded-lg border border-red-200 bg-red-50/90 p-4 text-left dark:border-red-500/30 dark:bg-red-500/10'>
+            <div className='text-sm font-semibold text-red-700 dark:text-red-300'>
+              登录流程没有完成
+            </div>
+            <p className='mt-2 text-sm leading-6 text-red-600 dark:text-red-200'>
+              请重试一次；如果问题持续出现，优先检查登录配置和回调地址。
+            </p>
+          </div>
+        ) : null}
+
+        <Button type='primary' size='large' className='!h-12 !rounded-lg !text-sm !font-semibold shadow-sm' block disabled>
+          登录模块待接入
+        </Button>
+
+        <div className='rounded-lg bg-white/70 p-5 text-center dark:bg-white/5'>
+          <Text className='text-sm leading-6 text-slate-500 dark:text-slate-300'>
+            基础模板只保留页面骨架。使用 `google` 或 `middle` 模板后会替换为真实登录流程。
+          </Text>
+        </div>
+      </Space>
+    </PanelPage>
+  )
+}
+
+export default function SignIn() {
+  return (
+    <Suspense fallback={<Spin />}>
+      <SignInPage />
+    </Suspense>
+  )
+}

package/template/web/base/src/app/auth/unauthorized/page.tsx

@@ -0,0 +1,60 @@
+'use client'
+
+import { useRouter, useSearchParams } from 'next/navigation'
+
+import {
+  ArrowRightOutlined,
+  Button,
+  PanelPage,
+  Result,
+  RetweetOutlined,
+  StopOutlined,
+  Typography,
+} from '@/components'
+
+import { getSafeCallbackPath } from '@/utils'
+
+export default function UnauthorizedPage() {
+  const router = useRouter()
+  const searchParams = useSearchParams()
+
+  const retryUrl = getSafeCallbackPath(searchParams.get('callbackUrl'), '/')
+
+  return (
+    <PanelPage eyebrow='Access Control' title='访问受限'>
+      <Result
+        status='403'
+        title='当前账号暂无访问权限'
+        icon={<StopOutlined style={{ color: '#f5222d' }} />}
+        subTitle={(
+          <Typography.Paragraph className='!mb-0 !text-sm !leading-6 !text-slate-600 dark:!text-slate-300'>
+            登录模块接入后，这里会展示当前账号的权限状态。
+          </Typography.Paragraph>
+        )}
+        extra={(
+          <div className='flex w-full flex-col gap-3 sm:flex-row sm:justify-center'>
+            <Button
+              type='primary'
+              icon={<RetweetOutlined />}
+              className='!rounded-lg'
+              onClick={() => {
+                router.push(retryUrl)
+              }}
+            >
+              重试
+            </Button>
+            <Button
+              icon={<ArrowRightOutlined />}
+              className='!rounded-lg'
+              onClick={() => {
+                router.push('/')
+              }}
+            >
+              回到首页
+            </Button>
+          </div>
+        )}
+      />
+    </PanelPage>
+  )
+}

package/template/web/base/src/app/demo/page.tsx

@@ -0,0 +1,59 @@
+'use client'
+
+import { Button } from '@/components'
+import { api } from '@/utils'
+
+export default function DemoPage() {
+  const itemsQuery = api.demoItem.findMany.useQuery({
+    orderBy: { createdAt: 'desc' },
+    select: {
+      id: true,
+      title: true,
+      description: true,
+    },
+    take: 20,
+  })
+
+  const createItem = api.demoItem.create.useMutation({
+    onSuccess: () => {
+      void itemsQuery.refetch()
+    },
+  })
+
+  const onCreate = () => {
+    void createItem.mutateAsync({
+      data: {
+        title: `示例记录 ${new Date().toLocaleTimeString('zh-CN')}`,
+        description: 'Created from middle template',
+      },
+    })
+  }
+
+  return (
+    <div className='mx-auto max-w-3xl px-5 py-8'>
+      <div className='mb-6 flex items-center justify-between gap-4'>
+        <h1 className='text-2xl font-semibold'>Demo Items</h1>
+        <Button type='primary' loading={createItem.isPending} onClick={onCreate}>
+          新增示例
+        </Button>
+      </div>
+
+      {itemsQuery.isLoading ? (
+        <div className='text-sm text-slate-500 dark:text-[#aab4c2]'>加载中...</div>
+      ) : itemsQuery.data?.length ? (
+        <div className='space-y-3'>
+          {itemsQuery.data.map(item => (
+            <div key={item.id} className='rounded-lg border border-slate-200 bg-white p-4 dark:border-[#303846] dark:bg-[#171c23]'>
+              <div className='font-medium'>{item.title}</div>
+              <div className='mt-2 text-xs text-slate-500 dark:text-[#aab4c2]'>{item.description || '-'}</div>
+            </div>
+          ))}
+        </div>
+      ) : (
+        <div className='rounded-lg border border-slate-200 bg-white p-6 text-sm text-slate-500 dark:border-[#303846] dark:bg-[#171c23] dark:text-[#aab4c2]'>
+          暂无数据，点“新增示例”创建一条。
+        </div>
+      )}
+    </div>
+  )
+}

package/template/web/base/src/app/layout.tsx

@@ -0,0 +1,32 @@
+import { type ReactNode } from 'react'
+import { type Metadata } from 'next'
+
+import { Providers } from '@/components/base/Providers'
+import { Layout } from '@/components/base/Layout'
+
+import '@/styles/globals.css'
+
+export const metadata: Metadata = {
+  title: '__WZYJS_APP_DISPLAY_NAME__',
+  icons: [{ rel: 'icon', url: '/favicon.ico' }],
+}
+
+interface RootLayoutProps {
+  children: ReactNode
+}
+
+export default function RootLayout(props: RootLayoutProps) {
+  const { children } = props
+
+  return (
+    <html lang='zh-CN' suppressHydrationWarning>
+      <body suppressHydrationWarning>
+        <Providers>
+          <Layout>
+            {children}
+          </Layout>
+        </Providers>
+      </body>
+    </html>
+  )
+}

package/template/web/base/src/app/not-found.tsx

@@ -0,0 +1,21 @@
+import Link from 'next/link'
+
+export default function NotFound() {
+  return (
+    <main className='flex min-h-screen items-center justify-center bg-slate-50 px-5 py-8 transition-colors dark:bg-[#14171c]'>
+      <section className='w-full max-w-xl rounded-lg border border-slate-200 bg-white p-8 text-center shadow-sm transition-colors dark:border-[#303846] dark:bg-[#1b2028]'>
+        <p className='text-sm font-semibold uppercase text-slate-400 dark:text-slate-500'>404</p>
+        <h1 className='mt-3 text-3xl font-semibold text-slate-950 dark:text-[#e8edf5]'>页面没有找到</h1>
+        <p className='mt-4 text-sm leading-6 text-slate-500 dark:text-[#aab4c2]'>
+          这个页面可能已经移动、删除，或者地址输入有误。
+        </p>
+        <Link
+          href='/'
+          className='mt-6 inline-flex h-10 items-center rounded-lg bg-slate-950 px-4 text-sm font-medium text-white transition-colors hover:bg-slate-800 dark:bg-[#e8edf5] dark:text-[#14171c] dark:hover:bg-white'
+        >
+          回到首页
+        </Link>
+      </section>
+    </main>
+  )
+}