presentation-tdd

NB993's avatarfrom NB993

프레젠테이션 계층(Controller, Request/Response DTO) TDD 개발 지침. Outside-In TDD로 인수 테스트부터 시작하여 Controller와 DTO를 구현합니다. API 문서 테스트로 문서화를 완성합니다.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026
[Testing and QA]

When & Why to Use This Skill

This Claude skill provides a comprehensive framework for Outside-In Test-Driven Development (TDD) specifically tailored for the presentation layer. It guides the systematic implementation of Controllers and Request/Response DTOs, starting from acceptance tests and concluding with automated API documentation, ensuring high code quality and architectural consistency.

Use Cases

  • Scenario 1: Implementing new REST API endpoints using an Outside-In TDD approach to ensure all requirements are validated through acceptance tests before writing production code.
  • Scenario 2: Standardizing the presentation layer by enforcing strict naming conventions for DTOs and ensuring each Controller handles only a single API responsibility.
  • Scenario 3: Automating the creation of technical API documentation by integrating API docs tests into the development workflow.
  • Scenario 4: Securing the web layer during development by automatically applying OAuth2 mocks and CSRF protection in the testing environment.
namepresentation-tdd
description프레젠테이션 계층(Controller, Request/Response DTO) TDD 개발 지침. Outside-In TDD로 인수 테스트부터 시작하여 Controller와 DTO를 구현합니다. API 문서 테스트로 문서화를 완성합니다.

프레젠테이션 계층 TDD 지침

TDD 순서

  1. 인수 테스트 (실패) → Controller + DTO 구현
  2. API 문서 테스트 → 문서화 완성

특이사항

  • Outside-In TDD: 인수 테스트부터 시작
  • 베이스 클래스: AcceptanceTestBase / ApiDocsTestBase 상속
  • 보안: @WithMockOAuth2User 필수
  • CSRF: POST/PUT/DELETE에 .postProcessors(csrf()) 필수

핵심 규칙

Controller 규칙

  • 하나의 Controller에 하나의 API만 작성
  • 모든 엔드포인트는 /api/로 시작
  • 비즈니스 로직/예외 처리 금지 (Service 책임)

DTO 명명

  • Request: {Find/Save/Modify/Delete}{도메인}Request
  • Response: {Find/Save/Modify/Delete}{도메인}Response
  • record 타입 필수

Controller 명명

  • {Find/Save/Modify/Delete}{도메인}Controller

상세 지침

[필수] 아래 참조 문서를 모두 읽은 후 작업을 시작하세요: