← 메인으로 돌아가기

📋 사이트 개편 계획

정적 사이트에서 동적 플랫폼으로의 전환 로드맵과 기술 스택

📚 마이그레이션 목차

1. 현재 상황 분석

기존 시스템 현황과 한계점

2. 마이그레이션 단계

6단계 점진적 전환 계획

3. 기술 스택

FastAPI, EKS, PostgreSQL

4. 시스템 아키텍처

EKS 기반 마이크로서비스 구조

5. 진행 상황

실시간 진행률 추적

6. API 엔드포인트

RESTful API 설계

📊 현재 상황 분석

✅ 현재 운영 중인 시스템

  • 플랫폼: AWS S3 정적 웹사이트
  • 페이지 수: 13개 핵심 HTML 페이지
  • 링크 검증: 247개 링크 모두 정상
  • 접근성: https://sac-serviceinfra.emart.com/aiseminar/

⚠️ 현재 시스템의 한계점

  • 동적 콘텐츠 생성 불가능
  • 사용자 상호작용 제한적
  • 실시간 데이터 처리 불가
  • API 기반 확장성 부족

🎯 마이그레이션 단계

Phase 0: 준비 단계

완료
  • ✅ EKS 클러스터 구축
  • ✅ FastAPI 기본 구조 설계
  • ✅ Git 리포지토리 생성
  • ✅ 개발 환경 구성

Phase 1: 백엔드 개발

완료
  • ✅ FastAPI 애플리케이션 개발
  • ✅ 데이터베이스 스키마 설계
  • ✅ 기본 API 엔드포인트 구현
  • ✅ 네트워크 아키텍처 설계 완료
  • ✅ 기존 컨텐츠 마이그레이션 스크립트
  • ✅ Docker 컨테이너화 완료

Phase 2: EKS 인프라 구축

부분 완료
  • ✅ EKS 클러스터 생성 (shr-prd-edustack-cluster-eks)
    • 클러스터 상태: ACTIVE
    • 노드그룹 구성 완료
    • 엔드포인트: EE9BEF57D98426681FCCB02377470C40.gr7.ap-northeast-2.eks.amazonaws.com
  • ✅ 네트워킹 구성 (VPC 서비스 경계 명확화)
    • VPC 및 서브넷 구성 완료
    • 보안 그룹 설정 완료
  • ⏳ 애플리케이션 배포 (미완료)
    • FastAPI 애플리케이션 배포 대기
    • PostgreSQL/Redis StatefulSet 배포 대기
  • ⏳ ALB Ingress Controller 설정

🛠️ 기술 스택

백엔드

FastAPI 0.104.1 SQLAlchemy 2.0.23 PostgreSQL Redis

인프라

Amazon EKS Docker Kubernetes AWS RDS

CI/CD

GitHub Actions ArgoCD Docker Hub Helm Charts

📐 시스템 아키텍처

EduStack 최종 아키텍처 (v10) - HA 구성

EduStack 최종 아키텍처 v10 - HA 구성

🎯 최종 아키텍처 특징

  • VPC 서비스 구분: 외부(S3, CloudFront, WAF) vs 내부(ALB, EKS, NAT Gateway)
  • HA 구성: Multi-AZ Pod 분산 배치 (ap-northeast-2a, 2c)
  • 네트워크 보안: ALB 퍼블릭 서브넷, 워커 노드 프라이빗 서브넷
  • 확장성: Pod Anti-Affinity + Topology Spread Constraints

📚 설계 과정 상세 보기: Docker에서 Kubernetes로: 네트워크 아키텍처 설계 과정
v02부터 v10까지의 진화 과정과 실무 팁을 확인하실 수 있습니다.

📈 진행 상황

Phase 0 (준비 단계)

100%
✅ 완료

Phase 1 (백엔드 개발 + 아키텍처 설계)

100%
✅ 완료

Phase 2 (EKS 인프라 구축)

70%
🔄 부분 완료 - 클러스터 구축 완료, 애플리케이션 배포 대기

🎯 최근 완료 작업

📱 2025.10.31 - 모바일 반응형 UI 개선
  • ✅ TOC 아이템 정렬 최적화 - 아이콘과 텍스트 나란히 배치
  • ✅ 모바일 레이아웃 조정 - 컨테이너 패딩, 헤더 크기 최적화
  • ✅ 플로팅 요소 개선 - 모바일에서도 TOC 표시, 크기 조정
  • ✅ 터치 인터페이스 최적화 - 버튼 크기, 간격 조정
  • ✅ 텍스트 줄바꿈 개선 - word-break: keep-all 적용
🏗️ 2025.10.04 - 네트워크 아키텍처 설계
  • ✅ 네트워크 아키텍처 설계 완료 (v02→v10 진화 과정)
  • ✅ ALB VPC 내부 배치 확정
  • ✅ HA 구성 설계 (Multi-AZ Pod 분산)
  • ✅ VPC 서비스 경계 명확화
  • ✅ 학습 자료 생성: 네트워크 아키텍처 설계 과정

🔌 API 엔드포인트

콘텐츠 관리 API

GET /api/v1/contents
GET /api/v1/contents/{slug}
POST /api/v1/contents
PUT /api/v1/contents/{slug}
DELETE /api/v1/contents/{slug}

분석 및 피드백 API

POST /api/v1/analytics/view
GET /api/v1/analytics/stats
GET /api/v1/analytics/popular
POST /api/v1/feedback
GET /api/v1/feedback/{content_id}
맨 위로
🏠 홈