feat: add optimistic locking and improve type safety

- Implement optimistic locking for deposit balance updates
  - Prevent race conditions in concurrent deposit requests
  - Add automatic retry with exponential backoff (max 3 attempts)
  - Add version column to user_deposits table

- Improve type safety across codebase
  - Add explicit types for Namecheap API responses
  - Add typed function arguments (ManageDepositArgs, etc.)
  - Remove `any` types from deposit-agent and tool files

- Add reconciliation job for balance integrity verification
  - Compare user_deposits.balance vs SUM(confirmed transactions)
  - Alert admin on discrepancy detection

- Set up test environment with Vitest + Miniflare
  - Add 50+ test cases for deposit system
  - Add helper functions for test data creation

- Update documentation
  - Add migration guide for version columns
  - Document optimistic locking patterns

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

README.md

@@ -202,6 +202,58 @@ npx @apidevtools/swagger-cli validate openapi.yaml
 
 ---
 
+## 🧪 테스트
+
+### 자동화된 단위 테스트
+
+프로젝트는 **Vitest**와 **Miniflare**를 사용하여 Cloudflare Workers 환경에서 단위 테스트를 실행합니다.
+
+#### 테스트 실행
+
+```bash
+# 의존성 설치
+npm install
+
+# 모든 테스트 실행
+npm test
+
+# Watch 모드 (개발 중)
+npm run test:watch
+
+# 커버리지 리포트
+npm run test:coverage
+```
+
+#### 테스트 범위
+
+**deposit-agent.ts** (예치금 시스템):
+- ✅ 음수/0원 금액 거부
+- ✅ 동시성 처리 안전성
+- ✅ Batch 부분 실패 처리
+- ✅ 입금자명 7글자 매칭 로직
+- ✅ 관리자 권한 검증
+- ✅ 거래 상태 검증
+
+**테스트 파일 위치**:
+- `tests/deposit-agent.test.ts` - 예치금 시스템 테스트 (50+ test cases)
+- `vitest.config.ts` - Vitest 설정 (Miniflare 환경)
+- `tests/setup.ts` - D1 Database 초기화 및 헬퍼 함수
+
+#### 테스트 아키텍처
+
+- **환경**: Miniflare (in-memory SQLite)
+- **모킹**: D1 Database, KV Namespace, 환경 변수
+- **커버리지**: V8 Coverage Provider
+- **실행 시간**: <10초 (전체 테스트 스위트)
+
+#### 수동 테스트
+
+자동화되지 않은 기능의 수동 테스트 예제:
+- `src/services/__test__/notification.test.ts` - 관리자 알림 시스템
+- `src/utils/__test__/logger.test.ts` - 구조화된 로깅
+
+---
+
 ## 🛠 기술 스택
 
 | 분류 | 기술 | 비고 |
@@ -211,6 +263,7 @@ npx @apidevtools/swagger-cli validate openapi.yaml
 | **Cache** | Cloudflare KV | Rate Limiting |
 | **AI** | OpenAI GPT-4o-mini | Logic & Tools |
 | **Fallback** | Workers AI (Llama 3) | Backup AI |
+| **Testing** | Vitest + Miniflare | Unit Tests |
 
 ---