[S15P11A705-307] back 실제 상태로 BD-46·latestCollectionId·thumbnailUrl 서술 정정

[TrossYou]

관련 이슈

S15P11A705-307 (후속 정정)

작업 내용

back 레포(Team-PinLog/back)의 실제 PR·결정 문서를 확인한 결과, #100에 담긴 서술 세 건이 사실과 달라 정정한다. 추측이 아니라 back PR 본문과 docs/backend/decisions/를 근거로 삼았다.

1. BD-46 — "해소 대기 중인 한계"가 아니라 의도적 보류 결정이었다

BD-46-list-sort-default-asc-with-params.md와 back #168을 확인했다. BD는 Jira 이슈가 아니라 Backend Decision 문서이고, 커서-방향 미검증은 고쳐지길 기다리는 버그가 아니라 감수하기로 결정한 트레이드오프다. back #168 본문에 "back 후속 없음"이 명시돼 있다.

• 정렬 방향 전환은 프론트 상수 한 줄 + 프론트 배포로 끝난다 — 판단 주체(화면을 보는 프론트)와 실행 주체를 일치시키려고 (c)안을 고른 결과다.
• 재검토 트리거는 **"정렬을 사용자 노출 토글로 만드는 순간"**이며, 그때 back에 "커서에 방향을 싣고 불일치를 400으로 거절"을 선행 작업으로 요청해야 한다.
• 커서가 Base64(정렬키, id)라 방향 정보가 없어 형식상 유효한 요청이 되고, 그래서 400을 낼 근거가 없다는 것까지 반영했다.
• [협의 필요]에서 제거했다 — 백엔드에 물어볼 것이 없는 항목이다.

2. latestCollectionId — 아직 머지 안 됨 (back #191 OPEN)

back PR #191(S15P11A705-308)이 열려만 있다. 현재 지도 마커가 전부 미분류 색인 것은 정상이며 optional 유지가 맞다. #100에서 "배포 시점이 늦어질 가능성"이라고 두루뭉술하게 적었던 것을 실제 상태로 바꿨다.

3. thumbnailUrl — 이미 머지됨 (back #184 MERGED, 2026-08-04)

PlaceSummaryResponse를 쓰는 모든 응답에 실린다. Record 상세뿐 아니라 Collection 상세도 포함이라, 두 곳의 Zod 스키마에 필드를 추가했다.

⚠️ 다만 당분간 값은 사실상 전부 null이다. back #184 본문 기준 (1) 이미지 파일이 src/test/resources에만 있어 배포 산출물에 실리지 않고, (2) place에 이미지를 잇는 UPDATE SQL이 미실행이다(배포 DB 쓰기 권한을 infra#189에서 요청 중). 폴백 이미지가 기본 화면이라고 보고 디자인해야 한다 — 이 점을 문서에 명시했다.

back이 SecurityConfig에 /images/places/** permitAll을 이미 넣어 인증은 막지 않으므로, 남은 변수는 Traefik 라우팅뿐이다(/api/core/v1이 아니라 /api/core/ 프리픽스로 넘겨야 함).

4. 회원 탈퇴 2단계 — 이미 완료됨

front #97(back #181 S15P11A705-285)로 이미 구현·머지돼 있었다. #100에서 "별도 티켓 필요"라고 적은 것은 사실이 아니라 경고 문구를 걷어냈다.

변경 유형

• feat (기능)
• fix (버그)
• refactor / chore / docs / style / test

확인 방법

• npx tsc --noEmit / npx vitest run(78 passed) 통과.
• thumbnailUrl은 .nullable().optional()이라 서버가 아직 안 내려줘도 파싱이 깨지지 않는다. Record 상세·Collection 상세 진입해 기존과 동일하게 렌더되는지만 확인하면 된다(현재는 값이 없어 화면 변화 없음).

체크리스트

• 공개 화면(Feed, 타인 Shelf, Collection 상세)에 Context 원문·신원 정보를 노출하지 않았다
• member.id(내부 사용자 ID)를 URL·요청·응답에 사용하지 않았다 (진입점은 Collection id)
• Keyword는 label만 사용하고 code를 노출하지 않았다
• Context 수정 후 새 contextId로 쿼리 키·URL·선택 상태를 교체했다 (이번 변경 범위에 Context 수정 없음)
• keywords: [] 등 빈 결과를 오류로 처리하지 않았고 로딩·오류·401 상태를 처리했다
• docs/conventions.md(용어·any·컴포넌트 직접 API 호출 금지)를 지켰다

---

남은 문의는 인프라 한 건뿐이다

BD-46과 탈퇴가 정리되면서 백엔드 문의는 사라졌다. 인프라 확인만 남는다:

Traefik 라우팅 규칙의 정확한 경로 프리픽스를 확인 부탁드립니다. 규칙이 /api/core/v1로 좁혀져 있으면 장소 썸네일(/api/core/images/places/…)이 프론트 nginx의 /api/* → 404로 떨어집니다. 로컬은 vite proxy가 /api 전체를 넘겨서 안 드러나고 운영에서만 깨집니다. 함께 api-contract.md [협의 필요] 1번(same-origin 실측)도 봐주시면 [확정]으로 승격하겠습니다.

🤖 Generated with Claude Code

[TrossYou]

브랜치 규칙(티켓 선행) 미준수로 되돌립니다. 티켓 생성 후 다시 올립니다.