Skip to content

#157 [Chore] 마이그레이션 3종 + 문서 + 테스트 동기화 #158

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jucheonsu merged 4 commits into from
Apr 11, 2026
Merged

#157 [Chore] 마이그레이션 3종 + 문서 + 테스트 동기화 #158

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b1a0cb4
[Chore] 분리/시나리오/롤백 마이그레이션 3종 추가
jucheonsu Apr 10, 2026
e7fa2b0
[Docs] API 명세 및 ERD 문서 동기화
jucheonsu Apr 10, 2026
d4b0670
[Test] 분리 도메인 기준 통합/서비스 테스트 반영
jucheonsu Apr 10, 2026
05a6580
[Test] 테스트 코드 수정
jucheonsu Apr 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions docs/api-specs/api-path-changes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# API 경로 변경/추가 요약 (프론트 전달용)

아래는 **사용자용 API 기준**으로, 기존 대비 바뀐 경로와 새로 분리/추가된 경로를 정리한 문서입니다.
관리자(`admin`) 경로는 제외했습니다.

## 1. 변경된 경로 (기존 → 현재)

### 1.1 콘텐츠 조회

| 기존(통합 Battle 타입 분기) | 현재(도메인 분리) |
|---|---|
| `GET /api/v1/battles?type=QUIZ` | `GET /api/v1/quizzes` |
| `GET /api/v1/battles/{battleId}` (QUIZ 상세) | `GET /api/v1/quizzes/{quizId}` |
| `GET /api/v1/battles?type=POLL` | `GET /api/v1/polls` |
| `GET /api/v1/battles/{battleId}` (POLL 상세) | `GET /api/v1/polls/{pollId}` |

### 1.2 투표 제출/조회

| 기존(통합 투표 처리) | 현재(도메인별 투표) |
|---|---|
| `POST /api/v1/battles/{battleId}/votes/...` (퀴즈 선택 제출에 재사용) | `POST /api/v1/battles/{battleId}/quiz-vote` |
| `GET /api/v1/battles/{battleId}/votes/me` (퀴즈 결과 확인에 재사용) | `GET /api/v1/battles/{battleId}/quiz-vote/me` |
| `POST /api/v1/battles/{battleId}/votes/...` (Poll 선택 제출에 재사용) | `POST /api/v1/battles/{battleId}/poll-vote` |
| `GET /api/v1/battles/{battleId}/votes/me` (Poll 결과 확인에 재사용) | `GET /api/v1/battles/{battleId}/poll-vote/me` |

## 2. 추가된 경로 (프론트에서 새로 호출 필요)

- `GET /api/v1/quizzes`
- `GET /api/v1/quizzes/{quizId}`
- `GET /api/v1/polls`
- `GET /api/v1/polls/{pollId}`
- `POST /api/v1/battles/{battleId}/quiz-vote`
- `GET /api/v1/battles/{battleId}/quiz-vote/me`
- `POST /api/v1/battles/{battleId}/poll-vote`
- `GET /api/v1/battles/{battleId}/poll-vote/me`

## 3. 유지되는 경로 (변경 없음)

- 배틀 전용 투표:
- `POST /api/v1/battles/{battleId}/votes/pre`
- `POST /api/v1/battles/{battleId}/votes/post`
- `GET /api/v1/battles/{battleId}/vote-stats`
- `GET /api/v1/battles/{battleId}/votes/me`

- 배틀 조회:
- `GET /api/v1/battles`
- `GET /api/v1/battles/{battleId}`
- `GET /api/v1/battles/today`

## 4. 참고

- `quiz-vote`, `poll-vote` 경로의 Path Variable 이름은 코드상 `battleId`로 되어 있지만, 내부적으로는 각각 `quizId`, `pollId`로 처리됩니다.
Loading