템플릿 빌더 공정 프로세스 IA (정보구조도)

# 템플릿 빌더 공정 프로세스 IA (정보구조도) 본 문서는 `conversion_workflow.php` 및 `saas_theme_convert.php` 등에서 가동되는 **멀티 프레임워크 자동 변환 엔진**의 전체 공정 프로세스를 기능 중심의 정보구조도(Information Architecture)로 도식화한 결과입니다. ## 1. IA 마인드맵 (Mindmap View) 공정 프로세스의 큰 갈래와 하위 기능들의 연관성을 한눈에 볼 수 있는 마인드맵 뷰입니다. ```mermaid mindmap root((템플릿 빌더 자동 공정)) 1. 템플릿 준비 1.1 원본 HTML 템플릿 로드 1.2 DOM 구조 분석 2. 콘텐츠 전처리 2.1 LLM 기반 자동 번역 2.2 에셋 및 이미지 추출 3. 코어 변환 엔진 3.1 HTML 구문 파싱 3.2 휴리스틱 레이아웃 분할 3.3 동적 에셋 경로 치환 3.4 CMS별 소스코드 조립 4. 상품화 연동 4.1 필수 게시판 자동 생성 4.2 쇼핑몰 상품 자동 등록 5. 패키징 및 상태 갱신 5.1 최종 플랫폼별 zip 압축 5.2 메타데이터 DB 기록 ``` --- ## 2. 계층형 정보구조도 (Tree Structure View) 기능이 실행되는 절차적 흐름과 뎁스(Depth)를 표현한 트리 구조 다이어그램입니다. ```mermaid graph TD Root[템플릿 빌더 공정 프로세스] Root --> D1[Depth 1: 템플릿 준비] D1 --> D1_1[1.1 원본 HTML 파일 탐색] D1 --> D1_2[1.2 DOM 요소 및 에셋 의존성 분석] Root --> D2[Depth 1: 콘텐츠 전처리] D2 --> D2_1[2.1 LLM 연동 텍스트 한글화] D2 --> D2_2[2.2 레이아웃 썸네일 및 미디어 추출] Root --> D3[Depth 1: 멀티 프레임워크 변환 엔진] D3 --> D3_1[3.1 구문 파싱 및 UTF-8 인코딩 정규화] D3 --> D3_2[3.2 헤더/바디/푸터 휴리스틱 분할] D3 --> D3_3[3.3 정적 리소스 → CMS 동적 함수 치환] D3 --> D3_4[3.4 대상 플랫폼 언어 기반 파일 조립] Root --> D4[Depth 1: 비즈니스 로직 및 상품화] D4 --> D4_1[4.1 템플릿용 게시판 스키마 생성] D4 --> D4_2[4.2 영카트 상품/옵션 DB 연동 등록] Root --> D5[Depth 1: 릴리즈 패키징] D5 --> D5_1[5.1 프레임워크별 배포용 zip 생성] D5 --> D5_2[5.2 변환 이력 테이블 업데이트] ``` --- ## 3. IA 상세 명세 (Depth Detail) 각 공정 단계별 파일 및 처리 대상 영역을 정의한 명세표입니다. | Depth 1 (공정 단계) | Depth 2 (세부 모듈) | Depth 3 (실행 내용) | 관련 타겟 / 비고 | | :--- | :--- | :--- | :--- | | **1. 템플릿 준비** | 1.1 원본 로드 | `_repository/_raw` 내 원본 HTML 읽기 | 물리 파일 시스템 | | | 1.2 사전 분석 | 메인/서브 페이지, CSS/JS 참조 노드 스캔 | `conversion_workflow.php` | | **2. 콘텐츠 전처리** | 2.1 LLM 번역 | 프롬프트 기반 텍스트 한글화 치환 | `lib.lmstudio_client.php` | | | 2.2 리소스 추출 | 템플릿 내 대표 이미지 수집 및 썸네일화 | `image_manager.php` | | **3. 코어 변환 엔진** | 3.1 파싱/정규화 | 문서 인코딩 강제 변환 및 DOM 트리 구축 | `saas_theme_convert.php` | | | 3.2 레이아웃 분할 | ``, `` 기준 상/중/하단 분리 | 휴리스틱 알고리즘 적용 | | | 3.3 경로 정규화 | `src="img/"` → `<?php echo G5_THEME_URL ?>` | 프레임워크별 함수/문법 대응 | | | 3.4 파일 조립 | 분리된 소스를 프레임워크 구조에 맞게 생성 | `head.php`, `App.jsx` 등 | | **4. 비즈니스 연동** | 4.1 게시판 생성 | 샘플 데이터 및 게시판 테이블 생성 | `g5_board` 연동 | | | 4.2 상품 등록 | 변환된 템플릿을 영카트 상품으로 Insert | `lib.product_registration.php` | | **5. 릴리즈 패키징** | 5.1 zip 압축 | `data/template/{slug}` 하위에 플랫폼별 패키징 | 파일 압축 및 저장 | | | 5.2 상태 갱신 | `g5_converted_themes` 변환 완료 마킹 | 상태값 `active` 전환 |