diff --git a/scripts/smoke_frame_render.py b/scripts/smoke_frame_render.py index 49de708..ff34b19 100644 --- a/scripts/smoke_frame_render.py +++ b/scripts/smoke_frame_render.py @@ -183,12 +183,31 @@ _MOCK_CONSTRUCTION_GOALS = { "intersection": "3요소가 조화를 이룰 때 BIM 의 궁극적 목표 달성", } +# Track A frame 3 — construction_bim_three_usage (frame 11). +# Builder = quadrant_flat_slots reuse (pad_to=3, category_N_label/body keys). +_MOCK_CONSTRUCTION_BIM_USAGE = { + "title": "시공단계 BIM 모델·정보 활용 구분", + "category_1_label": "모델기반", + "category_1_body": [ + {"text": "최종 목적물의 3D 형상정보 활용", "indent": 0}, + ], + "category_2_label": "객체기반", + "category_2_body": [ + {"text": "Model 개별 객체의 건설정보 활용", "indent": 0}, + ], + "category_3_label": "위치기반", + "category_3_body": [ + {"text": "공사 중 위치정보 활용", "indent": 0}, + ], +} + SELF_CHECK_FIXTURES: dict[str, dict] = { "three_parallel_requirements": _MOCK_THREE_PARALLEL, "process_product_two_way": _MOCK_PROCESS_PRODUCT, "bim_issues_quadrant_four": _MOCK_QUADRANT, "three_persona_benefits": _MOCK_THREE_PERSONA_BENEFITS, "construction_goals_three_circle_intersection": _MOCK_CONSTRUCTION_GOALS, + "construction_bim_three_usage": _MOCK_CONSTRUCTION_BIM_USAGE, } diff --git a/templates/phase_z2/catalog/frame_contracts.yaml b/templates/phase_z2/catalog/frame_contracts.yaml index eeca9e8..980df91 100644 --- a/templates/phase_z2/catalog/frame_contracts.yaml +++ b/templates/phase_z2/catalog/frame_contracts.yaml @@ -318,3 +318,71 @@ construction_goals_three_circle_intersection: label_key_pattern: "circle_{n}_label" empty_label: "" intersection_default: "" # MDX 안 intersection 명시 안 되면 빈 문자 + + +construction_bim_three_usage: + # Reason : V4 UAI=1 (01-1) + RS=1 — UAI tier strongest after F12. + # Pattern : cards / cards-3-category — 3 horizontal stacked rows. + # Track A frame 3 (Codex round 39 accepted, V4 priority strict). + template_id: construction_bim_three_usage + frame_id: 1171281182 + family: cards + + source_shape: top_bullets + cardinality: + strict: 3 + overflow_policy: abort_or_review + + # 순서 기반 visual role — 3 카테고리 (model / object / position) 각자 + # Figma 의 동일 brown label box + white content card 패턴. role 은 + # MDX label 내용 따라 결정되므로 generic ordering name 만. + role_order: + - category_1 + - category_2 + - category_3 + + # min_height_px derivation (round 13 §2.2 — derive + confirm) : + # Figma frame 1066 px @ scale 0.67542 → 720 px adapted (full frame). + # Phase Z compact (title + 3 rows + padding) : + # title 30 + 3 row × 70 (label + body) + gap 6×2 + padding 30 = 282 px. + # + safety buffer (body bullets 2-3 lines/row 보호) 38 = **320**. + # Confirm via smoke `--render-to` artifact + MDX 03 regression. + visual_hints: + min_height_px: 320 + + accepted_content_types: + - text_block + + # Frame Slot 선언 (SPEC v1 §3 layer B). 3 category × {label + body}. + sub_zones: + - id: category_1 + role: main_text + accepts: [text_block] + cardinality: { strict: 1 } + partial_target_path: ".f11b__rows > .f11b__row:nth-child(1)" + - id: category_2 + role: main_text + accepts: [text_block] + cardinality: { strict: 1 } + partial_target_path: ".f11b__rows > .f11b__row:nth-child(2)" + - id: category_3 + role: main_text + accepts: [text_block] + cardinality: { strict: 1 } + partial_target_path: ".f11b__rows > .f11b__row:nth-child(3)" + + payload: + title: + source: section.title + # Builder 재사용 = `quadrant_flat_slots` (F16) — pad_to / label_key / body_key + # 만 configure. F16 / 본 frame 모두 *flat keyed slot + label + body* grammar. + # Codex round 39 secondary builder reuse 허용 (V4 primary 보존). + builder: quadrant_flat_slots + builder_options: + item_parser: quadrant_item # F16 의 parser 재사용 + pad_to: 3 # 3 categories + truncate_at: 3 + label_key_pattern: "category_{n}_label" + body_key_pattern: "category_{n}_body" + empty_label: "" + empty_body: [] diff --git a/templates/phase_z2/families/construction_bim_three_usage.html b/templates/phase_z2/families/construction_bim_three_usage.html new file mode 100644 index 0000000..5c8b22b --- /dev/null +++ b/templates/phase_z2/families/construction_bim_three_usage.html @@ -0,0 +1,169 @@ + +{# +───────────────────────────────────────────────────────────────────────────── +Visual Provenance — figma_to_html_agent/blocks/1171281182/ (frame 11) +───────────────────────────────────────────────────────────────────────────── +Frame 11 = "시공단계 BIM 모델·정보 활용 구분" (cards-3-category, 1248×1066 +px, scale 0.67542). Figma 원본 = 3 horizontal stacked rows (각 row = brown +label box at left + white content card at right with green border) + bottom +BIM 모델/공사 Process 다이어그램 (deco). + +본 partial = Track A frame 3 (Codex round 39 accepted, V4 strongest UAI tier). +`index.html` base + Phase Z 규약 adapt + **compact MDX-mapped focus**. + +3-layer architecture (matrix §0) : +- V4 = matching authority — V4 ranked this frame as use_as_is for "01-1 용어 정의" + (MDX 01) and restructure=1 다른 section. UAI tier post-F12. +- figma_to_html = source/evidence — 401-line index.html + 4 PNG assets (title-icon, + card_decor × 3). full A+T+I+F+S resource. +- Phase Z = runtime orchestration — 본 commit 추가 runtime 자원 (catalog + partial + smoke). + +PROMOTED — CSS (Figma 색/디자인 의도 → CSS 보존) : + - 브라운 label box : rgba(50,31,9,0.8) bg + 우측 둥글기 (border-radius 0 20 20 0) + + drop-shadow — index.html L82-95 + - 라벨 typography : yellow (#FFE100) Korean + white English/subscript text — index.html L92-96 + - 화이트 content card : white bg + green border (#A5BBB4) — index.html L99-103 + - title gradient : F13/F14/F12 zone-title family (#000 ~ #883700) + +NOT PROMOTED — Phase Z compact zone fit (자체 결정, P1 case-by-case, matrix §4.1 Fix 7) : + - title-icon (50×50 PNG) — small icon, zone-size 에서 visible 효과 ↓ + - card_decor × 3 (260×120 decorative image at right side of each card) — Figma + 의 visual 풍부함이지만 MDX 내용과 무관 deco + - 하단 BIM 모델/공사 Process 연계 다이어그램 — Figma 의 *대구도 시각* 으로 + compact zone (320px 정도) 에서 표현 불가. content 의 *bottom synthesis text* 가 + 이 역할 대체 가능 — 단 현재 cardinality strict 3 (body) 라 별 slot 추가 X + → figma_to_html source evidence 는 *보존* (assets/ 폴더 그대로). 향후 *fidelity + review* 시 promote 결정 가능 (preservation guardrail, Codex round 37 §3 정합). + +ADAPTED : + - Figma 50/45/38/30px → token-fixed (zone-title 13 / sub-title 12 / caption / body 11) + - 1248×1066 absolute positioning + zoom 0.67542 → Phase Z flex column (3 row stack) + - 335×124 label box → compact 90~110×40~50 box (zone fit) + - 870×124 card → flex-1 (남은 width 차지) +───────────────────────────────────────────────────────────────────────────── +min_height_px derivation (round 13 §2.2) : + title 30 + 3 row × 70 (label + body 2-3 bullets) + gap 6×2 + padding 30 = 282 + + safety buffer 38 = **320**. F29/F12 와 동등 class. +───────────────────────────────────────────────────────────────────────────── +slots : + - title : section.title + - category_1_label / 2_label / 3_label : 3 category headings (quadrant_flat_slots) + - category_1_body / 2_body / 3_body : 3 category bullet lists (text_lines) +───────────────────────────────────────────────────────────────────────────── +4-class failure taxonomy (matrix §4.1 Fix 7) : + - class 1 adapter readiness : `quadrant_flat_slots` builder 재사용 (pad_to=3 + + key_pattern). 기존 F16 builder 미터치, secondary reuse 허용 (Codex round 39). + - class 2 content-fit : 3 row stack + body bullets. row 별 ~70px 한계 → + body 가 2-3 bullets 짧게. 4+ bullets 시 overflow watch. +#} + + + +
+
{{ slot_payload.title }}
+
+ {# 3 rows — quadrant_flat_slots produces category_N_label / category_N_body for N=1..3 #} +
+
{{ slot_payload.category_1_label | safe }}
+
+ {% if slot_payload.category_1_body %} + {% for line in slot_payload.category_1_body %}
{{ line.text | safe }}
{% endfor %} + {% endif %} +
+
+
+
{{ slot_payload.category_2_label | safe }}
+
+ {% if slot_payload.category_2_body %} + {% for line in slot_payload.category_2_body %}
{{ line.text | safe }}
{% endfor %} + {% endif %} +
+
+
+
{{ slot_payload.category_3_label | safe }}
+
+ {% if slot_payload.category_3_body %} + {% for line in slot_payload.category_3_body %}
{{ line.text | safe }}
{% endfor %} + {% endif %} +
+
+
+