<aside> <img src="/icons/git_gray.svg" alt="/icons/git_gray.svg" width="40px" />

React·FastAPI·MySQL을 Docker Compose로 통합하고 Naver Cloud에 배포

회원·게시글·댓글·추천 기능이 있는 커뮤니티 서비스를 구현하며 브라우저부터 데이터베이스·Linux·네트워크까지 이어지는 전체 흐름을 경험했고, 2026년에는 인증정보·인가·설정 문제를 다시 검토해 공개용 코드를 정리했습니다.

</aside>

<aside> <img src="/icons/plus_gray.svg" alt="/icons/plus_gray.svg" width="40px" />

왜 이 프로젝트를 시작했는가

GamjaWeb 직전에 진행한 2023 뉴스빅데이터 해커톤에서는 짧은 기간 안에 기능을 완성하는 데 집중한 나머지 역할과 책임, 개발 순서, 완료 기준을 명확하게 나누지 못했습니다. 이 경험을 바탕으로 다음 팀 프로젝트에서는 초기에 담당 영역과 협업 방식을 구체적으로 정하고, 각자의 작업을 안정적으로 합칠 수 있는 개발 체계를 만들어 보고 싶었습니다.

마침 2023년 2학기 데이터베이스 과목에서 관계형 데이터베이스를 배웠습니다. 수업에서 익힌 개념을 이론에 그치지 않고 사용자·게시글·댓글·추천을 실제 테이블과 관계로 설계한 뒤 웹 기능으로 구현하며 더 깊이 이해하고자 했습니다.

또한 로컬 환경에서 기능을 구현하는 데서 끝내지 않고, 클라이언트·서버·데이터베이스를 하나의 서비스로 통합해 외부 환경에 직접 배포해 보고 싶었습니다. 브라우저의 요청이 서버와 데이터베이스를 거쳐 응답으로 돌아오고, 완성한 서비스가 외부 사용자에게 제공되기까지의 과정을 경험하며 실제 웹사이트가 작동하는 방식을 배우기 위해 React, FastAPI, MySQL을 Docker Compose로 통합하고 Naver Cloud에 배포하는 GamjaWeb을 시작했습니다.

</aside>

PROJECT OVERVIEW

https://github.com/foxirain/GamjaWeb

핵심 질문 — 클라이언트·서버·데이터베이스·운영체제·네트워크를 어떻게 하나의 서비스로 연결하고, 각 경계에서 어떤 입력과 권한을 신뢰해야 할까?

Project Flow

flowchart LR
	A["Linux·Docker·<br>DB 학습"] --> B["서비스 기능·<br>관계 구조 설계"]
	B --> C["FastAPI API·<br>MySQL 구현"]
	C --> D["React 클라이언트<br>연동"]
	D --> E["Docker Compose<br>통합"]
	E --> F["Naver Cloud<br>배포"]
	F --> G["2026 보안 관점<br>재검토·정리"]

ROLE

Backend Developer · DevOps Contributor

• 담당 역할: 3인 팀에서 MySQL 관계 설계, FastAPI 백엔드 API, React 클라이언트 연동, Docker Compose 실행 환경 구성을 담당했습니다.
• 데이터·백엔드 책임: 사용자·게시글·댓글·추천 관계를 설계하고, JWT 인증과 게시판·댓글·추천·프로필 API를 구현했습니다.
• 통합 책임: React 화면의 요청·응답을 FastAPI와 연결하고, 클라이언트·서버·MySQL을 Docker Compose에서 함께 실행할 수 있도록 구성했습니다.
• 배포 경험: Naver Cloud에서 공인 IP·서비스 포트·인바운드 접근 규칙을 다루며 외부 배포 과정에 참여했습니다.

TECH STACK

React · JavaScript · Python · FastAPI · MySQL · Linux · Docker Compose · Naver Cloud Platform

MY WORK