From 28145032a6593adc566ddad55e270bc81f0d55fe Mon Sep 17 00:00:00 2001
From: KWON <thexero@gmail.com>
Date: Fri, 26 Dec 2025 13:13:47 +0900
Subject: [PATCH] =?UTF-8?q?feat:=20Git=20Submodule=20=EC=B6=94=EA=B0=80=20?=
 =?UTF-8?q?-=20firstgarden-web-gnu=EB=A5=BC=20www=20=ED=8F=B4=EB=8D=94?=
 =?UTF-8?q?=EB=A1=9C=20=EA=B4=80=EB=A6=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- www 폴더를 firstgarden-web-gnu 저장소의 Submodule로 설정
- .gitignore에서 www 규칙 제거 (Submodule이 자동 관리)
- README.md 업데이트: clone 방법, Submodule 관리 방법 설명 추가
- SourceTree에서도 메인 저장소와 Submodule 모두 표시됨
---
 .gitignore   |  3 +--
 .gitmodules  |  3 +++
 README.md    | 34 +++++++++++++++++++++++++++++++---
 www          |  1 +
 www/.gitkeep |  0
 5 files changed, 36 insertions(+), 5 deletions(-)
 create mode 100644 .gitmodules
 create mode 160000 www
 delete mode 100644 www/.gitkeep

diff --git a/.gitignore b/.gitignore
index c685b02..c525aa3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,8 +6,7 @@ data/**/*
 logs/**/*
 !logs/**/.gitkeep
 
-www/*
-!www/.gitkeep
+# www는 Git Submodule로 관리됨 (제외하지 않음)
 
 # IDE
 .vscode/
diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..d5f402a
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "www"]
+	path = www
+	url = https://git.siane.kr/firstgarden/firstgarden-web-gnu
diff --git a/README.md b/README.md
index 0c66b1c..82e3be1 100644
--- a/README.md
+++ b/README.md
@@ -9,12 +9,19 @@ Cafe24 10G자이언트플러스 호스팅 환경과 최대한 유사한 개발 
 
 ## 실행 방법
 
-### 1. 저장소 클론
+### 1. 저장소 클론 (Submodule 포함)
 ```bash
-git clone https://git.siane.kr/firstgarden/php-apache
+# Submodule을 함께 클론
+git clone --recurse-submodules https://git.siane.kr/firstgarden/php-apache
 cd php-apache
 ```
 
+또는 기존 저장소가 있다면:
+```bash
+cd php-apache
+git submodule update --init --recursive
+```
+
 ### 2. 환경설정
 ```bash
 cp .env.example .env
@@ -74,7 +81,7 @@ docker compose up -d
 │   └── mariadb/           # MariaDB 로그
 ├── data/
 │   └── mariadb/           # MariaDB 데이터 볼륨
-├── www/                   # 웹 소스 (PHP 8.2/8.4 공유)
+├── www/                   # Git Submodule - firstgarden-web-gnu
 │   └── (웹소스)
 ├── 8.2/
 │   ├── Dockerfile         # PHP 8.2 이미지
@@ -84,6 +91,27 @@ docker compose up -d
     └── entrypoint.sh
 ```
 
+## Git Submodule 관리
+
+### www 폴더 업데이트
+```bash
+# 최신 웹소스 받기
+cd www
+git pull origin main
+
+# 또는 메인 저장소에서 함께 업데이트
+cd ..
+git pull
+git submodule update --recursive
+```
+
+### SourceTree에서 보기
+SourceTree를 열 때 `--recurse-submodules` 옵션으로 Submodule이 자동으로 로드됩니다.
+- **메인 저장소**: php-apache (관리 및 빌드 설정)
+- **Submodule**: www (firstgarden-web-gnu, 웹소스 코드)
+
+각각 독립적으로 커밋/푸시할 수 있습니다.
+
 ## 주요 특징
 - **독립적인 PHP 버전**: 8.2와 8.4를 동시에 실행 가능
 - **공유 웹루트**: 동일한 소스코드를 양쪽 PHP 버전에서 테스트
diff --git a/www b/www
new file mode 160000
index 0000000..4479323
--- /dev/null
+++ b/www
@@ -0,0 +1 @@
+Subproject commit 4479323b25d7f8a5071477db9a9b1b36b01d9382
diff --git a/www/.gitkeep b/www/.gitkeep
deleted file mode 100644
index e69de29..0000000