chore: 시연용 표지 이미지를 정적 리소스에 추가하고 place에 연결한다

[minyongP]

배경

place 썸네일 목업 기반은 #182 / PR #184로 dev에 머지됐다(S15P11A705-305). 이어서 PR #194(S15P11A705-320)로 더미를 WebP로 교체하고 실제 이미지를 둘 경로를 확정했다.

코드 쪽 준비는 끝났다. thumbnail_url 컬럼, 응답 계약(PlaceSummaryResponse.thumbnailUrl), 정적 서빙 경로와 인증 제외가 모두 들어가 있고 WebP 서빙도 검증했다. 남은 것은 이미지를 넣는 것과 URL을 DB에 넣는 것뿐이고, 둘 다 코드 변경이 아니다. 그래서 이 이슈는 Jira 티켓 없이 이 문서를 절차서로 삼아 진행한다.

더미 이미지는 테스트 리소스에만 있어 배포 산출물에는 이미지가 없다. 그래서 지금 배포 환경의 thumbnail_url은 전부 NULL이고, 프론트(front#94)는 폴백 경로만 검증할 수 있다.

1단계 — 이미지를 넣는다

둘 곳

src/main/resources/static/images/places/test/

디렉터리가 아직 없으므로 새로 만든다. main 리소스여야 배포 산출물(jar)에 실린다 — 현재 더미가 있는 src/test/resources/...는 테스트에서만 서빙되고 배포에는 들어가지 않는다.

test/ 하위인 이유는 두 가지다. 목업이라는 것이 경로에서 드러나고, SecurityConfig의 PUBLIC_STATIC_ASSETS(/images/places/**)가 하위 경로까지 덮어서 시큐리티 설정과 정적 서빙 테스트를 고칠 필요가 없다. 나중에 실제 장소 사진으로 전환하면 images/places/ 바로 아래로 분리한다.

파일명 — 테스트 픽스처와 같은 규약을 쓴다. 장소가 늘면 같은 패턴으로 더한다.

cafe-1.webp  cafe-2.webp  restaurant-1.webp  park-1.webp

규격 — 4:3 비율, 가로 1200px(즉 1200×900), 장당 100KB 이하, WebP.

이 PC에는 cwebp도 ImageMagick도 없다. convert가 PATH에 잡히지만 그것은 Windows의 FAT 변환기(System32\convert.exe)이므로 이미지 변환에 쓰면 안 된다. Pillow로 한다.

python -c "
import glob, os
from PIL import Image
for p in sorted(glob.glob('*.jpg') + glob.glob('*.png')):
    im = Image.open(p).convert('RGB').resize((1200, 900), Image.LANCZOS)
    out = os.path.splitext(p)[0] + '.webp'
    im.save(out, 'WEBP', quality=82, method=6)
    print(out, str(os.path.getsize(out) // 1024) + 'KB')
"

출처는 아직 정하지 않았다. 직접 촬영·보유 사진, 무료 스톡(라이선스 표기 확인 필요), 생성 이미지 중 무엇을 쓸지 정하고 근거를 남긴다. 라이선스 표기가 필요한 출처면 그 표기도 함께 넣는다.

넣은 뒤 커밋 → PR → dev 머지 → 배포까지 간다. 배포되면 이렇게 확인한다.

curl -sI https://pin-log.com/api/core/images/places/test/cafe-1.webp | head -3

200과 content-type: image/webp가 나와야 다음 단계로 간다.

2단계 — DB에 URL을 넣는다

접속은 CloudBeaver(db.pin-log.com)를 쓴다. 쓰기 권한이 아직 없다 — 아래 「막힘」 참고.

대상 place 고르기. 시연에 실제로 쓰이는 place, 즉 record가 달려 있는 place를 본다.

SELECT p.id, p.name, p.address, count(r.id) AS records
FROM core.place p
JOIN core.record r ON r.place_id = p.id AND r.deleted_at IS NULL
GROUP BY p.id, p.name, p.address
ORDER BY records DESC, p.id;

URL 넣기. 값은 /api/core/images/places/test/<파일명>.webp다. /api/core 접두어는 게이트웨이가 떼고 Spring은 /images/places/...로 받는다 — 저장값에는 접두어를 포함해야 프론트가 <img src>에 그대로 쓸 수 있다.

UPDATE core.place SET thumbnail_url = '/api/core/images/places/test/cafe-1.webp'      WHERE id = <카페 place id>;
UPDATE core.place SET thumbnail_url = '/api/core/images/places/test/cafe-2.webp'      WHERE id = <카페 place id 2>;
UPDATE core.place SET thumbnail_url = '/api/core/images/places/test/restaurant-1.webp' WHERE id = <식당 place id>;
UPDATE core.place SET thumbnail_url = '/api/core/images/places/test/park-1.webp'       WHERE id = <공원 place id>;

PR #184 본문의 SQL 원문을 그대로 쓰면 안 된다. 경로에 test/가 없고 확장자가 .jpg다.

확인.

SELECT id, name, thumbnail_url FROM core.place WHERE thumbnail_url IS NOT NULL ORDER BY id;

그다음 해당 place의 record 상세를 실제로 호출해 place.thumbnailUrl이 실려 오는지 보고, 배포 웹에서 PC·모바일 폭 모두 4:3으로 잘려 표시되는지 확인한다.

마지막으로 front#94에 값이 들어갔음을 알린다 — 그 이슈에 그렇게 약속해 뒀고, 프론트는 그때부터 4:3 표시 조건을 검증할 수 있다.

완료 조건

• 이미지 출처와 그 선택 근거(라이선스 포함)가 기록된다
• 이미지가 src/main/resources/static/images/places/test/에 커밋되어 배포 산출물에 실린다
• 배포 환경에서 /api/core/images/places/test/*.webp가 200과 image/webp로 열린다
• 시연 대상 place의 record 상세 응답에 thumbnailUrl이 채워져 내려온다
• 배포 웹의 record 상세 화면에서 썸네일이 PC·모바일 폭 모두 4:3으로 표시된다
• 값이 들어갔음을 front#94에 공유한다

막힘

• 표지 이미지 자산 수급 대기 — 출처가 미정이다.
• 배포 DB 쓰기 경로. infra#189로 요청했으나 담당자가 minyongP(요청자 본인)로 잡혀 있어 인프라 쪽에 전달되지 않았고, 2026-08-04 이후 댓글이 없다. 같은 권한을 요청하는 infra#116이 이미 있고 담당자가 tpals0409다 — core 테이블의 INSERT·UPDATE·DELETE를 요구하므로 위 UPDATE에 필요한 권한과 같다. #189를 #116으로 합치는 것이 실제 경로로 보인다.

[minyongP]

1단계(이미지 넣기)를 PR #198로 올렸다. 이슈 본문과 달라진 점 세 가지를 여기 남긴다.

장당 용량 상한을 100KB에서 400KB로 올린다. 100KB는 단색에 가까운 더미로 잡은 값이라 실사진에 적용할 수 없었다. 1200×900 q82 실측으로 도산공원 330KB, 별마당 도서관 429KB가 나온다. 지키려면 가로를 800px 아래로 내리거나 품질을 q46까지 떨어뜨려야 해서 눈에 띄게 뭉갠다. 비율 4:3과 가로 1200px은 그대로다.

파일명이 업종에서 장소 이름으로 바뀐다. cafe-1·restaurant-1 대신 starfield-library·dosan-park 같은 실제 장소 이름을 쓴다. 실제 장소 사진이므로 어느 place에 붙일지가 이름에서 드러나야 한다. PlaceThumbnailAssetTests는 src/test/resources의 더미만 조회하므로 정적 서빙 테스트는 영향이 없다.

출처는 Wikimedia Commons이고 6장이다. 출처표시만 요구하는 라이선스(CC0·CC BY·공공누리 제1유형)로 좁혔다. TourAPI는 서비스키를 받아 강남역 반경 3km 67곳을 실제로 조회했으나 쓰지 못했다 — 음식점 사진이 전부 공공누리 제3유형(변경금지)이고, 제1유형 사진은 원본이 이미 940px 이하이며, 모든 사진에 한국관광공사 워터마크가 박혀 있다. 자세한 근거는 작업 로그 docs/backend/worklog/2026-08-06-back188-place-thumbnail-gangnam-assets.md에 있다.

2단계(배포 DB에 URL 연결)는 그대로 남아 있다. 사진이 실제 장소 사진이라 아무 place에나 붙일 수 없고, 매칭되는 place가 없는 사진은 쓰지 않는다.

[minyongP]

2단계용 시드 SQL이다. PR #198이 머지되고 배포된 뒤에 실행해야 thumbnail_url이 가리키는 이미지가 산다.

kakao_place_id가 유니크(uq_place_kakao)라 이미 있는 place면 thumbnail_url만 갱신하고 name·address 같은 기존 값은 건드리지 않는다. 로컬 Postgres에서 COMMIT을 ROLLBACK으로 바꿔 실행해 INSERT 0 11까지 확인했다.

-- 강남구 시연용 place 시드 — TourAPI 사진 + 카카오 로컬 장소 값
-- 만든 날짜: 2026-08-06 / 추적: back#188
--
-- 사진 출처: 한국관광공사 TourAPI, 공공누리 제1유형(출처표시). 제3유형은 변경 금지라 쓰지 않았다.
-- 이미지는 back 레포 static/images/places/tourapi/ 에 있다. 배포된 뒤에 실행해야 URL이 산다.
--
-- kakao_place_id가 유니크(uq_place_kakao)라 이미 있는 place면 thumbnail_url만 갱신한다.
-- name·address 같은 기존 값은 건드리지 않는다 — 운영 데이터를 덮어쓰지 않기 위해서다.

BEGIN;

INSERT INTO core.place
    (kakao_place_id, name, address, road_address, phone, place_url, thumbnail_url, lat, lng)
VALUES
    ('10246086', '대모산도시자연공원', '서울 강남구 일원동 53-22', NULL, '02-2104-1912', 'http://place.map.kakao.com/10246086', '/api/core/images/places/tourapi/10246086.webp', 37.4798207668752, 127.081321216711),  -- TourAPI: 대모산도시자연공원
    ('758415412', '향기억', '서울 강남구 신사동 657-19', '서울 강남구 선릉로157길 23', '02-517-9070', 'http://place.map.kakao.com/758415412', '/api/core/images/places/tourapi/758415412.webp', 37.52608949703695, 127.03787784889364),  -- TourAPI: 향기억
    ('26928847', '갤러리JJ', '서울 강남구 신사동 597-1', '서울 강남구 압구정로30길 63', '02-322-3979', 'http://place.map.kakao.com/26928847', '/api/core/images/places/tourapi/26928847.webp', 37.523249309421615, 127.02915789235401),  -- TourAPI: 갤러리JJ
    ('19148116', '국가무형유산전수교육관', '서울 강남구 삼성동 112-2', '서울 강남구 봉은사로 406', '02-566-6300', 'http://place.map.kakao.com/19148116', '/api/core/images/places/tourapi/19148116.webp', 37.5101898276068, 127.044653850051),  -- TourAPI: 국가무형유산전수교육관
    ('1703582456', '논현문화마루도서관', '서울 강남구 논현동 40-5', '서울 강남구 논현로131길 40', '02-512-8580', 'http://place.map.kakao.com/1703582456', '/api/core/images/places/tourapi/1703582456.webp', 37.5138469281521, 127.02710580276),  -- TourAPI: 논현문화마루도서관
    ('8000439', '역삼도서관', '서울 강남구 역삼동 829-20', '서울 강남구 역삼로7길 16', '02-508-1139', 'http://place.map.kakao.com/8000439', '/api/core/images/places/tourapi/8000439.webp', 37.49537383790107, 127.03328248367103),  -- TourAPI: 역삼도서관
    ('25051288', '유엠갤러리', '서울 강남구 신사동 556-26', '서울 강남구 도산대로25길 35', '02-515-3970', 'http://place.map.kakao.com/25051288', '/api/core/images/places/tourapi/25051288.webp', 37.521800274448445, 127.02626704822707),  -- TourAPI: 유엠갤러리
    ('17573702', '코엑스', '서울 강남구 삼성동 159', '서울 강남구 영동대로 513', '02-6000-0114', 'http://place.map.kakao.com/17573702', '/api/core/images/places/tourapi/17573702.webp', 37.511824182641504, 127.05915859162609),  -- TourAPI: 코엑스
    ('1219098323', '플랫폼엘 컨템포러리 아트센터', '서울 강남구 논현동 85-11', '서울 강남구 언주로133길 11', '02-6929-4470', 'http://place.map.kakao.com/1219098323', '/api/core/images/places/tourapi/1219098323.webp', 37.51613992410261, 127.03426787741671),  -- TourAPI: 플랫폼엘
    ('8216140', '논현가구거리', '서울 강남구 논현동 55-16', '서울 강남구 학동로 125', NULL, 'http://place.map.kakao.com/8216140', '/api/core/images/places/tourapi/8216140.webp', 37.5124049314709, 127.024779773951),  -- TourAPI: 논현 가구거리
    ('959051403', '10꼬르소꼬모 청담점', '서울 강남구 청담동 79', '서울 강남구 압구정로 416', '02-3018-1010', 'http://place.map.kakao.com/959051403', '/api/core/images/places/tourapi/959051403.webp', 37.5269276919481, 127.04240574538971)  -- TourAPI: 10꼬르소꼬모 청담점
ON CONFLICT (kakao_place_id) DO UPDATE
SET thumbnail_url = EXCLUDED.thumbnail_url,
    updated_at    = now();

-- 확인 — 방금 넣은 것만 본다
SELECT id, kakao_place_id, name, thumbnail_url
FROM core.place
WHERE kakao_place_id IN ('10246086', '758415412', '26928847', '19148116', '1703582456', '8000439', '25051288', '17573702', '1219098323', '8216140', '959051403')
ORDER BY name;

COMMIT;

-- 되돌리기: 사진 연결만 끊고 place는 남긴다
-- UPDATE core.place SET thumbnail_url = NULL, updated_at = now()
--  WHERE kakao_place_id IN ('10246086', '758415412', '26928847', '19148116', '1703582456', '8000439', '25051288', '17573702', '1219098323', '8216140', '959051403');