시스템 아키텍처 및 DB 명세

# 템플릿스택(TemplateStack) 시스템 아키텍처 및 DB 명세 **버전:** 1.0 (통합본) **일자:** 2026-02-01 --- ## 1. 시스템 아키텍처 (System Architecture) ### 1.1 전체 구조 TemplateStack은 하이브리드 아키텍처를 채택하고 있습니다. - **Frontend/Web Server**: Apache/PHP 기반의 그누보드5/영카트 프레임워크 사용. - **Backend/AI Engine**: Python (FastAPI) 기반의 분석, 크롤링, 변환 엔진 (예정). - **Deployment**: Local/Remote PHP 스크립트를 통한 FTP 전송. ### 1.2 기술 스택 - **Language**: PHP 8.1, Python 3.10+ - **Database**: MariaDB 10.6 - **Frontend Theme**: Custom 'Printown' Theme (Tailwind-like CSS classes) - **Library**: GnuBoard 5.5, YoungCart 5.5, TCPDF --- ## 2. 데이터베이스 명세 (Database Specification) ### 2.1 주요 테이블 ERD (논리적) ``` [g5_saas_template] --(1:N)-- [g5_shop_item] | +--(1:N)-- [g5_template_features] | +--(1:N)-- [g5_template_deploy_log] ``` ### 2.2 테이블 상세 정의 #### `g5_saas_template` (템플릿 원본) | Field | Type | Attributes | Description | |-------|------|------------|-------------| | `id` | INT | PK, AutoInc | 고유 ID | | `ca_id` | VARCHAR(10) | NOT NULL | 카테고리 코드 | | `name` | VARCHAR(255) | NOT NULL | 템플릿 이름 | | `origin_path` | VARCHAR(255) | NOT NULL | 서버 내 물리적 경로 | | `thumb_url` | VARCHAR(255) | | 썸네일 경로 | | `status` | ENUM | default 'new' | 상태 ('new', 'active', 'error') | | `reg_date` | DATETIME | | 등록일 | #### `g5_shop_item` (쇼핑몰 상품 - 표준 테이블 확장) *영카트 기본 테이블 사용. `it_id`를 통해 템플릿과 매핑됨 (별도 매핑 테이블 또는 규칙 사용).* #### `g5_industry_category` (업종 분류) | Field | Type | Attributes | Description | |-------|------|------------|-------------| | `idx` | INT | PK, AutoInc | 고유 ID | | `industry_code` | VARCHAR(50) | Unique | 업종 코드 (예: restuarant) | | `industry_name` | VARCHAR(100) | | 업종 한글명 | | `required_pages` | JSON | | 필수 페이지 목록 JSON | #### `g5_deployment_log` (배포 로그) | Field | Type | Attributes | Description | |-------|------|------------|-------------| | `log_id` | INT | PK, AutoInc | 로그 ID | | `mb_id` | VARCHAR(20) | | 회원 ID | | `template_id` | INT | | 템플릿 ID | | `target_url` | VARCHAR(255) | | 배포 대상 URL | | `status` | ENUM | | 'success', 'fail', 'processing' | | `message` | TEXT | | 상세 로그 메시지 | | `created_at` | DATETIME | | 생성일 | --- ## 3. 디렉토리 구조 (Directory Structure) ``` html-custemplate/ ├── adm/ # 관리자 페이지 │ ├── template_admin/ # 템플릿 관리 모듈 │ └── hosting_admin/ # 호스팅 관리 모듈 ├── data/ # 업로드 파일 및 설정 ├── theme/ │ └── custemplate/ # 메인 테마 │ ├── index.php # 랜딩 페이지 │ └── skin/ # 게시판/쇼핑몰 스킨 ├── shop/ # 쇼핑몰 로직 └── _template/ # 템플릿 원본 파일 저장소 ```