-idZddlmZddlZddlZddlmZmZmZm Z m Z eje Z e dZe dZej dZej dZd d Zd d Z d dd Zdd Zy)u엔티티 이름 매칭 유틸 — 괄호 접미사 드리프트 대응. **배경** `character_angles[].character`(LLM 출력) 등 시나리오 단위 입력과 `EntityCanon.name` (DB 고정) 사이에 표기 드리프트가 발생함: - "이도령" vs "이도령(혼)" (괄호 접미사 variant) - "수리영 " vs "수리영" (공백) - "민숙" vs " 민숙 " (전후 공백) exact-match 전제로 작성된 기존 dict lookup(`name_to_uuid.get(name)`) 패턴은 이런 드리프트에서 정상 엔티티까지 "미등록"으로 분류하는 silent bug를 만든다. **정규화 범위** 안전(공백만): - 앞뒤 공백 제거 - 중간 연속 공백 단일화 별개 단계(괄호 제거): - variant 엔티티("서현 (5세)")와 base("서현")가 공존하는 실측 데이터가 있어 괄호 제거 정규화 키를 variant 엔티티에 등록하면 base와 충돌 → silent 오매칭. - 따라서 `build_name_index`는 괄호 있는 엔티티를 저장할 때 **bare key(괄호 제거 키)를 등록하지 않음**. base는 원본=bare이므로 자연 등록. variant는 원본 및 공백 정리만. - `lookup_name`은 query 쪽을 단계별로 완화(raw → 공백정리 → bare)해 최대한 맞춤. 이 최후 수단이 base에 맞을 수도 있지만, 원본 표기가 일치하면 variant 우선이라 안전. 의도적으로 **제외**: - 조사 제거("민숙이"→"민숙"): "민숙이"가 본명일 수 있음. - 대소문자 통일: 한글은 불필요. 영문명은 원본 표기 의도 보존. **사용** ```python from app.core.name_matcher import build_name_index, lookup_name idx = build_name_index(canons, key_fn=lambda c: c.name, value_fn=lambda c: c.id) uuid = lookup_name(idx, llm_name) # None이면 미등록 ``` ) annotationsN)CallableDictIterableOptionalTypeVarTVu[\(\[（［【〈《「『].*$z\s+ct|tr|sy|j}tj d|j}t j d|}|S)u이름을 "bare key"(괄호 제거 + 공백 정리)로 정규화. 처리: 1. 앞뒤 공백 제거 2. 괄호 접미사 제거 (첫 괄호부터 끝까지) 3. 중복 공백 단일화 빈 문자열 / None / 비문자열 입력 시 "" 반환. 주의: 반환값은 "variant/base 구분 정보가 사라진" bare key이므로 `build_name_index`의 variant 엔티티 등록에는 쓰이지 않는다. lookup_name의 최후 fallback으로만 쓰임.  ) isinstancestrstrip_BRACKET_PATTERNsub _WS_PATTERN)namess K/Users/manta/Documents/Projects/TheRoad-I1/backend/app/core/name_matcher.pynormalize_namer7sN dC  AR#))+AQA Hcpt|tr|sytjd|j S)u_공백만 정리 (괄호는 보존). variant/base 둘 다 안전하게 등록 가능한 수준.r r )rrrrr)rs r_collapse_whitespacerMs+ dC  ??3 % + + --rc |d}i d fd }|D]w}||xsd}|s||}||||t|}||k7r ||||tj|rTt|}|sb||k7sh||k7sn||||y S)uitems의 이름을 키로 하는 lookup 인덱스 구축. 등록 정책 (variant/base 충돌 방지): - raw (원본 이름) 등록 - collapsed (공백만 정리) 등록 — raw와 다를 때만 - **bare** (괄호 제거 정규화) — raw에 괄호가 없을 때만 (variant면 bare 등록 안 함). 이유: "서현"(base)과 "서현 (5세)"(variant)가 공존하는 실측 데이터에서 variant의 bare "서현"을 등록하면 base와 충돌 → silent 오매칭. - 충돌 시 첫 등록 우선 (`setdefault`). raw/collapsed 충돌은 warning 로그. Args: items: 엔티티 컬렉션 (예: EntityCanon 리스트, 체크포인트 dict 리스트) key_fn: 각 item에서 **이름 문자열**을 추출하는 함수 value_fn: 인덱스 값 생성 함수. 생략 시 item 자체(항등) 사용. Returns: {key: value_fn(item)}. key는 raw/collapsed/bare 중 하나. Raises: 없음. 빈 이름 item은 스킵. c|SN)xs rz"build_name_index..osQrc\|sy|vr||urtjd||y||<y)uGkey 등록. 기존 값과 다른 엔티티 val이 충돌하면 warning.NzIname_index collision: key=%r kept existing entry, skipped new from raw=%r)loggerwarning)keyval raw_for_logindexs r _registerz#build_name_index.._registerss>  %<Sz$_ c rr )r$rr%r r&rreturnNone)rrsearchr) itemskey_fnvalue_fnr(itemrawr% collapsedbarer's @rbuild_name_indexr3Ts4E Tl b tn#sC (-   ic *&&s+!#&D  (9$S) Lrc|sy||vr||St|}|r||k7r ||vr||St|}|r|||fvr ||vr||Sy)uquery로 index 조회. raw → 공백정리 → bare 단계적 완화. bare 단계에서 variant 엔티티가 등록 제외된 상태라 base에 맞을 수 있지만, index에 variant의 원본 키가 있으면 raw 단계에서 먼저 잡히므로 정상 우선순위. N)rr)r'queryr1r2s r lookup_namer6sm  ~U|$U+IY%'I,>Y % D UI..45=T{ r)rrr)rr)r,z Iterable[T]r-zCallable[[T], str]r.zOptional[Callable[[T], V]]r) Dict[str, V])r'r7r5rr)z Optional[V])__doc__ __future__rloggingretypingrrrrr getLogger__name__r"r r compilerrrrr3r6rrrr@s$J# >>   8 $ CL CL2::?@bjj  ,.,0: : :): :zr