GM 오락실
personal project

Gunmo's Dev Life

2021년부터 운영 중인 이 사이트(gunmo.my). 포트폴리오이자, 새로 익힌 기술을 직접 적용해 보는 개발 실험장

2021.07 – 운영 중사이트 ↗
메인 화면
메인 화면
2021
운영 시작
17
게임 · 도구
280+
TS 파일 (web + server)
90+
서버 테스트

01개요

Create React App으로 시작한 개인 사이트로, 프로젝트 소개 외에 공부 기록, 방명록, 게임과 도구를 함께 운영하며 새로 배운 기술을 실제 서비스 형태로 적용해 왔습니다.

2026년 9월에 오래된 React 17 · CRA 구조를 Next.js App Router와 TypeScript로 옮겼고, 10월에는 정적 호스팅 + Firestore로 버티던 구조에서 벗어나 Express · socket.io · MongoDB 백엔드를 따로 두고 직접 서버에 올려 운영하는 형태로 바꿨습니다. 온라인 대국의 수 검증, 랭킹 조작 방지, 회원제는 이 구조 위에서 만들었습니다.

02기술 스택

Frontend
Next.js 16 (App Router · 서버 렌더링)React 19TypeScriptTailwind CSS 4
Backend
Node.js 24Express 5socket.iozod
Data / Auth
MongoDBFirebase Authentication (Google · 익명)jose (ID 토큰 검증)
Infra / CI
AWS LightsailDocker ComposeCaddy (HTTPS)GitHub ActionsGHCR
Library
Web Audio APICanvas APIWebRTCchess.jsStockfish (WASM)sql-formatterReact Quill
Tooling
VitestESLintPrettier

03아키텍처

빌드 · 배포
GitHub
main에 push
GitHub Actions
테스트 · 빌드 → 서버 · 프론트 이미지를 GHCR에
AWS Lightsail
SSH로 접속해 새 이미지로 교체
런타임
브라우저
로그인은 Firebase Auth
Caddy
HTTPS · 경로별 분기
Next 서버
페이지 서버 렌더링 · 공유 이미지
API 서버
REST(/api) + socket.io
MongoDB
글 · 랭킹 · 대국 · 회원

격투게임의 경기 입력만 브라우저끼리 WebRTC로 직접 주고받고, 연결이 안 되면 API 서버가 중계합니다. DOODLE PARTY · 격투의 방 상태는 서버 메모리에, 대국은 MongoDB에 둡니다.

04주요 기능

메인 · 포트폴리오

  • 메인: 메뉴(study · games · tools · devtools)에 있는 것들을 한 화면에 펼쳐 보여 주고, 최근 글을 서버에서 바로 그림
  • 포트폴리오: team · personal · games, 이름을 고르면 옆에 미리보기. 프로젝트마다 상세 페이지(/infoPage/[idx])
  • 사이트 검색(Ctrl+K): 메뉴 이름 일부 · 초성 · 설명으로 바로 이동
포트폴리오
포트폴리오
프로젝트 상세
프로젝트 상세

게임 9종

  • PIXEL Rhythm Up(4키 · 7키 리듬게임) · PIXEL FIGHT(1:1 격투) — 포트폴리오 games에서 따로 소개
  • 온라인 체스 · 장기 · 오목: 방을 만들어 실시간 대국 · 관전 · 채팅, AI 랭킹전
  • DOODLE PARTY: 최대 8명 그림 파티게임 — 그림 맞히기 · 가짜 화가 · 그림 릴레이
  • 멜론 게임(Canvas 드래그 퍼즐, 2분 타임어택) · 지뢰찾기(지뢰 99개) · 반응속도 테스트
  • 휴대폰: 터치 조작, 멜론 게임은 화면 폭에 맞춰 배율 고정
멜론 게임
멜론 게임
지뢰찾기
지뢰찾기
PIXEL Rhythm Up
PIXEL Rhythm Up

온라인 대국 (체스 · 장기 · 오목)

  • 수는 서버가 검증해서 저장 — 브라우저를 고쳐도 반칙 수를 둘 수 없음. 장기 · 오목 규칙 엔진은 직접 구현해 프론트와 서버가 같은 파일을 씀
  • 방 생성 · 참여 · 관전, 제한 시간 · 추가 시간 · 선후공, 무르기 · 무승부 제안 · 기권, 비밀번호 방, 다시 하기
  • socket.io 연결 하나로 요청(rpc)과 구독(sub)을 처리, 끊겼다 붙으면 보고 있던 것을 자동으로 다시 구독
  • 로그인(익명 포함) uid로 자리를 기억해 새로고침 · 서버 재시작 뒤에도 같은 자리에서 이어 둠
  • AI 상대: 체스는 Stockfish(WASM), 장기 · 오목은 직접 만든 탐색. 이기면 점수로 랭킹 등록
온라인 체스
온라인 체스

회원 · 랭킹

  • Google 로그인 + 별명(중복 불가 · 변경 가능). 로그인 없이도 모든 게임을 할 수 있고, 비회원 이름은 따로 표시
  • 회원은 랭킹 · 방명록 · 온라인 게임에 별명이 자동으로 들어가고, 기록은 결과 화면에서 자동 등록
  • 게임하던 익명 계정을 그대로 Google 계정으로 올려, 가입 전에 남긴 기록과 앉아 있던 자리가 이어짐
  • 내 정보: 게임별 최고 기록과 순위, 온라인 전적, 방문 횟수
  • 랭킹 조작 방지: 게임 시작 때 받은 1회용 티켓 + 그 기록이 나오려면 걸리는 시간 확인 + 점수 재계산, 한 사람당 최고 기록 하나

도구 (tools · devtools)

  • 사다리타기: 결과 칸 위치를 매번 섞어 누구든 확률 1/n, 룰렛: 결과를 먼저 뽑고 그 칸에 멈추도록 회전량 계산
  • 칼로리 계산기: 식약처 식품영양성분 DB 2만여 개 검색 · 식단 합계, 대표 음식 535개는 개별 페이지
  • JSON Formatter, 정규식 테스터, MyBatis 로그 → SQL, DDL → Java DTO · resultMap · Mapper, JSON → Java DTO
  • 입력은 브라우저 밖으로 나가지 않음. 난수는 crypto.getRandomValues로 편향 없이
사다리타기
사다리타기
룰렛
룰렛
칼로리 계산기
칼로리 계산기
MyBatis 로그 → SQL 변환기
MyBatis 로그 → SQL 변환기

개인 공부 · 회고 · 아카이브

  • 관리자 계정으로 로그인하면 React Quill 에디터로 글 작성 · 수정 · 삭제
  • 글 목록과 글 페이지는 요청 때 서버에서 그려 검색엔진에 그대로 노출 (BlogPosting 구조화 데이터)
  • 서버가 글 목록을 60초 캐시하고, 글이 바뀌면 백엔드가 Next 서버에 알려 바로 비움
  • 아카이브: 사이트 변경 이력 · 프로젝트 · 실무를 타임라인으로 기록
아카이브
아카이브

관리자 · 방명록 · 공통 UI

  • 관리자 대시보드: 문의함(읽음 관리 · 메일 답장), 글 관리, 방명록 · 대국 방 정리
  • 방명록: 포스트잇 보드, 새 글이 실시간으로 올라옴
  • 푸터 방문자 수 · 달력 · 시계, 플로팅 퀵메뉴, 문의하기, 공통 모달(ESC · 뒤로가기로 닫기)
  • 페이지마다 제목 · 설명으로 그려 주는 공유 미리보기 이미지(/og/…)
모바일 화면
모바일 화면

052026년에 바꾼 것

2026.09 — CRA → Next.js · TypeScript

  • React 17 · Create React App 구조를 Next.js App Router로 재구성
  • 전체 소스를 .ts/.tsx로 전환, 데이터 계층에 타입 정의
  • 페이지별 title · description · canonical, sitemap, JSON-LD
  • 스타일을 Tailwind CSS 중심으로 이전, ESLint · Prettier 도입

2026.10 — 백엔드 분리

  • 브라우저가 Firestore에 직접 읽고 쓰던 것을 Express API + MongoDB로
  • 화면 코드는 그대로 두고 데이터 함수의 이름 · 인자를 유지한 채 안쪽만 교체
  • 실시간(대국 · 채팅 · 방명록)은 socket.io 게이트웨이 하나로
  • Firebase는 로그인(Auth)만 남기고, 서버가 ID 토큰을 공개키로 검증

2026.10 — 정적 사이트 → 서버 운영

  • 정적 export + GitHub Pages에서 Next 서버 모드 + AWS Lightsail로 이전 (gunmo.my)
  • Docker Compose: MongoDB · API 서버 · Next 서버 · Caddy(HTTPS 자동)
  • 예전 주소는 페이지마다 새 주소로 넘기는 안내 페이지를 남김
  • 매일 DB 백업, 메모리 부족 대비 스왑

빌드 · 배포 자동화

  • GitHub Actions: 서버 타입 검사 · 테스트(MongoDB 서비스), 프론트 린트 · 타입 검사 · 빌드
  • main에 올리면 서버 · 프론트 이미지를 만들어 GHCR에 올림
  • 이어서 SSH로 서버에 접속해 새 이미지로 교체

06트러블슈팅

랭킹 점수를 요청만 꾸며서 넣을 수 있음

문제
점수는 브라우저에서 계산되므로, 게임을 하지 않고 등록 요청만 보내도 랭킹에 올라감
원인
서버는 형식과 범위만 검사하고, 실제로 게임을 했는지는 알 방법이 없었음
해결
게임을 시작할 때 1회용 티켓을 발급하고, 등록할 때 티켓을 받은 뒤 그 기록이 나올 만큼 시간이 지났는지 확인. AI 대국 점수는 같은 공식으로 다시 계산하고, 리듬게임은 채보의 노트 수와 대조

익명으로 놀다가 로그인하면 기록이 끊김

문제
게임은 익명 로그인으로 하는데, Google로 로그인하면 다른 계정이 돼서 앉아 있던 대국 자리와 남긴 기록을 잃음
원인
익명 계정과 Google 계정의 uid가 서로 다름
해결
익명 계정에 Google 계정을 연결(link)해 uid를 그대로 유지. 이미 가입한 Google 계정이면 그 계정으로 로그인하고, 소켓은 같은 연결에서 다시 인증

글을 고쳐도 한동안 예전 내용이 보임

문제
서버 렌더링 캐시 때문에 글을 쓰거나 고친 직후에는 목록 · 사이트맵에 반영되지 않음
원인
Next 서버가 글 목록을 60초 동안 다시 쓰도록 캐시
해결
글이 바뀌면 백엔드가 Next 서버의 내부 주소로 알려 캐시를 바로 비움. 이 주소는 프록시에서 바깥 접근을 막고 비밀값으로 확인

칼로리 계산기 빌드 결과물이 581MB

문제
음식 3,600개를 개별 페이지로 만들었더니 배포 용량이 감당할 수 없이 커짐
원인
정적 export는 페이지마다 공통 레이아웃 데이터(약 150KB)를 HTML에 함께 담음
해결
여러 조사에 공통으로 나오는 대표 음식 · 분류별 대표 원재료만 골라 535개로 줄이고, 나머지는 검색으로 제공 → 115MB

개발 모드에서 저장한 설정이 기본값으로 초기화

문제
새로고침하면 리듬게임 싱크 등 localStorage에 저장한 값이 기본값으로 돌아감
원인
StrictMode에서 effect가 두 번 실행되면서, 복원 effect가 반영되기 전에 저장 effect가 기본값을 먼저 덮어씀
해결
복원이 끝났다는 hydrated 상태를 두고 그 이후에만 저장하도록 8개 컴포넌트 수정

모바일에서 지뢰찾기 첫 탭에 페이지가 죽음

문제
세로 화면에서 칸을 누르는 순간 'This page couldn't load'가 뜸
원인
첫 렌더는 가로(20x24) 기준으로 상태 배열을 만들고, 마운트 후 세로(24x20) 크기로 지뢰를 깔아 존재하지 않는 행을 읽음
해결
판 크기를 상태로 관리하고 게임 시작 전에만 화면 방향에 맞춰 빈 판과 함께 다시 만들도록 변경

모바일에서 멜론 게임이 거의 원본 크기로 보임

문제
화면 폭에 맞춰 축소하도록 했는데 폰에서는 게임판이 화면 밖으로 넘침
원인
1030px 캔버스가 먼저 그려지면서 모바일 브라우저가 레이아웃 폭을 넓혀버려, window.innerWidth가 실제 화면보다 큰 값으로 나옴
해결
overflow:hidden 컨테이너의 폭으로 최초 1회 배율을 정해 transform으로 축소하고, 좌표는 캔버스 표시 크기 기준으로 환산해 포인터(터치) 이벤트로 처리

룰렛을 두 번째 돌리면 회전이 순식간에 끝남

문제
두 번째 판부터 회전이 확 빨라지고 최근 결과가 한 번에 여러 개 쌓임
원인
당첨 강조를 풀 때 각 칸의 opacity 전환이 끝나며 발생한 transitionend가 휠까지 버블링돼 '회전 끝'으로 처리됨
해결
이벤트 대상이 휠 자신이고 속성이 transform일 때만 회전 종료로 처리

모달을 닫은 직후 페이지 이동이 되돌려짐

문제
모바일 뒤로가기로 닫히도록 쌓아둔 히스토리를 정리하는 과정에서 직후의 router.push가 취소됨
원인
모달 cleanup의 history.back()이 호출부의 이동보다 늦게 처리됨
해결
히스토리 정리(popstate)가 끝난 뒤에 모달 Promise를 resolve하도록 순서를 보장

게임 랭킹의 저장형 XSS

문제
랭킹 이름에 HTML을 넣으면 방문자 브라우저에서 그대로 실행될 수 있음
원인
저장된 사용자 입력을 innerHTML로 삽입
해결
DOM 노드를 생성해 textContent로 삽입하도록 변경

07연혁

  1. 2021.07Create React App으로 개발 시작, GitHub Pages 배포
  2. 2021.08멜론 게임 제작
  3. 2024.12프로젝트 상세·소개·방명록·아카이브 페이지 구성
  4. 2025.01사이트 전면 리디자인, 퀵메뉴·Contact 모달 추가
  5. 2025.05개인공부 게시판, 지뢰찾기 추가
  6. 2026.09Next.js · TypeScript 전면 리뉴얼, SEO·배포 자동화, 온라인 체스·도구·관리자 대시보드, 리듬게임 첫 공개
  7. 2026.10장기 · 오목 · 스케치 퀴즈 · PIXEL FIGHT 추가, 리듬게임을 BEAT DASH로 개편, 칼로리 계산기 · devtools 변환기
  8. 2026.10백엔드(Express · socket.io · MongoDB) 분리, AWS 서버로 이전하고 주소를 gunmo.my로, 랭킹 조작 방지 · 회원제 · 메인 개편
전체 개발 기록 보기 →
Gunmo Lee
since 2021.07