Skip to content

[TASK] Swagger 문서 관리자/매니저/유저 그룹 분리 #343

Description

@hyorim-jo

작업 내용

Swagger 문서를 user/manager/admin 그룹으로 분리합니다.

지금은 모든 API가 하나의 문서에 섞여 있어 관리자/매니저 전용 API가 일반 유저용 문서에도 노출되고,
문서 상단 에러 코드 레퍼런스도 전체 에러 코드가 다 나열되어 있어 그룹별로 관련 없는 코드까지 봐야 합니다.

path와 @ApiAdmin/@ApiManager 어노테이션 기준으로 그룹을 나누고, 그룹별로 실제 사용 중인 에러 코드만 상단 레퍼런스에 표시되도록 개선합니다.

TODO

  • path 기준 분리(/api/v1/admin/**, /api/v1/manage/**, 나머지)
  • 컨트롤러의 @ApiAdmin/@ApiManager 어노테이션으로 그룹을 판별해, 그룹별로 실제 선언된 에러 코드만 문서 상단 레퍼런스에 반영

Additional Context

Metadata

Metadata

Assignees

Labels

📚 Docs문서(README, 위키 등) 개선

Type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions