@svton/cli 1.2.1 → 1.2.2

package/templates/apps/admin/src/lib/api-client.ts

@@ -0,0 +1,112 @@
+/**
+ * Admin 端 API Client
+ * 使用优化后的 @svton/api-client 系统
+ */
+
+import axios from 'axios';
+import {
+  createApiClient,
+  createTokenInterceptor,
+  createUnauthorizedInterceptor,
+} from '@svton/api-client';
+// 引入类型定义以启用模块增强
+import '{{ORG_NAME}}/types';
+
+/**
+ * Axios 适配器
+ * 后端使用统一响应格式：{ code, data, message }
+ */
+const axiosAdapter = {
+  async request(config: any) {
+    const response = await axios.request(config);
+    const result = response.data;
+
+    // 后端统一包装格式：{ code: 200, message: 'success', data: T, ... }
+    if (result && typeof result === 'object' && 'code' in result) {
+      if ((result as any).code !== 200) {
+        const error: any = new Error((result as any).message || 'Request failed');
+        error.code = (result as any).code;
+        error.response = {
+          status: (result as any).code,
+          data: result,
+        };
+        throw error;
+      }
+      return (result as any).data;
+    }
+
+    // 兼容未包装响应
+    return result;
+  },
+};
+
+/**
+ * 创建 API 客户端实例
+ */
+const { api, apiAsync, runGenerator } = createApiClient(axiosAdapter, {
+  baseURL: process.env.NEXT_PUBLIC_API_URL || 'http://localhost:3000/api',
+  interceptors: {
+    // 请求拦截器 - 添加 Token
+    request: [
+      createTokenInterceptor(() => {
+        if (typeof window !== 'undefined') {
+          // 从 zustand persist 存储中读取 token
+          const authStorage = localStorage.getItem('auth-storage');
+          if (authStorage) {
+            try {
+              const { state } = JSON.parse(authStorage);
+              return state?.accessToken || null;
+            } catch (e) {
+              console.error('[API Client] Failed to parse auth-storage:', e);
+            }
+          }
+        }
+        return null;
+      }),
+    ],
+    // 错误拦截器 - 处理 401
+    error: [
+      createUnauthorizedInterceptor(() => {
+        if (typeof window !== 'undefined') {
+          // 清除 zustand persist 存储
+          localStorage.removeItem('auth-storage');
+          window.location.href = '/login';
+        }
+      }),
+    ],
+  },
+});
+
+// 导出 API 函数
+export { api, apiAsync, runGenerator };
+
+/**
+ * 使用示例：
+ *
+ * // Generator 方式（推荐）
+ * function* loadDashboard() {
+ *   const user = yield* api('GET:/auth/me')
+ *   const contents = yield* api('GET:/contents', { page: 1, pageSize: 10 })
+ *   return { user, contents }
+ * }
+ *
+ * const data = await runGenerator(loadDashboard())
+ *
+ * // Promise 方式
+ * const user = await apiAsync('GET:/auth/me')
+ * const contents = await apiAsync('GET:/contents', { page: 1 })
+ *
+ * // 创建内容
+ * const newContent = await apiAsync('POST:/contents', {
+ *   title: '标题',
+ *   body: '内容',
+ *   contentType: 'article',
+ *   categoryId: 1,
+ * })
+ *
+ * // 更新内容
+ * const updated = await apiAsync('PUT:/contents/:id', {
+ *   id: 123,
+ *   data: { title: '新标题' }
+ * })
+ */

package/templates/apps/admin/src/lib/api-server.ts

@@ -0,0 +1,95 @@
+/**
+ * 服务端 API 客户端
+ * 基于 @svton/api-client
+ * 用于 Next.js 服务端组件中发起认证请求
+ */
+
+import { cookies } from 'next/headers';
+import { createApiClient, createTokenInterceptor } from '@svton/api-client';
+// 引入类型定义以启用模块增强
+import '{{ORG_NAME}}/types';
+
+/**
+ * Fetch 适配器（用于服务端）
+ * 后端使用统一响应格式：{ code, data, message }
+ */
+const fetchAdapter = {
+  async request(config: any) {
+    const { method, url, data, params, headers } = config;
+
+    const queryString = params ? '?' + new URLSearchParams(params).toString() : '';
+    const fullUrl = `${url}${queryString}`;
+
+    const response = await fetch(fullUrl, {
+      method,
+      headers: {
+        'Content-Type': 'application/json',
+        ...headers,
+      },
+      body: data ? JSON.stringify(data) : undefined,
+      cache: 'no-store',
+    });
+
+    const result = await response.json().catch(() => null);
+
+    // 兼容非 JSON 响应
+    if (result === null) {
+      if (!response.ok) {
+        const error: any = new Error(`HTTP ${response.status}`);
+        error.code = response.status;
+        error.response = { status: response.status, data: null };
+        throw error;
+      }
+      return result;
+    }
+
+    // 后端统一包装格式：{ code: 200, message: 'success', data: T, ... }
+    if (result && typeof result === 'object' && 'code' in result) {
+      if ((result as any).code !== 200) {
+        const error: any = new Error((result as any).message || 'Request failed');
+        error.code = (result as any).code;
+        error.response = {
+          status: (result as any).code,
+          data: result,
+        };
+        throw error;
+      }
+      return (result as any).data;
+    }
+
+    if (!response.ok) {
+      const error: any = new Error((result as any)?.message || `HTTP ${response.status}`);
+      error.code = response.status;
+      error.response = { status: response.status, data: result };
+      throw error;
+    }
+
+    return result;
+  },
+};
+
+/**
+ * 创建服务端 API 客户端实例
+ */
+const {
+  api: serverApi,
+  apiAsync: serverApiAsync,
+  runGenerator: runServerGenerator,
+} = createApiClient(fetchAdapter, {
+  baseURL: process.env.NEXT_PUBLIC_API_URL || 'http://localhost:3000/api',
+  interceptors: {
+    // 请求拦截器 - 从 Cookie 读取 Token
+    request: [
+      createTokenInterceptor(async () => {
+        try {
+          const cookieStore = await cookies();
+          return cookieStore.get('token')?.value || cookieStore.get('accessToken')?.value || null;
+        } catch {
+          return null;
+        }
+      }),
+    ],
+  },
+});
+
+export { serverApi, serverApiAsync, runServerGenerator };

package/templates/apps/admin/tailwind.config.js

@@ -0,0 +1,54 @@
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  darkMode: ['class'],
+  content: [
+    './src/pages/**/*.{js,ts,jsx,tsx,mdx}',
+    './src/components/**/*.{js,ts,jsx,tsx,mdx}',
+    './src/app/**/*.{js,ts,jsx,tsx,mdx}',
+  ],
+  theme: {
+    extend: {
+      colors: {
+        border: 'hsl(var(--border))',
+        input: 'hsl(var(--input))',
+        ring: 'hsl(var(--ring))',
+        background: 'hsl(var(--background))',
+        foreground: 'hsl(var(--foreground))',
+        primary: {
+          DEFAULT: 'hsl(var(--primary))',
+          foreground: 'hsl(var(--primary-foreground))',
+        },
+        secondary: {
+          DEFAULT: 'hsl(var(--secondary))',
+          foreground: 'hsl(var(--secondary-foreground))',
+        },
+        destructive: {
+          DEFAULT: 'hsl(var(--destructive))',
+          foreground: 'hsl(var(--destructive-foreground))',
+        },
+        muted: {
+          DEFAULT: 'hsl(var(--muted))',
+          foreground: 'hsl(var(--muted-foreground))',
+        },
+        accent: {
+          DEFAULT: 'hsl(var(--accent))',
+          foreground: 'hsl(var(--accent-foreground))',
+        },
+        popover: {
+          DEFAULT: 'hsl(var(--popover))',
+          foreground: 'hsl(var(--popover-foreground))',
+        },
+        card: {
+          DEFAULT: 'hsl(var(--card))',
+          foreground: 'hsl(var(--card-foreground))',
+        },
+      },
+      borderRadius: {
+        lg: 'var(--radius)',
+        md: 'calc(var(--radius) - 2px)',
+        sm: 'calc(var(--radius) - 4px)',
+      },
+    },
+  },
+  plugins: [require('tailwindcss-animate')],
+};

package/templates/apps/admin/tsconfig.json

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

package/templates/apps/backend/.env.example

@@ -0,0 +1,29 @@
+# 应用配置
+NODE_ENV=development
+PORT=3000
+
+# 数据库
+DATABASE_URL="mysql://root:password@localhost:3306/mydb"
+
+# Redis
+REDIS_URL=redis://localhost:6379
+# 或者分开配置
+# REDIS_HOST=localhost
+# REDIS_PORT=6379
+# REDIS_PASSWORD=
+
+# JWT
+JWT_SECRET=your-jwt-secret-key-must-be-at-least-32-chars
+JWT_EXPIRES_IN=7d
+
+# 七牛云对象存储（可选）
+# QINIU_ACCESS_KEY=your-access-key
+# QINIU_SECRET_KEY=your-secret-key
+# QINIU_BUCKET=your-bucket
+# QINIU_REGION=z0
+# QINIU_CDN_URL=https://cdn.example.com
+
+# 阿里云短信（可选）
+# ALIYUN_ACCESS_KEY_ID=your-access-key-id
+# ALIYUN_ACCESS_KEY_SECRET=your-access-key-secret
+# SMS_SIGN_NAME=your-sign-name

package/templates/apps/backend/nest-cli.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true
+  }
+}

package/templates/apps/backend/package.json.tpl

@@ -0,0 +1,57 @@
+{
+  "name": "{{ORG_NAME}}/backend",
+  "version": "1.0.0",
+  "description": "{{PROJECT_NAME}} 后端 API",
+  "prisma": {
+    "seed": "ts-node prisma/seed.ts"
+  },
+  "scripts": {
+    "build": "nest build",
+    "dev": "NODE_ENV=development nest start --watch",
+    "start": "NODE_ENV=production node dist/main",
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "test": "jest",
+    "type-check": "tsc --noEmit",
+    "prisma:generate": "prisma generate",
+    "prisma:migrate": "prisma migrate dev",
+    "prisma:migrate:deploy": "prisma migrate deploy",
+    "prisma:seed": "ts-node prisma/seed.ts",
+    "prisma:studio": "prisma studio",
+    "db:init": "pnpm prisma:generate && pnpm prisma:migrate && pnpm prisma:seed",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@nestjs/common": "^10.3.0",
+    "@nestjs/config": "^3.1.1",
+    "@nestjs/core": "^10.3.0",
+    "@nestjs/jwt": "^10.2.0",
+    "@nestjs/passport": "^10.0.3",
+    "@nestjs/platform-express": "^10.3.0",
+    "@nestjs/swagger": "^7.1.17",
+    "@prisma/client": "^5.7.1",
+    "{{ORG_NAME}}/types": "workspace:*",
+    "bcrypt": "^5.1.1",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.0",
+    "ioredis": "^5.3.2",
+    "passport": "^0.7.0",
+    "passport-jwt": "^4.0.1",
+    "reflect-metadata": "^0.2.1",
+    "rxjs": "^7.8.1"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^10.2.1",
+    "@nestjs/schematics": "^10.0.3",
+    "@nestjs/testing": "^10.2.10",
+    "@types/bcrypt": "^5.0.2",
+    "@types/express": "^4.17.21",
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.10.0",
+    "@types/passport-jwt": "^3.0.13",
+    "jest": "^29.7.0",
+    "prisma": "^5.7.0",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.0"
+  }
+}

package/templates/apps/backend/prisma/schema.prisma

@@ -0,0 +1,72 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "mysql"
+  url      = env("DATABASE_URL")
+}
+
+// 用户模型
+model User {
+  id          Int      @id @default(autoincrement())
+  phone       String   @unique
+  password    String
+  nickname    String
+  avatar      String?
+  email       String?
+  bio         String?  @db.Text
+  role        String   @default("user") // user, admin, super_admin
+  status      Int      @default(1) // 0: 禁用, 1: 启用
+  lastLoginAt DateTime?
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  contents    Content[]
+  comments    Comment[]
+
+  @@index([phone])
+  @@index([role])
+  @@index([status])
+  @@map("users")
+}
+
+// 内容模型
+model Content {
+  id           Int      @id @default(autoincrement())
+  title        String
+  content      String   @db.Text
+  images       String?  @db.Text // JSON array
+  status       String   @default("draft") // draft, pending, published, rejected
+  viewCount    Int      @default(0)
+  likeCount    Int      @default(0)
+  commentCount Int      @default(0)
+  authorId     Int
+  author       User     @relation(fields: [authorId], references: [id], onDelete: Cascade)
+  createdAt    DateTime @default(now())
+  updatedAt    DateTime @updatedAt
+
+  comments     Comment[]
+
+  @@index([authorId])
+  @@index([status])
+  @@index([createdAt])
+  @@map("contents")
+}
+
+// 评论模型
+model Comment {
+  id        Int      @id @default(autoincrement())
+  content   String   @db.Text
+  contentId Int
+  content_  Content  @relation(fields: [contentId], references: [id], onDelete: Cascade)
+  authorId  Int
+  author    User     @relation(fields: [authorId], references: [id], onDelete: Cascade)
+  likeCount Int      @default(0)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([contentId])
+  @@index([authorId])
+  @@map("comments")
+}

package/templates/apps/backend/prisma/seed.ts

@@ -0,0 +1,32 @@
+import { PrismaClient } from '@prisma/client';
+
+const prisma = new PrismaClient();
+
+async function main() {
+  console.log('🌱 开始初始化数据...');
+
+  // 创建管理员用户
+  const admin = await prisma.user.upsert({
+    where: { phone: '13800000000' },
+    update: {},
+    create: {
+      phone: '13800000000',
+      password: '$2b$10$example', // 需要用 bcrypt 生成
+      nickname: '管理员',
+      role: 'admin',
+      status: 1,
+    },
+  });
+
+  console.log('✅ 管理员用户:', admin);
+  console.log('🎉 数据初始化完成!');
+}
+
+main()
+  .catch((e) => {
+    console.error(e);
+    process.exit(1);
+  })
+  .finally(async () => {
+    await prisma.$disconnect();
+  });

package/templates/apps/backend/src/app.controller.ts

@@ -0,0 +1,15 @@
+import { Controller, Get } from '@nestjs/common';
+import { ApiTags, ApiOperation } from '@nestjs/swagger';
+import { AppService } from './app.service';
+
+@ApiTags('健康检查')
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @Get()
+  @ApiOperation({ summary: '健康检查' })
+  getHealth() {
+    return this.appService.getHealth();
+  }
+}

package/templates/apps/backend/src/app.module.ts

@@ -0,0 +1,85 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { AppController } from './app.controller';
+import { AppService } from './app.service';
+import { PrismaModule } from './prisma/prisma.module';
+import { AuthModule } from './auth/auth.module';
+import { UserModule } from './user/user.module';
+
+// Svton 基础设施包（按需启用）
+// import { createZodValidate } from '@svton/nestjs-config-schema';
+// import { HttpModule } from '@svton/nestjs-http';
+// import { LoggerModule } from '@svton/nestjs-logger';
+// import { RedisModule } from '@svton/nestjs-redis';
+// import { AuthzModule } from '@svton/nestjs-authz';
+// import { ObjectStorageModule } from '@svton/nestjs-object-storage';
+// import { createQiniuAdapter } from '@svton/nestjs-object-storage-qiniu-kodo';
+// import { envSchema } from './config/env.schema';
+
+@Module({
+  imports: [
+    // 配置模块（可启用 schema 验证）
+    ConfigModule.forRoot({
+      isGlobal: true,
+      // validate: createZodValidate(envSchema),
+    }),
+
+    // HTTP 规范化（统一响应/异常格式）
+    // HttpModule.forRoot({
+    //   successCode: 0,
+    //   successMessage: 'success',
+    //   excludePaths: ['/health', '/api-docs'],
+    // }),
+
+    // 日志模块
+    // LoggerModule.forRootAsync({
+    //   imports: [ConfigModule],
+    //   inject: [ConfigService],
+    //   useFactory: (config: ConfigService) => ({
+    //     appName: 'backend',
+    //     env: config.get('NODE_ENV'),
+    //     prettyPrint: config.get('NODE_ENV') !== 'production',
+    //   }),
+    // }),
+
+    // Redis 模块
+    // RedisModule.forRootAsync({
+    //   imports: [ConfigModule],
+    //   inject: [ConfigService],
+    //   useFactory: (config: ConfigService) => ({
+    //     url: config.get('REDIS_URL'),
+    //     keyPrefix: 'app:',
+    //   }),
+    // }),
+
+    // RBAC 权限模块
+    // AuthzModule.forRoot({
+    //   userRoleField: 'role',
+    //   enableGlobalGuard: false,
+    // }),
+
+    // 对象存储模块（七牛云示例）
+    // ObjectStorageModule.forRootAsync({
+    //   imports: [ConfigModule],
+    //   inject: [ConfigService],
+    //   useFactory: (config: ConfigService) => ({
+    //     defaultBucket: config.get('QINIU_BUCKET'),
+    //     publicBaseUrl: config.get('QINIU_CDN_URL'),
+    //     adapter: createQiniuAdapter({
+    //       accessKey: config.get('QINIU_ACCESS_KEY'),
+    //       secretKey: config.get('QINIU_SECRET_KEY'),
+    //       bucket: config.get('QINIU_BUCKET'),
+    //       region: config.get('QINIU_REGION'),
+    //       publicDomain: config.get('QINIU_CDN_URL'),
+    //     }),
+    //   }),
+    // }),
+
+    PrismaModule,
+    AuthModule,
+    UserModule,
+  ],
+  controllers: [AppController],
+  providers: [AppService],
+})
+export class AppModule {}

package/templates/apps/backend/src/app.service.ts

@@ -0,0 +1,12 @@
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class AppService {
+  getHealth() {
+    return {
+      status: 'ok',
+      timestamp: new Date().toISOString(),
+      environment: process.env.NODE_ENV || 'development',
+    };
+  }
+}

package/templates/apps/backend/src/auth/auth.controller.ts

@@ -0,0 +1,31 @@
+import { Controller, Post, Body, Get, UseGuards, Request } from '@nestjs/common';
+import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
+import { AuthService } from './auth.service';
+import { JwtAuthGuard } from './jwt-auth.guard';
+import type { LoginDto, RegisterDto } from '{{ORG_NAME}}/types';
+
+@ApiTags('认证')
+@Controller('auth')
+export class AuthController {
+  constructor(private authService: AuthService) {}
+
+  @Post('login')
+  @ApiOperation({ summary: '登录' })
+  async login(@Body() dto: LoginDto) {
+    return this.authService.login(dto);
+  }
+
+  @Post('register')
+  @ApiOperation({ summary: '注册' })
+  async register(@Body() dto: RegisterDto) {
+    return this.authService.register(dto);
+  }
+
+  @Get('me')
+  @UseGuards(JwtAuthGuard)
+  @ApiBearerAuth()
+  @ApiOperation({ summary: '获取当前用户信息' })
+  async getProfile(@Request() req: any) {
+    return this.authService.validateUser(req.user.sub);
+  }
+}

package/templates/apps/backend/src/auth/auth.module.ts

@@ -0,0 +1,27 @@
+import { Module } from '@nestjs/common';
+import { JwtModule } from '@nestjs/jwt';
+import { PassportModule } from '@nestjs/passport';
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { AuthController } from './auth.controller';
+import { AuthService } from './auth.service';
+import { JwtStrategy } from './jwt.strategy';
+import { PrismaModule } from '../prisma/prisma.module';
+
+@Module({
+  imports: [
+    PrismaModule,
+    PassportModule.register({ defaultStrategy: 'jwt' }),
+    JwtModule.registerAsync({
+      imports: [ConfigModule],
+      useFactory: async (configService: ConfigService) => ({
+        secret: configService.get<string>('JWT_SECRET'),
+        signOptions: { expiresIn: '7d' },
+      }),
+      inject: [ConfigService],
+    }),
+  ],
+  controllers: [AuthController],
+  providers: [AuthService, JwtStrategy],
+  exports: [AuthService],
+})
+export class AuthModule {}