node -v # 輸出 v18.17.0 之類(lèi)的版本號(hào)
npm -v  # 輸出 9.x 或 10.x 版本號(hào)

npm install -g @nestjs/cli

# nest new 項(xiàng)目名（推薦用英文，比如 ai-fullstack-demo）
nest new ai-fullstack-demo

ai-fullstack-demo/
├── src/                  # 核心代碼目錄（所有業(yè)務(wù)邏輯寫(xiě)這里）
│   ├── app.controller.ts # 控制器（處理路由、接收請(qǐng)求）→ 類(lèi)似前端的路由配置
│   ├── app.service.ts    # 服務(wù)（處理業(yè)務(wù)邏輯）→ 類(lèi)似前端的工具函數(shù)/API 封裝
│   ├── app.module.ts     # 根模塊（項(xiàng)目入口，整合所有功能模塊）→ 類(lèi)似前端的入口文件
│   └── main.ts           # 項(xiàng)目啟動(dòng)文件（配置端口、中間件等）
├── package.json          # 依賴(lài)配置（和前端一樣）
├── tsconfig.json         # TypeScript 配置（前端同學(xué)熟悉的配置文件）
└── nest-cli.json         # Nest CLI 配置（無(wú)需修改，默認(rèn)即可）

cd ai-fullstack-demo
npm run start:dev # 開(kāi)發(fā)模式啟動(dòng)（熱更新，改代碼不用重啟服務(wù)）

[Nest] 12345  - 2026/04/07 10:00:00     LOG [NestFactory] Starting Nest application...
[Nest] 12345  - 2026/04/07 10:00:01     LOG [InstanceLoader] AppModule dependencies initialized +100ms
[Nest] 12345  - 2026/04/07 10:00:01     LOG [NestApplication] Nest application successfully started +50ms

# 生成用戶(hù)模塊（處理用戶(hù)登錄、注冊(cè)等）
nest generate module modules/user
nest generate controller modules/user # 生成用戶(hù)控制器
nest generate service modules/user   # 生成用戶(hù)服務(wù)
# 生成 AI 模塊（處理 AI API 調(diào)用、生成功能等）
nest generate module modules/ai
nest generate controller modules/ai
nest generate service modules/ai

{
  "compilerOptions": {
    "module": "commonjs",
    "declaration": true,
    "removeComments": true,
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true, // 啟用裝飾器（Nest 核心特性）
    "target": "ES2021", // 目標(biāo) ES 版本，兼容 Node.js 18+
    "sourceMap": true,
    "outDir": "./dist",
    "baseUrl": "./",
    "incremental": true,
    "skipLibCheck": true,
    "strictNullChecks": true, // 嚴(yán)格 null 檢查（避免 undefined 報(bào)錯(cuò)，前端熟悉）
    "noImplicitAny": true, // 禁止隱式 any 類(lèi)型（強(qiáng)制寫(xiě)類(lèi)型，更規(guī)范）
    "strictBindCallApply": true,
    "forceConsistentCasingInFileNames": true
  }
}

npm install @nestjs/typeorm typeorm sqlite3

import { Entity, PrimaryGeneratedColumn, Column, CreateDateColumn, UpdateDateColumn, OneToMany } from 'typeorm';
import { AiRecord } from '../../ai/entities/ai-record.entity';
@Entity('users') // 映射數(shù)據(jù)庫(kù)表 users
export class User {
  @PrimaryGeneratedColumn('uuid') // 主鍵，UUID 類(lèi)型
  id: string;
  @Column({ unique: true, length: 64 }) // 唯一字段，字符串類(lèi)型
  username: string;
  @Column({ unique: true, length: 128 })
  email: string;
  @Column({ length: 255 })
  password: string;
  @CreateDateColumn({ name: 'created_at' }) // 自動(dòng)維護(hù)創(chuàng)建時(shí)間
  createdAt: Date;
  @UpdateDateColumn({ name: 'updated_at' }) // 自動(dòng)維護(hù)更新時(shí)間
  updatedAt: Date;
  @OneToMany(() => AiRecord, (aiRecord) => aiRecord.user) // 一對(duì)多關(guān)聯(lián)（關(guān)聯(lián) AI 生成記錄）
  aiRecords: AiRecord[];
}

import { Entity, PrimaryGeneratedColumn, Column, CreateDateColumn, UpdateDateColumn, ManyToOne, JoinColumn } from 'typeorm';
import { User } from '../../user/entities/user.entity';
@Entity('ai_records') // 映射數(shù)據(jù)庫(kù)表 ai_records
export class AiRecord {
  @PrimaryGeneratedColumn('uuid')
  id: string;
  @Column('text') // 長(zhǎng)文本字段（存儲(chǔ) AI 生成內(nèi)容）
  content: string;
  @Column({ length: 32 }) // 生成類(lèi)型（如 "code"、"text"）
  type: string;
  @Column({ length: 32, default: 'success' }) // 狀態(tài)（success/error）
  status: string;
  @Column({ name: 'user_id' }) // 外鍵字段（關(guān)聯(lián)用戶(hù)表）
  userId: string;
  @CreateDateColumn({ name: 'created_at' })
  createdAt: Date;
  @UpdateDateColumn({ name: 'updated_at' })
  updatedAt: Date;
  @ManyToOne(() => User, (user) => user.aiRecords) // 多對(duì)一關(guān)聯(lián)
  @JoinColumn({ name: 'user_id' }) // 顯式指定外鍵列名，避免歧義
  user: User;
}

import { DataSource } from 'typeorm';
import { ConfigService } from '@nestjs/config';
import { User } from '../modules/user/entities/user.entity';
import { AiRecord } from '../modules/ai/entities/ai-record.entity';
export const getTypeOrmConfig = (configService: ConfigService) => ({
  type: 'sqlite', // 數(shù)據(jù)庫(kù)類(lèi)型：SQLite
  database: configService.get('DATABASE_URL') || 'dev.db', // 數(shù)據(jù)庫(kù)文件（自動(dòng)生成）
  entities: [User, AiRecord], // 注冊(cè)實(shí)體（數(shù)據(jù)庫(kù)表映射）
  synchronize: false, // 生產(chǎn)環(huán)境禁用！用遷移管理表結(jié)構(gòu)
  migrations: ['dist/src/migrations/*.js'], // 遷移文件路徑
  migrationsTableName: 'migrations', // 遷移記錄表名
});

import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { UserModule } from './modules/user/user.module';
import { AiModule } from './modules/ai/ai.module';
import { TypeOrmModule } from '@nestjs/typeorm';
import { ConfigModule, ConfigService } from '@nestjs/config';
import { getTypeOrmConfig } from './config/typeorm.config';
@Module({
  imports: [
    ConfigModule.forRoot({ isGlobal: true }), // 加載環(huán)境變量（.env 文件）
    TypeOrmModule.forRootAsync({
      useFactory: getTypeOrmConfig,
      inject: [ConfigService], // 注入配置服務(wù)
    }),
    UserModule,
    AiModule,
  ],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

# 1. 生成遷移文件（基于實(shí)體類(lèi)變更）
npx typeorm-ts-node-commonjs migration:generate src/migrations/init-tables --dataSource src/config/typeorm.config.ts
# 2. 執(zhí)行遷移（創(chuàng)建數(shù)據(jù)庫(kù)表）
npx typeorm-ts-node-commonjs migration:run --dataSource src/config/typeorm.config.ts

npm install prisma --save-dev
npm install @prisma/client

npx prisma init

# 原配置（PostgreSQL）注釋掉，替換為以下內(nèi)容
DATABASE_URL="file:./dev.db" # SQLite 數(shù)據(jù)庫(kù)文件（會(huì)自動(dòng)生成在 prisma 目錄下）

generator client {
  provider = "prisma-client-js"
}
datasource db {
  provider = "sqlite" // 數(shù)據(jù)庫(kù)類(lèi)型：SQLite
  url      = env("DATABASE_URL") // 連接地址（從 .env 讀?。?
}
// 用戶(hù)表（存儲(chǔ)用戶(hù)信息，后續(xù)登錄用）
model User {
  id        String      @id @default(uuid()) // 主鍵，自動(dòng)生成 UUID
  username  String      @unique // 用戶(hù)名（唯一）
  email     String      @unique // 郵箱（唯一）
  password  String      // 密碼（后續(xù)會(huì)加密）
  createdAt DateTime    @default(now()) // 創(chuàng)建時(shí)間
  updatedAt DateTime    @updatedAt // 更新時(shí)間
  aiRecords AiRecord[]  // 關(guān)聯(lián) AI 生成記錄（一對(duì)多）
}
// AI 生成記錄表（存儲(chǔ) AI 生成的內(nèi)容，如代碼、文案）
model AiRecord {
  id        String   @id @default(uuid())
  content   String   // 生成的內(nèi)容（如代碼字符串）
  type      String   // 生成類(lèi)型（如 "code"、"text"）
  status    String   @default("success") // 狀態(tài)（success/error）
  userId    String   // 關(guān)聯(lián)的用戶(hù) ID
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
  user      User     @relation(fields: [userId], references: [id]) // 關(guān)聯(lián)用戶(hù)表
}

npx prisma migrate dev --name init

nest generate service prisma

import { Injectable, OnModuleInit } from '@nestjs/common';
import { PrismaClient } from '@prisma/client';
@Injectable()
export class PrismaService extends PrismaClient implements OnModuleInit {
  // 模塊初始化時(shí)連接數(shù)據(jù)庫(kù)
  async onModuleInit() {
    await this.$connect();
  }
}

import { Global, Module } from '@nestjs/common';
import { PrismaService } from './prisma.service';
@Global() // 標(biāo)記為全局模塊，所有模塊無(wú)需導(dǎo)入即可使用
@Module({
  providers: [PrismaService],
  exports: [PrismaService], // 導(dǎo)出服務(wù)，供其他模塊使用
})
export class PrismaModule {}

import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { UserModule } from './modules/user/user.module';
import { AiModule } from './modules/ai/ai.module';
import { PrismaModule } from './prisma/prisma.module'; // 導(dǎo)入 Prisma 模塊
@Module({
  imports: [PrismaModule, UserModule, AiModule], // 加入全局模塊
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

// 定義 AI 生成請(qǐng)求的參數(shù)類(lèi)型（前端可復(fù)用）
export class GenerateTextDto {
  prompt: string; // 提示詞（如 "寫(xiě)一段前端學(xué)習(xí)文案"）
  type: string; // 生成類(lèi)型（如 "text"）
  userId: string; // 關(guān)聯(lián)的用戶(hù) ID（測(cè)試用，后續(xù)替換為登錄用戶(hù)）
}

import { Injectable } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { Repository } from 'typeorm';
import { AiRecord } from './entities/ai-record.entity';
import { GenerateTextDto } from './dto/generate-text.dto';
@Injectable()
export class AiService {
  // 注入 AiRecord 實(shí)體的 Repository（操作數(shù)據(jù)庫(kù)）
  constructor(@InjectRepository(AiRecord) private aiRecordRepo: Repository<AiRecord>) {}
  // 模擬 AI 生成文本（后續(xù)替換為真實(shí) LLM API 調(diào)用）
  async generateText(dto: GenerateTextDto) {
    // 1. 模擬 AI 生成結(jié)果（實(shí)際項(xiàng)目中替換為 OpenAI/通義千問(wèn) API 調(diào)用）
    const generatedContent = `AI 生成結(jié)果（基于提示詞：${dto.prompt}）：前端轉(zhuǎn)全棧，用 NestJS + TypeORM 真的太香了！`;
    // 2. 把生成結(jié)果存入數(shù)據(jù)庫(kù)
    const aiRecord = this.aiRecordRepo.create({
      content: generatedContent,
      type: dto.type,
      userId: dto.userId,
    });
    await this.aiRecordRepo.save(aiRecord);
    // 3. 返回結(jié)果（包含數(shù)據(jù)庫(kù)記錄 ID）
    return {
      success: true,
      data: {
        recordId: aiRecord.id,
        content: generatedContent,
      },
    };
  }
}

import { Controller, Post, Body } from '@nestjs/common';
import { AiService } from './ai.service';
import { GenerateTextDto } from './dto/generate-text.dto';
@Controller('api/ai') // 路由前綴：所有接口都以 /api/ai 開(kāi)頭
export class AiController {
  constructor(private readonly aiService: AiService) {}
  // 定義 POST 接口：/api/ai/generate-text
  @Post('generate-text')
  async generateText(@Body() dto: GenerateTextDto) {
    return this.aiService.generateText(dto);
  }
}

// 定義 AI 生成請(qǐng)求的參數(shù)類(lèi)型（前端可復(fù)用）
export class GenerateTextDto {
  prompt: string; // 提示詞（如 "寫(xiě)一段前端學(xué)習(xí)文案"）
  type: string; // 生成類(lèi)型（如 "text"）
  userId: string; // 關(guān)聯(lián)的用戶(hù) ID（測(cè)試用，后續(xù)替換為登錄用戶(hù)）
}

import { Injectable } from '@nestjs/common';
import { PrismaService } from 'src/prisma/prisma.service';
import { GenerateTextDto } from './dto/generate-text.dto';
@Injectable()
export class AiService {
  constructor(private prisma: PrismaService) {} // 注入 Prisma 全局服務(wù)
  // 模擬 AI 生成文本（后續(xù)替換為真實(shí) LLM API 調(diào)用）
  async generateText(dto: GenerateTextDto) {
    // 1. 模擬 AI 生成結(jié)果（實(shí)際項(xiàng)目中替換為 OpenAI/通義千問(wèn) API 調(diào)用）
    const generatedContent = `AI 生成結(jié)果（基于提示詞：${dto.prompt}）：前端轉(zhuǎn)全棧，用 NestJS + Prisma 開(kāi)發(fā)效率翻倍！`;
    // 2. 把生成結(jié)果存入數(shù)據(jù)庫(kù)
    const aiRecord = await this.prisma.aiRecord.create({
      data: {
        content: generatedContent,
        type: dto.type,
        userId: dto.userId,
      },
    });
    // 3. 返回結(jié)果（包含數(shù)據(jù)庫(kù)記錄 ID）
    return {
      success: true,
      data: {
        recordId: aiRecord.id,
        content: generatedContent,
      },
    };
  }
}

import { Controller, Post, Body } from '@nestjs/common';
import { AiService } from './ai.service';
import { GenerateTextDto } from './dto/generate-text.dto';
@Controller('api/ai') // 路由前綴：所有接口都以 /api/ai 開(kāi)頭
export class AiController {
  constructor(private readonly aiService: AiService) {}
  // 定義 POST 接口：/api/ai/generate-text
  @Post('generate-text')
  async generateText(@Body() dto: GenerateTextDto) {
    return this.aiService.generateText(dto);
  }
}

{
  "prompt": "寫(xiě)一段前端學(xué)習(xí)文案",
  "type": "text",
  "userId": "test-user-123" // 測(cè)試用用戶(hù) ID，后續(xù)替換為真實(shí)用戶(hù)
}

{
  "success": true,
  "data": {
    "recordId": "xxx-xxx-xxx-xxx", // 自動(dòng)生成的記錄 ID
    "content": "AI 生成結(jié)果（基于提示詞：寫(xiě)一段前端學(xué)習(xí)文案）：前端轉(zhuǎn)全棧，用 NestJS + XXX 真的太香了！"
  }
}