7jOUdZddlmZmZmZmZgdZedhZee d<iddddd d gd d d dd ddddd d gd dd dd dddddd dgd dd ddd dddddd gd dd dd ddddd d!dgd dd ddd d"d#dd$dd dgd%d&d d'd(d) d*d+dd,d-d-dgd dd dd d.d/dd0d d!d*dgd dd dd d1d2dd3dd gd4d%dd dd d5d6dd7d8d gd9d%dd dd d:d;ddd?dd@d8d d:gd%dd dd dAdB dCdDddEd d!gdFd dGd dd dHdIddJd d!dCgd dGd dd dKdLddMd d!gdFd dGd dd dNdOddPd8d dKgd dGd dd dQdRddSd d!gdFd dGd dd idTdUddVd8d dQgd dGd dd dWdXddYd d!dZgd dd dd d[d\dd]d d!gd^d d_d dd d`dadd]d d!gd^d dbdcdd%dd dedfddgd d!dZd[gd dhd d_d ddi djdkddld d!degd dhd d_d ddi dmdnddodd gdpd dhd dbd ddi dqdrddsd d!gdtd dhd dud ddi dvdwddxdd dWdegd dd dd dZdyddzd d!gd{d dd dd d|d}dd~d d!dvgd dd dd ddddd8d d|gd%dd ddd dddddd d>gd%dd dd ddddd8d d*dgd dd dd%d ddddd d!dgdd dd dd ddddd8d dgd d&d d'dd) ddddd d!gdd dd dd%dd iddddd8d ddgd%dd d'dd) ddddd d!dgd dd d'dd) ddddd d!ddgd%dd dd ddddd8d dgd dd dd%d ddddd8d dgd dd dd%d ddddd8d dgd dd dd%d ddddsd8d dgd d&d d'dd%d ddddd d!gdd dd dd%d,d ddddd d!d>dgd dd dd ddddd d!gdd ddd'd ddddd8d dgdd dd dd%d d ddddd8d dVgd¢d%dd ddgd%d dĜdddddd gdǢd dd ddd ddddd d!gdˢd dddddgdd͜ ddddd d!gdѢd dd ddd ddddd d!gd֢d dd ddd ddddd d!gdۢd dd ddd iddddd d!ddgd ddddd ddddd d!gdd dd ddd dddd dd d!gdd dd ddd dddd dd d!gdd dd ddd ddddd d!gdd dddd$d ddddddgdd dddd,d ddddd d!gdd dd ddd ddddd d!gdd dd ddd ddddd d!gdd dd ddd dd dd d d!gd d ddddd d dddd d!gdd dd dd ddddd d!gdd dd dd$d ddddd d!dgdd dd dd ddddd d!ddgd dddd ddddd d!dgd ddddd d d!dd"d d!ddgd dd ddd d#d$dd%d d!gd&d dd ddd id'd(dd)d d!d#dgd dd ddd d*d+dd,d d!d#dgd dd ddd d-d.dd/d d!gd0d dd ddd d1d2dd3d d!gd4d dd ddd d5d6dd7d d!gd8d dd ddd d9d:dd;d d!gd<d ddddd d=d>dd?d d!gd@d dd ddMd dAdBddCd d!dgdDd dd dd dEdFddGd d!gdHd dd ddd dIdJddKd d!gdLd dMd ddgddN dOdPddQd d!gdRd dd d'd dSdTddUd d!gdVd dd d'd dWdXddYd d!dgd%d%ddd'dZ d[d\dd]d d!ddgd dddd d^d_dd`dd dgd%dddd dadbddcdd d^dgd%ddddd dedfddgdd dadgd dddd dhddid d!dgdjd dddd dkddld d!dSdgd ddd'd dmddndodogdpd%dqdrdd dsdtdudd dsdvdwd d!dsdxdyd d!dsdzd{d d!dsd|d}d~ddsddd d!dsgdddd dddd d!dgd d&d dd dddd d!dgd dd dd dZ ee ee effe d<de deee effdZ de de fdZde deee effdZde dee fdZde dee fdZde dee fdZdeee effdZy(u파이프라인 Step Manifest v4 + shot-more — 49단계 정의, 의존성, 설정. 이 파일이 파이프라인의 단일 진실 소스(Single Source of Truth). v4 + shot-more: beat→shot 기반 파이프라인. 정확한 실측 baseline은 `docs/architecture/_step_manifest.generated.md` 참조 (재생성 — 저장소 루트에서: `backend/.venv/bin/python backend/scripts/dump_step_manifest.py > docs/architecture/_step_manifest.generated.md`). 구성 (총 50, 2026-04-27 기준) - analysis: 42 (always 34, if_planning_doc 1, on_demand 4, disabled 3) - image: 6 (always 4, if_has_outlooks 1, on_demand 1) - auxiliary: 2 (on_demand 1, disabled 1) Active (분석 실행 경로, 40): always 38 + if_planning_doc 1 + if_has_outlooks 1 applicability 종류 - always: 항상 실행 - disabled: 실험용/비활성 - on_demand: 사용자 요청 시만 (project_summary 등) - if_planning_doc: 기획서 있을 때만 - if_has_outlooks: 아웃룩 있을 때만 Phase 1 추가 필드 (01-principles-revised.md §4, §5) - step_type (실측 3종, 2026-04-22): transform (41): 체크포인트 → 체크포인트 (DB 쓰기 금지) asset (6): 파일 + DB 메타 (이미지 계열) editorial (2): 타 step 체크포인트 수정 (t2i_review, scene_verify) (설계 초안의 `projection` 타입은 별도 step_type으로 분리되지 않고 Phase 2의 CheckpointSyncService 5-way 분해로 흡수됨. step은 여전히 transform/asset으로 남고 projection은 sync 레이어 책임.) - lifecycle: active | deprecated | removed 실측 2026-08-25: 총 84 — active 73, deprecated 10, removed 1. (종전 주석은 "active 42, deprecated 6, removed 1" 이었다. 「실측」이라 적힌 숫자가 낡으면 그대로 믿게 되므로 세어서 고친다.) ★lifecycle 은 **표시**일 뿐 실행을 막지 않는다. 막는 것은 `applicability == "disabled"`(8개)이고, 그 둘은 축이 다르다 — 차이 3개(outlook_extraction·scene_cinematography·scene_split)는 `on_demand` 라 **요청하면 돈다.** 스텝 목록을 API 에서 받아 순서대로 돌리는 운전 루프는 lifecycle 을 따로 걸러야 한다(API 응답에 이 칸이 없다). 안 거르면 대체된 옛 단계에 유료 호출이 나간다 — 08-25 실측: outlook_extraction 3회 6,264자. - resume_sensitive: resume 모드에서도 재실행 필요 (bool, 기본 False) - modifies_checkpoints: editorial만 사용. 자신이 덮어쓰는 타 step 체크포인트 목록 - replaced_by: deprecated만 사용. 대체된 step_id - allow_partial_downstream: 본 step 의 ``partial`` 결과가 downstream 으로 cascade 되어도 안전한지 (bool, 기본 True). False 시 downstream cascade stop — analysis_dispatch_service 가 batch 중단, check_gate 가 blocked. partial 시 incomplete 데이터로 후속 step 진행하면 잘못된 결과 (asset/entity 누락) 가 발생하는 step 에 명시 False. (problems.md #11 contract) default_model 컨벤션 (problems.md #5) - **반드시 LiteLLM Router 에 등록된 alias** (예: ``"gpt"``, ``"gpt-mini"``, ``"gemini-pro"``, ``"gemini-flash"``, ``"gemini-lite"``, ``"gemini-image"``, ``"fal-ai"``) 만 사용. 실 model ID (예: ``"gemini-3.1-flash-lite-preview"``) 는 사용 금지 — alias 가 router 에서 model ID 로 해소되며, alias 통일이 UI/admin/runtime parity 의 근거. - ``llm_client.PIPELINE_STEPS`` 가 본 manifest 의 default_model 을 derived view 로 build (#5: STEP_MANIFEST 가 single source of truth). 참조: docs/architecture-refactor-final/02-final-roadmap.md §Phase 1 )AnyDictListOptional) pendingblockedrunnablerunning completedpartialfailednot_applicablestale cancelled entity_t2i_LEGACY_SCHEMA_BUMP_ALLOWLISTplanning_doc_analysisu기획서 분석analysisz gemini-litegeminiFif_planning_doc transformactive) labelcategoryorder default_modelprovider depends_onfan_out applicability step_type lifecycle text_cleanupu텍스트 정리alwaysscene_segmentationu씬 세그먼테이션z gemini-flash) rrrrrrrr r!r"schema_versionepisode_summaryu에피소드 요약zgpt-minivisual_world_rulesu시각적 세계관 규칙gptopenai scene_splitu큰 씬 분할 (레거시)T on_demand deprecatedzbeat_extract,shot_extract) rrrrrrrr r!r" replaced_by scene_saveu 씬 저장-entity_character_listu 인물 리스트 (사전 추출)g@ scene_summaryu씬별 요약 (병렬))r4r)r+ beat_extractuBeat 추출 (병렬)gffffff@z gemini-pro)r4r+r7 shot_extractuShot 추출 (순차)g@)r:r+r7shot_validatoru Shot 검증g@allow_failed_validator) rrrrrrrr r!r"allow_partial_downstreampartial_override_config_keyentity_all_characteru인물 리스팅)r4r+r< grounding_a0if_not_chunk_producerentity_extract_characteru 인물 추출 entity_all_locationu배경 리스팅 entity_extract_locationu 배경 추출 entity_all_propu소품 리스팅 entity_extract_propu 소품 추출 entity_relationu요소 변형 관계 추출g333333+@ entity_mergerBu고증 후보 수집g@)r4r+r<if_grounding_v2grounding_chunku고증 구간 판독 (C(c))if_chunk_producerllm) rrrrrrrr r!r"resume_sensitivegrounding_planu고증 후보 분류·계획gL+@allow_missing_grounding) rrrrrrr>r?rr r!r"grounding_researchu#고증 조사(출처 붙은 claims)gףp= W+@grounding_screenu참조 획득 의무 판별gRQ+@)rOrBrQr+reference_acquisitionuD참고 사진 획득 (검색 → 이미지 검색 → 종류 선택)gL3@) entity_filterrXoutlook_phase3if_grounding_referencerZu저빈도 요소 필터링gffffff+@u요소 중복 병합g+@)rDrHrLr8r+rQ entity_detailu요소 상세 + enumu 요소 T2I 프롬프트 (병렬)shot_selectionu중요 샷 선택 (병렬)g/@scene_directoru씬 감독 (물리적 존재)) rrrrrrrr r!r"#requires_projection_sync_before_run shot_directoruShot별 VE 판정g0@)rar`rNr<) rrrrrr(rrr r!r"scene_cinematographyu촬영 감독 (레거시) shot_stagingscene_camera_flowu씬 카메라 플로우g 1@)r<r`rarOr4shot_cinematographyu"Shot별 촬영 기법 (deprecated)g1@disabledscene_dependencyu*씬 연관 분석 (레거시 — disabled)shot_dependencyuShot 연관 분석 (병렬)g2@outlook_phase1u아웃룩 목록 추출outlook_phase2u아웃룩 씬별 매핑g3@r[u아웃룩 병합 정리g3333333@outlook_extractionu아웃룩 추출 (레거시)z,outlook_phase1,outlook_phase2,outlook_phase3) rrrrrrrr r!r"r3rcu촬영 연출 (DP)g3@)r<r`r+rOrh) rrrrrrrr r!r"rTr(shot_essence_extractionu샷 essence 추출g333333@if_shot_essence_enabledlocation_floor_planu4위치 도면 생성 (deprecated, Phase 7로 대체)imageg5@)r<r`r4rOr+rabackground_plannerassetscene_consistencyu씬 시각적 일관성gfffff3@)rgrdrOr<r`r:r4r+) rrrrrr(rrr r!r"rTr> scene_detailu씬 상세 분석 (병렬)g333335@) rmrdr[rrgrxrYbackground_promptepisode_reference_policyvisual_continuity_anchorshot_dependency_t2i)rrrrrr(rrr r!r"consumes_downstreamrcr>uShot 연관 재계산 (LLM)g(\µ5@)ryrxrg t2i_reviewuT2I 프롬프트 검수gQ5@)rryr<rgr+rOr] editorial) rrrrrrrr r!r"modifies_checkpointsr(zoom_continuity_anchorz%zoom continuity anchor (W21B-W7 W-C1)g{G5@)r}ryrr4r<r`rg!if_zoom_continuity_anchor_enabledoutdoor_site_layoutu'야외 site layout 좌표 SOT (W21B-W8)g(\5@) ryrbackground_classifyr}r4r<r`rgrdif_outdoor_site_layout_enabledoutdoor_place_specu,야외 장소 마커 스펙 (W22 직행 ①)gQ5@)rr4rar<r`rgrOr+ if_outdoor_direct_or_map_or_laneoutdoor_place_canonu%장소 캐논 자산 (W22 직행 ②)gHz5@outdoor_lane_planoutdoor_shot_groundingu%야외 샷 grounding (W22 직행 ③)g ףp=5@)rrr4rar<r`rgif_outdoor_direct_composeu(야외 3레인 lane plan (설계 v2 ①)gfffff5@)rr4rar<r`rgif_outdoor_lane_plan) rrr>rrrrrr r!r"r(outdoor_frame_modeu 레인2 구도 판정 (E2E6 ③))rrr4r<r`rgraif_outdoor_frame_mode outdoor_structure_form_referenceu>야외 구조물 형태 참조 검색·선택 (Stage D 선행)g ףp=5@)rYrrrrOr4r+if_outdoor_lane_pipegenerateoutdoor_structure_seedu'야외 레인2 구조물 seed (Stage D)gQ5@z gemini-imagegoogle) rrrrOr4shot_ref_classifyrr<r`rgraru샷 참조 분류 (레시피)gfffff5@)r<r`r4raif_still_recipebackground_share_planu$배경 공유 계획 (전체 지휘)gHz5@if_background_share_planshot_continuityu 샷 연속성 저작 (레시피)g)\5@)r<r`r4rOshot_conti_lightu경량 콘티 (레시피)g{G8@zgpt-image-2.5-sunburst) rrrrr<r`r4rabackground_renderrrrryru배경 그룹 분류g(\3@)r<r`rOr]r+raif_background_modebackground_master_planu배경 마스터플랜gQ3@)rr4r<r`r+floor_plan_promptu도면 t2i 프롬프트g\(3@)rr4r<r`r+floor_plan_renderu도면 이미지 생성ǧ5@floor_plan_light_sidecaru'도면 단순화 사이드카 (W21B-w5)g(\5@floor_plan_overlay_payloadu 도면 오버레이 페이로드gR5@base_location_dossieru기초 위치 정보 (W20A)gGz5@)rrrrfloor_plan_geometry_readbacku도면 기하 readback (W20A2)gףp= 5@floor_plan_semantic_readbacku0도면 마커 의미 fidelity readback (W21B-w4)gK5@shot_projection_cardu@샷 projection card — 카메라 가시물 서술 SOT (W21B-w4)g+Η5@)rrrrrrrgr4bg_space_partitionu@BG 공간분할 — plate group / anchor / ref DAG SOT (W21B-w5)gMb5@)rrrdwelling_zone_mapu1dwelling zone map — FP+VLM 공간 묶기 (W21B)gx&15@)rrrrr space_set_bgu;space set BG — frame/addon/life 3층 공간 세트 (W21B)g6@)r world_guider4r<r`rashot_aware_bg_render_planz shot-aware BG render plan (W20B)gQ5@)rrrrrgrzu배경 t2i 프롬프트g5@)rrrr4r<r`r+r{u에피소드 참조 정책gfffff5@)rdr`r<rOrNrWrYr|u!시각 연속성 anchor (W21B-W7)g)\5@)r4r<r`rmrgrdr#if_visual_continuity_anchor_enabled) rrrrrrrr r!r"r~r(rvu5배경 생성 Planner (deprecated, Phase 7로 대체)ǧ3@)r<r`rarOr]r+background_chain_planningu6배경 chain 플래닝 (deprecated, Phase 7로 대체)g3@)r<r`rgrarOr]r+ scene_verifyu교차 검증 (레거시)) rrrrrrrrcr r!r"ru월드 가이드 ref_image_genu요소 참조 이미지composite_image_genu!인물+아웃룩 합성 이미지if_has_outlookscharacter_state_variantu%인물 상태 변형 참조 이미지g8@u배경 이미지 생성gQ8@)rrzrru3배경 chain 렌더 (deprecated, Phase 7로 대체)g333338@u씬 이미지 생성 (compound)mixed) rrrrrrrrrprompt_translationu T2I 번역)idrrr scene_t2i_genuT2I 이미지 생성scene_t2i_validationu이미지 검증prompt_sanitizeu프롬프트 안전화angle_recommendu 앵글 추천fal_angle_applyufal.ai 앵글 적용zfal-aifal final_selectu 최종 선택) rrrrrrr sub_stepsr r!r"u아웃룩 중복 판별 auxiliarydu프로젝트 요약 (미구현)eremoved)rbackground_chain_renderscene_image_pipeline outlook_dedupproject_summary STEP_MANIFESTstep_idreturnc,tj|S)uF주어진 step_id의 매니페스트 항목을 반환. 없으면 None.rgetrs L/Users/manta/Documents/Projects/TheRoad-I1/backend/app/core/step_manifest.py get_step_infor   W %%c|tvS)u등록된 step_id인지.)rrs rcontainsrs m ##rc,tj|S)u5dict 형태의 manifest entry (읽기 전용 관례).rrs rget_manifest_dictrrrcjtj|}|gSt|jdgS)u<주어진 step_id의 선행 의존 step_id 목록을 반환.r)rrlist)rinfos rget_depends_onr s2   W %D | r* ++rc tjDcgc]\}}||jdgvr|c}}Scc}}w)uI주어진 step_id를 의존하는 직접 하위 step_id 목록을 반환.r)ritemsr)rsidrs rget_downstream_stepsr sI+002 2 T dhh|R0 0 2  s <ct}t|}|rC|jd}||vr+|j||j t||rCt |S)uR주어진 step_id의 모든 하위 의존 step_id를 재귀적으로 반환 (BFS).r)setrpopaddextendsorted)rvisitedqueuecurrents rget_all_downstream_recursiver sZ5G  )E ))A, ' ! KK LL-g6 7  '?rcg}tjD]\}}d|i|}|j||jd|S)ugorder 기준으로 정렬된 매니페스트 항목 리스트 반환. 각 항목에 step_id 키 포함.rc |dS)Nr)xs rz#get_ordered_steps..# sajr)key)rrappendsort)resultrrentrys rget_ordered_stepsr sO F"((* TC(4( e+ KK(K) MrN)__doc__typingrrrr STEP_STATUSES frozensetr__annotations__rstrrboolrrrrrrrrrrs=~-, ,5l^+DyDT",#&*   T",$#&!  %T",>)'%&!  ?T",b&#!  cT",|-()!  }T",X-'+,$ !2 YT",t+,!  uT",T3#%9:!  UT",n)#M!  oT",H'%S!  IT",b'%U!  cT",|%%&!  %*'?#}T",f#\1  gT",D -.1  !ET",b#\1  cT",@ %,-1  AT",^#\1  _T",| %()1  }T",Z.%&!  [T",v'L*  wT",V .L,  W T",r /%~6%*'@+ 's T",\ 6'(%*'@* %] T",D .( - %*'@- I%E T",P WN%*'@2 =Q T",P -# )*:;! Q T",r ' ! s T",T'&'!  UT",v3%&'!  wT",R-#'(!  ST",l0%#\2! /3 mT",H$&_! ;IT",H,%'($ !% IT",d*j!  eT",D5%')9:# !% ET",`='(# !( aT",|.')9:!  }T",V*%'(! /3 WT",r*%'(! /3 sT",N*%'(! /3 OT",j/%'($ !E/3 kT",H%u!   IT",v%')9:2  wT",bG  #!)cT",N*% `!  %*-OT",D-%@  !  !66/3%*CBET",N.# '! 1OT",H*N! !-~ >+IT",P8 < #QT",P: 9 'QT",D?  < 5ET",F 8  ! ;+G T",z 8 4 #{ T",p!;%* / -q!T",j"3$) 0 'k"T",f#'Q  /I%)g#T",D%:' /I%E%T",^&0 * +_&T",R'7 3 S'T",|'3 *  '}'T",t(,1 4* Q)u(T",L*' - M*T",t*) - 7u*T",t+*  - )u+T",j,* !9 - k,T",n-:  -!o-T",d.!3 !9 - #e.T",^/. - #_/T",^0#1 #  - #%_0T",`1#C #  - %a1T",n2S  - +o2T",H4S  - +I4T",f5D  - -g5T",B7N -+C7T",L8 3 - :[."M8T",r9*  - /s9T",n:- $! ;!o:T",J<4 >  !663!K I # !"A>T",b>,%&/3# ! c>T",B?##^4! C?T",Z?*'#n! [?T",r?4'&(89* s?T",J@8',n=! K@T",t@+   -3FG24IJ#! 3  *',Q[iq r"-CVdrz {)4FY^lt u$/GZ_mu v$QVdl m$/EX`ns t!Oeai j "[.f+'($   3()# KDT", tCc3h'(T"tD&3&8DcN#;&$c$d$ &s&xS#X'?& ,C,DI,#$s) # $s) 4S#X/r