C.E.L_Slide_test2/docs/architecture/PHASE-Z-PIPELINE-STATUS-BOARD.md

Phase Z — pipeline status board

Snapshot date : 2026-04-30 (OVERVIEW reframe sync — Layer A / Universal Region Model / Operating Principles 반영) 역할 : 현재 위치표 / grading snapshot. 지도 본문 은 PHASE-Z-PIPELINE-OVERVIEW.md.

문서	역할	변동
PHASE-Z-PIPELINE-OVERVIEW.md	고정 지도 (22-step 도면)	거의 안 바뀜
PHASE-Z-PIPELINE-STATUS-BOARD.md	현재 진행 snapshot	자주 갱신

본 문서가 하지 않는 것 :

• 새 구현 제안 X
• next step 추천 X
• 우선순위 결정 X
• A/B/C 선택지 X
• MDX03 / MDX04 추가 분석 X
• 코드 변경 X
• OVERVIEW 구조 수정 X

---

1. Counting rule

Step 0      = precondition  (파이프라인 가동 전 사전 준비)
Step 1~22   = runtime pipeline  ("22-step pipeline" = 이 범위)
총 항목 수  = 23 (Step 0 + Step 1~22)
명명 = "22-step" (runtime 기준)

Step 0 은 본체가 아닌 준비 조건. Step 1 (MDX 업로드) 부터가 runtime entry.

---

2. 22-step status board

Block	Step	이름	Status
—	0	사전 준비 (catalog / contract / V4 / template / asset)	⚠ partial
A	1	MDX 업로드	✅
A	2	MDX 정규화	⚠ partial
A	3	Content Object 추출	❌
A	4	Section Internal Composition Planning	❌
A	5	Matching Evidence 생성	⚠ partial (rank-1 only)
A	6	Composition Planning	⚠ partial
A	7	Slide-Level Layout Planning	⚠ partial (count-based)
A	8	Zone + Internal Region Ratio Planning	⚠ partial (zone-level horizontal-2 만 dynamic, region-level 미구현)
A	9	Region-Level Frame / Display Selection	⚠ Step 5 와 conflate + region-level 미구현
A	10	Frame Contract 확인	⚠ partial (no sub_zones)
A	11	Content Unit / Child Group → Internal Region → Frame Slot Mapping	❌
A	12	Slot Payload 생성	✅ (deterministic)
B	13	Render	✅
C	14	Selenium Visual Runtime Check	⚠ partial (text/structural only)
C	15	Fit Classification (A1)	✅
C	16	Overflow Router (A2)	✅
C	17	Implemented Action 실행 (A3)	⚠ partial (zone_ratio_retry only)
C	18	Failure Classification (A4-1)	✅
C	19	Next Action Proposal (A4-2)	⚠ partial (1-D mapping)
C	20	Slide Status 결정	✅
C	21	Debug / Trace 기록	⚠ partial (planning trace 누락 + region-level telemetry 미기록)
C	22	사용자 확인 / Export	⚠ future (UI 영역 — 현재 범위 외)

범례 :

• ✅ implemented
• ⚠ partial
• ❌ missing
• ⚠ future (현 범위 외 — 후속)

---

3. 핵심 missing

Step 3.  Content Object 추출
Step 4.  Section Internal Composition Planning
            (3-way decision tree + Internal Region 분할)
Step 11. Content Unit / Child Group → Internal Region → Frame Slot Mapping

이 3 step 의 부재가 → Step 5 / 6 / 7 / 8 (region-level) / 9 (region-level) / 10 / 12 / 21 의 ⚠ partial 의 원인 종속.

Cross-cutting missing — Zone Internal Region (Layer A) :

• first-class entity 로 lock 됨 (PHASE-Z-PIPELINE-OVERVIEW.md Universal Region Model 참조)
• Step 4 / 8 / 9 / 11 의 granularity unit 이 zone → region 으로 한 단계 내려감 — 그 layer 자체의 schema / 구현 부재
• 도면 (OVERVIEW) 에는 반영됐으나 SPEC / PLAN / 코드 어디에도 Layer A 의 schema / 구현 없음

Step 22 는 별도 범주 (UI 영역 — 현재 자동 파이프라인 범위 외).

---

4. 구조 적절성 검토 (brief)

snapshot — 22-step 재구성 / 합치기 / 쪼개기 제안 X. OVERVIEW 영역.

• 3-block 구조 (A 계획 / B 렌더 / C 사후 telemetry) 적절. 위계 추가 (Zone Internal Region) 후에도 block 경계는 변동 없음
• Step 3~4 가 Step 5 보다 앞 인 순서 적절. content_object 와 internal composition decision (3-way) 이 frame matching 의 입력이어야 함
• Step 5 (evidence 생성) 와 Step 9 (final frame / display 선택) 가 분리 된 구조 적절. 현재 conflate 된 건 구현 결손이지 도면 결손 아님. Step 9 의 unit of analysis = region 으로 reframe (OVERVIEW)
• A1~A4 는 post-render telemetry layer. 진짜 fit policy 의 자리는 Block A (composition planning, region 분할 포함). C block 은 exception 처리 + 진단 안내
• Universal Region Model 적용 후에도 step numbering 보존 : Layer A 도입은 step 추가가 아니라 Step 4 / 8 / 9 / 11 의 granularity unit shift 로 흡수됨. step 0 ~ 22 그대로

---

5. AI 사용 위치 (runtime 기준)

runtime AI = Step 12 의 light_edit / restructure 1 곳만
   ├ 입력 : content_object + frame contract + Internal Region 배치 + Frame Slot 명세
   ├ 출력 : content → Internal Region / Frame Slot proposal
   └ 금지 : MDX 원문 요약·삭제 / HTML·CSS 직접 생성 / layout·zone·region·frame 임의 선택

Step 0 (사전 준비) 의 Figma → HTML 변환은 precondition phase 의 작업 — runtime AI 아님.

다른 step 에서의 AI 호출은 본 도면 안에 없음.

---

6. 현재 병목 (한 줄)

현재 Phase Z 는 post-render telemetry / status 는 많이 구축되었으나, 일반 MDX 대응을 위한 pre-render planning, 특히 content_object extraction (Step 3) / section internal composition planning (Step 4 — 3-way decision + Zone Internal Region 분할) / Internal Region → Frame Slot mapping (Step 11) 이 핵심 gap. 추가로 runtime contract-registered / verified frame set 이 text-frame 중심 이라 mixed-content (image / table / details) 처리는 frame 매칭이 아니라 display strategy 로만 가능 — 전체 frame inventory audit 또는 contract 등록 확장이 별 영역.

---

사용 방법

• 새 작업 들어오면 → 본 board 의 어느 step 의 status 를 바꾸는 작업인지 식별
• 작업이 Step 매핑이 안 되면 → over-scoped 또는 새 step 정의 필요 (OVERVIEW 영역)
• ✅ → ⚠ → ❌ status 전이 / 갱신 시 → 본 board 만 수정. OVERVIEW 는 step 추가/제거/순서 변경 시에만