Skip to main content

Orchestration: spring-api-one-set

개요: Spring REST API 테이블 한 세트를 추가하는 상황입니다. 기본 흐름과 별도 에이전트는 implement.md입니다. 확인 방법은 acceptance.md의 템플릿 기반 CRUD입니다.

FieldValue
IDspring-api-one-set
When to use테이블 하나에 대응하는 조회, 저장, 수정을 한 세트로 추가할 때
When not to use버그 수정, 동작 유지 리팩터, 템플릿에 없는 구조 설계
Profile hintdocs/harness/profiles/spring-api.md
Statusactive

이 상황​

별도 에이전트는 implement.md를 따릅니다. 아래는 그 흐름 안에서 이 상황이 지키는 것입니다.

  • 템플릿 기준을 재사용하고 이번 차이만 추가합니다.
  • ExampleItem 템플릿의 구조, 메서드 목록, DTO 형태, 계층 책임을 유지합니다. 도메인명만 바꿉니다.
  • 관련 테스트를 작성하고 실행합니다. 기존 테스트로 충분하면 중복을 만들지 않습니다.
  • 요구사항과 회귀를 확인합니다. Reviewer와 QA를 별도로 실행하지 않아도 이 확인은 합니다.
  • 반복되어 기준이 될 발견은 후보만 보고합니다.

모델 풀과 자유도는 각 역할 기본값입니다. Freedom은 역할 기본값보다 높이지 않습니다.

Verification tools​

ToolRung / scope검증증거
backend-unit-test./gradlew test. 배치는 docs/knowledge/backend/testing/test-structure.md관련 테스트가 있을 때command와 pass/fail
playwright-e2e이 상황의 기본값이 아님아님
browser-manual이 상황의 기본값이 아님아님

이 표의 검증은 별도 에이전트 실행이 아닙니다. 테스트 건수는 실행 증거이며 품질의 단독 기준이 아닙니다.

Knowledge assembly​

Implementer는 적용 템플릿과 채택된 Backend Knowledge를 읽습니다.

PathWhoKind
docs/knowledge/backend/controller/controller-design.md판단이 필요할 때current
docs/knowledge/backend/facade/facade-design.md판단이 필요할 때current
docs/knowledge/backend/service/service-design.md판단이 필요할 때current
docs/knowledge/backend/testing/test-structure.md테스트를 둘 때current
docs/harness/workflows/acceptance.md기준을 정할 때current
docs/harness/templates/backend/spring/구현current
docs/harness/templates/backend/spring/testing/테스트가 필요할 때current

Constraints​

  • ExampleItem은 도메인명으로 바꿉니다. 메서드 목록은 유지합니다.
  • 템플릿이 없다는 이유만으로 구현을 중단하지 않습니다.
  • 새 계층, 공개 계약, 의존성, 아키텍처 결정이 필요하면 선택지와 영향을 Master에게 전달하고, 결정 뒤에 진행합니다.
  • 운영 DB, 자격증명, 고객 정보, 운영 주소를 넣지 않습니다.