Repository navigation
Conversation
* docs(spec): 마이페이지 기능 스펙(006) 추가 마이페이지 조회·운전목표 수정·저장한 장소 목록 API 설계. 레벨별 추천 태그 고정 매핑, 저장 목록은 저장 시각순 커서 페이징(#51). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * feat(member): 운전목표 수정 API 추가 PATCH /api/v1/members/me (JWT) — 회원 부분 수정(현재 운전목표). 최대 30자, 빈값이면 목표 삭제. 없는 회원은 404. 스펙 006(#51). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * feat(member): 마이페이지 조회 API 추가 GET /api/v1/members/me (JWT) — 닉네임·레벨·레벨별 추천 태그·운전목표· 저장한 장소 수. 저장 수는 place 북마크 조회 서비스로 조합. 스펙 006(#51). - 레벨→추천태그 고정 매핑(NAVIGATOR는 활동 태그) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * feat(place): 저장한 장소 목록 조회 API 추가 GET /api/v1/places/bookmarks (JWT) — 북마크한 장소(코스+주차장)를 최신 저장순 커서 페이징. totalCount는 첫 페이지에서만. 스펙 006(#51) 완료. - bookmark.id 내림차순 keyset(저장 시각순 등가)로 커서 구성 - PlaceListItem.distanceFromMe를 Long(nullable)로 변경해 #2와 공용 (저장 목록은 현위치 없어 null), 엔티티 팩토리 ofCourse/ofParking로 통일 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
* fix(member): 온보딩 운전 기간(Q1) 선택지 개편 반영 기획 변경으로 DrivingPeriod 구간을 재정의(1개월 미만/1~2개월/ 3~5개월/6~11개월/1~2년/3~9년/10년 이상). Navigator 강제 배정 기준을 YEARS_3_9/OVER_10_YEARS로 갱신하고 ERD·스펙 문서 동기화. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * fix(member): 레거시 driving_period 값 V8 backfill 마이그레이션 추가 구간 개편으로 제거된 값(MONTHS_1_3/MONTHS_3_6/MONTHS_6_12/YEARS_2_10)이 저장된 기존 행을 새 enum 값으로 근사 매핑해 조회 오류를 방지. 스펙 문서에 매핑 이력 명시. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
* feat(place): 시군구 주소 키워드 검색 API 추가 - GET /api/v1/places/search — address 부분 일치(ILIKE·와일드카드 이스케이프), 현위치 거리순 커서 페이징, totalCount 첫 페이지만, 공개 - 키워드 트림 후 1~50자·위경도·size 검증(400) - 스펙 007(코스 검색·정렬 필터)·ADR 0011(검색·필터 정렬 전략) 문서 추가 - practiceTypes 정렬·클러스터링은 후속 커밋 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * feat(place): 장소 검색에 장소명(name) 매칭 추가 - searchByAddress → searchByKeyword, address OR name ILIKE 부분 일치로 확장 (주소 없는 place도 name으로 검색됨, 이름/주소 구분 없이 거리순) - 스펙 007: 장소명 검색 반영 + 필터 저장 A안(서버 member.filter_tags, 카테고리는 클라 전용, backfill 없음, 인증 시에만 적용) 확정 기록 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * fix(global): 무효 요청 본문을 500 대신 400으로 응답 - HttpMessageNotReadableException(잘못된 JSON·무효 enum 값 등)이 catch-all Exception 핸들러에 걸려 500으로 새던 갭 보강. 클라이언트 입력 오류이므로 INVALID_INPUT_VALUE(400) + WARN 로깅으로 매핑 - body를 받는 모든 엔드포인트에 적용(온보딩 enum, 필터 저장 등) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * feat(place): 홈 정렬 필터(연습유형 기반 매칭 우선 정렬) 구현 - member.filter_tags(jsonb, V9) 저장 + PUT /members/me/filter-tags (전체 교체, 빈 배열은 해제). 카테고리는 클라 전용, 서버는 연습유형만 안다. - 목록(GET /places)은 옵셔널 JWT(@CurrentMember(required=false)): 인증 회원이 필터를 가지면 매칭 place 우선→거리순(비매칭도 후순위로 전부 노출), 비로그인·빈 필터는 기존 거리순(하위 호환). 커서는 matched|distance 합성으로 확장. - 검색(GET /places/search)은 로그인 전용(JWT 필수, 비로그인 401). - 필터는 저장값에서만 적용(쿼리 파라미터 없음). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * docs: 최근 검색어 기능 스펙 초안 추가 - 008-recent-search: 검색 시 자동 저장·최신순 조회·개별/전체 삭제(로그인 전용), 별도 테이블(member_recent_search)·상한 15개. 구현은 후순위 보류. - specs 목록에 008 추가 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * fix(global): 요청 파라미터 누락·타입 불일치를 400으로 응답 - MissingServletRequestParameterException·MethodArgumentTypeMismatchException이 catch-all Exception 핸들러에 걸려 500 + 서버오류 알림으로 새던 갭 보강. 클라이언트 입력 오류이므로 INVALID_INPUT_VALUE(400) + WARN으로 매핑. - 목록 API 파라미터 누락·타입불일치 400 테스트 추가. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * docs: 검색·필터 문서를 서버 저장(A안) 구현에 맞게 정정 - ADR 0011: "클라 소유 필터(B안)" → "서버 저장 필터(A안)". 대안3(서버 저장)을 채택으로 표시하고 결과(긍정/부정)를 A안 기준으로 정정, 전환 경위를 상태에 기록. - 스펙 007: 필터 상태 클라 소유·practiceTypes 파라미터·공개 API·DB 변경 없음 → member.filter_tags(V9)·PUT·검색 JWT필수/목록 옵셔널JWT로 정정. - ADR·스펙 README 목록 제목/설명 갱신. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
* feat(member): 최근 검색어 저장·조회·삭제 구현 - 검색 시 자동 저장(첫 페이지만·중복은 최신 갱신·회원당 상한 15). member_recent_search(V10), upsert는 clock_timestamp로 재검색을 맨 앞으로 올림. - GET·DELETE(개별/전체) API(전부 JWT), 별도 RecentSearchController로 분리. - 스펙 008 구현 완료 반영. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * docs: 컨트롤러 분리 기준을 CLAUDE.md에 추가 - 자체 오퍼레이션 묶음을 가진 하위 리소스는 전용 컨트롤러, 단발 엔드포인트는 소유 컨트롤러에. URL 일관성이 아니라 기준의 일관 적용이 목표. (recent-searches→전용, filter-tags→MemberController) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * fix: 입력 검증·부수효과 격리·로그 보강 - filterTags 리스트 요소 null 검증(List<@NotNull>) → [null]이 500 대신 400. - 검색 시 최근 검색어 기록 실패를 try/catch로 격리 — 검색 결과 응답은 그대로 반환. - BusinessException에 cause 보존 생성자 추가, 커서 파싱 시 원인 예외 전달. - 무효 본문 로그에서 요청 원문 값(민감정보 가능) 제거 → 예외 타입만 로깅. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * docs: ADR·스펙 정합성 정정 - ADR 0011: 필터 상태는 서버 저장, 카테고리 선택 UI만 클라 로컬로 명확화. - 스펙 007: name 검색 구현 반영(범위밖 제거), 검색 JWT 필수·저장값 필터로 정정, 검색 예시 http 펜스 지정. - 스펙 008: upsert 예시 now() → clock_timestamp()(구현과 일치). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
* docs: 최근 검색어 재설계·연관 검색어 스펙 추가
- 008 재설계: 검색 자동저장 제거 → 연관검색 선택 항목을 POST 등록,
type(REGION/PLACE)·placeId 추가, V11 ALTER·부분 유니크 인덱스.
- 009 신규: 지역·장소명 자동완성(GET /places/related-search).
지역은 시군구 CSV(정규)+별칭 CSV(매칭) 인메모리, 관련도순 4개(좌표 추후 거리순);
장소는 name 관련도순 20개 커서. JWT 필수, 주차장 포함.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* feat(member): 최근 검색어를 연관검색 선택 등록 방식으로 재설계
- 검색 시 자동저장 제거 → POST /me/recent-searches로 연관검색 선택 항목 등록.
- 항목에 type(REGION/PLACE)·place_id 추가. 중복 판정은 REGION=이름·PLACE=placeId
(부분 유니크 인덱스). GET 응답에 type·placeId 포함.
- V11 ALTER(배포된 V10 위에): TRUNCATE + 컬럼·유니크 재구성.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* feat(place): 연관 검색어(지역·장소명 자동완성) 구현
- 지역: 시군구 CSV(정규 231개)+별칭 CSV(1,450개) 인메모리 로드(RegionSearchIndex),
접두매칭>별칭길이>priority 순 관련도 정렬, 상위 4개.
- 장소: place(코스+주차장) name의 POSITION 기반 관련도 정렬 + 커서 페이지네이션.
- GET /api/v1/places/related-search (JWT 필수), regions+places 구분 응답.
- V12: place.address 세종 표기 정규화("세종특별자치시"→"세종특별자치시 세종시").
- CSV 가공 중 발견한 데이터 결손 수정: 광주광역시·전라남도·인천중구가 원본에서
미래 개편명으로 완전 대체돼 있어 실제 place 시드가 고아될 뻔한 것을 재라벨링·
수동복원으로 해결.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: 연관 검색어 스펙 구현 완료 반영
- 스펙 009: lat/lng 미포함(YAGNI), 최종 정규 지역 231개(광주·전남·인천중구
재라벨링/복원 경위 기록), regions 응답이 문자열 배열임을 반영, V12 정규화
범위(세종만)로 정정, 완료 조건 체크.
- specs README: 009 상태 Implemented로 갱신.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* fix: 코드래빗 리뷰 반영 — 스펙 상태·size 범위·DB 불변식·커서 검증
- 스펙 008/009: Status를 허용값(Implemented)으로 정정, 해소된 미해결질문 제거,
size 범위(1~100) 명시 + 경계 테스트 추가.
- RecentSearch: type/place_id 불변식을 DB CHECK 제약으로 이중화(V11).
- PlaceQueryService: 연관검색 커서 matchPos 검증을 1 미만 거부로 강화
(POSITION()이 1-based라 0은 불가능한 값).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
* feat(review): 후기 작성·수정·삭제 구현 - place 1:N 후기(V13). 추천여부·난이도·혼잡도·연습방법·내용·주의사항 + 작성 시점 회원 레벨 스냅샷(member_level)을 서버가 저장(요청으로 받지 않음). - 수정은 작성 당시 레벨 = 현재 레벨일 때만(레벨업 후 이전 후기는 409), 삭제는 레벨 무관. 타인 후기는 403. 같은 장소에 여러 번 작성 가능(유니크 없음). - 스펙 010 추가(009는 연관 검색어가 선점해 번호 조정). 신고·차단, 목록·요약은 후속 커밋. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(review): 후기 신고·회원 차단 구현 - review_report·member_block(V14). 신고는 unique(review_id, reporter_id) + ON CONFLICT DO NOTHING으로 중복 신고 멱등, 본인 후기 신고는 400. 접수·보관까지만 하고 후기 노출은 바꾸지 않는다(자동 숨김 없음). - 신고 사유 폼(GET /reviews/report-form)을 서버가 정의해 내려준다 — 문구·순서·직접입력 여부를 앱 배포 없이 바꾸기 위함. 공통 구조는 global.common.form(FormResponse/FormOption) 으로 두고 연습 미방문 이유 폼도 재사용한다. - 사유는 화면 기준 5종(SPAM/ABUSE/IRRELEVANT/FALSE_INFO/OTHER), OTHER는 직접 입력 필수(최대 100자). - 차단은 단방향·멱등(자기 자신 400·없는 회원 404). CHECK로 자기참조를 DB에서도 막는다. - 후기 삭제 시 신고 행도 FK CASCADE로 함께 제거. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(review): 후기 목록·요약 조회 구현 - 레벨 필터(생략=내 레벨, ALL=전체) + 최신순 커서 목록. 차단 회원 후기 제외, isMine·isEditable 포함(작성 당시 레벨 = 현재 레벨일 때만 수정 가능 표시). - 요약은 선택 레벨 기준 난이도·혼잡도 분포(0건도 키 유지)·추천 수·레벨별 후기 수를 native FILTER로 한 쿼리 집계. 차단은 반영하지 않아 수치가 모두에게 동일. - Postgres가 null 바인드 타입을 못 정해(could not determine data type) 레벨은 IN 목록, 첫 페이지는 미래시각 sentinel 커서로 처리. - 목록은 JPQL + fetch join으로 작성자 닉네임 N+1 회피. - ERD·스펙 010 구현 완료 반영. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(review): 신고 5명 누적 시 후기 자동 비공개 - review.hidden_at 추가(V15). 신고 접수 직후 신고자 수를 세어 5명 이상이면 비공개 처리. unique(review_id, reporter_id) 덕에 행 수 = 신고자 수라 중복 제거가 필요 없고, 5번째 신고가 동시에 겹쳐도 결과가 같다. - 비공개 후기는 목록·요약에서 빠지되 작성자 본인 목록에는 남고 isHidden=true로 내려간다 (왜 안 보이는지 본인은 알아야 함). 요약 집계에서는 본인에게도 제외 — 안 보이는 글이 분포 막대에 잡히면 수치가 어긋난다. - 비공개여도 본인의 수정·삭제는 그대로 가능. 복구는 hidden_at을 NULL로 되돌린다 (운영자 화면·처리 상태 컬럼은 범위 밖). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * docs: git 컨벤션에 워크트리 브랜치·커밋 분할 규칙 추가 - Claude는 claude/<기능>에서만 커밋, feat/#N은 사용자 리뷰·PR 자리로 분리. 이슈·feat 브랜치는 스펙 승인 시점에 생성, 동기화는 ff-merge. - develop 반영은 워크트리에서 merge origin/develop(리베이스 금지 — squash라 불필요). - 큰 기능은 커밋을 단계별로 쪼개고 각 커밋이 빌드 통과 상태를 유지. - 브랜치명 어순(<도메인>-<작업내용>), 이슈 생성은 REST API, 트레일러 모델명 갱신. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * fix(review): 후기 내용 상한을 150자로 축소 - 화면 확정값이 150자인데 초안대로 1000자로 열려 있었다. Review.MAX_CONTENT_LENGTH를 단일 출처로 두고 엔티티·요청 DTO 검증이 같은 값을 쓰게 정리. - ddl-auto=validate라 DB 컬럼도 함께 줄여야 하는데, V13은 이미 적용된 마이그레이션이라 수정하면 체크섬이 깨진다 → V16 ALTER로 varchar(1000)→varchar(150). - 스펙 010·ERD의 글자수 표기와 경계 테스트(1001자→151자) 반영. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * fix(review): 신고 임계값 경합 방지 및 리뷰 지적 반영 - 신고 처리를 후기 행 잠금(FOR UPDATE)으로 직렬화. READ COMMITTED에서 동시 신고가 서로의 미커밋 행을 못 봐 각자 임계값 미만으로 세고, 신고 5건인데 공개로 남는 문제. - OTHER가 아닌 사유로 온 detail은 저장하지 않도록 요청 DTO에서 정규화. - V17로 enum CHECK 제약 추가(difficulty·congestion·practice_method·member_level·reason). V13·V14는 적용된 마이그레이션이라 수정하지 않고 새 파일로 얹음. - 신고 Swagger 문구를 자동 비공개 동작에 맞게 정정, ERD의 "추후" 항목에서 자동 숨김 제거. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
* feat(practice): 연습 코스 담기·목록 조회 구현
- member_practice(V18). 코스 상세 [연습하기]로 장소를 담고(PLANNED) 방문 여부를 기록한다.
코스·주차장 공통(place FK), unique(member_id, place_id)로 한 장소 한 행.
- 이미 담긴 장소를 다시 담으면 행을 늘리지 않고 상태만 예정으로 되돌린다(재도전).
재연습은 행을 추가하는 대신 visit_count로 누적해 목록이 같은 코스로 도배되지 않게 한다.
- 내 목록은 최근 방문순(방문 이력이 없으면 담은 시각) keyset 커서. 상태 필터는 두지 않고
장소 요약은 저장 목록과 같은 PlaceListItem을 재사용한다(현위치 없어 distanceFromMe=null).
- 스펙 011 추가.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(practice): 방문 여부 상태 변경·목록 제거 구현
- PATCH /practices/{id}: VISITED면 연습 횟수 +1·방문 시각 기록,
NOT_VISITED면 사유 필수(기타는 직접 입력 필수). 방문 판정은 클라이언트가 이동 추적으로
자동 호출하므로 서버는 결과만 기록한다(중복 호출 가드 없음 — 스펙 011·012의 결정).
- 미방문 사유는 한 번 저장하면 덮어쓸 수 없다(409). VISITED 전환은 언제든 가능하고
이때 사유는 비워진다.
- DELETE /practices/{id}: 멱등 삭제(없어도 200), 타인 항목은 403.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* docs: 레벨 진행도 스펙(012) 추가 및 애플 다중 Bundle ID 방침 기록
- 012: 누적 주행거리로 레벨 자동 승급·마이페이지 게이지. 코스만 반영, Navigator는 100% 고정,
기존 회원은 레벨 최소값 백필, 중복 호출 가드는 두지 않기로 한 결정과 그 위험을 명시.
- 002: dev 번들(com.dororong.rodi.dev) 지원은 X-Client-Id 헤더로 구분(바디 불변).
순차 시도·provider 분리를 접은 이유 기록.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(practice): 방문 인증 필요 거리 계산 정책 추가
- 필요 거리 = min(코스 전체 거리 × 40%, 5km). 12.5km부터 상한이 걸린다.
- 기획 예시 표(1.3km~40km) 8건과 경계값을 파라미터 테스트로 검증.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(practice): GPS 인정 주행거리 기반 방문 인증 적용
- "다녀왔어요"(연습기록)와 방문 인증을 분리한다. 앱이 측정한 인정 주행거리
(코스 경로선 150m 이내 이동거리)를 PATCH로 받고 인증 여부는 서버가 판정한다
— 앱이 verified를 직접 보내지 않아 잘못 계산해 보낼 여지가 없다.
- member_practice에 certified_distance_meters·verified 추가(V19). 한 번 인증되면 유지되고,
주차장처럼 주행거리가 없는 장소는 인증 대상이 아니다.
- 담기 응답에 requiredDistanceMeters를 실어 앱이 연습 진행률을 계산할 수 있게 한다.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* docs(review): 후기 목록·요약의 level 파라미터를 Swagger에서 선택 가능하게
- 자유 문자열이라 오타로 400을 받기 쉬웠다. allowableValues로 5개 레벨 + ALL 명시.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* docs: 스펙 011·012에 GPS 방문 인증 정책 반영
- 011: "다녀왔어요"와 방문 인증 분리, 필요 거리 공식, 측정 세션·150m 판정은 앱 담당,
certified_distance_meters·verified(V19), 담기 응답의 requiredDistanceMeters.
- 012: 레벨 누적 대상이 코스 전체 거리 → 인정 주행거리로 변경.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* refactor(practice): 미방문 사유 제출을 별도 API로 분리
- PATCH는 상태·GPS 측정값만 다루고, 사유는 POST /practices/{id}/skip-reason으로 받는다.
- 사유는 미방문 상태에서만 저장(그 외 400), 한 번 저장하면 수정 불가(409).
VISITED로 바꾸면 비워져 다시 남길 수 있다.
- 호출이 나뉘어 사유 없는 NOT_VISITED가 남을 수 있다(제출 전 이탈) — API 단순함을 택했다.
- 상태 변경 예시가 우리가 400으로 막는 PLANNED였다 → allowableValues로 VISITED/NOT_VISITED만.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* refactor(practice): 연습 목록 응답을 화면에 필요한 값으로 정리
- 장소 요약(PlaceListItem) 전체 대신 장소명·연습유형만 담는다. 이 화면은 주소·좌표·
주차면수를 쓰지 않는다. 미방문 사유는 수집 목적이라 응답에서 뺐다.
- hasReview 추가 — 그 장소에 내가 쓴 후기가 있는지("후기 쓰기" 버튼 노출 판단).
페이지의 장소 id로 한 번에 조회해 항목별 조회를 피한다(연습 → 후기 단방향 읽기).
- 스펙 011에 사유 제출 API 분리와 목록 응답 정리를 반영.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* fix: 검증 메서드가 요청 스키마에 필드로 노출되던 문제 수정
- @AssertTrue 메서드가 getter 모양이라 springdoc이 요청 본문 필드로 문서화했다
(Swagger 예시에 detailConsistent 등이 찍힘). @JsonIgnore + @Schema(hidden)으로 감춘다.
후기 신고·최근 검색어 2곳(연습 상태 변경은 앞 커밋에서 처리).
- /v3/api-docs를 검사하는 회귀 테스트 추가(애노테이션 제거 시 실패하는 것까지 확인).
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* refactor(practice): 방문 기록 API 요청에서 상태 제거
PATCH /practices/{id} 호출 자체가 "다녀왔어요"라 클라이언트가 상태를 보낼
이유가 없다. 요청은 인정 주행거리만 받고, 서버가 VISITED로 정한 뒤 거리로
인증 여부를 판정한다. 미방문은 별도 API(skip-reason)가 전담한다.
- PracticeStatusUpdateRequest → PracticeVisitRequest (certifiedDistanceMeters만)
- PracticeService.updateStatus → recordVisit
- 쓰이지 않게 된 PRACTICE_400_1(NOT_SKIPPED_PRACTICE) 삭제
- 스펙 011·012의 방문 API 서술을 구현에 맞춰 갱신
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(practice): 미방문 이유 폼 조회 API 추가
"안 했어요" 화면의 선택지 문구·순서를 서버가 정의해 내려준다. 앱 배포 없이
문구를 바꿀 수 있고, 선택지 code가 그대로 사유 제출 요청의 reason이 된다.
구조·직렬화 규칙은 신고 사유 폼(global.common.form)과 동일하다.
- SkipReason.toOption() — 기타만 직접 입력(placeholder·최대 길이 동반)
- 직접 입력 문구를 화면대로 "이유를 작성해주세요"로 정정
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(review): 인증된 후기 배지 추가
방문한 사람의 후기를 구분해 보여준다. 스펙 010의 미해결 질문이었던 "방문 판정
기준"이 스펙 011의 GPS 인증(인정 주행거리 >= min(코스거리 × 40%, 5km))으로
정해져 이제 판정할 수 있다.
작성 시점의 인증 이력을 스냅샷으로 남긴다(V20 is_verified_visit). 그래야
연습 항목을 지우거나 되돌려도 이미 쓴 후기의 배지가 흔들리지 않는다. 단순히
"다녀왔어요"만 누른 기록은 인증으로 보지 않는다.
- 후기 목록 응답에 isVerifiedVisit 추가
- 스펙 011의 마이그레이션 번호 충돌을 피해 스펙 012는 V21로 미룸
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* refactor(review): 후기 요약 개편
난이도 분포는 레벨별로 보는 값이지만 추천 수는 그 장소 자체의 평판이라 레벨을
나눌 이유가 없다. 모수를 levelReviewCount·totalReviewCount로 나누고, 레벨
조건을 WHERE가 아니라 COUNT(*) FILTER에 걸어 한 쿼리로 둘 다 센다.
- topDifficulty 추가 — 최다 난이도와 건수, 동률이면 더 어려운 쪽(쉽다고
오인해 무리하는 쪽이 더 위험하다), 후기가 없으면 키 자체를 생략
- 혼잡도는 화면에 쓰지 않아 응답에서 제외(작성 시 저장은 유지)
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* refactor(review): 후기 목록 응답 정리
목록 카드가 쓰지 않는 값이 함께 나가고 있었다. 추천 여부·난이도·혼잡도는
분포로 보는 값이라 요약 API에 있고, 작성 당시 레벨은 isEditable 판정에만
쓰이며, caution은 관리자 화면 전용이라 응답에서 뺀다(저장은 유지).
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(review): 내가 쓴 후기 목록 조회 API 구현
장소 후기 목록은 기본 필터가 조회자 본인 레벨이라, 레벨이 바뀌면 자기가 쓴
후기가 기본 화면에서 사라진다. 장소 목록의 필터 규칙은 그대로 두고 내 후기를
보는 창구를 따로 낸다.
레벨 필터가 없어 작성 당시 레벨과 무관하게 전부 나오고, 신고 누적으로
비공개된 후기도 isHidden으로 함께 내려준다. 어느 장소에 썼는지 알아야 하므로
장소를 함께 읽는다(JOIN FETCH).
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(member): 차단한 회원 목록 조회 API 구현
지금까지는 차단을 걸 수만 있고 되돌아볼 창구가 없어, 누구를 차단했는지
사용자가 알 수 없었다. 마이페이지에서 관리할 수 있도록 목록을 낸다.
차단한 시각 최신순 커서 페이지네이션으로, 항목의 memberId를 그대로 기존
해제 API 경로에 쓴다. 해제 버튼만 있는 화면이라 레벨·프로필은 싣지 않고,
탈퇴한 회원은 닉네임만 null로 나온다(차단 행은 복구를 대비해 유지).
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* test(member): 차단 목록 정렬 검증 보강
차단 삽입이 네이티브 now()를 쓰는데 Postgres에서 이는 트랜잭션 시작 시각이라,
한 테스트에서 만든 차단이 전부 같은 created_at을 가졌다. 그래서 "최신순"
검증이 id 타이브레이커만 통과시키고 시각 정렬은 확인하지 못했다.
차단 시각을 직접 옮겨 id 순서와 시각 순서를 반대로 두고, 커서의 created_at
비교 분기도 실제로 타게 했다. 정렬을 id 기준으로 바꾸면 실패하는 것을 확인했다.
- 동시각 타이브레이커·익명화 회원(닉네임 null) 케이스 추가
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* perf(place): 코스 연습 태그 배치 로딩 적용
연습·장소 목록이 항목마다 코스 태그를 따로 읽어, 항목 5개에 쿼리 8개가
나갔다(목록·총계·후기여부 3 + 태그 5). tags는 지연 로딩 컬렉션이라 페이지네이션과
함께 JOIN FETCH할 수 없어 배치로 묶는다. 같은 조건에서 4개로 줄었다.
쿼리 수가 항목 수에 비례하지 않는지 확인하는 테스트를 함께 둔다.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* fix(practice): 동시 담기 시 유니크 제약 충돌 처리
같은 장소를 연달아 두 번 누르면 두 요청이 나란히 "없음"으로 보고 둘 다 INSERT를
시도해, 늦게 온 쪽이 uq_member_practice에 걸려 500이 됐다. 담기는 멱등이어야 한다.
제약 위반을 잡아 재조회하는 방식은 JPA에서 통하지 않는다 — 위반 시점에 트랜잭션이
rollback-only가 되어 이어지는 조회가 실패한다. 그래서 회원 차단과 같이 DB에 판정을
맡긴다(ON CONFLICT DO NOTHING 후 재조회).
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* test(practice): 미방문 사유 검증·인증 커버리지 보강
스펙의 완료 조건 중 두 가지가 실제로는 검증되지 않고 있었다. 사유가 OTHER인데
직접 입력이 없을 때의 400과, 방문 기록·사유 제출·삭제·폼 조회의 401이다.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* fix(review): 후기 목록 설명의 혼잡도 안내 정정
요약에서 혼잡도를 뺐는데 목록 API 설명에는 "요약 API에서 본다"고 남아 있어,
클라이언트가 받을 수 없는 집계를 기대하게 된다. 저장만 하고 어느 API로도
내려주지 않음을 명시한다.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* test: OpenAPI 문서 응답 상태 검증 추가
문서 생성이 실패해 본문이 비어도 doesNotContain은 통과해버려, 검증 메서드
비노출 테스트가 헛돌 수 있었다.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* docs: 코드 리뷰 반영해 스펙 표기 정리
- 애플 다중 client id: 구분자·기본값과 AppleProperties 타입을 명시하고,
revoke에는 헤더가 없으므로 선택된 client id를 계정에 보존해야 함을 남김
- 연습 코스: 타임스탬프 타입을 V18과 맞추고(timestamptz → timestamp),
목록 항목 완료 조건을 평탄해진 응답에 맞춰 고침
- 완료 조건 체크 및 README 상태값을 정의된 값으로(011 Implemented, 007 Approved)
- 후기 스펙 코드펜스에 언어 지정
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* refactor(practice): 방문 기록을 하위 리소스 POST로 변경
방문 기록은 부를 때마다 연습 횟수가 오르는 비멱등 연산이라 PATCH가 맞지 않는다.
하위 리소스 POST로 바꾸면 미방문 사유(POST .../skip-reason)와도 대칭이 되어,
사용자의 두 선택이 같은 모양의 API 하나씩에 대응한다.
PATCH /practices/{id} → POST /practices/{id}/visits
바디·응답은 그대로다. 클라이언트 수정이 필요하다.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
* feat(member): 누적 주행거리 컬럼과 레벨 승급 규칙 추가 레벨을 누적 주행거리로 올리기 위한 토대. 아직 방문 기록과 연결하지 않아 동작 변화는 없다. 임계값(0/50/150/300/600km)은 Level enum에 둔다 — 화면과 서버가 같은 표를 봐야 하므로 서버가 단일 출처다. 승급 판정은 엔티티가 하고 승급 여부를 돌려줘 호출부가 응답에 실을 수 있게 한다. - V21: member.total_distance_meters 추가 + 기존 회원을 레벨 최소값으로 백필 - 온보딩 시 배정 레벨의 최소 기준값에서 시작(게이지가 Seed부터 그려지지 않게) - 레벨은 내려가지 않는다 — 계산된 레벨이 현재보다 낮으면 무시 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(practice): 방문 기록에 레벨 누적·승급 연결 방문을 기록하면 인정 주행거리가 회원 누적에 쌓이고, 기준에 도달하면 승급해 응답의 levelUp·newLevel로 알린다. 누적에는 코스 전체 거리라는 상한을 건다. 레벨은 내려가지 않아 한 번 잘못 오르면 되돌릴 수 없는데 측정값은 앱이 보내는 값이라, 서버가 아는 값으로 잘라낸다. 중복 호출 가드가 없는 지금 이게 유일한 서버 측 방어선이다. 누적은 읽고-더하고-쓰기라 같은 회원의 방문이 겹치면 한쪽 증가분이 사라진다. 회원 행을 잠가 직렬화한다. - 쓰이지 않게 된 PracticeVisitResponse.notVisited 제거 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(member): 마이페이지에 레벨 진행도 게이지 추가 다음 레벨까지 얼마나 남았는지 마이페이지에서 보여준다. 막대 길이는 progressPercent를 그대로 쓰면 되도록 서버가 계산해 내려준다. 최상위(Navigator)는 목표가 없어 nextLevelKm 키를 생략하고 진행률을 100으로 고정한다 — 누적 거리는 그 뒤로도 계속 쌓인다. km는 진행률과 같은 방향으로 소수 첫째 자리에서 내림해, 실제보다 앞서 보이지 않게 한다. - 스펙 004·006 갱신, 012는 Implemented로 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * fix(practice): 프록시로 온 코스의 주행거리를 읽지 못하던 문제 수정 방문 기록은 findById로 연습 항목을 읽어 place가 지연 로딩 프록시로 온다. instanceof Course 검사가 프록시에서 거짓이 되어 코스 거리가 null이 되고, 방문 인증이 성립하지 않고 레벨 거리도 쌓이지 않았다. 기존 테스트는 같은 트랜잭션에서 코스를 만들어 영속성 컨텍스트에 실제 엔티티가 올라와 있었던 탓에 이를 잡지 못했다. Place.drivingDistanceMeters()를 다형 메서드로 두고 Course가 재정의한다 — 메서드 호출은 프록시가 실제 엔티티로 위임하므로 안전하다. 컨텍스트를 비운 뒤 인증·누적을 검증하는 테스트를 함께 둔다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(practice): 방문 기록 중복 호출 쿨다운 추가 방문 기록은 앱이 이동 추적 결과로 자동 호출해 재시도·연타가 그대로 들어온다. 스펙 012로 거리가 레벨로 환산되면서, 되돌릴 수 없는 부당 승급으로 이어질 수 있게 됐다. 직전 방문 후 10분 안의 같은 항목 호출은 같은 방문으로 보고 무시한다. 오류로 주면 앱이 다시 시도하므로 200과 현재 상태를 돌려준다. 판정은 이미 있는 visited_at으로 하고 클라이언트 변경은 없다. 결정 배경과 한계(짧은 코스 연속 주행, 완전 동시 요청)는 ADR 0012에 기록했다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * fix(practice): 동시 방문 기록이 거리를 두 번 누적하던 문제 수정 쿨다운은 커밋된 visited_at을 봐야 동작하는데 잠금 없이 읽고 있었다. 동시에 도착한 두 요청이 서로의 미커밋 값을 못 봐 둘 다 통과하고, 회원 누적 거리가 두 번 더해졌다. 레벨은 내려가지 않아 되돌릴 수 없다. 연습 항목 행을 PESSIMISTIC_WRITE로 잠그고 판정한다. 잠금 순서는 항상 연습 항목 → 회원이다. 스레드 두 개가 각자 트랜잭션으로 같은 방문을 기록하는 테스트를 둔다. 누적 거리로 검증한다 — visit_count는 잠금이 없어도 두 요청이 같은 값을 계산해 써서 결함이 드러나지 않는다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * docs: 쿨다운 도입 이후 남은 서술 정정 가드를 두지 않는다는 옛 서술이 스펙·Swagger에 남아 있었고, 행 잠금으로 해소된 동시성 한계가 ADR에 그대로 있었다. - 스펙 012: Status·범위 밖·누적 상한 절을 쿨다운 도입 기준으로 정정 - ADR 0012: 잠금으로 동시 요청도 걸러짐을 결정·결과에 반영 - Swagger: 쿨다운 동작(200에 현재 상태, added=0)을 설명하고 "중복 방지는 클라이언트 몫" 문구 제거 - 마이페이지 컨트롤러 테스트에 Navigator 케이스 추가 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * test(practice): 동시성 테스트가 다른 테스트 데이터까지 지우던 문제 수정 트랜잭션 롤백을 쓸 수 없어 직접 정리하는데 deleteAll()로 회원·코스를 전부 지우고 있었다. 같은 컨테이너를 쓰는 다른 테스트가 남긴 회원을 지우려다 CASCADE 없는 FK(북마크·소셜계정·온보딩·리프레시토큰)에 걸려 CI가 깨졌다. 로컬은 실행 순서가 달라 통과했다. 이 테스트가 만든 행만 지운다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * test(practice): 동시성 테스트가 워커 예외를 삼키던 문제 수정 스레드가 던진 예외가 사라지고 countDown은 그대로 돌아, 한쪽이 실패해도 남은 하나의 수치가 맞으면 테스트가 통과했다. 예외와 응답을 모아 둘 다 정상 종료했는지, 하나만 반영되고 다른 하나는 쿨다운으로 0인지 확인한다. - addedCertifiedDistanceMeters가 누적값으로 오인되지 않도록 설명 보강 (이 항목에 기록된 원값이며 totalDistanceKm 증가분과 다를 수 있다) Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
* docs: 앱 연동 보완 스펙 추가 앱 연동 중 나온 보완 요청과 검토 중 발의한 정리 건을 스펙 013으로 확정한다. 후기 상세 조회·내용 선택 입력·레벨별 방문 인증·인증 응답 정리·즉시 탈퇴(테스트용) 등 10건이며, 스키마 변경은 V22·V23으로 커밋 단위에 맞춰 나눈다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * docs: 미방문 사유 폼 Swagger 예시 오류 수정 공용 FormResponse·FormOption 스키마에 신고 폼 값이 example로 박혀 있어, 같은 스키마를 공유하는 미방문 사유 폼도 REVIEW_REPORT_REASON·SPAM을 예시로 보여줬다. springdoc이 example을 스키마 단위로 렌더링하기 때문이다. 공용 스키마에서 example을 걷어내고, 폼별 실제 응답을 엔드포인트의 @ExampleObject로 옮긴다. @content를 직접 지정하면 응답 스키마가 통째로 빠져 필드 설명이 사라지므로, useReturnTypeSchema로 등록한 스키마를 ref로 다시 연결했다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(review): 후기 상세 조회 API 추가 수정 화면이 폼을 채울 값을 받을 곳이 없었다. 목록 응답은 content만 주고 별도의 상세 조회 API도 없어, 수정 요청이 요구하는 여섯 필드를 클라이언트가 알아낼 방법이 없었다. GET /api/v1/reviews/{reviewId}로 후기 한 건의 전체 값을 준다. 목록에 내리지 않는 caution까지 포함하므로 본인 후기만 열고(타인 403), 비공개된 내 후기는 isHidden으로 표시해 함께 내려준다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(review): 후기 내용 선택 입력 전환 글 없이 평가만 남기려는 사용자에게 작성을 강제하고 있었다. 필수를 추천 여부·난이도·혼잡도·연습 방법 넷으로 좁히고 content·caution은 선택으로 둔다. 공백만 온 내용은 caution과 같은 방식으로 null로 정규화한다 — 그대로 두면 "내용 없음"과 "빈 글"이 갈려 화면 분기가 둘로 늘어난다. 수정은 전체 교체라 내용을 비워 보내면 지워진다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(practice): 방문 인증 레벨별 판정 전환 인증된 후기 배지가 "한 번이라도 인증했는가"였던 탓에, Seed 때 받은 인증으로 Rookie가 된 뒤 쓴 후기까지 배지가 붙었다. 어느 레벨에서 인증했는지를 남겨 작성 당시 레벨 기준으로 판정한다(V23). 인증은 그 주행을 시작한 레벨로 기록한다 — 이 주행으로 승급했다면 새 레벨에서 다시 인증받아야 한다. 승급 전 값을 읽으려 회원 조회가 방문 기록보다 앞으로 오지만 잠금 순서(항목 → 회원)는 유지한다. 인증 표시를 후기 응답 한 곳으로 모으면서 연습 목록·방문 기록 응답의 isVerified를 없앴고, 참조가 사라진 verified 컬럼도 함께 지웠다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(practice): 주차장 방문의 측정값 무시 주행거리가 없는 장소는 인증도 레벨 누적도 성립하지 않는데, 앱이 보낸 측정값이 certified_distance_meters에는 그대로 쌓이고 응답에도 실렸다. 아무 데도 쓰이지 않는 수치가 남는다. countableMeters로 한 번 걸러 방문 기록과 응답이 같은 값을 쓰게 한다. 정규화를 두 곳에 복사하면 갈라지므로 markVisited도 이 메서드를 통과한다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * fix(global): 매핑 없는 요청의 500 응답 수정 지원하지 않는 메서드·존재하지 않는 경로가 전역 catch-all로 떨어져 500과 Discord 서버오류 알림을 냈다. 클라이언트 오류인데 서버 장애로 잡혀, 구버전 앱이 사라진 엔드포인트를 부를 때마다 알림이 쌓인다. 405·404로 응답하고 WARN으로만 남긴다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * remove(practice): 연습기록 삭제 API 제거 화면에서 쓰지 않기로 해 엔드포인트·서비스·테스트를 걷어낸다. 담은 항목을 목록에서 뺄 수단이 없어지지만 감수한다. 후기 배지 스냅샷 테스트는 저장소로 직접 행을 지워 검증을 유지한다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(practice): 연습 목록 활동 시각 필드 개명 담기만 한 항목은 visitedAt이 null이라 카드에 그릴 날짜가 없었다. 정렬 기준과 같은 값(다녀왔으면 마지막 방문 시각, 아니면 담은 시각)을 lastActivityAt으로 내려 항상 채워지게 한다. 방문한 적 없는 항목에 visitedAt이 채워지면 오해를 부르므로 이름을 바꾼다. 방문 여부는 status로 구분된다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * test(practice): 방문 기록 테스트의 디버깅 출력 제거 쿨다운 조사 때 넣은 System.out.println이 남아 테스트 로그를 채우고 있었다. 검증은 단언이 하고 있어 지워도 잃는 정보가 없다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(auth): 로그인 응답에 온보딩 완료 여부 추가 isNewMember만으로는 온보딩 화면 분기를 정할 수 없었다. 가입 후 온보딩 중 이탈한 회원이 재로그인하면 isNewMember=false라 온보딩으로 보낼 근거가 없다. member_onboarding 행 존재를 기준으로 isOnboarded를 내려준다. 온보딩 재제출을 거부할 때 쓰는 기준과 같다. 복구 응답도 같은 타입이라 함께 채운다 — 복구 직후에도 분기가 필요하다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(auth): 토큰 재발급 응답에 온보딩 완료 여부 추가 앱이 토큰만 갱신하고 들어오면 온보딩 화면을 분기할 근거가 없었다. 회전 과정에서 이미 찾은 회원을 TokenService가 함께 돌려주게 해, 추가 조회 없이 isOnboarded를 채운다. 같은 응답의 isNewMember는 뺀다 — 재발급은 가입이 아니라 항상 false로 하드코딩돼 있어 정보가 없고, 옆에 두면 분기 기준을 잘못 고르게 한다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(member): 즉시 탈퇴 API 추가 (내부 테스트용) 재가입을 시험하려면 탈퇴 후 10일을 기다려야 했다. 유예기간·익명화를 건너뛰고 회원을 물리 삭제해, 같은 소셜 계정으로 곧바로 다시 가입하고 온보딩을 반복할 수 있게 한다. 운영에는 존재하지 않는다 — @Profile("!prod")로 빈 자체가 만들어지지 않는다. 되돌릴 수 없는 삭제라 이 조건이 유일한 방어선이므로 프로파일 테스트로 못 박는다. CASCADE가 없는 네 테이블을 순서대로 지운 뒤 member를 지운다. 빠진 FK에 CASCADE를 붙이지는 않는다 — 운영에서 물리 삭제할 일이 없는데 실수의 파급만 커진다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * fix(member): 즉시 탈퇴 API의 회원 id 노출 수정 @CurrentMember는 토큰에서 꺼내는 값인데 @parameter(hidden = true)를 빠뜨려 Swagger가 required 쿼리 파라미터로 그렸다. 서버는 정상 동작하지만 문서상 호출이 막힌다. 같은 누락을 전역으로 잡도록, 어떤 엔드포인트도 memberId를 쿼리 파라미터로 노출하지 않는지 검사하는 테스트를 함께 넣는다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(auth): 재가입 대기 응답에 가능 시각 추가 복구 기간이 지난 계정의 로그인·복구가 409로 나가면서, 재가입 가능 날짜를 에러 메시지 안의 글자로만 알려줬다. 전역 예외 핸들러가 ApiResponse<Void>라 에러 응답에는 값을 실을 수 없다. 이미 200으로 내리던 WITHDRAWAL_PENDING과 같은 방식으로, status에 WITHDRAWAL_LOCKED를 더하고 reRegisterableAt을 값으로 준다. 로그인과 복구가 같은 안내를 주도록 한 곳에서 만든다. 던지는 곳이 없어진 MEMBER_409_1은 제거한다. 안내 시각을 배치 주기에 맞춰 보정하지 않는 결정은 ADR 0013에 남긴다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * docs: 앱 연동 보완 구현 완료 반영 스펙 013을 Implemented로 올리고, 관련 스펙(010·011·001·003)에 갱신 행을 남긴다. ERD에 member_practice가 빠져 있어(스펙 011 때 누락) 테이블부터 추가하고 verified_level·content NULL 허용·is_verified_visit을 반영한다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * docs: 앱 연동 보완 관련 스펙 문서 정정 리뷰 지적 반영. 스펙 003이 재가입 대기를 여전히 409로 적고 있었고, 001의 로그인 응답 예시는 실제와 다른 isNewUser를 쓰고 있었다. 010에는 후기 상세 조회와 content 선택 입력 계약이 빠져 있었다. SocialLoginResponse의 필드 설명도 PENDING만 언급하고 있어 LOCKED를 함께 적는다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * test: 헛돌던 삭제·인증 단언 보강 즉시 탈퇴 테스트가 bookmark·refresh_token·member_onboarding에 행이 없는 채로 "0이다"를 확인하고 있어, 삭제 목록에서 빠져도 통과했다. 행을 만들고 삭제 전 존재까지 확인한다. 후기 상세의 isVerifiedVisit은 목 데이터로만 검증돼 실제 매핑이 확인되지 않았다. 방문 인증을 태운 뒤 단언한다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
@Profile("!prod")로 막아 두었는데, 배포 환경이 하나뿐이라(develop·main이 같은 서버, 컨테이너는 prod 프로파일) 정작 앱이 붙는 서버에는 엔드포인트가 없었다. 로컬 전용이 되어 목적을 잃는다. 게이트를 걷어내고 그대로 배포한다. 노출 제한은 앱이 debug 빌드에서만 연결하는 것으로 갈음하며, 본인 계정만 지워지는 것이 서버 측 유일한 제약이라는 점을 스펙에 남긴다. Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
* docs(course): 3차 업데이트 코스 등록·승인·튜토리얼 스펙 추가
사용자 코스 등록 기능을 기능 단위 스펙 4건으로 나눠 확정한다.
014가 도메인 모델(V24)·승인 상태·노출 규칙의 기준 문서다.
- 014 코스 등록 — 등록·등록 폼(카테고리 트리)·승인 전 비노출 필터
- 015 내 코스 관리 — 상태별 목록·soft delete·목록 삭제 표시
- 016 코스 승인 — 상태 변경(권한 부여 전까지 로그인 사용자 전체 임시 허용)
- 017 코스 등록 튜토리얼 — 완료 저장·로그인 응답으로 완료 여부 전달
주요 결정
- 승인 상태를 별도 접수 테이블 대신 course 컬럼에 둔다. 승인 후
place.id가 유지돼 북마크·후기·연습기록이 이어진다. 대신 place를
읽는 모든 쿼리에 노출 필터를 넣는다.
- 삭제는 soft delete. 남의 북마크·후기·연습기록을 지우지 않고
COURSE_404_2로 "삭제된 코스입니다"를 안내한다.
- 좌표·주소·주행거리는 앱이 카카오맵에서 받아 보내고 서버는 저장만
한다(서버 지오코딩·경로탐색 없음).
- 코스 수정(PUT)·반려 사유·등록 개수 제한은 범위 밖.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(course): 코스 승인 상태·등록자·soft delete 컬럼 추가
사용자 코스 등록(스펙 014)의 토대. 승인 상태를 별도 접수 테이블이
아니라 course에 둬서, 승인 후에도 place.id가 유지되고 북마크·후기·
연습기록이 그대로 이어지게 한다.
- V24: approval_status(NOT NULL·CHECK, DEFAULT 없음)·created_by_member_id
(ON DELETE SET NULL)·approved_at·deleted_at, 내 코스 목록용 인덱스
- 기존 시딩 코스는 APPROVED로 backfill
- 생성 경로 분리: builder()는 운영자 시딩(APPROVED),
register()는 사용자 등록(PENDING)
- 승인 전이는 자유롭되 같은 상태면 no-op — 재승인으로 approved_at이
밀리면 "언제 승인됐는지"가 흔들린다
- 삭제는 soft delete. 행을 지우면 남의 북마크·후기·연습기록까지
사라져 담아둔 사람은 항목이 없어진 이유를 알 수 없다
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(course): 미승인·삭제 코스를 전체 조회에서 제외
승인 상태를 course에 두기로 한 대가(스펙 014) — place를 읽는 모든
경로에 노출 조건을 넣는다. 한 곳만 빠뜨려도 심사 중인 코스가 지도·
검색에 노출되므로 조건을 VISIBLE 상수로 묶어 공유한다.
- 목록·필터 목록·검색·필터 검색·연관검색어·각 count 8개 쿼리에 적용
- 검색 계열은 기존 address/name OR 조건을 괄호로 묶고 AND — 안 묶으면
OR가 필터를 삼켜 전부 노출된다
- 마커 좌표는 findAll() → findAllVisible()(JPQL)로 교체
- 상세는 삭제면 COURSE_404_2, 미승인이면 등록자 본인만 200
미승인에 전용 에러 코드를 주지 않는 이유: 코드가 갈리면 id를 훑어
심사 중인 코스의 존재를 알아낼 수 있다. 없는 장소와 똑같이 COMMON_404로
응답한다. 삭제는 이미 담아둔 사용자에게 알려주는 게 목적이라 반대로
전용 코드로 구분한다(스펙 갱신).
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(course): 코스 등록·등록 폼 API 구현
지도에서 고른 경로로 코스를 등록한다(스펙 014). 승인 대기 상태로
저장돼 관리자 승인 전까지 전체 조회에 나오지 않는다.
- POST /api/v1/courses, GET /api/v1/courses/registration-form
- 경로점은 단일 waypoints 배열로 받고 서버가 구성을 검증한다 —
첫 항목 START, 마지막 DESTINATION, 가운데는 VIA 0~3개
- 코스명 생략 시 출발지 지점명을 쓴다(등록 화면에 입력란이 없다).
그래서 출발지 지점명만 필수
- PracticeCategory는 폼 생성 전용으로 DB에 저장하지 않는다.
코스에 남는 값은 PracticeType뿐이고 카테고리는 역산 가능하다
- "전체" 버튼 노출은 항목 수 ≤ 최대 선택 개수로 파생 — 4개인
복합 상황만 자동으로 꺼지고, 구성이 바뀌어도 규칙이 따라온다
- 등록 응답은 201이 아니라 200 — 프로젝트의 모든 POST가 200이라
등록만 다르게 두면 앱이 분기해야 한다(스펙 갱신)
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(course): 내 코스 목록·삭제 구현
승인 전 코스는 전체 목록에 나오지 않으므로(스펙 014), 등록자가 심사
상태를 확인할 창구를 만든다(스펙 015).
- GET /api/v1/members/me/courses (상태 필터·커서), DELETE /api/v1/courses/{id}
- 삭제는 soft delete. 물리 삭제하면 다른 사용자의 북마크·후기·연습기록까지
사라져 담아둔 사람은 항목이 없어진 이유를 알 수 없다
- 저장 목록·연습 목록 응답에 isDeleted 추가 — 탭하기 전에 구분할 수 있어야
"삭제된 코스입니다"를 띄우려던 목적이 반쪽이 되지 않는다
- isDeleted는 Place의 다형 메서드로 둔다. 두 목록은 place를 지연 로딩으로
들고 있어 instanceof Course가 프록시에서 거짓이 되고, 그러면 삭제된
코스가 멀쩡한 것처럼 표시된다(drivingDistanceMeters와 같은 함정)
- 목록 커서는 id 하나만 — place.id가 IDENTITY라 id 내림차순이 곧 최신순
- 삭제는 없는 id면 멱등 200, 주차장 id면 404로 구분한다
- Swagger에 memberId가 쿼리 파라미터로 노출되던 것 수정
(OpenApiSchemaTest가 검출)
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(course): 관리자 코스 승인 상태 변경 API 구현
사용자 등록 코스를 승인·반려·대기로 전환하는 관리자 API를 추가한다
(스펙 016). 권한 체계가 아직 없어 이번 단계에서는 로그인 사용자 전체가
호출할 수 있게 두고, 관리자 권한 검사는 TODO로 남긴다.
- PATCH /api/v1/admin/courses/{courseId}/approval
- 승인 상태 자유 전이, 같은 상태 변경은 멱등 no-op
- APPROVED 전환 시 approvedAt 기록, 재승인으로 시각이 밀리지 않음
- 삭제된 코스는 COURSE_404_2, 없는 코스·주차장 id는 COURSE_404_1
- 승인되면 기존 노출 필터로 전체 목록에 즉시 나타나고, 반려/대기로
바뀌면 즉시 빠지는 흐름까지 통합 테스트로 검증
Co-Authored-By: Codex Opus 5 <noreply@anthropic.com>
* fix(course): 코스 등록 폼 구성 최신화
코스 등록 화면 변경에 맞춰 등록 폼 응답에서 연습유형 전체 선택 필드를
제거하고, 화면 소제목과 카테고리별 연습유형 매핑을 최신 기획표에 맞춘다.
- practiceType.selectAllLabel, categories[].selectAllEnabled 제거
- 기본정보·연습유형 카테고리 고르기·연습유형·주의사항 작성·한줄 소개 섹션 제목 추가
- 도심 기본에서 PARKING 제거
- 도로 흐름·복합 상황 연습유형 순서 수정
- 스펙 014와 테스트 갱신
Co-Authored-By: Codex Opus 5 <noreply@anthropic.com>
* feat(member): 코스 등록 튜토리얼 완료 저장 구현
코스 등록 튜토리얼을 한 번만 보여주기 위해 회원에 완료 시각을 저장하고,
로그인·토큰 재발급 응답으로 완료 여부를 미리 내려준다(스펙 017).
- V25: member.course_tutorial_completed_at 추가
- PATCH /api/v1/members/me/course-tutorial
- 완료 저장은 멱등 처리 — 다시 호출해도 최초 완료 시각 유지
- SocialLoginResponse, TokenResponse에 isCourseTutorialCompleted 추가
- 신규 가입과 토큰 없는 탈퇴 상태(PENDING·LOCKED)는 false
- ERD와 스펙 상태 갱신
Co-Authored-By: Codex Opus 5 <noreply@anthropic.com>
* style(course): spotless 포맷 적용
Co-Authored-By: Codex Opus 5 <noreply@anthropic.com>
* fix(course): 코스 리뷰 지적 반영
Co-Authored-By: Codex Opus 5 <noreply@anthropic.com>
* fix(member): 튜토리얼 완료 시각 정밀도 보정
Co-Authored-By: Codex Opus 5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
|
Important Review skippedToo many files! This PR contains 199 files, which is 99 over the limit of 100. To get a review, reduce the PR to 100 files or fewer by splitting it into smaller PRs or changing its base branch. Upgrade to a paid plan to raise the limit. This review couldn't start because sufficient usage credits or metered capacity aren't available. Add credits or update usage-based reviews in the billing tab, then retry. ⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: ASSERTIVE Plan: Pro Plus Run ID: ⛔ Files ignored due to path filters (2)
📒 Files selected for processing (199)
You can disable this status message by setting the 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. Comment |
요약
3차 업데이트 배포. 마이페이지·검색/필터·최근검색·후기·연습 코스·레벨 승급·코스 등록/승인까지 develop에 쌓인 11개 기능 묶음을 main으로 내보낸다.
develop→main이므로 컨벤션대로 Merge commit으로 머지한다(스쿼시 금지 — 어떤 기능들이 함께 배포됐는지 릴리즈 묶음을 보존한다).변경 사항
006-mypage004-onboarding007-course-search-filter008-recent-search008·009-related-search010-place-review011-practice-course012-level-progress013-app-integration-refinements003-member-withdrawal014·015·016·017마이그레이션 — 이번 머지로 새로 적용되는 것 없음
운영 DB는 이미 V25까지 적용돼 있다(확인 완료). CD가 main·develop 모두 같은 Lightsail 앱·같은 DB에 배포하는 단일 서버 구성이라(cd.yml), 위 11개 PR이 develop에 머지될 때마다 Flyway가 V8~V25를 이미 순차 적용했다.
따라서 이 머지에서 Flyway는
flyway_schema_history를 보고 전부 적용 완료로 판단하고 넘어간다.V16(후기 내용 컬럼 축소)·V23(verified 컬럼 제거) 같은 비가역 마이그레이션도 이미 오래전에 실행된 상태라, 이번 배포로 새로 발생하는 스키마 위험은 없다.배포 후 확인:
이 배포가 실제로 하는 일
애플리케이션 코드만 재배포된다. 내용은 develop이 이미 배포한 것과 동일하므로 운영 동작은 변하지 않는다. 실질적으로는 main을 develop과 같은 지점으로 맞추는 이력 정리에 가깝다.
그래도 필요한 작업이다 — main이 "지금 운영에 떠 있는 것"을 가리켜야 롤백 기준점·hotfix 분기점으로 쓸 수 있는데, 지금은 11개 뒤처져 그 역할을 못 하고 있다.
관련 이슈
체크리스트
./gradlew test통과 (develop 기준)참고