AgentSkillsCN

infra-tdd

在实现 JpaEntity、Adapter、Repository 类时务必使用。在构建基础设施层时，应以 TDD（红-绿-重构）模式推进。“JpaEntity 实现”“Adapter 实现”“Repository 实现”“持久化层”等环节启动时自动触发。

SKILL.md
--- frontmatter
name: infra-tdd
description: JpaEntity, Adapter, Repository 클래스를 구현할 때 반드시 사용. 인프라 계층 구현 시 TDD(Red-Green-Refactor) 방식으로 진행. "JpaEntity 구현", "Adapter 구현", "Repository 구현", "영속성 계층" 작업 시 자동 발동.

인프라 계층 TDD 지침

TDD 순서

  1. •JpaEntity - 변환 메서드 테스트 → 구현 → 리팩토링
  2. •Repository - 인터페이스 정의 (테스트 불필요)
  3. •Adapter - 테스트 → 구현 → 리팩토링

특이사항

  • •Mocking 미사용: 실제 DB(Testcontainer) 사용
  • •베이스 클래스: AdapterTestBase 상속
  • •sut 패턴: 테스트 대상을 sut 변수로 선언
  • •테스트 데이터: newXxx() + from() 패턴 사용

핵심 규칙

JpaEntity 명명

  • •클래스명: {도메인}JpaEntity (예: FamilyJpaEntity)
  • •기본 생성자: protected
  • •그 외 생성자: private
  • •setter 사용 금지

변환 메서드

  • •도메인→엔티티: static from(Domain domain)
  • •엔티티→도메인: toXxx() (예: toFamily())

Adapter 명명

  • •클래스명: {도메인}Adapter
  • •여러 Port 인터페이스 구현 가능

상세 지침

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