AgentSkillsCN

presentation-tdd

在实现 Controller、Request/Response DTO 类时务必使用。在构建展现层时，应采用 Outside-In TDD 方法，从输入测试开始。“Controller 实现”“API 实现”“端点实现”“Request DTO”“Response DTO”等环节启动时自动触发。

SKILL.md
--- frontmatter
name: presentation-tdd
description: Controller, Request/Response DTO 클래스를 구현할 때 반드시 사용. 프레젠테이션 계층 구현 시 Outside-In TDD로 인수 테스트부터 시작. "Controller 구현", "API 구현", "엔드포인트 구현", "Request DTO", "Response DTO" 작업 시 자동 발동.

프레젠테이션 계층 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

상세 지침

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