69 lines
1.4 KiB
Markdown
69 lines
1.4 KiB
Markdown
# FastAPI 브릿지
|
|
|
|
## 📋 개요
|
|
|
|
Technical Korea 생산팀 포털의 FastAPI 브릿지입니다. Express.js API의 성능을 향상시키고 확장성을 제공합니다.
|
|
|
|
## 🏗️ 아키텍처
|
|
|
|
```
|
|
브라우저 → FastAPI (포트 8000) → Express.js API (포트 3005)
|
|
```
|
|
|
|
## 🚀 빠른 시작
|
|
|
|
### 개발 환경
|
|
|
|
```bash
|
|
# 가상환경 생성
|
|
python -m venv venv
|
|
source venv/bin/activate # Windows: venv\Scripts\activate
|
|
|
|
# 의존성 설치
|
|
pip install -r requirements.txt
|
|
|
|
# 서버 실행
|
|
python main.py
|
|
```
|
|
|
|
### Docker 실행
|
|
|
|
```bash
|
|
# 이미지 빌드
|
|
docker build -t tk-fastapi-bridge .
|
|
|
|
# 컨테이너 실행
|
|
docker run -p 8000:8000 tk-fastapi-bridge
|
|
```
|
|
|
|
## 📡 API 엔드포인트
|
|
|
|
### 헬스체크
|
|
- `GET /` - 루트 정보
|
|
- `GET /health` - 전체 시스템 헬스체크
|
|
|
|
### 프록시
|
|
- `ALL /api/*` - Express.js API로 프록시
|
|
|
|
## 🔧 설정
|
|
|
|
`config.py`에서 설정을 변경할 수 있습니다:
|
|
|
|
- `FASTAPI_PORT`: FastAPI 서버 포트 (기본: 8000)
|
|
- `EXPRESS_API_URL`: Express.js API URL (기본: http://localhost:3005)
|
|
- `CORS_ORIGINS`: CORS 허용 오리진
|
|
|
|
## 📊 Phase 1 목표
|
|
|
|
- [x] 기본 FastAPI 설정
|
|
- [x] Express.js API 프록시
|
|
- [x] 헬스체크 및 모니터링
|
|
- [x] Docker 지원
|
|
- [x] CORS 설정
|
|
|
|
## 🔮 다음 단계 (Phase 2)
|
|
|
|
- [ ] 정적 파일 서빙
|
|
- [ ] 단일 포트 통합
|
|
- [ ] Redis 캐싱
|
|
- [ ] 성능 최적화 |