Files
tk-factory-services/system1-factory/fastapi-bridge
Hyungi Ahn 6495b8af32 feat: SSO 쿠키 인증 통합 + 서브도메인 라우팅 아키텍처
- Path-based 라우팅을 서브도메인 기반으로 전환
  (tkfb/tkreport/tkqc.technicalkorea.net)
- 3개 시스템 프론트엔드에 SSO 쿠키 인증 통합
  (domain=.technicalkorea.net, localStorage 폴백)
- Gateway: 포털+로그인+System1 프록시, 쿠키 SSO 설정
- System 1: 토큰키 통일, nginx.conf 생성, 신고페이지 리다이렉트
- System 2: api-base.js/app-init.js 생성, getSSOToken() 통합
- System 3: TokenManager 쿠키 지원, 중앙 로그인 리다이렉트
- docker-compose.yml에 cloudflared 서비스 추가
- DEPLOY-GUIDE.md 배포 가이드 작성

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-09 18:41:44 +09:00
..

FastAPI 브릿지

📋 개요

Technical Korea 생산팀 포털의 FastAPI 브릿지입니다. Express.js API의 성능을 향상시키고 확장성을 제공합니다.

🏗️ 아키텍처

브라우저 → FastAPI (포트 8000) → Express.js API (포트 3005)

🚀 빠른 시작

개발 환경

# 가상환경 생성
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 의존성 설치
pip install -r requirements.txt

# 서버 실행
python main.py

Docker 실행

# 이미지 빌드
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 목표

  • 기본 FastAPI 설정
  • Express.js API 프록시
  • 헬스체크 및 모니터링
  • Docker 지원
  • CORS 설정

🔮 다음 단계 (Phase 2)

  • 정적 파일 서빙
  • 단일 포트 통합
  • Redis 캐싱
  • 성능 최적화