docs: update documentation for Queue-based server provisioning

- Add Queue creation commands to CLAUDE.md
- Document server-provision-queue and provision-dlq
- Add Server System section with async flow diagram
- Document security improvements (password hashing, retryable flag)
- Update README.md with Queue setup in deployment guide

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
kappa
2026-01-24 22:59:35 +09:00
parent 1fead51eff
commit 13c59fbfb8
2 changed files with 184 additions and 6 deletions

View File

@@ -21,8 +21,8 @@
* 🛠 **Function Calling**: 날씨, 검색, 계산, 시간 등 다양한 도구를 자연어로 호출
* 💰 **예치금 시스템**: 은행 SMS 자동 파싱(AI 폴백 지원) 및 양방향 매칭을 통한 자동 충전
* 🌐 **도메인 관리**: 도메인 검색, 추천(AI), 가격 조회, 등록, DNS 관리 통합
* 🖥️ **서버 관리**: Linode/Vultr 인스턴스 검색, 비교, 주문, 소유권 관리
***서버리스**: Cloudflare Workers 위에서 동작하여 별도의 서버 관리 불필요
* 🖥️ **서버 관리 (Queue 기반)**: Linode/Vultr 인스턴스 검색, 비교, 주문, 비동기 프로비저닝
***서버리스**: Cloudflare Workers + Queues로 긴 작업도 안정적 처리
### 🚀 성능 최적화
@@ -59,7 +59,14 @@ npx wrangler kv:namespace create RATE_LIMIT_KV
# 출력된 id를 wrangler.toml의 [[kv_namespaces]] 섹션에 입력
```
### 4. 환경변수 설정
### 4. Queue 생성
```bash
# 서버 프로비저닝용 Queue 생성 (서버 기능 사용 시 필수)
npx wrangler queues create server-provision-queue
npx wrangler queues create provision-dlq
```
### 5. 환경변수 설정
#### 필수 Secrets
@@ -111,7 +118,7 @@ NAMECHEAP_API_URL = "https://your-api.example.com"
- `WTTR_IN_URL` - 날씨 API
- `HOSTING_SITE_URL` - 공식 웹사이트
### 5. 배포
### 6. 배포
#### 배포 전 체크리스트
@@ -148,7 +155,7 @@ curl "https://telegram-summary-bot.kappa-d8e.workers.dev/webhook-info?token=${BO
npm run tail
```
### 6. Webhook 연결
### 7. Webhook 연결
```bash
# 웹훅 설정 (token + secret 필요)
@@ -159,6 +166,7 @@ curl "https://<YOUR_WORKER_URL>/setup-webhook?token=${BOT_TOKEN}&secret=${WEBHOO
- **WEBHOOK_SECRET 필수**: 미설정 시 모든 webhook 요청이 거부됩니다.
- **KV Namespace 필수**: 미생성 시 Rate Limiting이 비활성화되어 DoS 공격에 취약합니다.
- **Queue 필수 (서버 기능 사용 시)**: 미생성 시 서버 프로비저닝 기능이 동작하지 않습니다.
- **환경변수 기본값**: 대부분의 외부 API URL은 기본값이 설정되어 있습니다. 프로덕션 환경에서는 기본값을 그대로 사용하거나, 필요시에만 override하세요.
---