Skip to content

feat(review): 후기 별로에요 코스 문제 항목·후기 작성 폼 추가 - #86

Merged
20210699 merged 4 commits into
developfrom
feat/#85-review-course-issue
Oct 28, 2026
Merged

20210699 merged 4 commits into
developfrom
feat/#85-review-course-issue

Conversation

@20210699

@20210699 20210699 commented Oct 28, 2026 •

Copy link
Copy Markdown
Collaborator

요약

후기 1단계(RV-03)에서 별로에요를 고르면 난이도·혼잡도 대신 코스 문제 항목(복수 선택, 기타 직접 입력 30자)을 받도록 분기했습니다. 추천해요는 기존 흐름 그대로입니다.
화면이 추천 여부로 갈리면서 문항·문구를 앱과 서버가 나눠 들면 어긋나기 쉬워, 후기 작성 화면 전체를 서버 폼으로 내려줍니다(스펙 013의 "후기 폼 API 미제공" 결정 변경).

변경 사항

  • DB(V30): review.difficulty·congestion NOT NULL 해제, course_issue_detail 추가, 추천 후기는 난이도·혼잡도 필수 CHECK. review_course_issue 테이블 신규(코드 CHECK, 후기 삭제 시 CASCADE)
  • 작성·수정 분기: 추천해요 → 난이도·혼잡도 필수 / 별로에요 → courseIssues 1개 이상 필수, OTHER면 courseIssueDetail 필수. 반대쪽 값은 에러 없이 무시, 추천↔별로 전환 수정 시 반대쪽 값 삭제
  • 후기 작성 폼 API(신규): GET /api/v1/places/{placeId}/review-form
    • 1단계(추천 여부·난이도·혼잡도·주의사항·코스 문제 항목) / 2단계(연습 방법·후기 작성)
    • 기본 선택값 없음 → 처음엔 추천 여부만 보이고, 선택 시 showWhen으로 후속 문항 노출
    • 1단계 제목에 코스명, 문구는 시안 기준(난이도·혼잡도·연습 방법 enum에 라벨 추가)
  • 후기 상세: courseIssues(폼 순서)·courseIssueDetail 추가. 별로에요 후기는 difficulty·congestion이 null
  • 후기 요약: levelReviewCount를 "선택 레벨에서 난이도를 표시한 후기 수"로 재정의 → difficultyCounts 합계와 항상 같음
  • 코스 문제 항목은 저장만(목록·요약 미노출)

관련 스펙 / 이슈

프론트 확인 필요

  • 앱이 levelReviewCount를 "이 레벨 후기 수"로 쓰고 있다면 levelCounts[level]로 바꿔야 합니다. 분포 막대 비율 계산에는 그대로 쓰면 됩니다.
  • 서버가 먼저 배포되면 구버전 앱의 별로에요 작성은 courseIssues가 없어 400이 됩니다(운영 비추천 후기 0건).

체크리스트

  • ./gradlew test 통과 (605 tests)
  • 스펙의 완료 조건(Acceptance Criteria) 충족
  • 필요한 문서/스펙 갱신

🤖 Generated with Claude Code

Summary by CodeRabbit

  • 새 기능

    • 후기를 추천하는 경우와 추천하지 않는 경우에 따라 서로 다른 평가 항목을 입력할 수 있습니다. 추천하지 않는 경우 코스 문제를 선택하고, ‘기타’에는 최대 30자까지 내용을 입력할 수 있습니다.
    • 장소별 후기 작성 폼에서 단계별 질문, 선택지와 조건부 표시 안내를 확인할 수 있습니다.
    • 후기 상세 정보에 코스 문제 항목과 ‘기타’ 입력 내용이 포함됩니다.
  • 변경 사항

    • 난이도 집계는 난이도를 표시한 후기만 포함하도록 변경되었습니다. 전체 후기 수 집계에는 난이도가 없는 후기도 포함됩니다.

20210699 and others added 3 commits October 28, 2026 20:25
- V30: difficulty·congestion NOT NULL 해제, 추천 후기는 둘 다 필수(CHECK)
- review_course_issue 테이블·course_issue_detail 컬럼 추가
- CourseIssue enum(시안 5개, 기타 직접 입력 30자)
- 스펙 024 작성·승인 (#85)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 추천 여부에 따라 1단계 평가 분기(추천: 난이도·혼잡도, 별로: 문제 항목)
- 반대쪽 값은 무시, 수정 시 추천↔비추천 전환하면 반대쪽 값 삭제
- 코스 문제 항목 폼 API(GET /reviews/course-issue-form) 추가
- 후기 상세에 courseIssues·courseIssueDetail 추가
- 요약 levelReviewCount를 난이도 표시 후기 수로 변경
- 스펙 024 Implemented (#85)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- GET /places/{placeId}/review-form: 1·2단계 문항·선택지·문구를 서버가 내려줌
- 추천 여부에 따라 showWhen으로 후속 문항 분기(추천: 난이도·혼잡도·주의사항, 별로: 코스 문제 항목)
- 난이도·혼잡도·연습 방법 enum에 시안 문구 라벨 추가
- 코스 문제 항목 단독 폼(GET /reviews/course-issue-form) 제거
- 스펙 024 후기 작성 폼 반영 (#85)

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

coderabbitai Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 49 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

Run configuration
Commits

Reviewing files that changed from the base of the PR and between 5ba5a02 and 1035bff.

Files selected for processing: 4
  • src/main/java/cmc/rodi/domain/review/dto/ReviewDetailResponse.java
  • src/main/java/cmc/rodi/domain/review/dto/ReviewFormResponse.java
  • src/main/java/cmc/rodi/domain/review/dto/ReviewRequest.java
  • src/main/java/cmc/rodi/domain/review/entity/CourseIssue.java

No actionable comments were generated in the recent review.

Recent review info
Run configuration
Commits

Reviewing files that changed from the base of the PR and between 6d20ca5 and 5ba5a02.

Files selected for processing: 27
  • docs/specs/024-review-course-issue.md
  • docs/specs/README.md
  • src/main/java/cmc/rodi/domain/review/controller/ReviewController.java
  • src/main/java/cmc/rodi/domain/review/controller/ReviewControllerDocs.java
  • src/main/java/cmc/rodi/domain/review/dto/ReviewDetailResponse.java
  • src/main/java/cmc/rodi/domain/review/dto/ReviewFormResponse.java
  • src/main/java/cmc/rodi/domain/review/dto/ReviewRequest.java
  • src/main/java/cmc/rodi/domain/review/dto/ReviewSummaryResponse.java
  • src/main/java/cmc/rodi/domain/review/entity/Congestion.java
  • src/main/java/cmc/rodi/domain/review/entity/CourseIssue.java
  • src/main/java/cmc/rodi/domain/review/entity/Difficulty.java
  • src/main/java/cmc/rodi/domain/review/entity/PracticeMethod.java
  • src/main/java/cmc/rodi/domain/review/entity/Review.java
  • src/main/java/cmc/rodi/domain/review/repository/ReviewRepository.java
  • src/main/java/cmc/rodi/domain/review/service/ReviewService.java
  • src/main/resources/db/migration/V30__add_review_course_issue.sql
  • src/test/java/cmc/rodi/domain/member/MemberHardDeleteIntegrationTest.java
  • src/test/java/cmc/rodi/domain/practice/PracticeIntegrationTest.java
  • src/test/java/cmc/rodi/domain/review/MyReviewListIntegrationTest.java
  • src/test/java/cmc/rodi/domain/review/ReviewCourseIssueIntegrationTest.java
  • src/test/java/cmc/rodi/domain/review/ReviewCourseIssueSchemaIntegrationTest.java
  • src/test/java/cmc/rodi/domain/review/ReviewDetailIntegrationTest.java
  • src/test/java/cmc/rodi/domain/review/ReviewListIntegrationTest.java
  • src/test/java/cmc/rodi/domain/review/ReviewReportBlockIntegrationTest.java
  • src/test/java/cmc/rodi/domain/review/ReviewSummaryIntegrationTest.java
  • src/test/java/cmc/rodi/domain/review/ReviewWriteIntegrationTest.java
  • src/test/java/cmc/rodi/domain/review/controller/ReviewControllerTest.java

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

Walkthrough

후기 작성 폼 API를 추가하고, 추천 여부에 따라 후기 입력값을 검증합니다. 비추천 후기의 코스 문제 항목과 기타 입력값을 저장하고 상세 응답에 포함합니다. 난이도 요약 집계는 난이도를 표시한 후기만 세도록 변경합니다.

Changes: 코스 후기 입력 및 조회

Layer / File(s) Summary
작성 폼 API와 요청 규칙
src/main/java/cmc/rodi/domain/review/controller/*, src/main/java/cmc/rodi/domain/review/dto/*, src/main/java/cmc/rodi/domain/review/entity/{CourseIssue,Difficulty,Congestion,PracticeMethod}.java, src/main/java/cmc/rodi/domain/review/service/ReviewService.java, src/test/java/cmc/rodi/domain/review/controller/ReviewControllerTest.java, src/test/java/cmc/rodi/domain/review/ReviewCourseIssueIntegrationTest.java, docs/specs/024-review-course-issue.md, docs/specs/README.md
GET /api/v1/places/{placeId}/review-form은 장소명과 단계별 질문·선택지를 반환합니다. 추천 후기에는 난이도와 혼잡도를 요구하고, 비추천 후기에는 코스 문제 항목을 하나 이상 요구합니다. OTHER 직접 입력은 공백을 제거하고 30자로 제한합니다.
후기 저장과 추천 여부별 전환
src/main/java/cmc/rodi/domain/review/entity/Review.java, src/main/java/cmc/rodi/domain/review/service/ReviewService.java, src/main/resources/db/migration/V30__add_review_course_issue.sql, src/test/java/cmc/rodi/domain/review/ReviewCourseIssueIntegrationTest.java, src/test/java/cmc/rodi/domain/review/ReviewCourseIssueSchemaIntegrationTest.java, src/test/java/cmc/rodi/domain/{member,practice}/*IntegrationTest.java, src/test/java/cmc/rodi/domain/review/{MyReviewList,ReviewDetail,ReviewList,ReviewReportBlock,ReviewWrite}IntegrationTest.java
코스 문제 항목을 후기와 연결해 저장하고, 추천 후기에는 난이도·혼잡도 필수 제약을 적용합니다. 후기 수정 시 추천 여부에 맞지 않는 평가값과 코스 문제 정보를 제거합니다. 관련 저장·수정·삭제 및 요청 호환 테스트를 추가했습니다.
상세 응답과 요약 집계
src/main/java/cmc/rodi/domain/review/dto/{ReviewDetailResponse,ReviewSummaryResponse}.java, src/main/java/cmc/rodi/domain/review/repository/ReviewRepository.java, src/main/java/cmc/rodi/domain/review/controller/ReviewControllerDocs.java, src/test/java/cmc/rodi/domain/review/{ReviewCourseIssue,ReviewDetail,ReviewSummary}IntegrationTest.java, src/test/java/cmc/rodi/domain/review/controller/ReviewControllerTest.java
상세 응답은 코스 문제 항목을 순서대로 반환하고 기타 입력값을 포함합니다. 난이도 집계 수는 난이도가 있는 후기만 세며, 전체 후기 수와 레벨별 후기 수에는 난이도가 없는 후기도 포함합니다.

Priority: Normal

Estimated code review effort: 3 (Moderate) | ~25 minutes

Change: Feature

Sequence Diagram(s)

sequenceDiagram
  participant Client
  participant ReviewController
  participant ReviewService
  Client->>ReviewController: GET /places/{placeId}/review-form
  ReviewController->>ReviewService: getReviewForm(placeId)
  ReviewService-->>ReviewController: ReviewFormResponse
  ReviewController-->>Client: ApiResponse<ReviewFormResponse>
Loading
Merge Risk: Minimal · previous review 5ba5a

확인된 병합 차단 결함은 없습니다. 서버를 먼저 배포하면 구버전 앱의 비추천 후기 작성·수정이 거부되므로 앱 전환 순서를 고려해야 합니다.

Pre-merge checks: Passed 3 · Failed 2

Failed Failed checks: 2 warnings

Check name Status Explanation Resolution
Linked Issues check Warning [#85] 직접 연결 이슈의 요구사항 중 하나가 구현되지 않았습니다. 이슈는 GET /api/v1/reviews/course-issue-form(코스 문제 항목 폼, MULTI_SELECT)을 기대 동작으로 명시합니다. head의 ReviewController에는 이 경로가 없습니다. 대신 `GET /api/v1/places/{placeId}/r… 둘 중 하나를 선택하십시오. (1) GET /api/v1/reviews/course-issue-form을 추가하여 코스 문제 항목 문항과 선택지를 반환하거나, 기존 ReviewFormResponse의 2단계 구성 중 코스 문제 항목 부분을 이 경로로 노출하십시오. (2) 이슈 #85의 기대 동작과 스펙 docs/specs/024-review-course-issue.md의 엔드포인트 목록을 `GET /api/v1/pl…
Docstring Coverage Warning Docstring coverage is 66.67% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documenta… Write docstrings for the functions missing them to satisfy the coverage threshold.
Passed Passed checks: 3 passed
Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed PR 제목 "feat(review): 후기 별로에요 코스 문제 항목·후기 작성 폼 추가"는 변경의 핵심인 '별로에요' 후기의 코스 문제 항목 수집과 후기 작성 폼 API 추가를 명확히 설명한다. 제목이 두 가지 주요 변경을 함께 다루며 세부 사항(V30 스키마, 요약 집계 변경, 수정 시 반대쪽 값 삭제 등)은 생략하지만, 이는 허용되는 범위다. 제목은 c…
Out of Scope Changes check Passed 변경 사항은 #85 요구사항 또는 그 구현에 연결됩니다. ReviewFormResponse, ReviewController.getReviewForm, ReviewService.getReviewForm은 코스 문제 항목 폼을 제공하는 경로로, PR 설명에 따라 문항·문구를 서버에서 내려주기 위한 구성입니다. Difficulty, `Congest…
Full details: Title check

Explanation

PR 제목 "feat(review): 후기 별로에요 코스 문제 항목·후기 작성 폼 추가"는 변경의 핵심인 '별로에요' 후기의 코스 문제 항목 수집과 후기 작성 폼 API 추가를 명확히 설명한다. 제목이 두 가지 주요 변경을 함께 다루며 세부 사항(V30 스키마, 요약 집계 변경, 수정 시 반대쪽 값 삭제 등)은 생략하지만, 이는 허용되는 범위다. 제목은 changeset의 주요 내용과 직접 관련되어 있다.

Full details: Out of Scope Changes check

Explanation

변경 사항은 #85 요구사항 또는 그 구현에 연결됩니다. ReviewFormResponse, ReviewController.getReviewForm, ReviewService.getReviewForm은 코스 문제 항목 폼을 제공하는 경로로, PR 설명에 따라 문항·문구를 서버에서 내려주기 위한 구성입니다. Difficulty, Congestion, PracticeMethod의 label 추가는 폼 문구를 위한 변경이며 같은 화면에 필요합니다. CourseIssue enum, ReviewRequest, Review, ReviewDetailResponse, ReviewSummaryResponse, ReviewRepository, V30 마이그레이션은 이슈의 작성·수정·상세·요약·스키마 요구사항에 직접 대응합니다. 테스트 파일의 null 인자 추가는 ReviewRequest 시그니처 변경에 따른 수정입니다. 문서 변경은 스펙과 API 문서 갱신입니다. 연결이 설명되지 않는 변경은 확인되지 않았습니다.

Full details: Linked Issues check

Explanation

[#85] 직접 연결 이슈의 요구사항 중 하나가 구현되지 않았습니다. 이슈는 GET /api/v1/reviews/course-issue-form(코스 문제 항목 폼, MULTI_SELECT)을 기대 동작으로 명시합니다. head의 ReviewController에는 이 경로가 없습니다. 대신 GET /api/v1/places/{placeId}/review-form을 추가했고, PR 설명은 이를 스펙의 기존 결정 변경으로 기술합니다. 나머지 요구사항(추천 여부별 필수 분기, 반대쪽 값 무시, V30의 nullable difficulty·congestion과 review_course_issue 테이블, 상세 응답의 courseIssues·courseIssueDetail, levelReviewCount 재정의, 목록·요약 미노출)은 PR 요약과 변경 파일 기준으로 구현된 것으로 보입니다. 다만 변경 파일 요약은 실행 결과가 아니므로 코드 수준 검증은 제한적입니다.

Resolution

둘 중 하나를 선택하십시오. (1) GET /api/v1/reviews/course-issue-form을 추가하여 코스 문제 항목 문항과 선택지를 반환하거나, 기존 ReviewFormResponse의 2단계 구성 중 코스 문제 항목 부분을 이 경로로 노출하십시오. (2) 이슈 #85의 기대 동작과 스펙 docs/specs/024-review-course-issue.md의 엔드포인트 목록을 GET /api/v1/places/{placeId}/review-form으로 수정하고, 이슈 작성자가 이 변경에 동의한 근거를 남기십시오. 두 경우 모두 이슈 요구사항과 구현 경로가 일치해야 합니다.

Full details: Docstring Coverage

Explanation

Docstring coverage is 66.67% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 9 functions across 24 files. (3 skipped: 3 unsupported.)

Resolution

Write docstrings for the functions missing them to satisfy the coverage threshold.

Finishing Touches: 💡 1
📝 Generate docstrings: 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@20210699
20210699 merged commit 57fefa8 into develop Oct 28, 2026
2 checks passed
@20210699 20210699 mentioned this pull request Nov 20, 2026
3 tasks done
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[feat] 후기 '별로에요' 선택 시 코스 문제 항목 입력

1 participant