diff --git a/README.md b/README.md
index 53c088d..6bcd746 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,148 @@
-# mango-boss-fe
\ No newline at end of file
+# π₯ MangoBoss (λ§κ³ 보μ€)
+
+> [](https://drive.google.com/file/d/1avQXxRjYqYMZdZu0MLEnuBWkBaB1wWlD/view)
+> μλΉμ€ μμ° μμ (Service Demo)
+
+
+> **"볡μ‘ν λ§€μ₯ κ΄λ¦¬, μ΄μ λ§κ³ λ³΄μ€ νλλ‘ λ."**
+> μμκ³΅μΈ μ¬μ₯λλ€μ μν **μ¬μΈμ λ§€μ₯ κ΄λ¦¬ μ루μ
(SaaS)** νλ‘ νΈμλ μ μ₯μμ
λλ€.
+
+
+
+## π λ°°ν¬ λ° λ¬Έμ (Links)
+* **Service URL**: [https://www.mangoboss.com](https://www.mangoboss.com)
+* **Team Notion**: [MangoBoss Team Docs](https://www.notion.so/1af52a9c0c5380e6b73beb5fc5e64aea)
+* **Personal Docs**: [Dev Progress](https://www.notion.so/MangoBoss-1aea0b0c7d4c805c8204eba5bb540b55)
+
+
+
+## π νλ‘μ νΈ λ°°κ²½ (Background)
+
+**"μ¬μ₯λμ μ₯μ¬μλ§ μ§μ€νμΈμ, κ΄λ¦¬λ λ§κ³ 보μ€κ° ν κ²μ."**
+
+λ§μ μμμ
μλΆλ€μ΄ μ¬κ³ κ΄λ¦¬, μ§μ μ€μΌμ€λ§, λ§€μΆ μ μ°μ μν΄ μμ
μ μΌκ±°λ μ¬λ¬ κ°μ μ±μ λ²κ°μ μ¬μ©νλ©° μκ°μ λλΉνκ³ μμ΅λλ€.
+**MangoBoss**λ ν©μ΄μ Έ μλ λ§€μ₯ κ΄λ¦¬ κΈ°λ₯μ νλμ μΉ λμ보λλ‘ ν΅ν©νμ¬, ITμ μ΅μνμ§ μμ μ¬μ₯λλ€λ μ§κ΄μ μΌλ‘ μ¬μ©ν μ μλλ‘ UXλ₯Ό μ€κ³νμ΅λλ€.
+
+
+
+## β¨ ν΅μ¬ κΈ°λ₯ (Key Features)
+
+* **π μ€μκ° λ§€μΆ λμ보λ**: μ°¨νΈ λΌμ΄λΈλ¬λ¦¬λ₯Ό νμ©νμ¬ μΌκ°/μ£Όκ°/μκ° λ§€μΆ μΆμ΄λ₯Ό μκ°ν
+* **π¦ μ€λ§νΈ μ¬κ³ κ΄λ¦¬**: μ¬κ³ λΆμ‘± μ μλ¦Ό μ 곡 λ° μν΄λ¦ λ°μ£Ό μμ€ν
+* **π
μ§μ μ€μΌμ€λ§**: λλκ·Έ μ€ λλ‘(DnD)μΌλ‘ κ°νΈνκ² μλ°μ 근무ν μμ±
+* **π± λ°μν μΉ (Mobile First)**: PC ν¬μ€κΈ°λ λ¬Όλ‘ , μ΄λ μ€μΈ μ¬μ₯λμ μ€λ§νΈν°μμλ μλ²½ νΈν
+* **π μ€μκ° μ£Όλ¬Έ μλ¦Ό**: μΉ μμΌ(Web Socket)μ μ°λνμ¬ μ£Όλ¬Έ μ μ μ μ¦κ°μ μΈ μλ¦Ό μ 곡
+
+
+
+## π οΈ κΈ°μ μ€ν (Tech Stack)
+
+| λΆλ₯ | κΈ°μ |
+| :-- | :-- |
+| **Framework** |   |
+| **State Mgt** | `Zustand` (μ μ μν) |
+| **Styling** |  |
+| **Visualization** | `Recharts` (λ§€μΆ λ°μ΄ν° μκ°ν) |
+| **Build Tool** |  |
+
+
+
+## π ν΄λ ꡬ쑰 (Directory Structure)
+
+μ μ§λ³΄μμ±κ³Ό νμ₯μ±μ κ³ λ €νμ¬ **κΈ°λ₯(Feature)** λ¨μμ **곡ν΅(Shared)** λ¨μλ₯Ό λΆλ¦¬νμ¬ μ€κ³νμ΅λλ€.
+
+```bash
+dev-fe/
+βββ src/
+β βββ api/ # Axios μΈμ€ν΄μ€ λ° API μμ² ν¨μ λͺ¨μ
+β βββ assets/ # μ΄λ―Έμ§, ν°νΈ, μμ΄μ½ 리μμ€
+β βββ components/ # μ¬μ¬μ© κ°λ₯ν κ³΅ν΅ UI (Button, Input λ±)
+β βββ constants/ # μμ λ°μ΄ν° (λ©λ΄ 리μ€νΈ, μλ¬ λ©μμ§ λ±)
+β βββ hooks/ # 컀μ€ν
ν
(useAuth, useSalesData λ±)
+β βββ layout/ # νμ΄μ§ λ μ΄μμ (Header, Sidebar)
+β βββ pages/ # λΌμ°ν
νμ΄μ§ (Dashboard, Inventory, Schedule)
+β βββ store/ # Zustand μ μ μν κ΄λ¦¬
+β βββ types/ # TypeScript νμ
μ μ
+β βββ utils/ # λ μ§ λ³ν, νν λ¨μ ν¬λ§·ν
λ± μ νΈ ν¨μ
+β βββ App.tsx
+β βββ main.tsx
+βββ .env
+βββ package.json
+βββ README.md
+```
+
+
+
+## π μ€μΉ λ° μ€ν (Getting Started)
+
+```bash
+# 1. μ μ₯μ ν΄λ‘
+git clone [https://github.com/Mango-Butter/dev-fe.git](https://github.com/Mango-Butter/dev-fe.git)
+
+# 2. ν¨ν€μ§ μ€μΉ
+yarn install
+
+# 3. κ°λ° μλ² μ€ν
+yarn dev
+```
+
+
+
+## π μ±λ₯ μ΅μ ν (Performance Optimization)
+
+μ΄κΈ° λ‘λ© μλ κ°μ κ³Ό λ λλ§ μ΅μ νλ₯Ό μν΄ Viteμ λΉλ μ λ΅μ μμ νκ³ μ½λ λΆν μ μ κ·Ήμ μΌλ‘ λμ
νμ΅λλ€.
+
+* **λ²λ€ μ¬μ΄μ¦ 96.8% κ°μ**: `React.lazy`, `Suspense` λ° `manualChunks` μ λ΅μ μ μ©νμ¬ λͺ¨λ리μ λ²λ€μ λΆλ¦¬.
+ * **Before**: 5MB (μ΄κΈ° λ¨μΌ λ²λ€)
+ * **After**: 161KB (Core Chunk)
+ * **Result**: μ 체 Chunk ꡬ쑰λ₯Ό 1κ° β 60κ° μ΄μμΌλ‘ λΆμ°νμ¬ TTI(Time to Interactive) λν κ°μ .
+* **Lazy Loading μ μ©**: λλ© νμ΄μ§ λ° μ£Όμ μΉμ
μ `Intersection Observer`λ₯Ό λμ
νμ¬ λ·°ν¬νΈμ μ§μ
ν λλ§ λ¦¬μμ€λ₯Ό λ‘λνλλ‘ κ°μ .
+* **λΉλκΈ° UX κ°ν**: λ°μ΄ν° νμΉ λκΈ° μκ°μ **Skeleton UI**μ **Lottie JSON μ λλ©μ΄μ
**μ λ
ΈμΆνμ¬ μ²΄κ° λ‘λ© μκ°μ λ¨μΆνκ³ λκΉ μλ μ¬μ©μ κ²½ν μ 곡.
+
+
+
+## ποΈ μν€ν
μ² λ° κΈ°μ μ νΉμ§ (Architecture & Tech)
+
+### 1. PWA & FCM μλ¦Ό μμ€ν
+* **PWA (Progressive Web App)**: `vite-plugin-pwa`λ₯Ό νμ©νμ¬ λͺ¨λ°μΌ ν νλ©΄ μ€μΉ μ§μ λ° μλΉμ€ μ컀(Service Worker) κΈ°λ°μ μ€νλΌμΈ μΊμ μ λ΅ μ μ©. λ€νΈμν¬κ° λΆμμ ν νκ²½μμλ ν΅μ¬ κΈ°λ₯ μ¬μ© κ°λ₯.
+* **Push Notification**: FCM(Firebase Cloud Messaging)μ μ°λνμ¬ λΈλΌμ°μ μ Foreground/Background μνμ κ΄κ³μμ΄ μ€μκ° μ£Όλ¬Έ/μ€μΌμ€ μλ¦Ό μ μ‘.
+
+### 2. μν κ΄λ¦¬ λ° λΌμ°ν
(State & Routing)
+* **Zustand κΈ°λ° μν λΆλ¦¬**: μ¬μ₯λ(Admin)κ³Ό μλ°μ(Staff)μ λ°μ΄ν° μ κ·Ό λ²μκ° λ€λ¦μ κ³ λ €νμ¬, μ μ μν μ€ν μ΄λ₯Ό μν λ³λ‘ λΆλ¦¬ λ° κ²½λν.
+* **Role-Based Access Control (RBAC)**:
+ * `PublicRoute`: λΉλ‘κ·ΈμΈ μ¬μ©μ μ κ·Ό
+ * `ProtectedRoute`: λ‘κ·ΈμΈ μ¬μ©μ μ μ©
+ * `RoleRoute`: νΉμ κΆν(μ¬μ₯λ/μλ°μ)μ λ°λ₯Έ νμ΄μ§ μ κ·Ό μ μ΄ λ° λ¦¬λλ μ
μ²λ¦¬
+
+### 3. λμμΈ μμ€ν
(Design System)
+* **Component-Driven Development**: **Tailwind CSS**μ **JSX in SVG**λ₯Ό κΈ°λ°μΌλ‘ μ μ°ν λμμΈ μμ€ν
ꡬμΆ.
+* **Storybook λμ
**: κ³΅ν΅ UI μ»΄ν¬λνΈ(Button, Input, Modal λ±)λ₯Ό λ¬Έμννμ¬ λμμ΄λ-κ°λ°μ κ° νμ
ν¨μ¨ μ¦λ λ° UI μΌκ΄μ± μ μ§.
+
+### 4. SEO & λ§μΌν
(SEO & Meta)
+* μμ© μλΉμ€ μμ€μ **SEO λ©ννκ·Έ**, **OpenGraph**, **PWA Manifest**λ₯Ό μλ²½νκ² κ΅¬μ±νμ¬ SNS 곡μ μ 미리보기 μ΅μ ν λ° κ²μ μμ§ λ
ΈμΆ λμ.
+
+
+
+## π 보μ λ° λ°°ν¬ νμ΄νλΌμΈ (Security & DevOps)
+
+### π ν΄λΌμ΄μΈνΈ 보μ (Client Security)
+* **AES κΈ°λ° λ°μ΄ν° μνΈν**: μ μκ·Όλ‘κ³μ½μ λ± λ―Όκ° λ°μ΄ν° μ μ‘ μ, ν΄λΌμ΄μΈνΈμμ μμ±ν **Random Session Key**μ **Encryption Key**λ₯Ό μ‘°ν©νμ¬ AES μνΈν μ μ©.
+* **μΌνμ± ν€ μ λ΅**: μ μ‘ ν ν€λ₯Ό νκΈ°νλ λ°©μμΌλ‘ λ°μ΄ν° νμ·¨ λ° μ€κ°μ 곡격(MITM) λ°©μ΄.
+
+### βοΈ CI/CD & Infrastructure
+* **Automated Deployment**: GitHub Actionsλ₯Ό νμ©νμ¬ `dev` (κ°λ°) β `test` (ν
μ€νΈ) β `main` (μ΄μ) λΈλμΉλ³ μλ λ°°ν¬ νμ΄νλΌμΈ ꡬμΆ.
+* **AWS Serverless**: **Amazon S3**(μ μ νΈμ€ν
)μ **CloudFront**(CDN)λ₯Ό μ°λνμ¬ μ μΈκ³ μ΄λμλ λΉ λ₯Έ μλλ‘ μ½ν
μΈ λ₯Ό μ μ‘νκ³ SSL(HTTPS) 보μ μ μ©.
+
+
+
+## π¬ Team Mango-Butter
+
+| μ΄λ¦ | μν |
+| :-- | :-- |
+| **[μ€μμ°¬](https://github.com/PaleBlueNote)** | Frontend Lead
+| **μ νμ§** | Backend Lead
+| **μ¬μ¬μ½** | Backend
+| **μ΄λͺ
건** | Designer
+
+---
+Β© 2026 Mango-Butter. All rights reserved.
diff --git a/index.html b/index.html
index 0d26d5d..7e6ccec 100644
--- a/index.html
+++ b/index.html
@@ -44,7 +44,7 @@
-
+