YojqUdZddlmZddlZddlmZddlmZmZm Z m Z ddl m Z m Z ddlmZddlmZej$eZgd Zd Zd Zd Z d(d Z d)dZ d*dZddddddd d+dZdddddiddddddd d!gd"Zded#<d$Z d,d%Z dddd& d-d'Z!y).ulocation_aerial — W-L (2026-07-03): 야외 location 항공뷰 배치도(야외 fp) SOT. 같은 야외 location 의 bg plate 들이 샷 관점별로 쪼개진 평면도들을 1순위 ref 로 받아(같은 loc 에 fp 가 여러 장 = fp 분열) plate 끼리 서로 다른 위상으로 갈라지는 결함의 근본 대응. 야외 location 의 위상 SOT 는 **위에서 내려다본 배치도(실내 floor plan 과 같은 도면 언어의 야외판) 1장/loc** 이며, 야외 bg 렌더는 분열된 개별 fp 대신 이것을 1순위 ref 로 받는다(실내 loc 은 기존 실내 fp 1순위 유지 — 이 모듈 무관). ★사용자 7차 정정(2026-07-03) 반영: "항공뷰"는 실사 드론 사진이 아니라 실내 fp 처럼 **위에서 그린 도면형 배치도**를 뜻한다. 또한 건물/구조물에 속한 상층 location 은 그 **구조물 레벨의 평면**으로 그려야 한다 (지면 위 단독 부지로 상상 금지 — 판단은 classify 산출 데이터가 이끈다). - ``build_loc_aerial_context`` — background_classify ``building_groups`` 구조 조인(순수): loc별 is_indoor/group_mixed/label/summary. 파일명/라벨 파싱 0. - ``build_aerial_establishing_prompt`` — 도면형 site-plan T2I 프롬프트(generic 템플릿, location label/summary 는 데이터로만 주입, 시나리오 토큰 0, 마커/텍스트 금지). - ``render_location_aerial`` — loc당 1장 생성(T2I; 같은 building 그룹에 실내가 공존(mixed)하면 indoor floor plan 을 I2I ref 로 footprint 정합). 기존 마커형 항공뷰(outdoor_site_layout_provider.generate_location_aerial_base — composition guide 전용 다이어그램)와 별개 producer. - ``AERIAL_SITE_GUIDANCE`` — bg plate 렌더에 aerial 배치도를 1순위 ref 로 첨부할 때 프롬프트에 덧붙이는 위상 계약(중립 — 도면 스타일 복제 금지). 소비자(background_render)가 flag ``outdoor_aerial_reference_enabled`` ON 일 때만 호출한다(OFF = 미호출 = 기존 경로 byte-identical). ) annotationsN)Path)AnyDictListOptional)ImageCallBudgetExceededreserve_current_call)call_gpt_image_bytes)PromptSanitizer) AERIAL_SITE_GUIDANCEAERIAL_FP_COHERENCE_GUIDANCEPLATE_ORDER_SCHEMAbuild_loc_aerial_context build_aerial_establishing_promptcompute_aerial_context_hashdecide_group_plate_orderrender_location_aerialvalidate_plate_orderz4.202607040120u The FIRST attached image is a flat TOP-DOWN SITE PLAN of this location (an outdoor floor plan) — the location's spatial MASTER reference. It fixes the real layout: each structure's footprint, size and position, the entrances and approach paths, level changes, and where the permanently installed elements sit. Keep this render consistent with that layout — anything shown here must exist where the plan puts it, and the scene must read as standing somewhere INSIDE that plan. Do NOT copy the plan's drawing style: no plan lines, flat colour fills, symbols or top-down map view in the output — render a fully photoreal scene at the camera position and angle this prompt describes. The plan marks doorways, windows and other openings with small hollow-circle symbols — those circles are drafting notation ONLY: never draw circles, rings or marker overlays in this render, and never reproduce any circular or ring-shaped marking from the plan as a painted pattern, decal or decoration on any surface; at each marked position render the real door, window, gate or opening itself, on the wall the plan puts it on. Where the plan marks blank lettering panels, this render shows the place's own lettering in those positions — the same characters and mark wherever it appears. Lighting, weather and time of day follow THIS prompt. If any earlier instruction calls a floor plan the base visual reference, that means THIS attached site plan.u The ATTACHED image is the TOP-DOWN INTERIOR FLOOR PLAN of the building this location belongs to — a STRUCTURAL REFERENCE ONLY, never content to copy. Draw the site plan described above as a fresh drawing in the same drafting style. Keep the building's footprint size, shape, proportions and the placement of its doors, windows and level access consistent with that interior plan, so the two plans read as the same single building. Place the site plan's hollow-circle opening markers so they COINCIDE with the interior plan's door, window and stair positions on the shared walls — the two plans' openings must line up as the same physical openings. Do NOT copy the interior plan's room contents, furniture symbols, text or numbers into the site plan.c i}|xsgD]}t|ts|jdxsgDcgc]3}t|tr!t|jdtr|5}}|sit |jdxsd}|st d|D}t d|D}|xr|}|Dcgc]}t |jdxsdrgt |jdxsdt |jdxsdt |jd xsdt|dd } }t |jd xsd} |D]x}t |jdxsd} | r| |vr(|t|d|t |jdxsdt |jd xsd| | d || <z|Scc}wcc}w) uwbackground_classify ``building_groups`` → loc별 aerial 컨텍스트 (순수). 반환: ``{loc_sid: {"group_id", "is_indoor", "group_mixed", "label", "summary", "anchor_loc", "group_members"}}``. ★8차 정정: aerial 산출 단위는 loc 가 아니라 **같은 장소 그룹** (building_groups 그룹 = 하나의 건물/구조물/부지) — 같은 그룹의 야외 loc 들은 통합 배치도 1장을 공유한다. ``group_members`` 는 그룹 전 멤버(실내 포함)의 {loc_id, label, summary, is_indoor} 리스트로, 통합 배치도 프롬프트의 place 데이터가 된다. building_fp_link.build_group_membership_by_loc 와 같은 구조 조인 규칙 (``is_indoor`` 가 bool 아닌 멤버 제외 — 추측 금지, group_id 없는 그룹 제외, 같은 loc 여러 그룹이면 first-wins = classify 산출 순서 결정론). members is_indoorgroup_idc3&K|] }|d ywrN.0ms Z/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/pipeline/location_aerial.py z+build_loc_aerial_context..s9A;sc3(K|] }|d  ywrrrs r!r"z+build_loc_aerial_context..s>ga n,gsloc_idlabelsummaryr$r%r&r anchor_loc)rr group_mixedr%r&r( group_members) isinstancedictgetboolstrany) building_groupsoutgroupr rr has_indoor has_outdoormixed member_datar(locs r!rrys$&(C &B&%&  ),22 2!!T"z!%% 2Dd'K 2   uyy,23 999 >g>> *{  155?(b) aeeHo34QUU7^1r2quuY/526!!K.1      <06B7 AaeeHo+,C#*$!!K.1$QUU7^1r2quuY/526(!,CH 5'N JI   s 8G/B G4cddl}ddl}t|xsdt|xsdt|xsd|xsgDcgc]u}t|jdxsdt|jdxsdt|jdxsdt |jddwc}d }|j |j |d d jd jddScc}w)u그룹 통합 배치도의 **입력 구조 컨텍스트** 해시 (순수, sha256 16자). Codex 8차 NARROW: 캐시 재사용을 prompt_version 만으로 판정하면 같은 group_id 가 유지된 채 building_groups 멤버/label/summary/is_indoor/ anchor_loc 또는 mixed fp 링크가 바뀌는 resume 에서 낡은 배치도가 부활한다. 이 해시는 구조 데이터만 접는다: group_id + 멤버 리스트 (loc_id/label/summary/is_indoor, classify 산출 순서 보존) + anchor_loc + mixed fp SOT(fp_id — 링크 유무·정체 변화 감지). 소비자는 prompt_version AND context_hash 둘 다 일치할 때만 캐시를 재사용한다. rNrr$r%r&rr')rr(fp_sotrTF) sort_keys ensure_asciizutf-8) hashlibjsonr/r-r.sha256dumpsencode hexdigest)rrr(r:r>_jsonr payloads r!rrs"B'**+fl#mm $ aeeHo34QUU7^1r2quuY/526!!%% "45   $ G >> Gt% @  ik#2  sA:C= cg}|xsgD]}|jdrdnd}djdt|jdxsdjt|jdxsdjfD}|s|j d |d ||rd j|nd }d jd dd|ddddddddddgS)u같은 장소 그룹의 통합 배치도(site plan) T2I 프롬프트 (generic 템플릿). 실내 floor plan 과 같은 도면 언어의 야외판 — 위에서 수직으로 내려다본 flat 컬러 배치도(실사 사진/3D 아님). ★8차 정정: 그룹(하나의 건물/ 구조물/부지) 전 멤버를 **한 장에 통합** — 건물은 지붕뷰(roof plane, 상층 요소가 그 위에 보임)+주변 지상 공간, 탈것/구조물은 전체 형태. 상업/공공 시설의 간판 판 위치도 표기(도면이므로 빈 판 — 문자 금지). ``members`` 는 classify 산출 데이터({label, summary, is_indoor})로만 주입 — 템플릿 자체는 어떤 시나리오에도 범용(특정 장소 명사 0, 마커/라벨/텍스트 0 강제). rz indoor partz outdoor part c3$K|]}|r| ywNr)rxs r!r"z3build_aerial_establishing_prompt..s! ! sr%rr&z- (z)  z&- an ordinary real-world outdoor site.uWONE flat TOP-DOWN SITE PLAN of a single real-world place, drawn in the exact drafting style of a clean architectural floor plan: flat colour fills, thin dark outlines, simple fixture symbols, straight-down orthographic view — NOT a photograph, NOT a 3D render, NOT an oblique aerial photo; no perspective, no photo textures, no cast shadows.uThis ONE place consists of these connected parts — draw them TOGETHER as one coherent whole (one building/structure and its immediate surroundings), never as separate lots:uDraw the WHOLE place in one plan: the full outline of the main building or structure seen from directly above — its roof plane, with whatever stands on that top level drawn in place — plus every open ground or floor area around and on it, the entrances, stairs and approach paths that connect the parts, and every permanently installed element as a simple plan symbol in its true position. Indoor parts stay under the roof outline — do NOT expose their interior rooms; the roof plane and its top-level features represent the building. If the place is a vehicle or vessel, draw the ENTIRE craft from above as one complete shape. Where the place carries lettering, include those lettering panels at their true positions, drawn as blank panels. Keep the geometry simple, unambiguous and physically plausible — this plan is the place's master spatial reference that later renders must stay consistent with.u,Frame the plan a little WIDER than the place itself: include a modest margin of the immediate surroundings — the adjacent street, ground, water or neighbouring structures the place actually touches — so the place reads in its real context. The place itself stays the dominant subject of the plan.uMark EVERY opening of the place — each doorway, gate, window and level-access point (the top of a stair, a ladder, a hatch) — with a small hollow CIRCLE symbol placed exactly ON the wall, parapet, railing or hull line that opening belongs to. An opening symbol must sit on a real physical boundary line — never floating in open space — and openings between two parts must be shared by both. Doors that lead into an enclosed part sit on that part's outline at the side where the entrance really is. These hollow opening circles must be the ONLY circular marks anywhere on the plan — do not add any other round motifs, ring patterns or circular decorations to roofs, decks, floors or walls.uIf the place's main level sits ON TOP of a building or structure (an upper level above the ground), the plan must make that unmistakable: draw the supporting building's full roof outline as that level's boundary, keep a clearly visible roof-edge/parapet line around it, place the level-access opening symbol where one arrives onto that level, and let the surrounding ground or street read as OUTSIDE and BELOW that outline — never draw an upper level as if it were its own ground-level lot with a yard of its own.zSTRICT: NO people, NO animals, NO text, letters, numbers, labels, arrows, logos or watermarks anywhere in the image. The ONLY marker symbols allowed are the hollow-circle opening markers and the standard flat plan fixture symbols described above.)r-joinr/stripappend)r lines_partsr tagbody place_blocks r!rrs  K ]] uu[1m~xx AEE'N(b)//1AEE)$*+113      SED62 3-8$))K(0 99 %  ;     ?  "  3  EGG G1536x864high)building_fp_path sanitizersizequality max_attemptscapture_input_image_idsDict[str, Any]c (t|} |duxr|j} | r | tz} ddg| | tdd} | }| t }t d| dzD]}|| d< |||dd}| r%t d t|d ||g|d d |d d| }n#t d t|d|d|d d|dd| }|s td|j|d| d<t|| d<|| d<| cS| S#t$rt$r }t|jtfddD}|r|| kr |j|dgt!|d}|j#dd}|r+|}| dj%|j#d Yd}~=n*#t$r}d!|dd"| d#<| cYd}~cYd}~cSd}~wwxYwt&j)d$||| t|dd"|| k\rt|dd"| d#<| cYd}~cSYd}~d}~wwxYw)%u같은 장소 그룹 1곳의 통합 항공뷰 배치도(site plan) PNG 생성. - ``place_id`` = building_groups 의 group_id(로그/캡처 메타 전용 — 프롬프트에는 넣지 않는다). ``members`` = 그룹 전 멤버의 {label, summary, is_indoor} 데이터. - ``building_fp_path`` 가 존재하면(mixed 그룹) I2I edit(fp ref) + AERIAL_FP_COHERENCE_GUIDANCE — 건물 footprint/개구부를 실내 fp 와 정합 (같은 도면 언어). 없으면 순수 T2I. - moderation 류 차단은 PromptSanitizer 로 bounded retry (render_one_ background 미러). 실패는 raise 하지 않고 status='failed' dict 반환 — 호출자(background_render)는 해당 그룹의 aerial 없이 기존 경로로 fail-safe 진행한다. Returns dict: ``{status, attempts, strategies, building_fp_used, prompt_used, prompt_version, final_block_reason, png_path?}``. )rNfailedr)statusattempts strategiesbuilding_fp_used prompt_usedprompt_versionfinal_block_reasonra)modelrYrZnz&background_render.location_aerial_edit)sourceeditlocation_aerialT) budget_sourceplace_idrc)modeprompt ref_paths call_kwargs capture_rolecapture_metadatar\z*background_render.location_aerial_generategenerateFzempty b64 responseokr`png_pathrdc3&K|]}|v ywrIr)rkmsgs r!r"z)render_location_aerial..s!  AS s) moderationsafetycontent_policy prohibitedpolicyblockedviolates violationSAFETY)original_prompt block_reasonblock_categoriesattemptsanitized_promptrrbstrategyzsanitize_failed: rfz$location_aerial %s attempt %d/%d: %s)rexistsrAERIAL_PROMPT_VERSIONr ranger r RuntimeError write_bytesr/r Exceptionlowerr0sanitizeminr-rNloggererror) openai_client image_modelrnrout_pathrWrXrYrZr[r\rp fp_attachedinfocurrent_promptrrrpngexc is_moderationsr sanitizedserzs @r!rrFs<.g >F"$.L3C3J3J3LK66'/"DN#% L1,-"ZZ $" K $CE*!)/0 +!2E$,,0 & -D %GI*!#)" +!2I$,,1 & -D"#788   %!DN"8}D "0D Kg.z KS'  & c(.."C    MI )2\*11"&&2DE !! +B40#6-.KK  LL6'<S$3 ,&-0Xds^)* 'I& sV#BC11H4H 9AFH  F?! F:-F?.H 2H:F???H >H HobjectFarraytypestringu:bg_id generation order — a permutation of the input list)ritems descriptionzBone sentence: why the first bg_id best establishes the whole place)rr)order first_reasonrr)radditionalProperties propertiesrequiredruYou order the outdoor background renders of ONE real-world place for sequential image generation. The renders are generated one at a time. The FIRST render is generated with only the place's top-down site plan as reference, so it must be the view that best ESTABLISHES the whole place — the widest, most representative view of the main structure and its surroundings. Each LATER render is generated with the PREVIOUS successful render as its visual reference, so order the rest to maximize visual continuity: views that overlap or sit next to each other should be adjacent in the order, and wider views should generally come before tighter partial views of the same area. Rules: - Return EVERY bg_id from the input exactly once (a permutation). - If a render lists depends_on entries, it must come AFTER all of them (it depicts a later state of that render). - Judge only from the given data; do not invent anything about the place.ct|}t|t|k7rdt|dt|St|Dcic]\}}|| }}}t|}|xsij D]>\}}||vr |xsgD]+} | |vs|j | d||kDs!d|d| ccS@ycc}}w)u1LLM 이 낸 순서의 결정론 검증 (순수). 위반 사유 문자열 / 정상 None. - 순열: candidate_ids 와 정확히 같은 집합, 중복/누락/외부 id 금지. - 의존: ``depends_on_by_bg[bid]`` 의 각 dep(후보 집합 내의 것만)가 bid 보다 먼저 와야 한다. znot a permutation: got=z expected=zdependency violated: z before its dep N)listsorted enumeratesetrr-) r candidate_idsdepends_on_by_bgcandibidposcand_setdepsdeps r!rr s  D e}t $%fUm_5t ~ ' !*% 0 1 0fa36 0C 14yH&,"335 T c> :2:Ch3773#3c#h#>.sg5EcWMM6  2s B<)project_config opik_metadata max_retriesc ddl}|Dcgc] }t|jdxsd"}}|D cic]K}t|jdxsd|jdxsgD cgc] } t| c} M} }} t|ddddd} t |dkrd | d <| S|j |d d d d} d} t d|dzD]}|| d< |dt| t|d|}|jdxsgDcgc] }t|}}t||| }| t||| d<d| d <t|jdxsd| d<d| d<| cS| | d<tjd|| Scc}wcc} wcc} }wcc}w#t$r2}t|dd} tjd|||| Yd}~d}~wwxYw)uy같은 장소 그룹 1곳의 plate 생성 순서를 LLM 으로 결정 (비차단). ``candidates`` 항목: ``{bg_id, location_label, location_summary, surface_role, state_label, depends_on, t2i_prompt}`` — t2i_prompt 는 **전문**(자르기 금지 계약). ``depends_on`` 은 후보 집합 내 bg_id 만. 반환: ``{"order", "order_source"('llm'|'fallback_structural'), "first_reason", "attempts", "error"}``. LLM 실패/검증 실패가 ``max_retries`` 를 소진하면 입력 순서 그대로 fallback (구조 순서 = 기존 lane 순서 — 결정론). 예외를 밖으로 던지지 않는다. rNbg_idr depends_onfallback_structural)r order_sourcerrarrVtrivialrzWOrder these renders for sequential chained generation. Return every bg_id exactly once.) place_renders instructionF)r<indentrgrabackground_plate_order)step system_prompt user_promptresponse_schemar schema_namerrllmrrrz-plate_order group=%s attempt %d/%d failed: %su9plate_order group=%s exhausted — 구조 순서 fallback)r?r/r-rlenrArPLATE_ORDER_SYSTEMrr ValueErrorrrwarning)r candidatescall_structured_fnrrrrDcrdrr2rlast_errrresultrJrrrs r!rr'sH(8BC 1Sw-2. MC  A AEE'N b!UU<06B6$ 6qCF6$   m$- C :'N ++'3  KHK!O,!J '-0' 2-4+F'-jj&9&?R&?A&?SV&?EA,}&68I$ ++ CL"'C "%fjj&@&FB"GC CLJ+-8CL NNCXO J}D$ TB 3x~H NN?';   sG%F 9F.FF.F" FA F"FF"" G+'GG)r1List[Dict[str, Any]]returnzDict[str, Dict[str, Any]]) rr/rrr(r/r:r/rr/)rrrr/)rrrr/rnr/rrrrrWzOptional[Path]rXzOptional[PromptSanitizer]rYr/rZr/r[intr\zOptional[List[str]]rr])r List[str]rrrzDict[str, List[str]]rz Optional[str])rr/rrrrrOptional[Dict[str, Any]]rrrrrr])"__doc__ __future__rloggingpathlibrtypingrrrrapp.core.image_call_budgetr r #app.modules.llm.gpt_image_primitiver app.modules.prompt_sanitizerr getLogger__name__r__all__rr rrrrrr__annotations__rrrrrSr!rs>:#,,E8   8 $ *)*@ G:)::z%%"% %  %  %Pe !e e^(,+/37NNN N " N  N%N)N NNN1NNv !h'L    .)'&N. * + B04.2TT%T T - T , TTTrS