• 목차
• 📘 Mangement Cloud server FastAPI 프로젝트
  • 🟦 Epic 1 — FastAPI 프로젝트 구조 설계
  • 🟦 Issue 2 — Django 모델 분석 및 FastAPI 모델 변환 계획
  • 🟦 Issue 3 — FastAPI 기본 서버 구축
  • 🟦 Issue 4 — PostgreSQL 연결 및 SQLAlchemy 모델 생성
  • 🟦 Issue 5 — MQTT Worker 독립 프로세스 설계
  • 🟦 Issue 6 — Reverse SSH 구조 설계
  • 🟦 Issue 7 — AlmaLinux 서버 2대 구성 계획
  • 🟦 Issue 8 — journald / systemd 최적화 계획
  • 🟦 Issue 9 — Django → FastAPI 마이그레이션 체크리스트 작성
  • 🟦 Issue 10 — 전체 아키텍처 문서화

📘 Mangement Cloud server FastAPI 프로젝트¶

🟦 Epic 1 — FastAPI 프로젝트 구조 설계¶

트래커: Task
카테고리: FastAPI 서버 개발

설명:

• FastAPI 기반 mgmt 서버의 전체 디렉토리 구조를 설계한다.
• app / worker / routers / models / core 구조 정의
• Gitea 저장소 생성
• PyCharm 개발 환경 준비
• 기본 실행 구조(main.py) 설계

🟦 Issue 2 — Django 모델 분석 및 FastAPI 모델 변환 계획¶

트래커: Task
카테고리: Django → FastAPI 마이그레이션

설명
기존 Django ORM 모델을 분석하고 SQLAlchemy 모델로 변환 계획을 수립한다.

ServerMaster

ServerStatus

ServerControl

ServerDetail

JSONField → PostgreSQL JSONB 변환

관계(OneToOne, ForeignKey) 매핑 방식 정의

🟦 Issue 3 — FastAPI 기본 서버 구축¶

트래커: Feature
카테고리: FastAPI 서버 개발

설명
FastAPI 기본 서버를 구축한다.

/ping

/server/list

/server/status/{hostname}

uvicorn 실행 테스트

test_main.http 테스트

🟦 Issue 4 — PostgreSQL 연결 및 SQLAlchemy 모델 생성¶

트래커: Feature
카테고리: DB(PostgreSQL)

설명
PostgreSQL 연결 및 SQLAlchemy 모델을 생성한다.

DB 연결 테스트

SQLAlchemy Base 생성

모델 매핑

JSONB 필드 테스트

🟦 Issue 5 — MQTT Worker 독립 프로세스 설계¶

트래커: Feature
카테고리: MQTT Worker

설명
MQTT worker를 FastAPI와 분리된 독립 프로세스로 설계한다.

asyncio-mqtt 사용

메시지 수신 구조 설계

DB 업데이트 방식 결정

FastAPI와 연동 방식 정의(API 호출 vs DB 직접 업데이트)

🟦 Issue 6 — Reverse SSH 구조 설계¶

트래커: Task
카테고리: Reverse SSH

설명
Reverse SSH 기능을 FastAPI에서 제어할 수 있도록 구조를 설계한다.

포트 관리

세션 관리

FastAPI 제어 API 설계

로컬 테스트 플로우 정의

🟦 Issue 7 — AlmaLinux 서버 2대 구성 계획¶

트래커: Task
카테고리: 서버 분리(1GB × 2대)

설명
서버를 2대로 분리하고 1GB 메모리 기준으로 최적화한다.

mgmt + worker 서버

lotto + pwa 서버

systemd 서비스 구성

메모리 최적화 계획

🟦 Issue 8 — journald / systemd 최적화 계획¶

트래커: Task
카테고리: AlmaLinux 환경 구성

설명
AlmaLinux에서 journald 및 systemd 최적화를 수행한다.

journald 메모리 제한

로그 로테이션

systemd 서비스 파일 설계

gunicorn/uvicorn 서비스 구성

🟦 Issue 9 — Django → FastAPI 마이그레이션 체크리스트 작성¶

트래커: Task
카테고리: Django → FastAPI 마이그레이션

설명
Django에서 FastAPI로 전환하기 위한 전체 체크리스트를 작성한다.

기능 비교

API 매핑

DB 스키마 비교

MQTT 로직 분리

reverse SSH 기능 이전

배포 플로우 정의

🟦 Issue 10 — 전체 아키텍처 문서화¶

트래커: Documentation
카테고리: 문서화

설명
FastAPI mgmt 서버 + MQTT worker + PostgreSQL + reverse SSH + 서버 분리 구조를 문서화한다.

전체 아키텍처 다이어그램

데이터 흐름

서버 구성

배포 전략

운영 가이드