[d1ng1724]

Summary

• 예시 컨트롤러: 테스트 소스 example 패키지에 도메인 컨트롤러 본보기를 둔다. {grn}을 Grn으로 받고, @RequirePermission과 같은 Action을 로더에 넘기며, listVisible과 CursorPage로 목록을 돌려주고, service가 BusinessException을 던진다. 계약에 명세가 없는 API라 운영 코드에는 넣지 않는다
• 테스트 도우미: @ApiWebMvcTest(XController::class)로 실제 인증 필터·오류 형식·요청 id를 켜고, TestTokens.user()/admin()과 bearer()로 토큰을 붙인다. 토큰은 개발용 토큰 API와 같은 AccessTokenProvider.issue로 발급한다
• 완료 기준 테스트: 토큰 있음 200, 토큰 없음 401, 틀린 GRN 400, 남의 자원 404, 팀원 삭제 시도 403. 목록 커서 페이지, permissions, 도메인 오류 테스트를 함께 둔다
• README: 로컬 실행·개발용 토큰, 도메인 컨트롤러 만들기(패키지, 엔티티·reader, 어노테이션, 로더 고르기, 로더가 돌려주는 응답, 응답·목록·오류), 컨트롤러 테스트 작성법을 정리한다

팀 도메인이 생기기 전까지 로더가 Spring 빈이 아니어서, 테스트 설정(ExampleTestConfig)에서 직접 만든다.

Test plan

• ./gradlew ktlintCheck
• ./gradlew test --tests 'com.gsmsv.api.example.*' --tests 'com.gsmsv.api.global.security.*' --tests 'com.gsmsv.api.global.grn.*' (예시 테스트 8개 포함 통과)
• CI 전체 테스트
• README만 보고 도메인 컨트롤러를 만들 수 있는지 리뷰어 확인

관련 이슈

Closes #25

확인

• 권한 판단을 자원 로더 밖에서 하지 않았다 (22번 권한 판단 Layer)
• GRN 문자열을 직접 자르지 않고 GRN 파서만 썼다. GRN의 소유자 칸 값을 어떤 판단에도 쓰지 않았다 (23번 자원 이름 규칙)
• 비밀값·내부 IP·포트·서버 주소 같은 운영 정보를 넣지 않았다 (공개 저장소)

🤖 Generated with Claude Code