# 빠른 시작 가이드

## 로컬 개발

### 1. 의존성 설치
```bash
pnpm install
```

### 2. 개발 서버 실행
```bash
pnpm dev
```

브라우저에서 http://localhost:5173 접속

**참고**: 로컬 개발 환경에서는 실제 Durable Objects가 에뮬레이션되므로, WebSocket 연결이 완벽하게 작동하지 않을 수 있습니다.

### 3. Cloudflare Workers 환경에서 로컬 테스트

더 실제와 유사한 환경에서 테스트하려면:

```bash
pnpm build
pnpm cf:dev
```

이제 Wrangler가 로컬 Cloudflare Workers 환경을 시뮬레이션합니다.

## Cloudflare에 배포

### 1. Wrangler 로그인

처음 배포하는 경우, Cloudflare 계정에 로그인합니다:

```bash
npx wrangler login
```

### 2. 프로젝트 빌드 및 배포

```bash
pnpm deploy
```

또는 수동으로:

```bash
pnpm build
npx wrangler deploy
```

### 3. 배포 확인

배포가 완료되면 Wrangler가 배포된 URL을 출력합니다:

```
Published dd (1.23 sec)
  https://dd.your-subdomain.workers.dev
```

브라우저에서 해당 URL을 열어 애플리케이션을 확인하세요!

## Durable Objects 설정

첫 배포 시 Durable Objects를 활성화해야 할 수 있습니다:

1. Cloudflare Dashboard에 로그인: https://dash.cloudflare.com
2. **Workers & Pages** 섹션으로 이동
3. 배포된 Worker 선택
4. **Settings** > **Durable Objects** 탭
5. `CounterDurableObject` 바인딩 확인

## 로그 확인

실시간으로 Worker 로그를 확인하려면:

```bash
pnpm cf:tail
```

또는

```bash
npx wrangler tail
```

## 문제 해결

### "Durable Object not configured" 오류

- `wrangler.jsonc` 파일이 올바르게 설정되었는지 확인
- Cloudflare Dashboard에서 Durable Objects 바인딩 확인
- 다시 배포: `pnpm deploy`

### WebSocket 연결 실패

- 브라우저 콘솔에서 오류 메시지 확인
- `wrangler tail`로 서버 로그 확인
- HTTPS 환경인지 확인 (로컬에서는 HTTP도 가능)

### 빌드 오류

```bash
rm -rf .svelte-kit node_modules
pnpm install
pnpm build
```

## 다음 단계

- 여러 카운터 룸 추가
- 사용자 인증 구현
- 카운트 히스토리 저장
- 실시간 채팅 기능 추가

자세한 내용은 `README.md`를 참고하세요!