# 🚨 Vercel 배포 오류 해결 가이드

## 문제 상황

```
Environment Variable "VITE_APPWRITE_ENDPOINT" references Secret "vite_appwrite_endpoint", which does not exist.
```

## 해결 방법

### 1. Vercel 대시보드에서 환경 변수 설정

**🔗 URL:** https://vercel.com/hansoohas-projects/zellyy-finance/settings/environment-variables

**📝 설정해야 할 환경 변수들:**

#### Production 환경

| 변수명                                     | 값                             | 설명                         |
| ------------------------------------------ | ------------------------------ | ---------------------------- |
| `VITE_APPWRITE_ENDPOINT`                   | `https://cloud.appwrite.io/v1` | Appwrite 클라우드 엔드포인트 |
| `VITE_APPWRITE_PROJECT_ID`                 | `YOUR_PROJECT_ID`              | Appwrite 프로젝트 ID         |
| `VITE_APPWRITE_DATABASE_ID`                | `default`                      | 데이터베이스 ID              |
| `VITE_APPWRITE_TRANSACTIONS_COLLECTION_ID` | `transactions`                 | 컬렉션 ID                    |
| `VITE_APPWRITE_API_KEY`                    | `YOUR_API_KEY`                 | Appwrite API 키              |
| `VITE_DISABLE_LOVABLE_BANNER`              | `true`                         | Lovable 배너 비활성화        |

#### Preview 환경 (동일한 값 또는 테스트용 값)

- 위와 동일한 변수들을 Preview 환경에도 설정

### 2. CLI로 환경 변수 설정 (대안)

```bash
# Production 환경
vercel env add VITE_APPWRITE_ENDPOINT production
vercel env add VITE_APPWRITE_PROJECT_ID production
vercel env add VITE_APPWRITE_DATABASE_ID production
vercel env add VITE_APPWRITE_TRANSACTIONS_COLLECTION_ID production
vercel env add VITE_APPWRITE_API_KEY production
vercel env add VITE_DISABLE_LOVABLE_BANNER production

# Preview 환경
vercel env add VITE_APPWRITE_ENDPOINT preview
# ... 기타 변수들
```

### 3. 환경 변수 설정 후 재배포

```bash
# 환경 변수 설정 확인
vercel env ls

# 재배포
vercel --prod
```

## Appwrite 설정 가이드

1. **Appwrite 클라우드 계정 생성**
   - https://cloud.appwrite.io 접속
   - 계정 생성/로그인

2. **프로젝트 생성**
   - 새 프로젝트 생성
   - 프로젝트 ID 복사

3. **데이터베이스 설정**
   - Database 메뉴에서 새 데이터베이스 생성 (이름: default)
   - Collection 생성 (이름: transactions)

4. **API 키 생성**
   - Settings > API Keys에서 새 API 키 생성
   - 필요한 권한 부여

5. **도메인 설정**
   - Settings > Platforms에서 Web 플랫폼 추가
   - Vercel 도메인 추가 (예: https://zellyy-finance.vercel.app)

## 주의사항

⚠️ **보안 주의사항:**

- API 키는 절대 코드에 하드코딩하지 마세요
- 환경 변수만 사용하세요
- `.env` 파일은 `.gitignore`에 포함되어 있는지 확인하세요

✅ **성공 확인:**

- 환경 변수 설정 후 `vercel env ls`로 확인
- 재배포 후 브라우저에서 정상 동작 확인
- 개발자 도구 Console에서 에러 메시지 확인