diff --git a/README.md b/README.md
index 3e20804..ce9e64c 100644
--- a/README.md
+++ b/README.md
@@ -1,99 +1,115 @@
-# โจProject Conventionโจ
----
+# ๐ฑ ์๋ฐํ๋ฌํ
Backend
-
-
-## โ๏ธ Commit Convention
+์ง์ญ ๋ฐ์ฐฌ ๋งค๋ฌผ์ ๊ธฐ๋ฐ์ผ๋ก **์ฌ์ฉ์ ๋ง์ถคํ ๋ฐ์ฐฌ ์ถ์ฒ๊ณผ ๊ฒฝ๋ก ์ต์ ํ**๋ฅผ ์ ๊ณตํ๋ ๋ฐฑ์๋ ์๋ฒ์
๋๋ค.
+Spring Boot๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ๊ตฌ์ถ๋์์ผ๋ฉฐ, **FastAPI ๊ธฐ๋ฐ AI ์ถ์ฒ ์๋ฒ**์ ์ฐ๋๋์ด ๋์ํฉ๋๋ค.
-์ปค๋ฐ ๋ฉ์์ง๋ **Udacity ์คํ์ผ**์ ์ฌ์ฉํ๋ฉฐ, ๋ค์๊ณผ ๊ฐ์ ๊ตฌ์กฐ๋ก ์์ฑ
+---
-```
-type: Subject (์ ๋ชฉ)
+## ๐ Tech Stack
+
-body (๋ณธ๋ฌธ) (๊ธด ์ค๋ช
์ด ํ์ํ ๊ฒฝ์ฐ์ ์์ฑ)
-footer (๊ผฌ๋ฆฌ๋ง) (issue tracker ID๋ฅผ ๋ช
์ํ๊ณ ์ถ์ ๊ฒฝ์ฐ์ ์์ฑ)
-```
-
+### ๐น Backend
+- **Java 21**
+- **Spring Boot 3.5.3**
+- **MySQL** : ๋ฉ์ธ ๋ฐ์ดํฐ๋ฒ ์ด์ค
+- **Swagger (springdoc-openapi)** : API ๋ฌธ์ํ
+
-### ๐ **type**: ์ปค๋ฐ์ ์ ํ
-| ํ์
| ์ค๋ช
|
-|------------|------------------------------------------------|
-| `feat` | โจ ์๋ก์ด ๊ธฐ๋ฅ ์ถ๊ฐ |
-| `fix` | ๐ ๋ฒ๊ทธ ์์ |
-| `docs` | ๐ ๋ฌธ์ ์์ (README, ์ฃผ์ ๋ฑ) |
-| `style` | ๐ ์ฝ๋ ํฌ๋งทํ
, ์ธ๋ฏธ์ฝ๋ก ๋๋ฝ ๋ฑ ๊ธฐ๋ฅ ์ํฅ ์๋ ๋ณ๊ฒฝ |
-| `refactor` | โป๏ธ ์ฝ๋ ๋ฆฌํฉํ ๋ง (๊ธฐ๋ฅ ๋ณํ ์์) |
-| `test` | โ
ํ
์คํธ ์ฝ๋ ์ถ๊ฐ ๋๋ ์์ |
-| `chore` | ๐ง ๋น๋ ์ค์ , ํจํค์ง ๋งค๋์ ์ค์ ๋ฑ ๊ธฐํ ์์
|
-| `perf` | โก ์ฑ๋ฅ ๊ฐ์ |
-| `ci` | ๐ CI ๊ด๋ จ ์ค์ ๋ฐ ์คํฌ๋ฆฝํธ ์์ |
-| `revert` | โ๏ธ ์ด์ ์ปค๋ฐ ๋๋๋ฆฌ๊ธฐ |
+### ๐น AI / Recommendation
+- **FastAPI (Python)** : AI ์ถ์ฒ ์๋ฒ
+- **GPT-4o-mini**
+ - ๐ณ **์๋ฆฌ ๋ ์ํผ ์์ฑ** (์ฌ์ฉ์๊ฐ ๊ตฌ๋งคํ ๋ฐ์ฐฌ ๊ธฐ๋ฐ)
+ - ๐ฅ **์๋จ ํ
๋ง ๊ธฐ๋ฐ ์ถ์ฒ** (๋ค์ด์ดํธ/ํคํ /์ ์ผ/๋ฒํฌ์
/ํ๋น)
+- **Fine-tuning**
+ - GPT-4o-mini๋ฅผ **์์์ฑ๋ถํ ๋ฐ์ดํฐ๋ก ํ์ธํ๋**
+ โ ๋งค๋ฌผ์ ์ค์ ์์ ์ฑ๋ถ ๋ถ์ ํ ๋ง์ถคํ ์ถ์ฒ ์ ๊ณต
-
+
-### ๐๏ธ **Subject**: ์ ๋ชฉ
-- 50์ ์ด๋ด๋ก ๊ฐ๊ฒฐํ๊ฒ ์์ฑ
-- ๋ง์นจํ(`.`) ๊ธ์ง
-- ๊ณผ๊ฑฐ ์์ X, ๋ช
๋ น์ด ์ฌ์ฉ
+### ๐น DevOps
+- **Gradle** : ๋น๋ & ์์กด์ฑ ๊ด๋ฆฌ
+- **GitHub Actions** : CI/CD ํ์ดํ๋ผ์ธ
+ - Build & Test
+ - Docker Build & Push โ DockerHub ์
๋ก๋
+- **Docker** : ์ปจํ
์ด๋ํ ๋ฐ ๋ฐฐํฌ
-
+
-### ๐ **Body**: ๋ณธ๋ฌธ
-- **์ ํ ์ฌํญ**
-- ์ ๋ชฉ์์ ์ค๋ช
ํ ์ ์๋ ์ถ๊ฐ ์ ๋ณด๋ฅผ ์ ๊ณต
-- "๋ฌด์์"๊ณผ "์"๋ฅผ ์ค์ฌ์ผ๋ก ์์ธํ ๊ธฐ์
-- ํ ์ค๋น 72์ ์ด๋ด๋ก ์์ฑ
-- ํ์์ Markdown ์ฌ์ฉ ๊ฐ๋ฅ
+---
+## ๐ Project Structure
+```text
+๐ฆ src
+โฃ ๐ main
+โ โฃ ๐ java/com/example/Centralthon
+โ โ โฃ ๐ domain # ๋๋ฉ์ธ ๋ก์ง
+โ โ โฃ ๐ global # ๊ณตํต ์ค์ ๋ฐ ์ ํธ
+โ โ โฃ ๐ core/exception # ์ ์ญ ์์ธ ์ฒ๋ฆฌ
+โ โฃ ๐ resources
+โ โ โฃ application.properties # ํ๊ฒฝ ์ค์
+โฃ ๐ test # ๋จ์/ํตํฉ ํ
์คํธ
+```
---
-
+## ๐ ์ฃผ์ ๊ธฐ๋ฅ
-## ๐ฟ Git Flow ๋ธ๋์น ์ ๋ต (with `main`) ๐ฟ
+### 1. ๐ ๋ฐ์ฐฌ ๋งค๋ฌผ ์กฐํ
+- ์ฌ์ฉ์์ ํ์ฌ ์์น๋ฅผ ๊ธฐ์ค์ผ๋ก **๋ฐ๊ฒฝ 2km ์ด๋ด**์ ๋งค๋ฌผ ๋ชฉ๋ก ์กฐํ
+- ๊ฐ๊ฒ ์ ๋ณด, ๋ฉ๋ด ์ ๋ณด, ๊ฐ๊ฒฉ, ํ ์ธ์จ ํฌํจ
+### 2. ๐ถ ์ต์ ๊ฒฝ๋ก ์ ๊ณต
+- ์ฌ์ฉ์๊ฐ ๋งค๋ฌผ์ ์ฅ๋ฐ๊ตฌ๋์ ๋ด๊ณ ํฝ์
์์ฝํ๋ฉด
+ ํด๋น ๊ฐ๊ฒ๋ค์ ๊ฒฝ์ ํ๋ **๋๋ณด ์ต์ ๊ฒฝ๋ก(TSP ๊ธฐ๋ฐ)** ์ ๊ณต
+- **Tmap API + ๋ด๋ถ ์ต์ ํ ์๊ณ ๋ฆฌ์ฆ ํ์ฉ**
-### ๐ด ๊ธฐ๋ณธ ๋ธ๋์น
-| ๋ธ๋์น | ์ญํ |
-|--------|------|
-| `main` | ์ต์ข
๋ฐฐํฌ์ฉ ๋ธ๋์น (stable) |
-| `develop` | ๋ค์ ๋ฐฐํฌ๋ฅผ ์ํ ํตํฉ ๊ฐ๋ฐ ๋ธ๋์น |
+### 3. ๐ณ ์๋ฆฌ ๋ ์ํผ ์ถ์ฒ (AI)
+- ๊ตฌ๋งคํ ๋ฐ์ฐฌ๋ค์ ์กฐํฉํ์ฌ ๋ง๋ค ์ ์๋ **๋ ์ํผ ์๋ ์์ฑ**
+- **GPT-4o-mini ํ์ฉ**
-
+### 4. ๐ฅ ๋ง์ถคํ ์๋จ ์ถ์ฒ (AI Fine-tuning)
+- ๋ค์ฏ ๊ฐ์ง ์๋จ ํ
๋ง ์ ๊ณต:
+ - ๋ค์ด์ดํธ / ํคํ / ์ ์ผ / ๋ฒํฌ์
/ ํ๋น ์กฐ์
+- **GPT-4o-mini Fine-tuning** โ ์ค์ **์์์ฑ๋ถํ ๋ฐ์ดํฐ๋ฅผ ํ์ต**์์ผ, ๋งค๋ฌผ์ ์ฑ๋ถ์ ๊ธฐ๋ฐ์ผ๋ก ํ
๋ง๋ณ ๋ง์ถคํ ์ถ์ฒ ์ ๊ณต
-### ๐ฑ **์์
๋ธ๋์น ๋ค์ด๋ฐ ๊ท์น**
+---
-```
-type/#issue๋ฒํธ (์์
๋จ์๋ ๊ธฐ๋ฅ/์์ /๋ฆฌํฉํ ๋ง ๋ฑ์ผ๋ก ๊ตฌ๋ถ)
-```
+## โ๏ธ CI/CD Workflow
+### ๐น CI Pipeline
+1. Gradle ๋น๋ โ Spring Boot JAR ์์ฑ
+2. Docker ์ด๋ฏธ์ง ๋น๋
+3. DockerHub ํธ์ (latest, commit sha ํ๊ทธ)
-| prefix | ์ค๋ช
| ์์ |
-|--------------|------------------------------|-----------------------------------|
-| `feature/` | โจ ์๋ก์ด ๊ธฐ๋ฅ ๊ฐ๋ฐ | `feature/#15` |
-| `fix/` | ๐ ๋ฒ๊ทธ ์์ | `fix/#42` |
-| `refactor/` | โป๏ธ ์ฝ๋ ๋ฆฌํฉํ ๋ง | `refactor/#23` |
-| `chore/` | ๐ง ์ค์ ๋ณ๊ฒฝ, ์ก์ผ | `chore/#25` |
-| `perf/` | โก ์ฑ๋ฅ ๊ฐ์ | `perf/#94` |
-| `hotfix/` | ๐ ๊ธํ ์์ (main์์ ๋ฐ๋ก ๋ถ๊ธฐ) | `hotfix/#102` |
-| `test/` | ๐งช ํ
์คํธ ์ฝ๋ ์ถ๊ฐ/์์ | `test/#55` |
+### ๐น CD Pipeline
+1. ๋์ ์๋ฒ์์ DockerHub์์ pull
+2. ์ปจํ
์ด๋ ์ฌ๊ธฐ๋(๊ต์ฒด ๋ฐฐํฌ)
-
-### ๐ ๋ธ๋์น ํ๋ฆ ์์ฝ
+๐ GitHub Actions์์ **`main` ๋ธ๋์น์ push ์ ์๋ ์คํ**
-```text
-1. main โ ๋ฐฐํฌ
-2. develop โ ํตํฉ ๊ฐ๋ฐ (PR ๋์)
-3. develop์์ feature/fix/... ๋ธ๋์น ๋ถ๊ธฐ
-4. ๊ธฐ๋ฅ ์๋ฃ ํ develop์ผ๋ก PR & ๋จธ์ง
-5. ๋ฐฐํฌ ์ develop โ main ๋จธ์ง
-6. ๊ธํ ์์ ์ hotfix์์ main โ develop ๋ณํฉ
-```
+---
+## ๐ ERD
+
+
+
+---
+
+## ๐ API ๋ชฉ๋ก (์ฃผ์ ์๋ํฌ์ธํธ)
+
+- `GET /api/menus` โ ์ฌ์ฉ์ ์์น ๊ธฐ๋ฐ ๋ฐ๊ฒฝ 2km ๋ด ๋งค๋ฌผ ์กฐํ
+- `POST /api/routes/directions` โ ํฝ์
์์ฝ ๊ธฐ๋ฐ ์ต์ ๊ฒฝ๋ก ์์ฑ
+- `POST /api/menus/tips` โ ๊ตฌ๋งค ๋ฐ์ฐฌ ๊ธฐ๋ฐ ์๋ฆฌ ๋ ์ํผ ์ถ์ฒ (AI)
+- `POST /api/menus/recommend` โ ์๋จ ํ
๋ง ๊ธฐ๋ฐ ์ถ์ฒ (AI Fine-tuning)
+
+Swagger ๋ฌธ์:
+๐ [https://52.78.244.98.nip.io/api/swagger-ui/index.html](https://52.78.244.98.nip.io/api/swagger-ui/index.html)
---
+
+
diff --git a/docs/images/server.png b/docs/images/server.png
new file mode 100644
index 0000000..653369b
Binary files /dev/null and b/docs/images/server.png differ