Files
tk-factory-services/system1-factory/fastapi-bridge/README.md
Hyungi Ahn 550633b89d feat: 3-System 분리 프로젝트 초기 코드 작성
TK-FB(공장관리+신고)와 M-Project(부적합관리)를 3개 독립 시스템으로
분리하기 위한 전체 코드 구조 작성.
- SSO 인증 서비스 (bcrypt + pbkdf2 이중 해시 지원)
- System 1: 공장관리 (TK-FB 기반, 신고 코드 제거)
- System 2: 신고 (TK-FB에서 workIssue 코드 추출)
- System 3: 부적합관리 (M-Project 기반)
- Gateway 포털 (path-based 라우팅)
- 통합 docker-compose.yml 및 배포 스크립트

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-09 14:40:11 +09:00

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 캐싱
- [ ] 성능 최적화