docs: Swagger/OpenAPI 문서 전체 구현 #6

htlee · 2026-02-14T21:36:30+09:00

htlee 코멘트됨,

2026-02-14 21:36:30 +09:00

소유자

Summary

springdoc-openapi 2.8.6 기반 Swagger UI 추가
전체 7개 Controller에 Swagger 어노테이션 추가
OpenApiConfig: JWT 보안 스킴, 서버 목록, API 정보 설정
SecurityConfig: swagger-ui 경로 공개 접근 허용

접근 경로

Swagger UI: /swagger-ui.html
API Docs: /v3/api-docs

Tag 목록

1. 시스템 (Health)
1. 인증 (Google Login, JWT)
1. 관리자 - 사용자
1. 관리자 - 롤/권한
1. 관리자 - 통계
1. 활동 기록
1. 이슈 관리

🤖 Generated with Claude Code

## Summary - springdoc-openapi 2.8.6 기반 Swagger UI 추가 - 전체 7개 Controller에 Swagger 어노테이션 추가 - OpenApiConfig: JWT 보안 스킴, 서버 목록, API 정보 설정 - SecurityConfig: swagger-ui 경로 공개 접근 허용 ## 접근 경로 - Swagger UI: `/swagger-ui.html` - API Docs: `/v3/api-docs` ## Tag 목록 - 00. 시스템 (Health) - 01. 인증 (Google Login, JWT) - 02. 관리자 - 사용자 - 03. 관리자 - 롤/권한 - 04. 관리자 - 통계 - 05. 활동 기록 - 06. 이슈 관리 🤖 Generated with [Claude Code](https://claude.com/claude-code)

htlee added 1 commit 2026-02-14 21:36:30 +09:00

docs: Swagger/OpenAPI 문서 전체 구현 357879988e

springdoc-openapi 2.8.6 기반으로 모든 API 엔드포인트에
Swagger 어노테이션을 추가하여 API 문서를 자동 생성합니다.

- OpenApiConfig: JWT 보안 스킴, 서버 목록, API 정보 설정
- SecurityConfig: swagger-ui 경로 공개 접근 허용
- 7개 Controller: @Tag, @Operation, @ApiResponses, @Parameter 등
  (00.시스템, 01.인증, 02~04.관리자, 05.활동, 06.이슈)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

htlee merged commit 1955165985 into develop

2026-02-14 21:36:51 +09:00

htlee 커밋

2026-02-14 21:36:53 +09:00

에서 이 이슈 언급

Merge pull request 'docs: Swagger/OpenAPI 문서 전체 구현' (#6) from feature/admin-and-api into develop

"로그인하여 이 대화에 참여"

No reviewers

레이블 없음

마일스톤 없음

담당자 없음

참여자 1명

알림

마감일

기한이 올바르지 않거나 범위를 벗어났습니다. 'yyyy-mm-dd'형식을 사용해주십시오.

마감일이 설정되지 않았습니다.

의존성

No dependencies set.

Reference: gc/gc-guide-api#6