1j.UdZddlmZddlZddlZddlmZddlmZddl m Z m Z m Z m Z mZddlmZdZd Zd d d d dddddddddd Zded<dZeeeej3eezZedd5dZd6dZd7dZd8dZd9d Zd:d!Z d;d"Z! dd%Z$d?d&Z%d:d'Z&d@d(Z' dAd)Z( dAd*Z)dBd+Z*d,Z+dCd-Z,dd. dDd/Z-dEd0Z.d6d1Z/d2d3 dFd4Z0y)GuiW21B space_set_bg — frame/addon/life 3층 공간 세트 BG 파이프라인 (pure core). ~/tmp/geum_fp_frame_addon_exp.py 에서 14회 실험-육안-수정 반복으로 검증된 방식의 production 포팅 (2026-06-10 사용자 합의): · ANALYZE 3층: frame(경계·개구부·access path·construction_character) / addon(씬 증거·기능 필수 핵심 가구 — FP 도면에 그려짐) / life_baseline(인물 상황→환경 추론 고정물 — FP 미표기, BG 생성시만) · 실내: frame 2D(t2i) → addon i2i = ★최종 2D FP★ → VLM 좌표 → 공간당 ★단일 번호 마킹★ 사본(PIL) → 그 사본을 base 로 BG i2i (★3D FP 단계 없음 — 실험 비교에서 손실 변환으로 판정, 제거 확정) · 옥외(open_air): FP 미경유 — 공간당 ★단 한 장★ T2I 기준 BG (이후 모든 샷이 i2i 참조 변형하기 쉬운 일반 구도) · threshold = connector (plate 생략) / same_space = canonical 사진 참조 · place_desc = whole/indoor/outdoor 분리 + 세계관 시각 정체성(문화권·시대 양식) + visible_adjacent_enclosed_masses(반대 그룹 매스 외관) 반영 · frame_check = VLM 진단(게이트 아님 — 사람 육안 반복이 완성 수단) 이 모듈은 pure core — 프롬프트 접근자 + 순수 함수만. 프롬프트 본문 15건은 2026-08-15 에 ``prompts/_base/space_set_bg/`` 팩으로 옮겼고(내용 무변경), 이 모듈은 그것을 지연 로드해 종전과 같은 상수 이름으로 내놓는다. LLM/VLM/이미지/DB I/O 는 provider(space_set_bg_provider) / step(space_set_bg_step) 몫. ★generic 절대 — 장소 종류·품목·시나리오 하드코딩 0 (SF 등 어떤 장소도 동일 작동). ★CLAUDE.md: LLM 입력(씬/시나리오 텍스트)은 절대 자르지 않는다. ) annotationsN) OrderedDict) lru_cache)AnyDictListOptionalTuple)capture_artifact space_set_bganalyze_fa_sysplace_group_sys frame_fp_sys addon_i2iframe_check_sys space_pos_sysview_brief_sysmarked_fp_viewsamespace_viewindoor_bg_t2i_sysoutdoor_bg_t2i_sysshot_assign_sysderive_plate_view) ANALYZE_FA_SYSPLACE_GROUP_SYS FRAME_FP_SYS ADDON_I2IFRAME_CHECK_SYS SPACE_POS_SYSVIEW_BRIEF_SYSMARKED_FP_VIEWSAMESPACE_VIEWINDOOR_BG_T2I_SYSOUTDOOR_BG_T2I_SYSSHOT_ASSIGN_SYSDERIVE_PLATE_VIEWDict[str, str] _PACK_STEMS)analyze_user_headview_briefs_user_tail)maxsizec(ddlm}|t|S)uZ팩에서 프롬프트 stem 을 읽고 프로세스 수명 동안 같은 객체로 캐시.r) load_prompt)app.modules.prompt_loaderr.PROMPT_PACK_MODULE)stemr.s W/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/pipeline/space_set_bg.py_packr3Hs6 )4 00cptj|}|tdtd|t |S)uP상수처럼 보이는 프롬프트 이름을 팩에서 지연 로드 (PEP 562).zmodule z has no attribute )r)getAttributeError__name__r3)namer1s r2 __getattr__r:Os8 ??4 D |wxl2DTHMNN ;r4cddlm}m}i}tD]q}|t|j dxsij d}|r|j dst td||d}||t||d||<s|S)u소비하는 stem 각각의 (판 이름, 내용 해시) — 팩 신원. 프롬프트가 코드에 있을 때는 코드 해시가 곧 프롬프트 신원이었다. 팩으로 옮긴 뒤로는 ★파일이 실행 입력★ 이므로, 같은 코드로도 다른 프롬프트가 나갈 수 있다 — 그래서 스텝의 config_hash·결과 기록이 이 신원을 접어야 한다. 로더는 stem 마다 최신판을 ★따로★ 고른다(한 모듈 안에서 판이 섞일 수 있다). 그래서 판 이름을 모듈 하나로 뭉뚱그리지 않고 stem 단위로 담는다. 내용 해시를 같이 두는 이유는 판 이름이 그대로여도 파일이 바뀔 수 있기 때문이다. ★캐시하지 않는다★ — 캐시하면 파일이 바뀌어도 지문이 안 움직인다. stem 이 하나라도 없으면 예외(fail-closed): 없는 팩을 빈 신원으로 접으면 "팩이 사라져도 지문이 그대로"인 구멍이 다시 생긴다. r)get_effective_sourcepack_stem_content_hash candidatesfileversionu 팩 stem 을 찾지 못했다: )r@ sha256_16)r/r<r=PACK_STEM_NAMESr0r6FileNotFoundError)r<r=identityr1candr@s r2 pack_identityrFWs +-H$%7>\")&(##f+ 488I.#%&&FtfMO Oy//"GT3   Or4chtddz|zdzdjd|Dzdz|zS)uPanalyze user 프롬프트 — ★씬/전문 입력 절대 무삭제 (CLAUDE.md).r* u [원본 시나리오 전문 — 표제(슬러그라인) 아래 '/' 하위구분 = 별개 공간 강력 증거. 위 샷이 다루는 장면(scene z, c32K|]}t|yw)N)str).0ns r2 z%build_analyze_user..s/JqCFJsu)만 분석하고 다른 장소의 장면은 무시하라. ★예외: 이 장소로 들어오는 access path 의 증거만은 전문 어디서든 사용하라(그 경유 장소들을 spaces 로 추가하진 말 것).★] )r3join)shot_blocks_textfulltext scene_numss r2build_analyze_userrRsY !"T),<< ` ` ))/J/ / 03n nqy yr4c Rt}|D]}|jd}||vrg|jdgd||<|jd}|r!|||dvr||dj||jdsv||dj|dg}|jD]d\}}dj |d}d j d |dD}|jd |d |d |jdxsdd|fdj |S)ujscene 별로 묶은 LLM 입력 텍스트 (heading + 요약 + 그 scene 의 모든 shot 묘사, 무삭제).scenesummary)headingsrUshotsheadingrV shot_descrWz / rHc3&K|] }d| yw)z - N)rKxs r2rMzshot_blocks..s9jD*jsz[scene ]  장면요약: u shot 묘사들:  )rr6appenditemsrN) rWbysschblocksdheadsliness r2 shot_blocksrks--8]B  UU7^ R<"$y1ABOBrF EE)  "R&,, rF:  % %a ( 55  rF7O " "1[> 2FA 1Z=) 9aj99 t2eW,}|jd t|jd xsd j@} }|D]}|jd} | s| | vst|jd xsd j} | | } | d k(| d k(k7sY|j d |jd d| d| d| d |D]}t|jd xsdjdk(r3|jdxsi} | jdxsg}| jdxsg}|s'|s%|j d|jd d|r|j d|jd d|jdxsgD]L}|jddus|j d|jdd|jddN|jd xsgD]8}|j d!|jd"d|jd#d:||t|t|d$|d%<|Scc}wcc}wcc}w)&u{deterministic — frame/addon 계약 + access path 검사 (의미추론 X, 카운트·존재만). 게이트 아님(진단).spaces same_space_asstructure_kindskindr_separate_spaceu(STRUCTURE SHRUNK: separate_space 증거 u > 독립 spaces r9 enclosureenclosedopen_airzCROSS-ENCLOSURE same_space: 'z'(u) ↔ ') thresholdframe access_pathsopeningsuNO ACCESS: 공간 'uA' 에 access_path/opening 둘 다 없음 (물리적으로 막힘)u6access_path 명시 없음(opening 으로만 추정): ''access_validation has_accessFz$access_validation has_access=false: spacez (noteuncertain_structure_itemsz uncertain: itemreason)failswarningsindependent_spacesseparate_space_evidence _validation)r6rJlowerlenra)analysisroomsrindeprwarnsskrdsepenc_byrefe1e2rwapsopsavus r2 validate_fars2 LL " (bE <1QUU?%;QE <EE ' ( .BB ObCfb 1288:>NN1bC O 3x#e* ?CzIZ[^_d[eZfghTY ZTYqaeeFmS{!3!AzBHHJJTYF Z eeO$ 3&=QUU;'5:6<<>BBj bJ&67 **W[`ij:k l # $&*jj>P1Q1WUWfk&l m   TFr s  t#j .s+A GG )G <G G;A가구·설비·물체는 절대 그리지 마라(frame only).udframe 을 먼저 정확히 그리고 그 안에 각 공간 addon 만 심볼로(frame 변형 금지).uj 지정 그룹만(반대 그룹 매스는 빈 외벽 윤곽). 인물명·분위기·재질·치수 금지.Frr)r6rarJrrr)rrm group_kind frame_only fr_spacesrdfrrrrroppheadtails r2 build_fp_userrs  I  UU7^ !rEE&Mk0B&&.4"z*0bFF>28b   ?@uuW~?SQS?Sp?SXYX]X]^nXoQUU#34?SpDMll<0hllSeFf$LL);<B"iG &, ,VaeeFmVF , ( X 6 <" <  HR DYID n LE F w  w  $**W5C Cd JJ1q- sG,GGAG"c6dtj|dzS)Nun이 평면도에서 다음 공간들 각각의 방 중심 정규화 좌표를 찾아 schema 로 출력하라: Fr)rr)namess r2build_space_positions_userr8s; {CIIJO^cd ddr4c xddlm}m}m}|j |j d}|j \} } tt| | dz} t|| zt|| z} } |j|}|j| | z | | z | | z| | zgdtd| dztd t| d z} |jd |} |j| | ft!|d|d |j#|t |d5}t%|j'ddd|idddy#t$r|j}YwxYw#t$rB|jtd| |dzz td| |dzz ft!|dYwxYw#1swYyxYw)u최종 2D FP 사본에 ★빨간 원 + 번호 1개만★ 마킹 (코드 이미지 처리, LLM 미사용). ★BG 한 장당 마킹 하나 — 모든 번호를 한 도면에 같이 찍지 않는다 (사용자 hard rule).r)Image ImageDraw ImageFontRGBg?)rrr )outlinewidth g?z#/System/Library/Fonts/Helvetica.ttcmm)fillfontanchorr)rrbspace_set_marked_fp diagnosticnum)role dispositionpipeline_metadataN)PILrrropenconvertsizeintminDrawellipsemaxtruetype Exception load_defaulttextrJsaver read) fp_png_path out_png_pathcxcyrrrrimwrfrr\yrhfsizer_mfs r2mark_fpr<s0/ K ( ( /B 77DAq C1I A rAv;BF qArAIIq1ua!eQUAE*Ks1aSTf~IV CCL !E(!!"GO] 1vs3xkTJGGL lD !S HHJ2 $cl  " ! (%%'( ] Aq5A:~&Aq5A:~(>?SP[\] " !s1 E!E" F0EE"AF-,F-0F9cddl}|j|}g}|jdgD]}|jdxsgDcgc]%}|jds|jd'c}|d<|jdr|jdgng|d<|jd xsijd xsgD]}|j|||d <|Scc}w) uframe/addon analysis → view brief 입력 형태(fixed_elements + defining_features + top-level openings)로 평면화. construction_character 는 defining_features 로(재질 정체성이 view 에 흘러가게).rNrmrrfixed_elementsrdefining_featuresrwry)copydeepcopyr6ra)rrr flat_openingsrdr\os r2adapt_for_viewr]s hA*,M UU8R ABwAUSUAUrAU1Z[Z_Z_`pZqquu%56AUr FGeeLdFe!%%(@"A!Bkm 55>'R,,Z8>B>A   #?! "AjM H ss C#C#chdtjt|ddzdztdzS)Nu공간 분석(JSON): Frrr`r+)rrrr3)rs r2build_view_briefs_userrls9 4::nX.FUZcd#ee  01 2r4c |jdxsi}|jd|jd|jd|jdxsg|jdxsg|jdxsg|jdxsgDcgc]%}|jd s|jd 'c}|jd xsgDcgc]%}|jd s|jd 'c}d |jd xsg||d}tj|dddzScc}wcc}w)Nrwr9rrrrryrxrr life_baselinerr9rrrrryrxruklife_baseline(이동하지 않는 배경 필수 물품 — 그 환경의 현실 수준으로 자연 배치)rr}rplacesuggested_viewFrru 위 실내 공간의 ★단 한 장 기준 배경 실사진★ T2I 프롬프트(영어)를 작성하라. 이후 샷들이 i2i 로 변형해 쓰는 유일한 원본이므로 입구를 등진 wide establishing 일반 구도로, 구조·고정물·구축 방식(재질 이질감)·life_baseline 을 정확히, place 의 시각 정체성을 충실히. 사건·표식·인물·글자 금지.r6rrrr}r view_hintrrr\rs r2build_indoor_bg_userrs@ 7  !rBIIf%EIIk4J&+ii0H&I&&.4""&&BTBZXZFF>28b8= '8J8Pb8Pm8P!UVUZUZ[kUlaee,-8Pm(- /(B(Hb(H|(H!QUUSY]f (H|  %LL);<B) G 7q9 k kn|D>0D>E3Ec |jdxsi}|jd|jd|jd|jdxsg|jdxsg|jdxsg|jdxsgDcgc]%}|jd s|jd 'c}|jd xsgDcgc]%}|jd s|jd 'c}d |jd xsg||d}tj|dddzScc}wcc}w)Nrwr9rrrrryrxrrrrrrrFrruN 위 옥외 공간의 ★단 한 장 기준 배경 실사진★ T2I 프롬프트(영어)를 작성하라. 이후 샷들이 i2i 로 변형해 쓰는 유일한 원본이므로 변형이 쉬운 일반적 wide establishing 구도로, 구조·고정물·구축 방식(재질 이질감)을 정확히. 사건·표식·인물·글자 금지.rrs r2build_outdoor_bg_userr s@ 7  !rBIIf%EIIk4J&+ii0H&I&&.4""&&BTBZXZFF>28b8= '8J8Pb8Pm8P!UVUZUZ[kUlaee,-8Pm(- /(B(Hb(H|(H!QUUSY]f (H|  %LL);<B) G 7q9 r rn|r ct|rddj|zdznd}tdj||||S)ug실내 마킹 FP → BG i2i 프롬프트. life_baseline(FP 미표기 고정물)은 여기서만 주입.u★Additionally, make the room realistically lived-in by including these non-movable items that belong in this place (NOT drawn in the plan): z; u — true to the place's real condition and level, placed plausibly, WITHOUT altering any wall, door, window or the drawn furniture positions.★ r_r)rrviewextra)rNr3format)rrr  life_itemsrs r2build_marked_view_promptrs\  $&*ii &; <?X X   ! " ) ) u4u * 66r4) reuse_basederive_from_baseno_platec |jdxsgDcgc]x}|jd|jd|jd|jdxsgDcgc]%}|jds|jd'c}dz}}}g}t}|D]}|jd}||vrQ|j||jd |d |jd xsd d |jdxsd |jd|d|jdd|jdxsd dt j |ddzdzdj |zdzScc}wcc}}w)ushot→space 배정 user 프롬프트 — ★씬/샷 입력 절대 무삭제 (CLAUDE.md). shot_rows = step._scenes_to_shot_rows 출력 (scene/shot 인덱스 포함).rmr9rrrnrr)r9rrrnrrTz [scene r]rXr_r^rUz - (scene z, shot shotz) rYuI[이 장소의 공간 목록 — space 값은 이 name 들 중에서만] FrruS [샷 목록 — 각 샷의 (scene, shot) 인덱스를 출력에 그대로 사용]rHuq 각 샷이 촬영되는 주 공간 하나를 증거로 배정해 schema 로 출력하라. 불확실하면 null.)r6setaddrarrrN) r shot_rowsrdrrmrj seen_scenerres r2build_shot_assign_userrs,,x(.B.  /A EE&Mk0BUU?389g8L"8Li8L!QRQVQVWgQhaee,-8Li /  EeJ  UU7^ Z  NN2  LL9RD155+;+Ar*BBRSTSXSXYbScSigiRjk l {2$gaeeFm_Bquu[?Q?WUW>XYZ  U **V% : ; a b ))E   @  @j sA F%F<FFF)connector_namesc ,i}g}|xs t}|xsgD]I}|jd|jd}}|jd} t|t|} } | d| } | s&|j d|||jdd }|jd xsd } | t vr|j d ||| | d d } | dk(r'|j d||| |jddd}| dk(r=|jdxsdj}|s|j d||| dd } |j| }| | |vrdnd}|j |||| dV|jddk7r|j d||| d| |vr|j d||| d| |jd|jd|jdd| d| |jdxsd| d }| dk(r-||d<|jd|d!<|jd|d"<|jd#r|jd#|d#<||| <L||fS#ttf$r|j d||| dYywxYw)$u배정 결과 × plate 산출의 ★순수 deterministic 조인★ (LLM/이미지 호출 없음). 반환: (shot_plate_map, diagnostics) shot_plate_map["{scene}_{shot}"] = {space, plate_key, plate_png, plate_kind, shot_id, basis, plate_action[, secondary_spaces] [, derive_instruction, canonical_plate_key, canonical_plate_png]} diagnostics = 배정 불가 사유 기록 (게이트 아님 — 해당 shot 은 기존 경로 유지) connector_names = plate 를 의도적으로 생략한 threshold 공간 — 배정되면 LLM 발명(unknown_space)과 구분해 connector_no_plate 로 기록 (운영 디버깅). Phase 3 plate_action (얇은 gate — 조인은 비치명 유지): · reuse_base(기본/미지정/enum 밖 값) = canonical plate 그대로. · derive_from_base = derive 메타만 기록하고 plate_png 는 ★canonical 유지★ — step 이 derive i2i 성공 시에만 derived png 로 교체 (실패 = canonical fallback). · no_plate = spm 제외 + 진단 (해당 shot 은 기존 경로 유지). rTrr} invalid_index)rrTrr}_ unassignedbasis)rrTrr! plate_actionrunknown_plate_action)rrTrr}r"rplate_action_no_plate)rrTrr}r!r_rderive_instructionderive_missing_instructionconnector_no_plate unknown_spacestatusok plate_not_okduplicate_shotkeypngrpS_Shot)r} plate_key plate_png plate_kindshot_idr!r"canonical_plate_keycanonical_plate_pngsecondary_spaces)rr6r TypeError ValueErrorra PLATE_ACTIONSstrip) assignmentsplatesrspmdiags connectorsrreshr}scishir-actionr%platerentrys r2build_shot_plate_maprGs.&(C"$E )CEJ  B wvBg 2wBCQsen LLL2r#$55>3 4 ~&6,  & LL$:RQS#(&B C!F Z  LL$;bRT#(155>C D  ' '"#%%(<"="C!J!J!L % (Dr&(5:;% 5! =-2j-@)oF LLFReT U  99X $ & LLNRV[\ ]  #: LL$4r2X]^ _ 5)5)))F+3%uSE*UU7^)r"!  ' '*}|jdt|jdxsdj@}}t|}t |dkD}i}|j D]-\} } |rd| nd } | D]} | || jdxsd </|D cgc]+} |s'|j| d k(r|j| s| -}} |D cgc]} |j| r| |vs| }} |D cgc]} |j| s| |vs| }} ||z}i}t |D]N\}} t| xsd |dz}||jvr|d|dz}||jvr||| <Pg}t |D]\}} |j| }|j| d k(}|r||vrd }n|rd}nd}|j|| |dz| |j| d |||r|j|nd|j| d |j| d i}|D])}|ddk(s |j|dddz||d<+|D])}|ddk(s |j|dddk(s%d|d<+|D cgc]'} | |j| d|j| d)}} ||fScc}wcc}wcc} wcc} wcc} wcc} w)u각 공간의 BG 생성 계획을 결정 (순수 로직 — 이미지/LLM 호출 없음). 반환: (plans, connectors) plans[i] = {key, num, room, view, kind, ref_room, group_suffix} kind ∈ {"marked_indoor", "outdoor_t2i", "samespace_ref"} · canonical(독립) 공간 먼저, same_space 종속은 그 뒤 (참조 가능 순서) connectors = threshold(=connector) 공간 — plate 생략 (threshold_plate=False 시) rmr9rnNrrrsrr_rvr}rt samespace_ref outdoor_t2i marked_indoor) r-rroomr rpref_roomref_key group_suffixrrrprYr indoor_t2izentry connector (no plate))rVrrrr ) r6rJrrrrb enumeraterOvaluesra)rbriefsrPrsamerrmulti space_suffixgkgssfxrdrnr@rdepsorderedkeymapikplansris_outrp marked_by_sfxp conn_metas r2plan_space_viewsroVsFN\\RZ\^E_ `E_AEE&MAEE/2:d :E_D `QYQ]Q]^fhjQk lQkA155=#aeeK0>J?EEG GQkC l h 'F K!OE#%L,,.B"hRA03Lv," -! rSWWR[K%?QS  V! N&B :9MR&E N I2488BARTU/VYZ/ZM!N+ , V9 'M,=,=a>OQR,SWX,X$AfI B#''"+7S]c]g]ghj]kl ) g a l O IBs<,LAL";0L'1L,L, L,L1.L13L1+,L6)r1rJreturnrJ)r9rJrprJ)rpzDict[str, Dict[str, str]])rOrJrPrJrQz List[int]rprJ)rWList[Dict[str, Any]]rprJ)rDict[str, Any]rprr)rrrrpz('OrderedDict[str, List[Dict[str, Any]]]') rrrrrrrrJrrqrprJ) rrrrmrqrrJrboolrprJ)r List[str]rprJ) rrJrrJrfloatrrurrrpNone)rrrrprJ) rrrr}rrrrJrrJrprJ) rrrrJr rJrrtrprJ)rrrrrqrprJ)r<rqr=zDict[str, Dict[str, Any]]rz Optional[set]rpz6Tuple[Dict[str, Dict[str, Any]], List[Dict[str, Any]]])rJrJrprJ)rrrr]r(rPrsrpz1Tuple[List[Dict[str, Any]], List[Dict[str, Any]]])1__doc__ __future__rrrM collectionsr functoolsrtypingrrrr r app.services.image_capture.sinkr SCHEMA_VERSIONr0r)__annotations___FRAGMENT_STEMStuplesortedrr\rBr3r:rFrRrkrrrrrrrrrr rr:rrGrKrOror[r4r2rsA2# #33<$'("($&&&,.(, ^"As;#5#5#783;OOPQ 411 !P(%P (!! ! !" !  !V(K(K (K(K (K  (Kfd B  *     @     : 6"? @&* S%S %S# S < Sx1G" AA A A 7 Ar4