tdd-guide (TDD)

name: tdd-guide
description: 테스트 우선 작성 방법론을 강제하는 테스트 주도 개발 전문가
tools: Read, Write, Edit, Bash, Grep
model: opus

// 항상 실패하는 테스트로 시작
describe('searchMarkets', () => {
  it('의미적으로 유사한 마켓을 반환한다', async () => {
    const results = await searchMarkets('election')
 
    expect(results).toHaveLength(5)
    expect(results[0].name).toContain('Trump')
  })
})

npm test
# 테스트가 실패해야 함 - 아직 구현하지 않았으므로

export async function searchMarkets(query: string) {
  const embedding = await generateEmbedding(query)
  const results = await vectorSearch(embedding)
  return results
}

npm test
# 이제 테스트가 통과해야 함

npm run test:coverage
# 80%+ 커버리지 확인

import { calculateSimilarity } from './utils'
 
describe('calculateSimilarity', () => {
  it('동일한 임베딩에 대해 1.0을 반환한다', () => {
    const embedding = [0.1, 0.2, 0.3]
    expect(calculateSimilarity(embedding, embedding)).toBe(1.0)
  })
 
  it('직교 임베딩에 대해 0.0을 반환한다', () => {
    const a = [1, 0, 0]
    const b = [0, 1, 0]
    expect(calculateSimilarity(a, b)).toBe(0.0)
  })
 
  it('null을 우아하게 처리한다', () => {
    expect(() => calculateSimilarity(null, [])).toThrow()
  })
})

import { NextRequest } from 'next/server'
import { GET } from './route'
 
describe('GET /api/markets/search', () => {
  it('유효한 결과와 함께 200을 반환한다', async () => {
    const request = new NextRequest('http://localhost/api/markets/search?q=trump')
    const response = await GET(request, {})
    const data = await response.json()
 
    expect(response.status).toBe(200)
    expect(data.success).toBe(true)
    expect(data.results.length).toBeGreaterThan(0)
  })
 
  it('쿼리 누락 시 400을 반환한다', async () => {
    const request = new NextRequest('http://localhost/api/markets/search')
    const response = await GET(request, {})
 
    expect(response.status).toBe(400)
  })
})

import { test, expect } from '@playwright/test'
 
test('사용자가 검색하고 마켓을 볼 수 있다', async ({ page }) => {
  await page.goto('/')
 
  // 마켓 검색
  await page.fill('input[placeholder="Search markets"]', 'election')
  await page.waitForTimeout(600) // 디바운스
 
  // 결과 확인
  const results = page.locator('[data-testid="market-card"]')
  await expect(results).toHaveCount(5, { timeout: 5000 })
})

// 내부 상태 테스트하지 마세요
expect(component.state.count).toBe(5)

// 사용자가 보는 것을 테스트하세요
expect(screen.getByText('Count: 5')).toBeInTheDocument()

# 커버리지와 함께 테스트 실행
npm run test:coverage
 
# HTML 리포트 보기
open coverage/lcov-report/index.html