💡 08. 실전 가이드 — 배운 것들을 모두 엮어 '진짜' API 만들기

// packages/schema/src/schema.ts
import { pgTable, serial, text, timestamp } from 'drizzle-orm/pg-core';
 
// 1. 테이블 정의 (물리적 DB 구조)
export const portfolios = pgTable('portfolios', {
  id: serial('id').primaryKey(),
  userId: text('user_id').notNull(),      // 소유자 ID
  name: text('name').notNull(),           // 예: "내 노후 든든 조합"
  description: text('description'),       // 설명 (Optional)
  createdAt: timestamp('created_at').defaultNow(),
  updatedAt: timestamp('updated_at').defaultNow(),
});
 
// 2. 타입 추론 (여기가 Drizzle의 꿀잼 포인트)
export type Portfolio = typeof portfolios.$inferSelect;   // SELECT 할 때 나오는 객체의 타입
export type NewPortfolio = typeof portfolios.$inferInsert; // INSERT 할 때 넣어야 하는 객체의 타입

nest g resource portfolios
# 물어보면 REST API를 선택해!

// src/portfolios/dto/create-portfolio.dto.ts
import { createZodDto } from 'nestjs-zod';
import { createInsertSchema } from 'drizzle-zod';
import { portfolios } from '@repo/schema'; // 방금 짠 스키마 가져오기
 
// 1. Zod 스키마로 자동 번역!
const CreateSchema = createInsertSchema(portfolios, {
  // DB 모델에는 없는 Zod만의 깐깐한 규칙을 추가!
  name: (s) => s.min(2, '포트폴리오 이름은 2글자 이상 적어주세요!').max(50),
  description: (s) => s.max(200).optional(),
}).pick({
  name: true,        // 클라이언트가 입력해야 할 건 이름과 설명뿐이야.
  description: true, // userId 같은 건 헤더의 토큰에서 빼낼 거니까 DTO에선 지움!
});
 
// 2. 완벽한 DTO 클래스 탄생
export class CreatePortfolioDto extends createZodDto(CreateSchema) {}

// src/portfolios/dto/update-portfolio.dto.ts
import { createZodDto } from 'nestjs-zod';
import { CreatePortfolioDto } from './create-portfolio.dto';
 
// Create DTO의 구성 요소를 모조리 Optional(?)로 바꾼다.
export class UpdatePortfolioDto extends createZodDto(
  CreatePortfolioDto.schema.partial()
) {}

// src/portfolios/portfolios.service.ts
import { Inject, Injectable, NotFoundException } from '@nestjs/common';
import { DATABASE_TOKEN, Database } from '../database/database.module';
import { portfolios, NewPortfolio } from '@repo/schema';
import { eq, and } from 'drizzle-orm';
import { CreatePortfolioDto } from './dto/create-portfolio.dto';
import { UpdatePortfolioDto } from './dto/update-portfolio.dto';
 
@Injectable()
export class PortfoliosService {
  // DB 전용 핫라인 주입!
  constructor(@Inject(DATABASE_TOKEN) private readonly db: Database) {}
 
  // 1. 생성 로직
  async create(userId: string, dto: CreatePortfolioDto) {
    // DTO(이름, 설명)에 시스템 변수(유저ID)를 결합
    const newPortfolio: NewPortfolio = { ...dto, userId };
 
    const [created] = await this.db
      .insert(portfolios)
      .values(newPortfolio)
      .returning(); // Postgres 마법: INSERT 한 데이터를 꺼내줌
 
    return created;
  }
 
  // 2. 다건 조회 로직 (반드시 내 것만 나와야 함!!)
  async findAll(userId: string) {
    return this.db.query.portfolios.findMany({
      where: eq(portfolios.userId, userId), 
      orderBy: (p, { desc }) => [desc(p.createdAt)], // 최신순
    });
  }
 
  // 3. 단일 조회 (보안 체크 포함)
  async findOne(userId: string, id: number) {
    const portfolio = await this.db.query.portfolios.findFirst({
      // id도 맞고, userId도 맞아야 함 (남의 포트폴리오는 못 보게 방어)
      where: and(eq(portfolios.id, id), eq(portfolios.userId, userId)),
    });
 
    if (!portfolio) {
      throw new NotFoundException(`포트폴리오 #${id}를 찾을 수 없당.`);
    }
    return portfolio;
  }
}

// src/portfolios/portfolios.controller.ts
import { Controller, Get, Post, Body, Param, UseGuards, ParseIntPipe } from '@nestjs/common';
import { PortfoliosService } from './portfolios.service';
import { CreatePortfolioDto } from './dto/create-portfolio.dto';
import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard';
import { CurrentUser } from '../auth/decorators/current-user.decorator';
import { User } from '../auth/types'; // (내가 만든 유저 인터페이스)
 
// 1. 라우터 접두사와 전역 경비원 배치
@Controller('portfolios') 
@UseGuards(JwtAuthGuard)  
export class PortfoliosController {
  constructor(private readonly portfoliosService: PortfoliosService) {}
 
  // 2. 생성 API (POST /portfolios)
  @Post()
  create(
    @CurrentUser() user: User,       // 👈 누가 요청했는지 사원증에서 뽑기
    @Body() dto: CreatePortfolioDto  // 👈 입구에서 Zod가 데이터 검사 다 해줌
  ) {
    // 컨트롤러는 겁나 쿨하게 파라미터만 넘겨주고 퇴근!
    return this.portfoliosService.create(user.id, dto);
  }
 
  // 3. 다건 조회 API (GET /portfolios)
  @Get()
  findAll(@CurrentUser() user: User) {
    return this.portfoliosService.findAll(user.id);
  }
 
  // 4. 단일 조회 API (GET /portfolios/:id)
  @Get(':id')
  findOne(
    @CurrentUser() user: User,
    @Param('id', ParseIntPipe) id: number // 👈 문자를 숫자로 강제 변환
  ) {
    return this.portfoliosService.findOne(user.id, id);
  }
}