diff --git a/README.md b/README.md
new file mode 100644
index 0000000..26bbf28
--- /dev/null
+++ b/README.md
@@ -0,0 +1,225 @@
+# 🍽️ AI Review - 소상공인을 위한 AI 기반 경쟁업체 분석 및 액션 추천 시스템
+
+소상공인들이 카카오맵 리뷰 데이터를 기반으로 경쟁업체를 분석하고, AI가 제안하는 맞춤형 비즈니스 개선 방안을 받을 수 있는 마이크로서비스 기반 플랫폼입니다.
+
+## 🎯 시스템 개요
+
+### 핵심 가치 제안
+- **🔍 스마트 경쟁업체 발견**: 지역과 업종 기반으로 유사한 경쟁업체 자동 탐지
+- **📊 대량 리뷰 데이터 분석**: 카카오맵 리뷰를 수집하여 고품질 인사이트 도출
+- **🤖 AI 기반 맞춤 컨설팅**: Claude AI가 제공하는 실행 가능한 비즈니스 액션 플랜
+- **⚡ 완전 자동화**: API 기반으로 모든 과정이 자동화된 솔루션
+
+### 비즈니스 임팩트
+- **소상공인**: 데이터 기반 경영 의사결정으로 매출 향상 지원
+- **경쟁 우위**: AI 기반 개인화된 비즈니스 전략으로 차별화
+- **운영 효율**: 수작업 시장조사 대비 시간과 비용 90% 절감
+
+## 🏗️ 서비스 아키텍처
+
+본 시스템은 3개의 독립적인 마이크로서비스로 구성되어 있습니다:
+
+### 📍 Restaurant Service
+**음식점 검색 및 정보 수집 서비스**
+
+- **핵심 기능**: 카카오 로컬 API 기반 음식점 검색 및 상세 정보 수집
+- **주요 API**: 
+  - 음식점 검색 (`/restaurants/search`)
+  - 음식점 상세 정보 (`/restaurants/{restaurant_id}`)
+- **기술 스택**: FastAPI, Python 3.11, Kakao Local API
+- **포트**: 18000
+
+### 📝 Review Service  
+**카카오맵 리뷰 수집 및 분석 서비스**
+
+- **핵심 기능**: 카카오맵 리뷰 대량 수집, 감정 분석, 키워드 추출
+- **주요 API**:
+  - 리뷰 수집 (`/reviews/collect`)
+  - 리뷰 분석 (`/reviews/analyze`)
+- **기술 스택**: FastAPI, Python 3.11, BeautifulSoup, Sentiment Analysis
+- **포트**: 19000
+
+### 🧠 Vector Service
+**Vector DB 구축 및 AI 비즈니스 컨설팅 서비스**
+
+- **핵심 기능**: ChromaDB 기반 Vector 검색, Claude AI 연동 액션 추천
+- **주요 API**:
+  - Vector DB 구축 (`/find-reviews`)
+  - AI 액션 추천 (`/action-recommendation`)
+- **기술 스택**: FastAPI, ChromaDB, Sentence Transformers, Claude AI
+- **포트**: 8000
+
+## 🚀 AKS 배포 가이드
+
+### 1. 사전 준비
+
+#### Local Ubuntu 접속 후 소스 다운로드
+```bash
+cd ~/workflow
+git clone https://github.com/cna-bootcamp/ai-review.git
+cd ai-review
+```
+
+#### Azure Cloud 로그인
+```bash
+az login --use-device-code
+```
+
+#### AKS Credential 취득
+```bash
+az aks get-credentials aks-digitalgarage-03 -f ~/.kube/config
+```
+
+#### Namespace 생성 및 이동
+```bash
+k create ns ai-review-ns
+kubens ai-review-ns
+```
+
+#### Image Pull Secret 생성
+```bash
+./restaurant/create-imagepullsecret.sh acrdigitalgarage03 rg-digitalgarage-03
+```
+
+### 2. Restaurant Service 배포
+
+#### 디렉토리 이동
+```bash
+cd ~/workspace/ai-review/restaurant
+```
+
+#### 베이스 이미지 빌드
+```bash
+./build-base.sh latest acrdigitalgarage03 rg-digitalgarage-03
+```
+
+#### 서비스 이미지 빌드
+```bash
+./build.sh latest acrdigitalgarage03 rg-digitalgarage-03
+```
+
+#### Manifest 수정
+- **Deployment yaml** (`deployment/manifest/deployment.yaml`)의 image명을 서비스 이미지명으로 변경
+- **Ingress yaml** (`deployment/manifest/ingress.yaml`)의 host 수정
+  ```bash
+  # Ingress IP 확인
+  k get svc -n ingress-nginx
+  ```
+
+#### 배포 실행
+```bash
+k apply -f deployment/manifest
+```
+
+#### 배포 확인
+```bash
+# Pod 상태 확인
+k get po
+
+# Ingress 확인  
+k get ing
+
+# Swagger 페이지 접속
+# http://{ingress 주소}/docs
+```
+
+### 3. Review Service 배포
+
+#### 디렉토리 이동
+```bash
+cd ~/workspace/ai-review/review
+```
+
+#### 베이스 이미지 빌드
+```bash
+./build-base.sh latest acrdigitalgarage03 rg-digitalgarage-03
+```
+
+#### 서비스 이미지 빌드
+```bash
+./build.sh latest acrdigitalgarage03 rg-digitalgarage-03
+```
+
+#### Manifest 수정
+- **Deployment yaml** (`deployment/manifest/deployment.yaml`)의 image명을 서비스 이미지명으로 변경
+- **Ingress yaml** (`deployment/manifest/ingress.yaml`)의 host 수정
+  ```bash
+  # Ingress IP 확인
+  k get svc -n ingress-nginx
+  ```
+
+#### 배포 실행
+```bash
+k apply -f deployment/manifest
+```
+
+#### 배포 확인
+```bash
+# Pod 상태 확인
+k get po
+
+# Ingress 확인
+k get ing
+
+# Swagger 페이지 접속
+# http://{ingress 주소}/docs
+```
+
+### 4. Vector Service 배포
+
+#### 디렉토리 이동
+```bash
+cd ~/workspace/ai-review/vector
+```
+
+#### 베이스 이미지 빌드
+```bash
+./build-base.sh latest acrdigitalgarage03 rg-digitalgarage-03
+```
+
+#### 서비스 이미지 빌드
+```bash
+./build.sh latest acrdigitalgarage03 rg-digitalgarage-03
+```
+
+#### Manifest 수정
+- **Deployment yaml** (`deployment/manifest/deployment.yaml`)의 image명을 서비스 이미지명으로 변경
+- **Ingress yaml** (`deployment/manifest/ingress.yaml`)의 host 수정
+  ```bash
+  # Ingress IP 확인
+  k get svc -n ingress-nginx
+  ```
+
+#### 배포 실행
+```bash
+k apply -f deployment/manifest
+```
+
+#### 배포 확인
+```bash
+# Pod 상태 확인
+k get po
+
+# Ingress 확인
+k get ing
+
+# Swagger 페이지 접속
+# http://{ingress 주소}/docs
+```
+
+## 🔧 서비스 상태 확인
+
+### 전체 서비스 상태 점검
+```bash
+# 모든 Pod 상태 확인
+kubectl get pods -n ai-review-ns
+
+# 모든 Service 확인
+kubectl get svc -n ai-review-ns
+
+# 모든 Ingress 확인
+kubectl get ing -n ai-review-ns
+
+# 로그 확인 (예: restaurant 서비스)
+kubectl logs -l app=restaurant-api -n ai-review-ns --tail=100
+```