"""동일 업소 후보 조회 — ★ 서버가 자동 확정하지 않고 사람이 고르게 한다. 남의 가게를 붙이는 게 이 서비스에서 제일 비싼 실수다(체크인 시간이 틀리면 실제 예약 클레임). 그래서 자동 판정이 MATCHED 여도 후보를 전부 내려보내 UI 가 확인시킬 수 있게 한다. """ from common.enums import ErrorType from services.external import kakao as kakao_client from services.external import naver as naver_client def _np(name, addr, url=None): return naver_client.NaverPlace( name=name, road_address=addr, address=None, phone=None, latitude=38.0, longitude=128.7, category_name="숙박>펜션", place_url=url, naver_place_id=None, ) def _match(outcome, place=None, candidates=None, reason=None): return naver_client.MatchResult( outcome=outcome, place=place, candidates=candidates or [], reason=reason, detail=None, ) async def _place(client, h, name="핑크비치펜션"): return (await client.post("/v1/place", headers=h, json={"name": name, "category": 1})).json()["place"]["place_id"] def _patch_naver(monkeypatch, result): """네이버 판정을 고정값으로 바꾼다. 호출 인자를 그대로 돌려줘 호출측 규약도 볼 수 있게 한다.""" monkeypatch.setattr(kakao_client.KakaoLocalClient, "enabled", property(lambda self: False)) monkeypatch.setattr(naver_client.NaverLocalClient, "enabled", property(lambda self: True)) seen: dict = {} async def _verify(self, name, address_hint=None, *, search_query=None): seen["name"] = name seen["search_query"] = search_query return result async def _close(self): return None monkeypatch.setattr(naver_client.NaverLocalClient, "verify_place", _verify) monkeypatch.setattr(naver_client.NaverLocalClient, "aclose", _close) return seen async def test_single_match_is_auto_selectable(auth_headers, client, monkeypatch): """검증: 정확히 1건 일치하는 상호명. 기대결과: auto_selectable=true 로 내려오되 **후보는 그대로 내려온다** — UI 가 한 번 확인시킬 수 있다.""" only = _np("핑크비치펜션", "강원특별자치도 양양군 현북면 하조대3길 11", "http://pinkbeach.kr") _patch_naver(monkeypatch, _match(kakao_client.MatchOutcome.MATCHED, only, [only], "name_exact")) h = await auth_headers("u1") pid = await _place(client, h) body = (await client.get(f"/v1/place/{pid}/verify/candidates", headers=h)).json() assert body["result"]["success"] is True assert body["outcome"] == "matched" assert body["auto_selectable"] is True assert len(body["candidates"]) == 1 assert body["candidates"][0]["place_url"] == "http://pinkbeach.kr" async def test_ambiguous_returns_all_candidates_for_ui(auth_headers, client, monkeypatch): """검증: 동명 업소가 여러 건이라 자동 판정이 안 된다. 기대결과: ★ auto_selectable=false + 후보 전체 — UI 가 목록을 그려 사람이 고른다.""" rows = [ _np("하조대펜션", "강원특별자치도 양양군 현북면 하조대3길 11"), _np("하조대펜션", "강원특별자치도 양양군 현북면 하조대2길 48"), _np("하조대펜션", "강원특별자치도 양양군 손양면 동명로 5"), ] _patch_naver(monkeypatch, _match(kakao_client.MatchOutcome.AMBIGUOUS, None, rows, "name_duplicate")) h = await auth_headers("u1") pid = await _place(client, h, "하조대펜션") body = (await client.get(f"/v1/place/{pid}/verify/candidates", headers=h)).json() assert body["outcome"] == "ambiguous" assert body["auto_selectable"] is False assert len(body["candidates"]) == 3 assert body["reason"] == "name_duplicate" # 사람이 고를 수 있게 주소가 다 실려 있어야 한다 assert len({c["road_address"] for c in body["candidates"]}) == 3 async def test_no_candidate_is_reported(auth_headers, client, monkeypatch): """검증: 외부 장소 DB 에 후보가 하나도 없다. 기대결과: PLACE_VERIFY_NO_CANDIDATE — 사장님이 직접 입력하는 경로로 안내해야 한다.""" _patch_naver(monkeypatch, _match(kakao_client.MatchOutcome.NO_CANDIDATE, None, [], "empty")) h = await auth_headers("u1") pid = await _place(client, h, "존재하지않는가게") body = (await client.get(f"/v1/place/{pid}/verify/candidates", headers=h)).json() assert body["result"]["code"] == ErrorType.PLACE_VERIFY_NO_CANDIDATE.value async def test_picked_candidate_can_be_confirmed(auth_headers, client, monkeypatch): """검증: 후보 목록에서 하나를 골라 확정한다(UI 흐름 전체). 기대결과: 확정되고, 후보가 준 홈페이지가 공식 채널로 자동 등록된다.""" rows = [ _np("하조대펜션", "강원특별자치도 양양군 현북면 하조대3길 11", "http://hajodae-a.kr"), _np("하조대펜션", "강원특별자치도 양양군 손양면 동명로 5", "http://hajodae-b.kr"), ] _patch_naver(monkeypatch, _match(kakao_client.MatchOutcome.AMBIGUOUS, None, rows, "name_duplicate")) h = await auth_headers("u1") pid = await _place(client, h, "하조대펜션") cands = (await client.get(f"/v1/place/{pid}/verify/candidates", headers=h)).json()["candidates"] picked = cands[1] # 사람이 두 번째를 골랐다 r = (await client.post(f"/v1/place/{pid}/verify", headers=h, json={ "source": 2, "road_address": picked["road_address"], "latitude": picked["latitude"], "longitude": picked["longitude"], "place_url": picked["place_url"], })).json() assert r["result"]["success"] is True assert r["place"]["road_address"] == "강원특별자치도 양양군 손양면 동명로 5" links = (await client.get(f"/v1/place/{pid}/link/list", headers=h)).json()["links"] official = [l for l in links if l["url"] == "http://hajodae-b.kr"] assert official, "고른 후보의 홈페이지가 공식 채널로 등록되지 않았다" assert official[0].get("confirmed_at") is None, "등록만 하고 확정은 따로다" async def test_candidates_require_configured_source(auth_headers, client, monkeypatch): """검증: 카카오도 네이버도 키가 없다. 기대결과: LOCAL_NOT_CONFIGURED — 조용히 빈 목록을 주지 않는다.""" monkeypatch.setattr(kakao_client.KakaoLocalClient, "enabled", property(lambda self: False)) monkeypatch.setattr(naver_client.NaverLocalClient, "enabled", property(lambda self: False)) h = await auth_headers("u1") pid = await _place(client, h) body = (await client.get(f"/v1/place/{pid}/verify/candidates", headers=h)).json() assert body["result"]["code"] == ErrorType.LOCAL_NOT_CONFIGURED.value async def test_candidates_scoped_to_company(auth_headers, client, other_company_id, monkeypatch): """검증: 다른 회사 계정으로 남의 사업장 후보를 조회한다. 기대결과: PLACE_NOT_FOUND.""" _patch_naver(monkeypatch, _match(kakao_client.MatchOutcome.MATCHED, _np("a", "b"), [], "x")) h1 = await auth_headers("o1") pid = await _place(client, h1) h2 = await auth_headers("o2", other_company_id) body = (await client.get(f"/v1/place/{pid}/verify/candidates", headers=h2)).json() assert body["result"]["code"] == ErrorType.PLACE_NOT_FOUND.value async def test_region_stays_in_query_and_out_of_the_match_name(auth_headers, client, monkeypatch): """검증: 화면이 '상호명 + 위치'를 합쳐 query 로 보낸다. 기대결과: 검색어에는 지역이 그대로 실리고, 판정용 상호명에는 **상호만** 간다. ★ 왜 이걸 못 박아 두나: 판정(pick_match)은 후보 상호명과 정확일치를 본다. 지역이 붙은 문자열을 판정에 그대로 넘기면 정확일치가 구조적으로 성립할 수 없어, 후보가 단 1건인 경우까지 AMBIGUOUS 로 떨어진다 — 사장님은 매번 "비슷한 가게가 여럿입니다"를 읽는다. 실측(2026-08-28) 10건 전부 그랬다. 검색은 넓게, 판정은 좁게. """ only = _np("보사노바 커피로스터스 강릉점", "강원 강릉시 창해로14번길 28") seen = _patch_naver( monkeypatch, _match(kakao_client.MatchOutcome.MATCHED, only, [only], "name_exact") ) h = await auth_headers("u1") pid = await _place(client, h, name="보사노바 커피로스터스 강릉점") body = ( await client.get( f"/v1/place/{pid}/verify/candidates", headers=h, params={"query": "보사노바 커피로스터스 강릉점 강릉 견소동"}, ) ).json() assert body["result"]["success"] is True assert seen["search_query"] == "보사노바 커피로스터스 강릉점 강릉 견소동" assert seen["name"] == "보사노바 커피로스터스 강릉점" async def test_match_name_falls_back_to_query_when_place_has_no_name(auth_headers, client, monkeypatch): """검증: 사업장 상호가 비어 있다(직접 입력 등으로 이름 없이 만들어진 경우). 기대결과: 검색어를 판정용 상호명으로도 쓴다 — 조회 자체가 실패하지는 않는다.""" only = _np("핑크비치펜션", "강원특별자치도 양양군") seen = _patch_naver( monkeypatch, _match(kakao_client.MatchOutcome.MATCHED, only, [only], "name_exact") ) h = await auth_headers("u1") pid = await _place(client, h, name="핑크비치펜션") # 상호를 비운다 — places.name 이 빈 문자열인 상태를 만든다. await client.patch(f"/v1/place/{pid}", headers=h, json={"name": ""}) body = ( await client.get( f"/v1/place/{pid}/verify/candidates", headers=h, params={"query": "핑크비치펜션 양양"} ) ).json() assert body["result"]["success"] is True assert seen["name"] == "핑크비치펜션 양양"