[ARCH-001] 플랫폼 아키텍처 명세서 admin 2026.05.19 4 # 📋 Custemplate 플랫폼 마스터 플랜 (최종 통합본) > **문서 ID:** FINAL-01 > **작성일:** 2026-05-20 > **통합 대상:** ARCH-001, CATE-001, WBS-001 v1/v2, restructuring_plan, platform_vision, platform_audit 외 12개 문서 > **성격:** 이 문서가 모든 기획의 **단일 진실 원천(Single Source of Truth)**입니다. --- ## 1. 플랫폼 비전 및 핵심 요구사항 ### 1-1. 서비스 개요 무료/유료 HTML 템플릿을 **다양한 CMS/프레임워크 테마로 자동 변환**하고, 사용자가 노코드로 커스터마이징한 뒤 **호스팅까지 원스톱으로 제공**하는 SaaS 플랫폼. ### 1-2. 타겟 고객 | 유형 | 어필 포인트 | 핵심 요구 | |------|-----------|----------| | 신규 제작 | 다양성, 편의성, 효율성 | 전 과정 무오류, 가이드 제시, 자동 추천 | | 기존 사이트 리뉴얼 | 가격 경쟁력, 레거시 보존 | 기존 환경 유지, 레거시 데이터 100% 보존 | ### 1-3. 전체 사용자 워크플로우 ``` 템플릿 탐색 → 옵션 소개/가이드 → 미리보기 → 프레임워크 선택 → 주문/결제 → 호스트 자동 개통 → 노코드 에디팅 → 테스트 → 배포 → 유지관리 ``` ### 1-4. 핵심 요구사항 3가지 1. **모듈형 옵션 시스템**: 웹사이트 기능을 옵션화하여 사용자가 선택적 장착. 영카트 상품 옵션과 자동 연동. 2. **멀티 CMS/프레임워크 변환** ← ⭐ 가장 중요: 하나의 원시 HTML 템플릿을 **7가지 이상의 프레임워크**로 자동 변환 (아래 §3 상세) 3. **저비용 운영 구조**: 플랫폼 자체가 저비용으로 운영 가능한 아키텍처 --- ## 2. 3-Zone 서버 아키텍처 ### 2-1. 논리적 분리 (현재 단일 서버) ``` ┌──────────────────────────────────────────────────────────┐ │ 카페24 서버 (단일) │ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ Zone A │ │ Zone B │ │ Zone C │ │ │ │ 자원 저장소 │ │ SaaS 웹앱 │ │ 호스팅 서비스 │ │ │ │ │ │ │ │ │ │ │ │ _repository/ │ │ theme/ │ │ _hosted/ │ │ │ │ data/template│ │ user/ │ │ (고객 사이트) │ │ │ │ (원시/WIP/ │ │ adm/ │ │ │ │ │ │ 완료 패키지) │ │ _base_engine/│ │ │ │ │ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │ │ └──────── custemplate DB ────────────┘ │ └──────────────────────────────────────────────────────────┘ ``` ### 2-2. 코드 수준 추상화 (추후 물리적 분리 대비) ```php // extend/custemplate.config.php define('CT_ZONE_A_PATH', G5_DATA_PATH.'/template'); // 추후: NAS/CDN define('CT_ZONE_A_URL', G5_DATA_URL.'/template'); // 추후: CDN URL define('CT_ZONE_C_PATH', G5_PATH.'/_hosted'); // 추후: 호스팅 서버 define('CT_REPOSITORY_PATH', G5_PATH.'/_repository'); // 추후: NAS ``` --- ## 3. ⭐ 멀티 프레임워크 변환 파이프라인 > [!IMPORTANT] > 이것이 custemplate의 **핵심 경쟁력**입니다. 하나의 원시 HTML 템플릿에서 다양한 CMS/프레임워크 테마를 자동 생성합니다. ### 3-1. 지원 대상 프레임워크 (7종+) | # | 프레임워크 | 슬러그 | 현재 상태 | 변환기 파일 | 비고 | |---|-----------|--------|----------|------------|------| | 1 | **GnuBoard 5** | `gnuboard` | ✅ 구현됨 | `saas_theme_convert.php` | head/index/tail 분리, G5 상수 치환 | | 2 | **WordPress** | `wordpress` | ✅ 구현됨 | `wordpress_theme_convert.php` | header/footer/index/functions/style.css 생성 | | 3 | **Laravel (Blade)** | `laravel` | 🔲 계획됨 | (미작성) | layouts/app.blade.php 구조 변환 | | 4 | **React (CRA/Vite)** | `react` | 🔲 계획됨 | (미작성) | JSX 컴포넌트 분리 변환 | | 5 | **Vue.js** | `vue` | 🔲 계획됨 | (미작성) | SFC(.vue) 컴포넌트 변환 | | 6 | **Next.js** | `nextjs` | 🔲 계획됨 | (미작성) | App Router/Pages 구조 변환 | | 7 | **Static HTML** | `static` | ✅ 원본 | (복사만) | 원시 HTML 그대로 패키징 | | 8 | **XpressEngine** | `xe` | 🔲 계획됨 | (미작성) | 국내 CMS 추가 대응 | ### 3-2. 변환 엔진 공통 아키텍처 모든 프레임워크 변환기는 아래 **5단계 파이프라인**을 공유합니다: ``` [1] 원시 HTML 파싱 └→ index.html 읽기 + 인코딩 정규화 [2] 휴리스틱 분할 (Heuristic Split) └→ </header>, <footer> 태그 탐지 → head/body/footer 분리 └→ Fallback: <body> 태그 기준 분리 [3] 에셋 경로 정규화 (Asset Rewriting) └→ 정적 경로(css/, js/, img/) → 각 프레임워크의 동적 경로 함수로 치환 └→ GnuBoard: <?php echo G5_THEME_CSS_URL ?> └→ WordPress: <?php echo get_template_directory_uri(); ?> └→ Laravel: {{ asset('css/...') }} └→ React/Vue: import 구문으로 변환 └→ Next.js: public/ 폴더 참조 또는 next/image [4] 프레임워크별 파일 생성 └→ GnuBoard: head.php, index.php, tail.php, head.sub.php, tail.sub.php, theme.config.php └→ WordPress: header.php, footer.php, index.php, functions.php, style.css, page.php, single.php └→ Laravel: layouts/app.blade.php, views/home.blade.php, routes/web.php └→ React: App.jsx, components/Header.jsx, components/Footer.jsx, index.css └→ Vue: App.vue, components/HeaderSection.vue, components/FooterSection.vue └→ Next.js: app/layout.tsx, app/page.tsx, components/... [5] 메타데이터 기록 └→ g5_converted_themes INSERT (변환 이력) └→ g5_saas_template status 업데이트 ``` ### 3-3. 변환 타입 DB 관리 (`g5_conversion_types`) 어드민 화면(`conversion_types.php`)에서 각 변환 타입의 가격/상태를 관리합니다: - 변환별 **개별 과금** 가능 (무료 변환 / 유료 변환) - 상태: `planned` → `developing` → `active` → `deprecated` ### 3-4. 통합 변환 워크플로우 (`conversion_workflow.php`) 6단계 마스터 플로우 (구현됨): ``` 📋 템플릿 선택 → 🔍 구조 분석 → 🌐 한글화(LLM) → 🖼️ 이미지 추출 → ⚙️ 테마 변환 → 📝 게시판 생성 → 🛒 상품 등록 ``` 변환 옵션 체크박스: - [x] 🌐 한글화 (LLM 번역) — `lib.lmstudio_client.php` 연동 - [x] 🖼️ 이미지 추출 — `image_manager.php` - [x] 📝 게시판 자동 생성 - [x] 🛒 상품 자동 등록 — `lib.product_registration.php` --- ## 4. 폴더 구조 (확정안) ``` html-custemplate/ │ │ ── [Zone A: 자원 저장소] ────────────────────── │ ├── _repository/ ← 템플릿 작업장 │ ├── _raw/ ← 원시 템플릿 (수집 상태 그대로) │ │ ├── html/{industry}/ ← 업종별 정리 │ │ │ └── {template_slug}/ │ │ ├── react/ │ │ ├── vue/ │ │ └── wordpress/ │ ├── _wip/ ← 변환 작업중 │ └── _reference/ ← 참고 자료 (업종코드 CSV 등) │ ├── data/template/ ← 변환 완료 패키지 (상품) │ └── {template_slug}/ │ ├── gnuboard/v1.0.0.zip ← 프레임워크별 버전 │ ├── wordpress/v1.0.0.zip │ ├── laravel/v1.0.0.zip │ ├── react/v1.0.0.zip │ ├── vue/v1.0.0.zip │ ├── nextjs/v1.0.0.zip │ ├── static/v1.0.0.zip │ ├── thumb.jpg ← 대표 썸네일 │ └── manifest.json ← 패키지 메타 │ │ ── [Zone B: SaaS 서비스] ────────────────────── │ ├── theme/custemplate/ ← SaaS 웹 서비스 테마 ├── user/ ← SaaS 사용자 대시보드 (18개 스크립트) ├── adm/ ← 관리자 ├── _base_engine/gnuboard/ ← 프로비저닝 시드 │ │ ── [Zone C: 호스팅] ────────────────────────── │ └── _hosted/ ← 고객 배포 사이트 └── {customer_id}_{site_slug}/ ``` ### 현재 → 신규 매핑 | 현재 경로 | 이동 대상 | |-----------|----------| | `/_template/category/*` | `/_repository/_raw/html/{industry}/` | | `/_template/무료 템플릿 모음-*` | `/_repository/_raw/html/_unsorted/` | | `/_template/*.csv` | `/_repository/_reference/` | | `/demo/*` | 패키징 후 `/data/template/{slug}/gnuboard/` | | `/wp-themes/*` | 패키징 후 `/data/template/{slug}/wordpress/` | --- ## 5. 업종 분류 체계 (3단계) **L1 대분류 8개** → L2 중분류 ~30개 → L3 소분류 ~120개 | L1 code | 한국어 | 주요 L2 | |---------|--------|---------| | `business` | 기업/비즈니스 | 일반기업, 스타트업, 제조/산업, 금융/보험, 부동산 | | `commerce` | 쇼핑몰/커머스 | 패션, 뷰티, 식품, 전자/가전, 가구/리빙, 반려동물, 디지털상품 | | `service` | 서비스업 | 음식점/카페, 숙박/여행, 교육/학원, 웨딩/이벤트, 피트니스 | | `professional` | 전문직/기관 | 병원/의료, 법률, 관공서/공공, 종교 | | `creative` | 크리에이티브 | 포트폴리오, 사진/영상, 디자인에이전시 | | `tech` | IT/테크 | SaaS/앱, 호스팅, 대시보드, 문서/도큐먼트 | | `community` | 커뮤니티 | 블로그/매거진, 포럼 | | `utility` | 유틸리티 | CMS테마, 다목적, 랜딩페이지 | > 상세 L2/L3 분류표는 별도 문서 **FINAL-02** 참조 --- ## 6. 현재 구현 현황 실측 ### 6-1. 사용자단 프론트엔드 (9개 화면) — ✅ UI 완료 | 화면 | 소스 | 상태 | |------|------|------| | 메인 페이지 | `theme/custemplate/index.php` | ✅ 정상 | | 템플릿 목록 | `theme/custemplate/template_list.php` | ✅ 정상 | | 템플릿 미리보기 | `theme/custemplate/preview.php` | ✅ 정상 | | 회사소개/요금제/포트폴리오 | `theme/custemplate/*.php` | ✅ 정상 | | 내 템플릿 | `theme/custemplate/mytemplate.php` | ✅ 정상 | ### 6-2. 관리자 백엔드 — 부분 구현 | 기능 | 파일 | 상태 | |------|------|------| | 템플릿 목록/등록/수정 | `saas_template_list.php`, `saas_template_form.php` | ✅ 구현됨 | | 템플릿 자동 스캔 | `saas_template_scan.php` | ✅ 구현됨 | | 그누보드 테마 변환 | `saas_theme_convert.php` | ✅ 구현됨 | | 워드프레스 테마 변환 | `wordpress_theme_convert.php` | ✅ 구현됨 | | 통합 변환 워크플로우 | `conversion_workflow.php` | ✅ UI+AJAX 구현 | | 변환 타입 관리 | `conversion_types.php` | ✅ 구현됨 | | LLM 한글화 클라이언트 | `lib.lmstudio_client.php` | ✅ 구현됨 (외부 서버 연동 미검증) | | 이미지 매니저 | `image_manager.php` | ✅ 구현됨 | | 배포 관리 | `deployment.php` | ✅ 구현됨 | | 호스팅 대시보드 | `hosting_dashboard.php` | ✅ 구현됨 | | WBS 대시보드/명세 | `wbs_dashboard.php`, `wbs_task.php`, `wbs_screen.php` | ✅ 구현됨 | ### 6-3. SaaS 사용자 대시보드 (`/user/`) — ✅ 구현됨 | 기능 | 상태 | |------|------| | 템플릿 빌드 (ajax.build_theme.php) | ✅ 구현됨 | | 콘텐츠 편집 (content_manager.php) | ✅ 구현됨 | | 이미지/파일 업로드 | ✅ 구현됨 | | 미리보기 | ✅ 구현됨 | | 편집 이력/원본 복원 | ✅ 구현됨 | ### 6-4. ❌ 미구현 핵심 기능 | 기능 | 설명 | |------|------| | **PG 결제 연동** | 구매 버튼이 `href="#"`으로 하드코딩. 실제 PG 미연결 | | **프레임워크 선택 UI** | 사용자가 구매 시 gnuboard/wordpress/react 등 선택하는 화면 없음 | | **Laravel/React/Vue/Next.js 변환기** | 코드 아직 미작성 (planned 상태) | | **자동 호스팅 프로비저닝** | 결제 후 자동 사이트 생성 파이프라인 미연결 | | **스테이징/프로덕션 분리** | 빌드 즉시 theme/에 생성. 검수 단계 없음 | | **파일 시스템 형상 관리** | Git 등 VCS 연동 없음 | --- ## 7. ✅ 확정 정책 사항 (2026-05-20 결정) | # | 항목 | 결정 | 비고 | |---|------|------|------| | P-1 | 패키지 단위 | **1상품 N패키지 (옵션 방식)** | 사용자가 구매 시 프레임워크를 옵션으로 선택 | | P-2 | 호스팅 계정 | **여러 사이트 가능, 사이트당 과금** | `g5_customer_sites` 1:N 관계 설계 | | P-3 | FTP 접근 | **chroot jail 적용 (보안 필수)** | 자기 사이트 폴더만 접근 가능 | | P-4 | 무료 템플릿 | **zip 다운로드만 기본 제공** | 자사 호스팅 이용 유도: 원할 경우 호스팅 비용만 과금 | | P-5 | 카테고리 언어 | **영문 컬럼 유지 + 11개 언어 확장 대비** | 글로벌 버전에서 영문이 기본 언어 | ### P-5 다국어 확장 계획 (11개 언어) 카테고리, 메뉴, 템플릿명 테이블에 아래 11개 언어 컬럼을 설계합니다. 현 단계에서는 `name_ko`, `name_en` 2개만 필수 사용하고, 나머지는 **NULL 허용 컬럼으로 미리 생성**하여 향후 직접 명명할 수 있도록 준비합니다. | # | 언어 | 컬럼명 | 현 단계 | 비고 | |---|------|--------|---------|------| | 1 | 한국어 | `name_ko` | ✅ 필수 | 기본 서비스 언어 | | 2 | 영어 | `name_en` | ✅ 필수 | 글로벌 기본 언어 | | 3 | 중국어(간체) | `name_zh` | NULL | | | 4 | 일본어 | `name_ja` | NULL | | | 5 | 러시아어 | `name_ru` | NULL | | | 6 | 독일어 | `name_de` | NULL | | | 7 | 프랑스어 | `name_fr` | NULL | | | 8 | 힌디어 | `name_hi` | NULL | | | 9 | 베트남어 | `name_vi` | NULL | | | 10 | 태국어 | `name_th` | NULL | | | 11 | 아랍어 | `name_ar` | NULL | RTL 레이아웃 대응 필요 | --- ## 8. 개발 로드맵 (Phase 0~7) ``` Phase 0 (문서 확정 + 정책 결정) ← 현재 ↓ Phase 1 (CSS 클린업 / 인라인 정규화) ← 즉시 병행 가능 ↓ Phase 2 (폴더 구조 재편: _repository/ 생성, 파일 이관) Phase 3 (DB 분류 체계 정비: 3단계 카테고리, free 분리) ← 병행 ↓ Phase 4 (패키지 관리: manifest.json, 빌드 스크립트, 추가 변환기 개발) ↓ Phase 5 (자동 배포: PG 결제 → 계정생성 → 패키지전송 → 설치 → 통보) ↓ Phase 6 (호스팅 관리도구: Control Panel) ↓ Phase 7 (WBS 편성 및 문서화 마무리) ``` --- ## 9. 폐기 대상 기존 문서 목록 아래 문서들은 이 통합본에 **모두 흡수**되었으므로 더 이상 참조할 필요 없습니다: | 세션 | 파일명 | 상태 | |------|--------|------| | ecb49a04 | `ARCH-001_architecture.md` | → 본 문서 §2,4에 통합 | | ecb49a04 | `CATE-001_category_taxonomy.md` | → 본 문서 §5 + FINAL-02에 통합 | | ecb49a04 | `restructuring_plan.md` | → 본 문서 §2,4,8에 통합 | | ecb49a04 | `WBS-001_action_plan.md` | → 본 문서 §8에 통합 | | 6018f156 | `WBS-001_v2_action_plan.md` | → 본 문서 §8에 통합 (v2 최신) | | 6018f156 | `handoff_custemplate_wbs.md` | → 본 문서 §6에 통합 | | 6018f156 | `prompt_frontend_analysis.md` | → 작업 완료, 아카이브 | | 6018f156 | `WBS_system_analysis.md` | → 본 문서 §6에 통합 | | a2c78486 | `platform_vision.md` | → 본 문서 §1에 통합 | | a2c78486 | `platform_audit.md` | → 본 문서 §6에 통합 | | a2c78486 | `WBS_Action_Plan.md` | → 본 문서 §8에 통합 (구버전) | | a2c78486 | `style_extraction_targets.md` | → Phase 1 작업용, 아카이브 | --- *최종 업데이트: 2026-05-20* 목록 이전 다음 댓글 0개 등록된 댓글이 없습니다. 첫 번째 댓글을 남겨보세요!