[fix] #282 - Swagger 그룹화를 코드 기반 설정으로 변경

[hoonyworld]

Related issue 🛠

• closes [bug] @DisableSwaggerSecurity 어노테이션이 적용되지 않는 문제 #282

Work Description ✏️

• Swagger 그룹화를 코드 기반 설정으로 변경하였습니다.
• 코드에서 GroupedOpenApi.builder()를 사용해서, 경로 매칭뿐 아니라 추가적인 커스터마이징 로직을 직접 정의하였습니다.
• 또한, 스웨거 접속 시 admin 그룹을 default로 보여줘서, general 그룹을 default로 보여주도록 변경하였습니다.

Trouble Shooting ⚽️

OperationCustomizer와 YAML의 한계

• springdoc.group-configs를 통해 YAML에서 그룹을 정의하면, SpringDoc이 해당 경로 설정에 맞는 그룹을 자동으로 생성합니다.
• 하지만 YAML 기반의 그룹 생성 과정에서는 추가적인 OperationCustomizer나 다른 커스터마이징 로직이 적용되지 않는 것을 확인했습니다.
  • 즉, 그룹 설정이 SpringDoc 내부에서 처리되며, 사용자 정의 OperationCustomizer를 연결할 수 없어서 코드에서 명시적으로 등록한 경우에만 동작하는 것 같습니다.
• 그래서 springdoc.group-configs는 단순히 경로 매칭에 따라 그룹을 생성할 뿐, 사용자 정의 로직을 추가할 수 없으므로 @DisableSwaggerSecurity와 같은 커스텀 어노테이션도 작동하지 않았던 것입니다.

Related ScreenShot 📷

• 토큰이 필요하지 않는 API의 경우 좌물쇠가 사라지는 것을 확인했습니다.

Uncompleted Tasks 😅

To Reviewers 📢

[hyerinhwang-sailin]

Yml로 설정할 경우 customize가 덮이는 군요!! 트러블 슈팅 고생하셨습니다👍👍