README 통합 갱신: 프로젝트 개요 + 22-step Mermaid + 로드맵 Mermaid
GitHub / Gitea 두 mirror 통합 README. Codex 안 채택 — 옛 AS-IS/TO-BE (Phase Q~T) / "Phase Z 통합 설계" 섹션 폐기 (CHANGE-LOG.md 에 history 박힘). 구조: 1. 프로젝트 개요 — V4 / Phase Z / figma_to_html_agent 책임 분담 2. 전체 실행 구조 (22-step pipeline) - Mermaid flowchart (decision diamond + Block A/B/C 그룹화) - 22 step 텍스트 list (모든 step 명시) - STATUS-BOARD.md 가 single source of truth (✅/⚠/❌) 3. 현재 완료 수준 - MDX03 PASS 결과 - 22-step 진행 수준 ≈ 65~70% - 박힌 axis (시간 순) — Step 7-A/B / 8-A/B / 5 보완 / 6-A / 7-conn / 8-conn / Step 9 v0 / F29 fix / cleanup-1 - 폐기된 안 history (compat 매트릭스 / 6-B frame ownership) - 검증 sample 성격 (MDX 03/04/01/02 = 22-step 보완 수단) 4. 향후 로드맵 - Mermaid LR (7 단계) - 단계별 상세 (frame 연결 / Phase Q audit / AI repair / DB / Front / HTML 수정 / frame 지속) 5. 운영 기준 - 절대 lock (MDX 원문 보존 / 자유 디자인 금지 / 그릇 변경 / dropped) - V4 ↔ Phase Z 책임 분담 - 렌더 정책 (rank-1 / rank 2~6 보존 / user_overrides) + Repository Mirrors (GitHub + Gitea) + 참고 문서 (CLAUDE / OVERVIEW / STATUS-BOARD / CHANGE-LOG / SPEC / ...) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
351
README.md
351
README.md
@@ -1,158 +1,289 @@
|
|||||||
# C.E.L. Slide Pipeline
|
# Design Agent / C.E.L Slide Automation
|
||||||
|
|
||||||
## 이 프로젝트는 무엇인가
|
## 1. 프로젝트 개요
|
||||||
|
|
||||||
MDX 기반 콘텐츠를 입력하면, 1280×720 슬라이드 HTML로 자동 변환하는 파이프라인입니다.
|
MDX 문서를 입력받아 1280×720 프레젠테이션 슬라이드 HTML 로 자동 변환하는 파이프라인.
|
||||||
|
|
||||||
텍스트 콘텐츠를 넣으면, 구조를 분석하고 BEPs(Figma) 디자인을 매칭하여 슬라이드를 만들어줍니다.
|
- **입력**: MDX (텍스트 + 표 + bullets + JSX block + details + image)
|
||||||
|
- **변환**: V4 frame matching → Phase Z render pipeline
|
||||||
|
- **출력**: `final.html` (단일 슬라이드) + step artifact (의사결정 trace)
|
||||||
|
- **최종 목표**: pipeline + AI repair + DB/catalog + frontend editor 가 연결된 *제품형* 시스템
|
||||||
|
|
||||||
|
원천 디자인 = Figma BEPs frame (32 frame) → `figma_to_html_agent/blocks/` 에 HTML/CSS 변환물 누적. V4 catalog (`tests/matching/v4_full32_result.yaml`) 가 MDX section ↔ frame 매칭 점수/label 산출. Phase Z 가 V4 결과를 받아 *render-able slide* 로 번역.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 어떻게 구성/구현되어 있는가
|
## 2. 전체 실행 구조 (22-step pipeline)
|
||||||
|
|
||||||
### 전체 흐름
|
```mermaid
|
||||||
|
flowchart TD
|
||||||
|
Input([MDX Input])
|
||||||
|
Input --> S1_2["Step 1-2<br/>MDX Upload & Normalize"]
|
||||||
|
S1_2 --> S3_4["Step 3-4<br/>Content Object &<br/>Internal Composition Planning"]
|
||||||
|
S3_4 --> S5["Step 5<br/>V4 Frame Evidence<br/><sub>rank 1 + non-reject max-6</sub>"]
|
||||||
|
S5 --> S6["Step 6<br/>Composition Planning"]
|
||||||
|
S6 --> S7["Step 7<br/>Layout Candidates<br/><sub>8 preset vocabulary</sub>"]
|
||||||
|
S7 --> S8["Step 8<br/>Zone / Internal Region /<br/>Display Strategy"]
|
||||||
|
S8 --> S9["Step 9<br/>Application Plan<br/><sub>V4 후보 → 적용 방식 번역</sub>"]
|
||||||
|
S9 --> S10_12["Step 10-12<br/>Frame Contract / Slot Mapping / Payload"]
|
||||||
|
S10_12 --> S13["Step 13<br/>Render final.html<br/><sub>Jinja2 + frame partial</sub>"]
|
||||||
|
S13 --> S14["Step 14<br/>Visual Runtime Check<br/><sub>Selenium</sub>"]
|
||||||
|
S14 --> Visual{"Visual OK?"}
|
||||||
|
Visual -->|Yes| S20["Step 20<br/>PASS / Slide Status"]
|
||||||
|
Visual -->|No| S15_19["Step 15-19<br/>Fit Classification / Router /<br/>Retry / Next Action"]
|
||||||
|
S15_19 --> Repair{"Repair 방식?"}
|
||||||
|
Repair -->|Deterministic<br/>zone_ratio / popup / layout_adjust| S13
|
||||||
|
Repair -->|AI Required<br/>restructure / low score / overflow 반복| AI["AI Repair / Restructure Layer<br/><sub>(향후 axis)</sub>"]
|
||||||
|
AI --> S13
|
||||||
|
S20 --> S21_22["Step 21-22<br/>Debug / Trace / Export / Front 연결"]
|
||||||
|
|
||||||
```
|
classDef stage fill:#e7f5ff,stroke:#1971c2,color:#000
|
||||||
MDX 입력 → 정규화 → 꼭지 추출(AI) → zone 구분 → BEPs 매칭 → 조립 → 검증 → 출력
|
classDef render fill:#fff3cd,stroke:#f59f00,color:#000
|
||||||
|
classDef telemetry fill:#f3f0ff,stroke:#7048e8,color:#000
|
||||||
|
classDef decision fill:#ffd8a8,stroke:#d9480f,color:#000
|
||||||
|
classDef future fill:#f8f9fa,stroke:#868e96,color:#000,stroke-dasharray: 5 5
|
||||||
|
|
||||||
|
class S1_2,S3_4,S5,S6,S7,S8,S9,S10_12 stage
|
||||||
|
class S13 render
|
||||||
|
class S14,S15_19,S20,S21_22 telemetry
|
||||||
|
class Visual,Repair decision
|
||||||
|
class AI future
|
||||||
```
|
```
|
||||||
|
|
||||||
### 구조
|
**Block 구분** : `Block A (PRE-RENDER PLANNING, Step 0~12)` · `Block B (RENDER, Step 13)` · `Block C (POST-RENDER TELEMETRY / EXCEPTION HANDLING, Step 14~22)`. *진짜 fit policy 의 자리* = Block A. C block 은 *exception 처리 layer*.
|
||||||
|
|
||||||
- **slide-base:** 1280×720 슬라이드 프레임. 대목차 + 구분선 + 본문 영역 + 핵심 인사이트(footer)
|
**텍스트 list** (모든 22 step) :
|
||||||
- **레이아웃:** slide-body 안의 zone 분배 형태 (Type A/B/B'/B'')
|
|
||||||
- **zone:** 레이아웃이 정한 콘텐츠 영역 (top/bottom 등)
|
|
||||||
- **프레임 (구 "블록"):** zone 안에 들어가는 디자인 단위. Figma에서 추출한 BEPs 디자인을 HTML/CSS로 변환한 것
|
|
||||||
- **catalog:** 프레임의 메타 정보 (구조, 슬롯, 매칭 조건)
|
|
||||||
|
|
||||||
> ⚠️ Phase Z (2026-04-28) 부터 "블록" → "프레임" 으로 용어 통일. 기존 코드 (`block_reference.py`, `templates/blocks/`, `BLOCK-RULES.md` 등) 는 점진적 정리.
|
```
|
||||||
|
Block A — PRE-RENDER PLANNING (Step 0~12)
|
||||||
|
Step 0 precondition (catalog / contract / V4 / template / asset)
|
||||||
|
Step 1 MDX 업로드
|
||||||
|
Step 2 MDX 정규화 (frontmatter / heading tree / footer)
|
||||||
|
Step 3 Content Object 추출 (text_block / table / image / details / ...)
|
||||||
|
Step 4 Section Internal Composition Planning (whole / group / split)
|
||||||
|
Step 5 V4 Matching Evidence (non-reject max-6 후보 list)
|
||||||
|
Step 6 Composition Planning (composition unit 결정)
|
||||||
|
Step 7 Slide-Level Layout Planning (8 preset vocabulary)
|
||||||
|
Step 8 Zone + Internal Region Ratio Planning
|
||||||
|
Step 9 Region-Level Frame / Display Selection (application_plan)
|
||||||
|
Step 10 Frame Contract 확인
|
||||||
|
Step 11 Content → Internal Region → Frame Slot Mapping
|
||||||
|
Step 12 Slot Payload 생성
|
||||||
|
|
||||||
### 주요 파일
|
Block B — RENDER (Step 13)
|
||||||
|
Step 13 Render (Jinja2 + frame partial → final.html)
|
||||||
|
|
||||||
| 파일 | 역할 |
|
Block C — POST-RENDER TELEMETRY / EXCEPTION HANDLING (Step 14~22)
|
||||||
|------|------|
|
Step 14 Selenium Visual Runtime Check
|
||||||
| `src/pipeline.py` | 파이프라인 오케스트레이션 |
|
Step 15 Fit Classification
|
||||||
| `src/section_parser.py` | 중목차 추출, 구조 분류 |
|
Step 16 Overflow Router
|
||||||
| `src/block_reference.py` | BEPs 디자인 매칭 |
|
Step 17 Implemented Action 실행 (zone_ratio_retry / details_popup_escalation / ...)
|
||||||
| `src/block_assembler.py` | 슬라이드 HTML 조립 |
|
Step 18 Failure Classification
|
||||||
| `templates/blocks/slide-base.html` | 슬라이드 프레임 |
|
Step 19 Next Action Proposal
|
||||||
| `templates/catalog.yaml` | 블록 메타 정보 |
|
Step 20 Slide Status 결정 (PASS / RENDERED_WITH_VISUAL_REGRESSION / ...)
|
||||||
|
Step 21 Debug / Trace 기록
|
||||||
|
Step 22 사용자 확인 / Export
|
||||||
|
```
|
||||||
|
|
||||||
### 산출물
|
각 step 의 ✅ / ⚠ / ❌ 정확한 상태는 [`STATUS-BOARD.md`](docs/architecture/PHASE-Z-PIPELINE-STATUS-BOARD.md) 가 single source of truth.
|
||||||
|
|
||||||
각 실행은 `data/runs/{run_id}/` 아래에 저장됩니다.
|
**위계 (Slide → Frame Slot)**:
|
||||||
|
|
||||||
| 파일 | 내용 |
|
```
|
||||||
|------|------|
|
Slide → Zone → Internal Region → Frame → Frame Slot → Content
|
||||||
| `final.html` | 최종 슬라이드 |
|
```
|
||||||
| `final_context.json` | 파이프라인 결과 데이터 |
|
|
||||||
| `steps/*.html` | 단계별 디버그 보드 |
|
22-step 도면 lock = [`docs/architecture/PHASE-Z-PIPELINE-OVERVIEW.md`](docs/architecture/PHASE-Z-PIPELINE-OVERVIEW.md)
|
||||||
| `첨부*_상세*.html` | popup 상세 내용 |
|
현재 snapshot = [`docs/architecture/PHASE-Z-PIPELINE-STATUS-BOARD.md`](docs/architecture/PHASE-Z-PIPELINE-STATUS-BOARD.md)
|
||||||
|
axis history = [`docs/architecture/PHASE-Z-CHANGE-LOG.md`](docs/architecture/PHASE-Z-CHANGE-LOG.md)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 무슨 문제가 있는가
|
## 3. 현재 완료 수준
|
||||||
|
|
||||||
| 문제 | 설명 |
|
### 3.1 MDX03 정상 경로 (PASS)
|
||||||
|------|------|
|
|
||||||
| **블록마다 스타일이 제각각** | 각 블록 HTML 안에 font-size, color, padding이 직접 박혀있어서, 같은 슬라이드 안에서 블록이 섞이면 위계가 안 맞음 |
|
```
|
||||||
| **slide-base에 구조+스타일 혼재** | 프레임 HTML 안에 전체 CSS가 인라인으로 들어있어서 유지보수가 어려움 |
|
overall : PASS
|
||||||
| **블록이 완성 HTML** | 블록이 구조+스타일+값을 모두 포함하고 있어서, 재사용/조합이 안 됨 |
|
visual_check_passed : true
|
||||||
| **매칭 안 되면 고정 렌더** | BEPs에 맞는 블록이 없을 때 코드가 1회 고정 렌더하고 끝. 반복 조정 없음 |
|
full_mdx_coverage : true
|
||||||
| **빈 공간/overflow 방치** | 렌더 후 빈 공간이 있어도 조정 안 하고, overflow만 감지 |
|
adapter_needed_count : 0
|
||||||
| **검증이 약함** | overflow 측정만 하고, 정렬/위계/가독성 같은 시각 품질은 미검증 |
|
content_truncated_count: 0
|
||||||
|
units : 03-1 → F13 (use_as_is, 0.927)
|
||||||
|
03-2 → F29 (use_as_is, 0.920)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 22-step 진행 수준
|
||||||
|
|
||||||
|
상세는 [`STATUS-BOARD.md`](docs/architecture/PHASE-Z-PIPELINE-STATUS-BOARD.md) 의 표 참조. 큰 그림:
|
||||||
|
|
||||||
|
- **✅ implemented**: Step 1 / 12 / 13 / 15 / 16 / 18 / 20
|
||||||
|
- **⚠ partial**: Step 0 / 2 / 5 / 6 / 7 / 8 / 9 / 10 / 14 / 17 / 19 / 21
|
||||||
|
- **❌ missing 또는 future**: Step 3 (content_object) / 4 (internal composition) / 11 (slot mapping) / 22 (UI)
|
||||||
|
|
||||||
|
→ 22-step 일반화 진행 수준 ≈ **65~70%**. MDX03 정상 경로는 *닫힘*. 일반화 (다른 MDX / edge case / fallback path / UI) 는 진행 중.
|
||||||
|
|
||||||
|
### 3.3 박힌 axis (시간 순)
|
||||||
|
|
||||||
|
이번 session 박힌 주요 axis:
|
||||||
|
|
||||||
|
- **Step 7-A / 7-B**: layout catalog yaml + select_layout_candidates(unit_count) (catalog axis)
|
||||||
|
- **Step 8-A / 8-B-1 / 8-B-2**: region_layouts.yaml + display_strategies.yaml + 후보 함수
|
||||||
|
- **Step 5 보완**: V4 rank-1 → non-reject max-6 후보 list
|
||||||
|
- **Step 6-A**: CompositionUnit 에 v4_candidates 필드 (additive, logic 무변)
|
||||||
|
- **Step 7-conn / 8-conn**: catalog 후보 함수 → runtime artifact 연결 (passive 기록)
|
||||||
|
- **Step 9 v0**: passive application_plan artifact (V4 후보 + layout/region/display 통합 trace)
|
||||||
|
- **F29 visual fidelity fix**: missing SVG 3 개 → CSS gradient 재현 (figma 원본 R8 룰 따라)
|
||||||
|
- **cleanup-1**: stale 주석 정정 (`pipeline 호출처 X` → 호출처 박힘)
|
||||||
|
|
||||||
|
### 3.4 폐기된 안 (history 보존)
|
||||||
|
|
||||||
|
CHANGE-LOG 에 박힘:
|
||||||
|
|
||||||
|
- **compat 매트릭스 안** (Step 9 초기 안) — V4 cardinality 재계산 위험으로 폐기
|
||||||
|
- **6-B (frame ownership transfer)** — misframed axis. V4 가 frame 선택, Step 6 은 전사, Step 9 는 번역. "Step 6 의 frame 채택 책임 이전" = 허구.
|
||||||
|
|
||||||
|
### 3.5 검증 / 실험 repo 성격
|
||||||
|
|
||||||
|
본 repo 는 *제품형 시스템* 까지의 진행 과정에서 *검증 재료* 로 다음 sample 사용:
|
||||||
|
|
||||||
|
- `samples/mdx_batch/03.mdx` — 기준 sample (MDX03 정상 경로 lock)
|
||||||
|
- `samples/mdx_batch/04.mdx` — MDX04 검증 예정
|
||||||
|
- `samples/mdx/01. ...mdx` / `02. ...mdx` — 향후 검증
|
||||||
|
|
||||||
|
샘플 MDX 는 *로드맵 단계* 가 아니라 *22-step pipeline 보완을 위한 검증 재료*.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 어떻게 개선하려 하는가
|
## 4. 향후 로드맵
|
||||||
|
|
||||||
핵심은 3가지입니다.
|
```mermaid
|
||||||
|
flowchart LR
|
||||||
|
R1["1. 22-step Pipeline<br/>Stabilization<br/><sub>frame 연결 / visual check 보강 /<br/>MDX 정리 / 01·02·04 검증</sub>"]
|
||||||
|
R2["2. Phase Q Audit & Salvage<br/><sub>옛 25 모듈 검토 → Z 이식</sub>"]
|
||||||
|
R3["3. AI Repair /<br/>Restructure Layer<br/><sub>low score / reject /<br/>restructure / overflow</sub>"]
|
||||||
|
R4["4. DB / Catalog<br/>Integration<br/><sub>frame / V4 / runs / overrides</sub>"]
|
||||||
|
R5["5. Frontend Connection<br/><sub>run / timeline /<br/>rank 후보 / plan</sub>"]
|
||||||
|
R6["6. HTML Editing /<br/>User Overrides<br/><sub>user_overrides.json</sub>"]
|
||||||
|
R7["7. Continuous Frame<br/>Adapter Updates<br/><sub>Figma → Phase Z adapter</sub>"]
|
||||||
|
|
||||||
1. **블록을 구조 부품화** — 완성 HTML이 아니라, 구조만 담고 스타일은 토큰으로 분리
|
R1 --> R2 --> R3 --> R4 --> R5 --> R6 --> R7
|
||||||
2. **스타일을 토큰으로 통일** — 블록마다 제각각인 폰트/색/여백을 공통 기준으로
|
|
||||||
3. **2경로 파이프라인** — 매칭되면 바로 쓰고(direct-fit), 안 되면 재구성(recipe)
|
|
||||||
|
|
||||||
### AS-IS → TO-BE
|
classDef current fill:#fff3cd,stroke:#f59f00,color:#000
|
||||||
|
classDef future fill:#f3f0ff,stroke:#7048e8,color:#000
|
||||||
|
classDef later fill:#f8f9fa,stroke:#868e96,color:#000,stroke-dasharray: 5 5
|
||||||
|
|
||||||
> ⚠️ 아래 AS-IS / TO-BE 는 Phase Q ~ T 시점의 흐름. **현재 (Phase Z) 흐름은 [`IMPROVEMENT-REDESIGN.md`](IMPROVEMENT-REDESIGN.md)** 참조.
|
class R1 current
|
||||||
|
class R2,R3 future
|
||||||
|
class R4,R5,R6,R7 later
|
||||||
|
```
|
||||||
|
|
||||||
|
**현재 위치** : 단계 (1) 22-step Pipeline Stabilization. MDX03 정상 경로 닫힘 / 일반화 진행 중.
|
||||||
|
|
||||||
|
### 단계별 상세
|
||||||
|
|
||||||
```
|
```
|
||||||
AS-IS (Phase Q ~ T):
|
1. 22-step 파이프라인 정리 (현재)
|
||||||
AI가 먼저 꼭지를 추출하고
|
├ frame ↔ Phase Z 연결 구조 정리 (= V4 frame 후보 → Phase Z render path 연결 확장)
|
||||||
→ 매칭 블록이 있으면 삽입, 없으면 코드가 1회 고정 렌더
|
│ · F14 / F11 / F18 등 미연결 frame 의 contract / partial / builder adapter
|
||||||
→ 빈 공간이 있어도 그냥 둠
|
│ · Figma 새 디자인 X / V4 새 매칭 X — 이미 두 layer 에 있는 frame 의 adapter
|
||||||
→ 블록마다 font-size, color가 직접 박혀있어서 섞이면 위계 안 맞음
|
├ visual check 범위 정리 (Step 14 보강)
|
||||||
|
│ · missing image / table clipping / image aspect mismatch / underfilled zone
|
||||||
|
├ MDX 정규화 / 정리 방법 적용 (Step 2 / 3 / 4)
|
||||||
|
└ MDX 01 / 02 / 04 검증을 통해 보완 (edge case 발견 + pipeline 일반화)
|
||||||
|
|
||||||
TO-BE (Phase Q ~ T):
|
2. Phase Q 재검토 후 Phase Z 반영
|
||||||
중목차 기준으로 zone을 먼저 나누고
|
├ src/ 안 옛 25 모듈 audit (slide_measurer, space_allocator, content_editor 등)
|
||||||
→ TF-IDF로 BEPs 매칭 시도
|
├ 살릴 기능 식별 → Phase Z 로 이식
|
||||||
→ 매칭되면 블록 삽입 + 크기 조절 (direct-fit)
|
└ tests/matching/ 의 V4 진화 history / DECK / ATTACH 자료도 같이 검토
|
||||||
→ 안 되면 AI가 꼭지 정리 + 유사 디자인으로 redesign + 반복 조정 (recipe)
|
|
||||||
→ 빈 공간/overflow를 자동 재분배
|
|
||||||
→ 모든 블록이 토큰 기반이라 스타일 통일
|
|
||||||
|
|
||||||
NEW (Phase Z, 2026-04-28 ~):
|
3. AI 적용 관련 프로세스 정립 및 적용
|
||||||
STAGE 1) MDX 분석 + 레이아웃 매칭 (Type A/B/B'/B'')
|
├ low score / all reject / light_edit / restructure / overflow 반복 케이스
|
||||||
STAGE 2) Zone 별 텍스트 1차 배치
|
├ AI repair / restructure / popup / layout adjust
|
||||||
STAGE 3) Zone 별 프레임 매칭 — V1~V4 (완벽/어정쩡/안됨 분기)
|
├ MDX 원문 보존 lock (AI 가 원문 삭제 / 요약 / 재작성 X)
|
||||||
STAGE 4) 프레임 검토 + 컨테이너 조정 (5차 Fallback)
|
└ 연결 step: Step 9 / 12 / 17 / 19 / 21
|
||||||
STAGE 5) HTML 조립 (slide-base + Jinja2) + 검증 + 출력
|
|
||||||
⭐ AI = zone 안 콘텐츠만 / HTML 구조 = 코드 (Jinja2)
|
4. DB / Catalog 정리
|
||||||
⭐ 자유 디자인 금지 — 프레임 DB 참고 필수
|
├ frame catalog / contracts
|
||||||
⭐ MDX 원문 무손실 보존
|
├ V4 results
|
||||||
|
├ run history / step artifacts
|
||||||
|
├ user overrides
|
||||||
|
└ 선택 이력 (rank-N 사용자 선택 trace)
|
||||||
|
|
||||||
|
5. Front 연결
|
||||||
|
├ run 목록 / preview.png / final.html
|
||||||
|
├ 22-step timeline (각 step artifact 시각)
|
||||||
|
├ V4 rank 1~6 후보 표시 + 사용자 선택
|
||||||
|
├ layout / region / application_plan 표시
|
||||||
|
└ visual check / retry / failure / next action 결과
|
||||||
|
|
||||||
|
6. HTML 수정 기능 추가
|
||||||
|
├ 텍스트 수정
|
||||||
|
├ 이미지 크기 / 위치 조정
|
||||||
|
├ frame 후보 변경 (rank-N 선택)
|
||||||
|
├ layout / region 조정
|
||||||
|
└ user_overrides.json 저장 (final.html 직접 수정 X — MDX 원문 보존 정합)
|
||||||
|
|
||||||
|
7. 이후 frame 지속 업데이트
|
||||||
|
├ Figma → HTML 변환 추가 (figma_to_html_agent)
|
||||||
|
├ Phase Z adapter 연결 (1 의 frame ↔ Phase Z 연결 axis 와 같은 결)
|
||||||
|
├ contract / partial / builder 추가
|
||||||
|
└ V4 catalog 와 runtime 동기화
|
||||||
```
|
```
|
||||||
|
|
||||||
|
→ MDX03 / 04 / 01 / 02 검증은 **(1) 22-step 정리 안의 *수단*** — 별 단계 X.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 현재 상태
|
## 5. 운영 기준
|
||||||
|
|
||||||
| 대상 | 슬라이드 변환 | 파이프라인 자동화 |
|
### 5.1 절대 lock
|
||||||
|------|-------------|----------------|
|
|
||||||
| MDX 03 (3개 목표 + 비교표) | ✅ 완료 | ✅ 파이프라인 연결 |
|
- **MDX 원문 무손실 보존** — AI 가 normal path 에서 MDX 원문을 *재작성 / 삭제 / 요약 X*. 원문은 본문 preview 또는 details/popup 에 *반드시* 보존.
|
||||||
| MDX 02 (목표 + 프로세스 + 상세표) | ✅ 완료 | △ 파이프라인 연결, 시각 품질 개선 중 |
|
- **자유 디자인 금지** — Figma frame DB / catalog / frame contract 기반으로만 디자인 결정. AI 가 frame / layout / 새 디자인 패턴 *생성 X*.
|
||||||
| MDX 01 (Type A, sidebar 구조) | ✅ 완료 (개별) | 미연결 |
|
- **그릇 변경 원칙** — 콘텐츠가 안 맞을 때 *콘텐츠를 줄이지 않음*. *그릇* (layout / zone / region / frame / display strategy) 을 변경. 공통 CSS / padding / tolerance 임의 축소 *금지*.
|
||||||
| 토큰 기반 CSS 체계 | - | ✅ 정의 완료, slide-base 적용 |
|
- **dropped 절대 룰** — `text_block / table / image / details` 는 dropped 절대 X (catalog `forbidden_for` lock). decorative_element 만 dropped 가능.
|
||||||
| Figma 블록 추출 | - | 진행 중 (`figma_to_html_agent/blocks/`) |
|
|
||||||
| **매칭 시스템 (V1~V4)** | - | **✅ 별도 검증 완료** (`tests/`) — TARGET 3/4 |
|
### 5.2 V4 ↔ Phase Z 책임 분담
|
||||||
| **Phase Z 통합 설계** | - | **✅ 설계 완료** (`IMPROVEMENT-REDESIGN.md`) — 구현 대기 |
|
|
||||||
|
- **V4** = frame 선택 (점수 + label: use_as_is / light_edit / restructure / reject)
|
||||||
|
- **Step 5 (Phase Z)** = V4 후보 list 추출 (non-reject max-6, raw 32 entry 영속)
|
||||||
|
- **Step 6** = composition unit 결정 (어느 section 묶음 = 1 zone unit). 현재 V4 rank-1 default 전사
|
||||||
|
- **Step 9 v0** = V4 후보 → application_plan 번역 (V4 axis 재계산 X)
|
||||||
|
- `use_as_is` → `direct_insert`
|
||||||
|
- `light_edit` → `same_frame_with_adjustment`
|
||||||
|
- `restructure` → `layout_or_region_change` (auto_applicable=False, human_review delegate)
|
||||||
|
- `reject` → `exclude`
|
||||||
|
|
||||||
|
### 5.3 렌더 정책
|
||||||
|
|
||||||
|
- **현재 렌더** = V4 rank-1 (Step 6 default)
|
||||||
|
- **rank 2~6 보존** = Step 9 application_plan + Step 5 evidence 에 trace. 향후 frontend 에서 사용자 선택 가능.
|
||||||
|
- **final.html 직접 수정 X** — frontend 에서 변경 시 `user_overrides.json` 으로 누적 (원문 보존 정합).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 다음 단계 방향 — Phase Z 매칭 시스템 통합
|
## Repository Mirrors
|
||||||
|
|
||||||
상세: [IMPROVEMENT-REDESIGN.md](IMPROVEMENT-REDESIGN.md)
|
본 프로젝트는 두 repository 에서 mirror 로 관리됨:
|
||||||
|
|
||||||
| 단계 | 내용 |
|
- **GitHub** : https://github.com/keimin86/design_agent
|
||||||
|------|------|
|
- **Gitea** : https://gitea.hmac.kr/Kyeongmin/C.E.L_Slide_test2
|
||||||
| Phase Z-1 | 통합 prototype — Stage 1.7 만 V4 로 교체, MDX 03 회귀 |
|
|
||||||
| Phase Z-2 | 매칭 + 프리셋 (Type A/B/B'/B'') 통합 |
|
|
||||||
| Phase Z-3 | 컨테이너 검증 + 5 차 Fallback |
|
|
||||||
| Phase Z-4 | 전체 통합 + 검증 |
|
|
||||||
|
|
||||||
**핵심 위계** (Phase Z 정리) :
|
두 저장소의 README 와 코드 base 는 동일하게 유지 (push 시 둘 다 fast-forward).
|
||||||
```
|
|
||||||
slide → slide-base → slide-body → 레이아웃 → Zone → 프레임
|
|
||||||
```
|
|
||||||
|
|
||||||
**5 단계 새 흐름** :
|
|
||||||
1. MDX 분석 + 레이아웃 매칭
|
|
||||||
2. Zone 별 텍스트 배치
|
|
||||||
3. Zone 별 프레임 매칭 (완벽 / 어정쩡 / 안 됨)
|
|
||||||
4. 프레임 검토 + 컨테이너 조정
|
|
||||||
5. HTML 조립 + 검증 + 출력
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 참고 문서
|
## 참고 문서
|
||||||
|
|
||||||
| 문서 | 내용 |
|
| 문서 | 역할 |
|
||||||
|------|------|
|
|---|---|
|
||||||
| [IMPROVEMENT-REDESIGN.md](IMPROVEMENT-REDESIGN.md) | **Phase Z 통합 설계** (위계 / 용어 / 5 단계 흐름) |
|
| [`CLAUDE.md`](CLAUDE.md) | 프로젝트 규칙 + Phase Z 위계 |
|
||||||
| [docs/architecture/FRAME-INTEGRATION-MAP.md](docs/architecture/FRAME-INTEGRATION-MAP.md) | **32 frame Zone 적용 분류** (`zone_direct/adapt/extract/reference_only`) |
|
| [`PHASE-Z-PIPELINE-OVERVIEW.md`](docs/architecture/PHASE-Z-PIPELINE-OVERVIEW.md) | 22-step 도면 (구조 lock) |
|
||||||
| [docs/architecture/PHASE-Z-FRAME-STYLE-INVENTORY.md](docs/architecture/PHASE-Z-FRAME-STYLE-INVENTORY.md) | **Frame / Style / Token 인벤토리** (32 frame + 18 token + 6 legacy) |
|
| [`PHASE-Z-PIPELINE-STATUS-BOARD.md`](docs/architecture/PHASE-Z-PIPELINE-STATUS-BOARD.md) | 현재 snapshot (✅ / ⚠ / ❌) |
|
||||||
| [PROCESS_OVERVIEW.html](PROCESS_OVERVIEW.html) | 임원 보고용 A4 2 페이지 (프로세스 + 구조도) |
|
| [`PHASE-Z-CHANGE-LOG.md`](docs/architecture/PHASE-Z-CHANGE-LOG.md) | axis-by-axis 의사결정 history |
|
||||||
| [tests/PIPELINE.md](tests/PIPELINE.md) | 매칭 시스템 (V1~V4) 통합 정리 |
|
| [`PHASE-Z-CONTENT-OBJECT-SUBZONE-SPEC.md`](docs/architecture/PHASE-Z-CONTENT-OBJECT-SUBZONE-SPEC.md) | content_object + Internal Region + Frame Slot SPEC |
|
||||||
| [PROGRESS.md](PROGRESS.md) | 전체 Phase 이력 (Phase 1~T + R' + Z) |
|
| [`PHASE-Z-FIT-CLASSIFIER-ROUTER-SPEC.md`](docs/architecture/PHASE-Z-FIT-CLASSIFIER-ROUTER-SPEC.md) | Step 14~19 telemetry layer SPEC |
|
||||||
| [CLAUDE.md](CLAUDE.md) | 프로젝트 규칙 + Phase Z 위계 |
|
| [`IMPROVEMENT-REDESIGN.md`](IMPROVEMENT-REDESIGN.md) | Phase Z 통합 설계 핵심 |
|
||||||
| [IMPROVEMENT-PLAN.md](docs/architecture/IMPROVEMENT-PLAN.md) | 개선 설계 (이전 Phase Q 까지) |
|
| [`PROCESS_OVERVIEW.html`](PROCESS_OVERVIEW.html) | 임원 보고용 A4 2 페이지 (프로세스 + 구조도) |
|
||||||
| [TOKENS-v1.md](docs/architecture/TOKENS-v1.md) | 토큰 위계 기준표 |
|
| [`PROGRESS.md`](PROGRESS.md) | 전체 Phase 이력 (Phase 1~T + R' + Z) |
|
||||||
| [BLOCK-RULES.md](docs/architecture/BLOCK-RULES.md) | 블록 작성 규칙 |
|
|
||||||
|
|||||||
Reference in New Issue
Block a user