Skip to content

test: 명세 대조 검사에 이름 축 추가 - #28

Merged
yessjun merged 1 commit into
mainfrom
fix/contract-gate-and-password-ownership
Aug 8, 2026
Merged

test: 명세 대조 검사에 이름 축 추가#28
yessjun merged 1 commit into
mainfrom
fix/contract-gate-and-password-ownership

Conversation

@yessjun

@yessjun yessjun commented Aug 8, 2026

Copy link
Copy Markdown
Member

📝 작업내용

  • 설계 명세 대조 검사에 이름 축 비교를 추가
    • 종전 검사는 경로와 메서드 집합만 비교해서 operationId 가 어긋나도 통과
    • 실제로 스무 건이 그렇게 벌어졌고 손으로 맞춰야 했음
    • 두 문서가 함께 가진 경로마다 비교하고 어긋난 것을 한 줄씩 실패 메시지에 수록
  • 스키마명은 포함 관계로 비교
    • 설계 명세의 이름이 전부 생성 명세에 있는지만 확인
    • 생성 명세에만 있는 DTO 는 설계 명세가 문서화하지 않는 것이라 등호로 걸면 전량 오탐
  • 오퍼레이션별 참조 스키마 대조는 제외
    • 백사십 건 중 아흔한 건이 어긋나는데 대부분 공통 오류 응답이라 결함이 아님

⭐️ 검증

  • api verify.sh 통과, 체크스타일과 mvn verify 전체 테스트와 의존성 감사와 공개 위생 검사 green
  • 설계 명세 사본을 일부러 어긋나게 만들어 두 축이 각각 실패하는 것을 확인
  • 그 검사가 조건 미충족으로 건너뛰지 않고 실제로 실행됐음을 결과 파일로 확인
  • 원본 설계 명세는 실험 전후 해시가 동일

💬 리뷰 포인트

  • 스키마명을 등호가 아니라 포함으로 비교한 경계

The gate compared path+method sets only, so a design-contract operationId
or schema name could drift from the generated spec and still pass; 20 had
drifted that way. Verified by pointing the gate at a renamed copy of the
design contract and watching each axis fail.
@yessjun
yessjun merged commit 4fdd888 into main Aug 8, 2026
1 check passed
@yessjun
yessjun deleted the fix/contract-gate-and-password-ownership branch August 8, 2026 13:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant