diff --git a/README.md b/README.md
index c13a999..9bd9036 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,21 @@
# ๐ฑDevice Life - Frontend
-> ์๋ง์ ๋๋ฐ์ด์ค ์ค ์ ์ ์๊ฒ ์ต์ ์ ์กฐํฉ์ ์ ๊ณตํ๋ค
+> ์ต์ ์ ๊ธฐ๊ธฐ์กฐํฉ ์น ์๋น์ค
> UMC 9th Project - Client Repository
+
+
## ๐ ํ๋ก์ ํธ ์๊ฐ (Project Overview)
-์ด ์ ์ฅ์๋ Device Life์ ํด๋ผ์ด์ธํธ ์ ํ๋ฆฌ์ผ์ด์
์ฝ๋๋ฅผ ๊ด๋ฆฌํฉ๋๋ค. ์ฌ์ฉ์๊ฐ ์ง๊ด์ ์ผ๋ก ๊ธฐ๊ธฐ๋ฅผ ํ์ํ๊ณ , ์กฐํฉ์ ์์ฑํ๋ฉฐ, ์ค์๊ฐ์ผ๋ก ์๊ฐ์ ์ธ ํ๊ฐ ํผ๋๋ฐฑ์ ๋ฐ์ ์ ์๋ UI/UX ๊ตฌํ์ ์ง์คํฉ๋๋ค.
+์ด ์ ์ฅ์๋ ์ต์ ์ ๊ธฐ๊ธฐ ์กฐํฉ ์ถ์ฒ ์๋น์ค 'Device Life'์ ์น ํด๋ผ์ด์ธํธ ์ฝ๋๋ฅผ ๊ด๋ฆฌํฉ๋๋ค. ์ฌ์ฉ์๊ฐ ์๋ง์ ์ค๋งํธ ๊ธฐ๊ธฐ ์ฌ์ด์์ ์์ ์๊ฒ ๋ง๋ ์ต์ ์ ์กฐํฉ์ ์ฐพ์ ์ ์๋๋ก, ์ง๊ด์ ์ธ ํ์ ๊ฒฝํ๊ณผ ๋ก์ง ๊ธฐ๋ฐ์ ์ค์๊ฐ ํ๊ฐ ํผ๋๋ฐฑ์ ์ ๊ณตํ๋ ์์ฑ๋ ๋์ UI/UX ๊ตฌํ์ ์ง์คํฉ๋๋ค.
### โจ ํ๋ก ํธ์๋ ํต์ฌ ๊ธฐ๋ฅ (Key Features)
-* ์กฐํฉ ์ํฌ์คํ์ด์ค UI: ๊ธฐ๊ธฐ ์ถ๊ฐ/์ญ์ ์ ๋ถ๋๋ฌ์ด ์ธํฐ๋์
๋ฐ ์ํ ๊ด๋ฆฌ ๊ตฌํ
-* ์ค์๊ฐ ํ๊ฐ ํผ๋๋ฐฑ: ์ํ๊ณ, ์ถฉ์ , ์ปฌ๋ฌ ์ ์ ๋ฐ์ดํฐ๋ฅผ ์๊ฐ์ ๊ทธ๋ํ๋ ์์น๋ก ์ฆ์ ๋ ๋๋ง
-* ๊ธฐ๊ธฐ ํ์ ๋ฐ ํํฐ UI: ๊ฐ๊ฒฉ๋ ์กฐ์ ์ ์ํ Range Slider ์ปดํฌ๋ํธ ๋ฐ ์นดํ
๊ณ ๋ฆฌ ์นฉ ๊ตฌํ
-* ๋ผ์ดํ์คํ์ผ ์ ํ: ์ด๋ฏธ์ง ์นด๋ ๋ฐ ๋ธ๋๋ ๋ก๊ณ ๋ฅผ ํ์ฉํ ์ง๊ด์ ์ธ ์ฌ์ฉ์ ์
๋ ฅ ์ธํฐํ์ด์ค
-* ์ธํฐ๋์
: ๋ด ์กฐํฉ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ ์ค์์ดํ ์ญ์ ๋ฐ ๋ชจ๋ฌ ์ ๋๋ฉ์ด์
์ฒ๋ฆฌ
+- ๋์ ์ ์ ๊ถํ ๋ฐ GNB ๋ ๋๋ง: ๋ก๊ทธ์ธ ์ ๋ฌด ๋ฐ ์จ๋ณด๋ฉ ์ํ์ ๋ฐ๋ผ ๋ฉ๋ด ๊ตฌ์ฑ๊ณผ ์ ๊ทผ ๊ถํ ์ ์ด
+- ์จ๋ณด๋ฉ ํ๋ก์ฐ: ์ ๊ท ์ ์ ๋ฅผ ์ํ ์คํ๋์ ํ๋ฉด, ๋ผ์ดํ์คํ์ผ ํ๊ทธ ์ ํ, ์ฒซ ์กฐํฉ ์์ฑ์ผ๋ก ์ด์ด์ง๋ ๋จ๊ณ๋ณ ํผ ์์ ๋ ๊ตฌํ
+- ๋ค์ค ํํฐ ๊ธฐ๋ฐ ๊ธฐ๊ธฐ ํ์: ์นดํ
๊ณ ๋ฆฌ ์นฉ, ๋จ์ผ/๋ค์ค ์ฒดํฌ๋ฐ์ค ํํฐ, 4๊ฐ์ง ์ ๋ ฌ ์ต์
์ ์กฐํฉํ ๊ฒ์ ์ธํฐํ์ด์ค ์ ๊ณต
+- ์กฐํฉ ๋ด๊ธฐ ์์คํ
: ํ์ฌ ์ ํ๋ ์กฐํฉ ์ํ๋ฅผ ์ ์งํ๋ฉฐ ์ค๋ณต ์ ์ฅ
+- ๋ผ์ดํ์คํ์ผ ์๋ ๋กํ
์ด์
: ์ ์ ์ก์
์ ๋ฐ์ํ์ฌ ์ ์ง/์ฌ์๋๋ ์๊ฐ์ ํ๊ทธ ๋กํ
์ด์
๋ฐ ๊ธฐ๊ธฐ ํ๋ ์ด์
์นด๋ ๊ตฌํ
+- ๋ก์ง ๊ธฐ๋ฐ ํ๊ฐ ๋ฆฌํฌํธ: ๊ธฐ๊ธฐ ๊ฐ ์ฐ๋์ฑ, ํธ์์ฑ, ๋ผ์ดํ์คํ์ผ ์ ํฉ๋ ๋ถ์ ๋ด์ฉ์ ๋ง์ดํ์ด์ง ๋ด ํ ์ค ํ๊ฐ ๋ฆฌํฌํธ๋ก ๋ ๋๋ง
---
-
## ๐ง๐ปโ๐ป ํ์ (Contributors)
|
|
|
|
@@ -23,70 +25,32 @@
---
-
## ๐ ๏ธ ๊ธฐ์ ์คํ (Tech Stack)
| ์ญํ | ์ข
๋ฅ | ์ ์ ๊ทผ๊ฑฐ |
| :-- | :-- | :-- |
| **Language & Framework** |    | TypeScript๋ก ํ์
์์ ์ฑ์ ํ๋ณดํ๊ณ , React ๊ธฐ๋ฐ ์ปดํฌ๋ํธ UI๋ฅผ ๊ตฌ์ฑํ์ผ๋ฉฐ, Vite์ ๋น ๋ฅธ ๋ฒ๋ค๋ง๊ณผ HMR๋ก ๊ฐ๋ฐ ์์ฐ์ฑ์ ๋์์ต๋๋ค. |
| **Styling** |  | ์ ํธ๋ฆฌํฐ ๊ธฐ๋ฐ ์คํ์ผ๋ง์ผ๋ก ๋น ๋ฅด๊ณ ์ผ๊ด๋ UI๋ฅผ ๊ตฌํํ์ต๋๋ค. |
+| **UI Utilities** |   | SVGR๋ก SVG๋ฅผ React ์ปดํฌ๋ํธ๋ก ๊ด๋ฆฌํด ์ฌ์ฌ์ฉ์ฑ์ ๋์๊ณ , clsx๋ก ์กฐ๊ฑด๋ถ className ๋ก์ง์ ๊ฐ๊ฒฐํ๊ฒ ์ฒ๋ฆฌํ์ต๋๋ค. |
| **State Management** |   | Zustand๋ก ํด๋ผ์ด์ธํธ ์ํ๋ฅผ ๊ฐ๋จํ ๊ด๋ฆฌํ๊ณ , TanStack Query๋ก ์๋ฒ ์ํ/์บ์ฑ์ ์ ์ธ์ ์ผ๋ก ๊ด๋ฆฌํ์ต๋๋ค. |
| **Data Fetching** |   | Axios๋ก HTTP ์์ฒญ์ ์ฒ๋ฆฌํ๊ณ , TanStack Query๋ก ์์ฒญ ์ํ/์บ์ฑ/๋๊ธฐํ ๊ด๋ฆฌ๋ฅผ ์ํํ์ต๋๋ค. |
| **Tools** |   | ESLint๋ก ์ฝ๋ ๊ท์น์ ํต์ผํ๊ณ , Prettier๋ก ํฌ๋งท์ ์๋ํํด ์ผ๊ด๋ ์ฝ๋ ์คํ์ผ์ ์ ์งํ์ต๋๋ค. |
| **DevOps** |    | Git/GitHub๋ก ๋ฒ์ ๊ด๋ฆฌ ๋ฐ ํ์
์ ์งํํ๊ณ , Vercel๋ก ๋ฐฐํฌ ์๋ํ ๋ฐ CI/CD ๊ณผ์ ์ ๊ฐ์ํํ์ต๋๋ค. |
| **Package Manager** |  | ํ์ค ํจํค์ง ๋งค๋์ (npm)๋ฅผ ์ฌ์ฉํ์ฌ ์์กด์ฑ ์ค์น ๋ฐ ๊ด๋ฆฌ๋ฅผ ์ํํ์ต๋๋ค. |
-
+| **Validation** |  | Zod๋ก API ์๋ต ๋ฐ ํผ ์
๋ ฅ ๊ฐ์ ์คํค๋ง ๊ธฐ๋ฐ์ผ๋ก ๊ฒ์ฆํด ๋ฐํ์ ์ค๋ฅ๋ฅผ ์ค์ด๊ณ ํ์
์์ ์ฑ์ ๊ฐํํ์ต๋๋ค. |
+| **Collaboration** |    | Notion์ ํตํ ๋ฌธ์ํ์ ํ๋ก์ ํธ ์๋ฃ ๊ด๋ฆฌ, Figma ๊ธฐ๋ฐ ๋์์ธ ํ์
, Discord๋ฅผ ํ์ฉํ ์ค์๊ฐ ์ปค๋ฎค๋์ผ์ด์
์ผ๋ก ํ ํ์
ํจ์จ์ ๋์์ต๋๋ค. |
---
+## ๐ ์ปจ๋ฒค์
(Conventions)
-## ๐ Git-flow ์ ๋ต (Git-flow Strategy)
-
-* main: ์ต์ข
์ ์ผ๋ก ์ฌ์ฉ์์๊ฒ ๋ฐฐํฌ๋๋ ๊ฐ์ฅ ์์ ์ ์ธ ๋ฒ์ ๋ธ๋์น
-* develop: ๋ค์ ์ถ์ ๋ฒ์ ์ ๊ฐ๋ฐํ๋ ์ค์ฌ ๋ธ๋์น. ๊ธฐ๋ฅ ๊ฐ๋ฐ ์๋ฃ ํ feature ๋ธ๋์น๋ค์ด ๋ณํฉ
-* feature: ๊ธฐ๋ฅ ๊ฐ๋ฐ์ฉ ๋ธ๋์น. develop์์ ๋ถ๊ธฐํ์ฌ ์์
-
----
-
-## ๐ ๋ธ๋์น ๊ท์น ๋ฐ ๋ค์ด๋ฐ (Branch Rules & Naming)
-
-* ๋ชจ๋ ๊ธฐ๋ฅ ๊ฐ๋ฐ์ feature ๋ธ๋์น์์ ์์
-* ์์
์์ ์ , ํญ์ ์ต์ develop ๋ด์ฉ ๋ฐ์์ค๊ธฐ (git pull origin develop)
-* ์์
์๋ฃ ํ, develop์ผ๋ก Pull Request(PR) ์์ฑ
-* PR์ Reviewer(๋ฉ์
) ์ง์ ์ดํ ๋จธ์ง
-* ๋ธ๋์น ์ด๋ฆ ํ์: feature/์ด์๋ฒํธ-๊ธฐ๋ฅ๋ช
-* ์์: feature/1-login-ui
-
----
-
-## ๐ฏ ์ปค๋ฐ ์ปจ๋ฒค์
(Commit Convention)
-
-### ์ฃผ์ ์ฌํญ
-* type์ ์๋ฌธ์๋ง ์ฌ์ฉ (feat, fix, refactor, docs, style, test, chore)
-* subject๋ ๋ชจ๋ ํ์ฌํ ๋์ฌ
-
-### ๐ ํ์
๋ชฉ๋ก
-
-| type | ์ค๋ช
|
-| :--- | :--- |
-| start | ์๋ก์ด ํ๋ก์ ํธ๋ฅผ ์์ํ ๋ |
-| feat | ์๋ก์ด ๊ธฐ๋ฅ์ ์ถ๊ฐํ ๋ |
-| fix | ๋ฒ๊ทธ๋ฅผ ์์ ํ ๋ |
-| design | CSS ๋ฑ ์ฌ์ฉ์ UI ๋์์ธ์ ๋ณ๊ฒฝํ ๋ |
-| refactor | ๊ธฐ๋ฅ ๋ณ๊ฒฝ ์์ด ์ฝ๋๋ฅผ ๋ฆฌํฉํ ๋งํ ๋ |
-| settings | ์ค์ ํ์ผ์ ๋ณ๊ฒฝํ ๋ |
-| comment | ํ์ํ ์ฃผ์์ ์ถ๊ฐํ๊ฑฐ๋ ๋ณ๊ฒฝํ ๋ |
-| dependency/Plugin | ์์กด์ฑ/ํ๋ฌ๊ทธ์ธ์ ์ถ๊ฐํ ๋ |
-| docs | README.md ๋ฑ ๋ฌธ์๋ฅผ ์์ ํ ๋ |
-| merge | ๋ธ๋์น๋ฅผ ๋ณํฉํ ๋ |
-| deploy | ๋น๋ ๋ฐ ๋ฐฐํฌ ๊ด๋ จ ์์
์ ํ ๋ |
-| rename | ํ์ผ ํน์ ํด๋๋ช
์ ์์ ํ๊ฑฐ๋ ์ฎ๊ธธ ๋ |
-| remove | ํ์ผ์ ์ญ์ ํ๋ ์์
๋ง ์ํํ์ ๋ |
-| revert | ์ด์ ๋ฒ์ ์ผ๋ก ๋กค๋ฐฑํ ๋ |
-
-### โจ ์์
-* feat: ์ปดํฌ๋ํธ ์ถ๊ฐ
-* fix: ๊ฐ๋ ค์ง ํ์ ํด๊ฒฐ
+- ๐ [Commit Convention](https://www.notion.so/Commit-Convention-305c82f125c980898111df6891b25578?source=copy_link)
+- ๐ชต [Branch Convention](https://www.notion.so/Branch-Convention-305c82f125c980afaecfdc5b00ad1f71?source=copy_link)
+- ๐ป [Coding Convention](https://www.notion.so/Coding-Convention-2dac82f125c980a8810bca8fadbe8b5f?source=copy_link)
+- ๐ข [API Convention](https://www.notion.so/API-Convention-2e0c82f125c9805bb0c3c22fda770978?source=copy_link)
+- ๐ [Issue Convention](https://www.notion.so/Issue-Convention-305c82f125c980029b7ce00b73962f66?source=copy_link)
+- โ
[PR Convention](https://www.notion.so/PR-Convention-305c82f125c9809e98ebe702534bf18a?source=copy_link)
+- ๐ [Folder Structure Convention](https://www.notion.so/Folder-Structure-Convention-2d4c82f125c98112bd64d946da9d2f34?source=copy_link)
---
@@ -107,3 +71,12 @@
- **Figma ์์น ๊ท์น**
- ๋์์ด๋๋๊ป์ ๋ณ๋๋ก ์๋ดํ ๊ฒฝ์ฐ๋ฅผ ์ ์ธํ๊ณ , ๊ฐ์ฅ ๊ฐ๊น์ด 4์ ๋ฐฐ์๋ก ์ค๋
ํ์ฌ ์ ์ฉํฉ๋๋ค.
+
+---
+
+## ๐ฐ ์ํฐํด ๋ชจ์ (Articles)
+
+| ์ด๋ฆ | ์ํฐํด ์ ๋ชฉ |
+| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ๐ ๋ฐ์ ๋ฏผ | [์ํ ๊ธฐ๋ฐ ์ธํฐ๋์
๊ตฌํ๊ธฐ](https://velog.io/@waldls/Frontend-%EC%83%81%ED%83%9C-%EA%B8%B0%EB%B0%98-%EC%9D%B8%ED%84%B0%EB%9E%99%EC%85%98-%EA%B5%AC%ED%98%84%EA%B8%B0) |
+| ๐ ์ด์ ์ฐ | [Device Life Auth ์์คํ
๊ตฌํ ํ๊ณ ](https://www.notion.so/Device-Life-Auth-305564e055eb8007a616fde7ddb853d7?source=copy_link) |