diff --git a/README.md b/README.md
index 3e20804..0d94a0c 100644
--- a/README.md
+++ b/README.md
@@ -1,99 +1,119 @@
-# โจProject Conventionโจ
----
+# ๐ค ์๋ฐํ๋ฌํ
AI
-
-
-## โ๏ธ Commit Convention
+FastAPI ๊ธฐ๋ฐ์ **AI ์ถ์ฒ ์๋ฒ**๋ก, ์์ฝ์ฒ ์์์ฑ๋ถํ ๋ฐ์ดํฐ๋ฅผ ๊ธฐ๋ฐ์ผ๋ก
+**๋ง์ถคํ ๋ฐ์ฐฌ ์ถ์ฒ**๊ณผ **์ญ์ทจ ํ ์ ๊ณต**์ ๋ด๋นํฉ๋๋ค.
-์ปค๋ฐ ๋ฉ์์ง๋ **Udacity ์คํ์ผ**์ ์ฌ์ฉํ๋ฉฐ, ๋ค์๊ณผ ๊ฐ์ ๊ตฌ์กฐ๋ก ์์ฑ
+### ๐น AI ๊ธฐ๋ฅ
-```
-type: Subject (์ ๋ชฉ)
+* **๋ฉ๋ด ์ถ์ฒ**
-body (๋ณธ๋ฌธ) (๊ธด ์ค๋ช
์ด ํ์ํ ๊ฒฝ์ฐ์ ์์ฑ)
+ * 5๊ฐ์ง ์ฝ์
ํธ ๊ธฐ๋ฐ:
+ `diet(๋ค์ด์ดํธ)`, `keto(์ ํ๊ณ ์ง)`, `low_sodium(์ ์ผ)`, `glycemic(ํ๋น)`, `bulking(๋ฒํฌ์
)`
+ * ์
๋ ฅ ๋ฉ๋ด๋ช
-> ์ ์ฌ๋ ๋งค์นญ -> ์์ ์ฑ๋ถ ํผ์ฒํ -> ์ฝ์
ํธ๋ณ ์ ์ํ(0\~100)
-footer (๊ผฌ๋ฆฌ๋ง) (issue tracker ID๋ฅผ ๋ช
์ํ๊ณ ์ถ์ ๊ฒฝ์ฐ์ ์์ฑ)
-```
-
+* **Tip ์์ฑ**
+
+ * OpenAI API ์ฐ๋์ ํตํ **์์ต๊ด ๊ฐ์ด๋ / ๋ ์ํผ ์ ์**
+
+---
+## ๐ Tech Stack
+
-### ๐ **type**: ์ปค๋ฐ์ ์ ํ
+### ๐น Framework & Language
+- **Python 3.11**
+- **FastAPI : ๊ฒฝ๋ ์น ํ๋ ์์ํฌ**
+- **Uvicorn : ASGI ์๋ฒ**
-| ํ์
| ์ค๋ช
|
-|------------|------------------------------------------------|
-| `feat` | โจ ์๋ก์ด ๊ธฐ๋ฅ ์ถ๊ฐ |
-| `fix` | ๐ ๋ฒ๊ทธ ์์ |
-| `docs` | ๐ ๋ฌธ์ ์์ (README, ์ฃผ์ ๋ฑ) |
-| `style` | ๐ ์ฝ๋ ํฌ๋งทํ
, ์ธ๋ฏธ์ฝ๋ก ๋๋ฝ ๋ฑ ๊ธฐ๋ฅ ์ํฅ ์๋ ๋ณ๊ฒฝ |
-| `refactor` | โป๏ธ ์ฝ๋ ๋ฆฌํฉํ ๋ง (๊ธฐ๋ฅ ๋ณํ ์์) |
-| `test` | โ
ํ
์คํธ ์ฝ๋ ์ถ๊ฐ ๋๋ ์์ |
-| `chore` | ๐ง ๋น๋ ์ค์ , ํจํค์ง ๋งค๋์ ์ค์ ๋ฑ ๊ธฐํ ์์
|
-| `perf` | โก ์ฑ๋ฅ ๊ฐ์ |
-| `ci` | ๐ CI ๊ด๋ จ ์ค์ ๋ฐ ์คํฌ๋ฆฝํธ ์์ |
-| `revert` | โ๏ธ ์ด์ ์ปค๋ฐ ๋๋๋ฆฌ๊ธฐ |
+
-
-### ๐๏ธ **Subject**: ์ ๋ชฉ
-- 50์ ์ด๋ด๋ก ๊ฐ๊ฒฐํ๊ฒ ์์ฑ
-- ๋ง์นจํ(`.`) ๊ธ์ง
-- ๊ณผ๊ฑฐ ์์ X, ๋ช
๋ น์ด ์ฌ์ฉ
+### ๐น Data / ML
+- **scikit-learn : ๋ฒกํฐํ, ์ฐจ์ ์ถ์, ์ค์ผ์ผ๋ง, ๊ฒฐ์ธก์น ๋ณด์ **
+- **hnswlib : ๊ทผ์ ํ์ (๋ฉ๋ด๋ช
์ ์ฌ๋ ๋งค์นญ)**
+- **numpy / joblib : ์์น ์ฐ์ฐ ๋ฐ ๋ชจ๋ธ ์ง๋ ฌํ**
+-**์์ฝ์ฒ ์์์ฑ๋ถํ ๋ฐ์ดํฐ (Excel/CSV) : ์์ ์ ๋ณด ๊ธฐ๋ฐ ํ์ต/์ถ์ฒ**
+
+
-
-### ๐ **Body**: ๋ณธ๋ฌธ
+---
-- **์ ํ ์ฌํญ**
-- ์ ๋ชฉ์์ ์ค๋ช
ํ ์ ์๋ ์ถ๊ฐ ์ ๋ณด๋ฅผ ์ ๊ณต
-- "๋ฌด์์"๊ณผ "์"๋ฅผ ์ค์ฌ์ผ๋ก ์์ธํ ๊ธฐ์
-- ํ ์ค๋น 72์ ์ด๋ด๋ก ์์ฑ
-- ํ์์ Markdown ์ฌ์ฉ ๊ฐ๋ฅ
+## ๐ Project Structure
+```text
+๐ฆ menu-ai
+โโโ Dockerfile
+โโโ main.py # FastAPI ์คํ ์ํธ๋ฆฌํฌ์ธํธ
+โโโ requirements.txt
+โโโ leftovers
+โ โโโ core # ์ค์ , ์๋ฌ ํธ๋ค๋ฌ, ๊ณตํต ์๋ต, ์ธ๋ถ ํด๋ผ์ด์ธํธ
+โ โโโ domain
+โ โโโ recommend # ๋ฉ๋ด ์ถ์ฒ ๋๋ฉ์ธ
+โ โ โโโ api/ # ์ถ์ฒ API
+โ โ โโโ data/ # ์๋ณธ ์์ ๋ฐ์ดํฐ (์์ฝ์ฒ ์์
)
+โ โ โโโ model_store # ํ์ต๋ ๋ชจ๋ธ ๋ฐ ์ ์ฒ๋ฆฌ ์ํฐํฉํธ
+โ โ โโโ schemas/ # ์์ฒญ/์๋ต ์คํค๋ง
+โ โ โโโ service/ # ์ถ์ฒ ๋ก์ง (๋งค์นญ, ์ค์ฝ์ด๋ง, ์ ์ฒ๋ฆฌ, ํ์ต)
+โ โโโ tip # ํ/๋ ์ํผ ๋๋ฉ์ธ
+โ โโโ api/ # Tip API
+โ โโโ schemas/ # ์์ฒญ/์๋ต ์คํค๋ง
+โ โโโ service/ # ํ๋กฌํํธ/LLM ํธ์ถ
+```
---
-
+## ๐ฌ ๋ฐ์ดํฐ ํ์ดํ๋ผ์ธ & ์๊ณ ๋ฆฌ์ฆ
-## ๐ฟ Git Flow ๋ธ๋์น ์ ๋ต (with `main`) ๐ฟ
+1. **๋ฐ์ดํฐ ๋ก๋ฉ**
+ * ์์ฝ์ฒ ์์ ๋ฐ์ดํฐ(`.xlsx`) ๋ก๋ -> ๊ฒฐ์ธก์น ๋ณด์ (Imputer) -> ์ ๊ทํ(Scaler)
-### ๐ด ๊ธฐ๋ณธ ๋ธ๋์น
-| ๋ธ๋์น | ์ญํ |
-|--------|------|
-| `main` | ์ต์ข
๋ฐฐํฌ์ฉ ๋ธ๋์น (stable) |
-| `develop` | ๋ค์ ๋ฐฐํฌ๋ฅผ ์ํ ํตํฉ ๊ฐ๋ฐ ๋ธ๋์น |
+2. **๋ฉ๋ด๋ช
๋งค์นญ**
-
+ * TF-IDF ๋ฒกํฐํ -> TruncatedSVD ์ฐจ์ ์ถ์ -> hnswlib ๊ทผ์ ํ์์ผ๋ก ์ ์ฌ ๋ฉ๋ด ๊ฒ์
-### ๐ฑ **์์
๋ธ๋์น ๋ค์ด๋ฐ ๊ท์น**
+3. **์์ ํผ์ฒํ**
-```
-type/#issue๋ฒํธ (์์
๋จ์๋ ๊ธฐ๋ฅ/์์ /๋ฆฌํฉํ ๋ง ๋ฑ์ผ๋ก ๊ตฌ๋ถ)
-```
+ * `kcal, protein, fat, carbs, sugar, sodium` ๋ฑ ์ฃผ์ ์์์๋ฅผ ๋ฒกํฐํ
+4. **์ค์ฝ์ด๋ง (Concept Scoring)**
-| prefix | ์ค๋ช
| ์์ |
-|--------------|------------------------------|-----------------------------------|
-| `feature/` | โจ ์๋ก์ด ๊ธฐ๋ฅ ๊ฐ๋ฐ | `feature/#15` |
-| `fix/` | ๐ ๋ฒ๊ทธ ์์ | `fix/#42` |
-| `refactor/` | โป๏ธ ์ฝ๋ ๋ฆฌํฉํ ๋ง | `refactor/#23` |
-| `chore/` | ๐ง ์ค์ ๋ณ๊ฒฝ, ์ก์ผ | `chore/#25` |
-| `perf/` | โก ์ฑ๋ฅ ๊ฐ์ | `perf/#94` |
-| `hotfix/` | ๐ ๊ธํ ์์ (main์์ ๋ฐ๋ก ๋ถ๊ธฐ) | `hotfix/#102` |
-| `test/` | ๐งช ํ
์คํธ ์ฝ๋ ์ถ๊ฐ/์์ | `test/#55` |
+ * ๋ค์ด์ดํธ: ์ด๋ยท๋น๋ฅยทํ์ํ๋ฌผ ์ ํ
+ * ์ ์ผ: ๋ํธ๋ฅจ ์๊ฒฉ ์ ํ
+ * ํ๋น: ๋น๋ฅยทํ์ํ๋ฌผ ๋์ ์ ํ
+ * ์ ํ๊ณ ์ง/๋ฒํฌ์
: ๊ธฐ์กด ๋น์จ ์ ์ง
-
+5. **์ถ์ฒ ๊ฒฐ๊ณผ ๋ฐํ**
-### ๐ ๋ธ๋์น ํ๋ฆ ์์ฝ
+ * ์ ์(0\~100) ๊ธฐ๋ฐ ๋ญํน -> ์์ N๊ฐ ๋ฐํ
+ * ์๋ต ๊ตฌ์กฐ: `isSuccess`, `httpStatus`, `data`, `timeStamp`
-```text
-1. main โ ๋ฐฐํฌ
-2. develop โ ํตํฉ ๊ฐ๋ฐ (PR ๋์)
-3. develop์์ feature/fix/... ๋ธ๋์น ๋ถ๊ธฐ
-4. ๊ธฐ๋ฅ ์๋ฃ ํ develop์ผ๋ก PR & ๋จธ์ง
-5. ๋ฐฐํฌ ์ develop โ main ๋จธ์ง
-6. ๊ธํ ์์ ์ hotfix์์ main โ develop ๋ณํฉ
+---
+
+## โ๏ธ ์คํ ๋ฐฉ๋ฒ
+
+### 1. ์์กด์ฑ ์ค์น
+
+```bash
+python3.11 -m venv .venv
+source .venv/bin/activate
+pip install --no-cache-dir -r requirements.txt
```
----
+### 2. ํ์ต (๋ชจ๋ธ ์์ฑ)
+
+์ต์ด ์คํ ์, `model_store/`๊ฐ ๋น์ด ์๋ค๋ฉด ํ์ต ๊ณผ์ ์ด ํ์ํฉ๋๋ค.
+
+```bash
+python -m leftovers.domain.recommend.service.train
+```
+
+โ `nutrition_imputer.joblib`, `nutrition_scaler.joblib`, `concept_model_*.joblib` ๋ฑ์ด ์์ฑ๋ฉ๋๋ค.
+
+### 3. ์๋ฒ ์คํ
+
+```bash
+uvicorn main:app --host 0.0.0.0 --port 8000
+```