@svton/cli 1.2.0 → 1.2.2

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 {}

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

@@ -0,0 +1,89 @@
+import { Injectable, UnauthorizedException, ConflictException } from '@nestjs/common';
+import { JwtService } from '@nestjs/jwt';
+import * as bcrypt from 'bcrypt';
+import { PrismaService } from '../prisma/prisma.service';
+import type { LoginDto, RegisterDto, LoginVo } from '{{ORG_NAME}}/types';
+
+@Injectable()
+export class AuthService {
+  constructor(
+    private prisma: PrismaService,
+    private jwtService: JwtService,
+  ) {}
+
+  async login(dto: LoginDto): Promise<LoginVo> {
+    const user = await this.prisma.user.findUnique({
+      where: { phone: dto.phone },
+    });
+
+    if (!user) {
+      throw new UnauthorizedException('用户不存在');
+    }
+
+    const isPasswordValid = await bcrypt.compare(dto.password, user.password);
+    if (!isPasswordValid) {
+      throw new UnauthorizedException('密码错误');
+    }
+
+    if (user.status === 0) {
+      throw new UnauthorizedException('账号已被禁用');
+    }
+
+    const payload = { sub: user.id, phone: user.phone, role: user.role };
+    const accessToken = this.jwtService.sign(payload);
+    const refreshToken = this.jwtService.sign(payload, { expiresIn: '30d' });
+
+    return {
+      accessToken,
+      refreshToken,
+      user: {
+        id: user.id,
+        phone: user.phone,
+        nickname: user.nickname,
+        avatar: user.avatar,
+        role: user.role as any,
+        status: user.status as any,
+        createdAt: user.createdAt.toISOString(),
+        updatedAt: user.updatedAt.toISOString(),
+      },
+    };
+  }
+
+  async register(dto: RegisterDto): Promise<LoginVo> {
+    const existingUser = await this.prisma.user.findUnique({
+      where: { phone: dto.phone },
+    });
+
+    if (existingUser) {
+      throw new ConflictException('手机号已被注册');
+    }
+
+    const hashedPassword = await bcrypt.hash(dto.password, 10);
+
+    const user = await this.prisma.user.create({
+      data: {
+        phone: dto.phone,
+        password: hashedPassword,
+        nickname: dto.nickname,
+        role: 'user',
+        status: 1,
+      },
+    });
+
+    return this.login({ phone: dto.phone, password: dto.password });
+  }
+
+  async validateUser(userId: number) {
+    return this.prisma.user.findUnique({
+      where: { id: userId },
+      select: {
+        id: true,
+        phone: true,
+        nickname: true,
+        avatar: true,
+        role: true,
+        status: true,
+      },
+    });
+  }
+}

package/templates/apps/backend/src/auth/jwt-auth.guard.ts

@@ -0,0 +1,5 @@
+import { Injectable } from '@nestjs/common';
+import { AuthGuard } from '@nestjs/passport';
+
+@Injectable()
+export class JwtAuthGuard extends AuthGuard('jwt') {}

package/templates/apps/backend/src/auth/jwt.strategy.ts

@@ -0,0 +1,27 @@
+import { Injectable, UnauthorizedException } from '@nestjs/common';
+import { PassportStrategy } from '@nestjs/passport';
+import { ExtractJwt, Strategy } from 'passport-jwt';
+import { ConfigService } from '@nestjs/config';
+import { AuthService } from './auth.service';
+
+@Injectable()
+export class JwtStrategy extends PassportStrategy(Strategy) {
+  constructor(
+    private configService: ConfigService,
+    private authService: AuthService,
+  ) {
+    super({
+      jwtFromRequest: ExtractJwt.fromAuthHeaderAsBearerToken(),
+      ignoreExpiration: false,
+      secretOrKey: configService.get<string>('JWT_SECRET'),
+    });
+  }
+
+  async validate(payload: any) {
+    const user = await this.authService.validateUser(payload.sub);
+    if (!user) {
+      throw new UnauthorizedException();
+    }
+    return { sub: payload.sub, phone: payload.phone, role: payload.role };
+  }
+}

package/templates/apps/backend/src/config/env.schema.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+
+/**
+ * 环境变量 Schema
+ * 使用 @svton/nestjs-config-schema 进行验证
+ */
+export const envSchema = z.object({
+  // 应用配置
+  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+  PORT: z.coerce.number().default(3000),
+
+  // 数据库
+  DATABASE_URL: z.string().url(),
+
+  // Redis（可选）
+  REDIS_URL: z.string().url().optional(),
+
+  // JWT
+  JWT_SECRET: z.string().min(32),
+  JWT_EXPIRES_IN: z.string().default('7d'),
+
+  // 七牛云对象存储（可选）
+  QINIU_ACCESS_KEY: z.string().optional(),
+  QINIU_SECRET_KEY: z.string().optional(),
+  QINIU_BUCKET: z.string().optional(),
+  QINIU_REGION: z.string().optional(),
+  QINIU_CDN_URL: z.string().url().optional(),
+
+  // 阿里云短信（可选）
+  ALIYUN_ACCESS_KEY_ID: z.string().optional(),
+  ALIYUN_ACCESS_KEY_SECRET: z.string().optional(),
+  SMS_SIGN_NAME: z.string().optional(),
+});
+
+export type EnvConfig = z.infer<typeof envSchema>;

package/templates/apps/backend/src/main.ts

@@ -0,0 +1,51 @@
+import { NestFactory } from '@nestjs/core';
+import { ValidationPipe } from '@nestjs/common';
+import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger';
+import * as express from 'express';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule, {
+    // 如果使用 @svton/nestjs-logger，启用 bufferLogs
+    // bufferLogs: true,
+  });
+
+  // 如果使用 @svton/nestjs-logger，设置 logger
+  // app.useLogger(app.get(Logger));
+
+  // Raw body 中间件（用于对象存储回调验签）
+  // 仅对特定路径启用，避免影响全局 JSON 解析
+  app.use('/object-storage/callback', express.raw({ type: '*/*' }));
+
+  // 全局验证管道
+  app.useGlobalPipes(
+    new ValidationPipe({
+      whitelist: true,
+      transform: true,
+      forbidNonWhitelisted: true,
+    }),
+  );
+
+  // CORS
+  app.enableCors({
+    origin: true,
+    credentials: true,
+  });
+
+  // Swagger 文档
+  const config = new DocumentBuilder()
+    .setTitle('API 文档')
+    .setDescription('项目 API 接口文档')
+    .setVersion('1.0')
+    .addBearerAuth()
+    .build();
+  const document = SwaggerModule.createDocument(app, config);
+  SwaggerModule.setup('api-docs', app, document);
+
+  const port = process.env.PORT || 3000;
+  await app.listen(port);
+  console.log(`🚀 Server running on http://localhost:${port}`);
+  console.log(`📚 API Docs: http://localhost:${port}/api-docs`);
+}
+
+bootstrap();