본문으로 건너뛰기

런칭스프린트] 할 일을 게임처럼, Questly 주간 보스 시스템 만들기

서진

2026.08.12

소개

Questly는 할 일을 퀘스트처럼 완료하고, XP와 능력치를 성장시키며 매주 보스를 쓰러뜨리는 생산성 게임입니다.

초기에는 앱 구조와 데이터 모델을 정리하고, Auth와 Firestore를 연결한 뒤 브라우저가 아니라 서버가 progression을 결정하는 구조로 전환했습니다.

현재는 주간 보스 시스템의 핵심 개발을 거의 마치고, 실제 배포 전 UX를 다듬는 단계입니다.

진행 방법

전체 개발은 다음 흐름으로 진행했습니다.

제품 구조 정리
→ Auth
→ Firestore
→ localStorage 마이그레이션
→ 서버 기반 progression
→ 주간 사이클
→ 주간 보스
→ 보스 HP / 요구조건
→ Complete / Undo
→ 보스 UI / 기록 / 카운트다운
→ 보안 및 회귀 테스트
→ UX 개선

가장 중요한 변화는 퀘스트 완료, XP 지급, 능력치 성장, 보스 데미지, Undo 같은 핵심 로직을 브라우저가 아니라 서버에서 처리하도록 만든 것입니다.

브라우저 요청
→ 서버 검증 및 계산
→ Firestore 반영
→ 브라우저는 서버 결과를 표시

덕분에 클라이언트가 임의로 progression 값을 변경하기 어려운 구조를 만들 수 있었습니다.

오늘 진행한 작업

오늘은 주간 보스 기능을 단순히 동작하는 상태에서 실제로 사용할 수 있는 수준으로 다듬는 작업에 집중했습니다.

실제 주간 보스를 UI에 연결하고 다음 정보를 표시했습니다.

  • 현재 HP와 총 HP

  • 누적 데미지

  • 공격 가능한 능력치

  • 승리 조건

  • 남은 시간

  • 처치 상태

  • 과거 보스 기록

직접 플레이하면서 자동 테스트만으로는 찾지 못했던 문제도 발견했습니다.

예를 들어 보스가 아직 살아 있는데도 Defeated라고 표시되는 문제와 날짜가 중복되는 문제를 수정했습니다.

실제 퀘스트를 완료했을 때도 보스 HP가

128 / 128
→ 108 / 128
→ 68 / 128

처럼 정상적으로 줄어드는 것을 확인했습니다.

성능 개선

퀘스트 완료 후 화면이 약 2초 정도 늦게 갱신되는 문제도 있었습니다.

기존에는 서버 처리 후 Firestore 전체 데이터를 다시 불러왔습니다.

Complete
→ 서버 처리
→ Firestore 전체 reload
→ UI 갱신

이를 다음과 같이 변경했습니다.

Complete
→ "Completing..." 표시
→ 서버 처리
→ 서버가 최신 값을 반환
→ UI에 바로 반영

서버가 최종 값을 결정하는 구조는 유지하면서 불필요한 네트워크 요청을 줄였습니다.

Undo도 같은 방식으로 개선했습니다.

어려웠던 점

가장 큰 문제 중 하나는 boss가 존재하지 않을 수 있도록 모델을 바꾸면서 기존 코드의 가정이 여러 곳에서 깨진 것이었습니다.

Today, AppContext, migration, Firestore 복원 코드와 기존 테스트까지 영향을 받았습니다.

또 AI 개발 도구가 테스트를 PASS라고 보고했지만 실제로는 테스트 명령이 정상 실행되지 않은 경우도 있었습니다.

그래서 이후에는 다음 방식으로 검증했습니다.

AI가 구현
→ 직접 테스트 명령 실행
→ 실제 결과 확인
→ 문제가 없을 때만 commit

기존 테스트가 오래된 보스 HP 규칙을 사용하고 있거나, TypeScript가 약한 fixture와 잘못된 타입 가정을 잡아내는 문제도 반복해서 수정했습니다.

결과와 배운 점

이번 단계에서 가장 크게 느낀 것은 안전한 구조를 만드는 것과 좋은 UX를 만드는 것은 다른 문제라는 점입니다.

서버 중심 구조를 만들면서 보안과 데이터 정확성은 좋아졌지만, 그 과정에서 속도가 느려질 수 있었습니다.

그래서 브라우저에서 XP나 보스 데미지를 임의 계산하는 대신, 서버가 계산한 결과를 바로 UI에 반영하는 방식으로 보안과 속도의 균형을 맞췄습니다.

또 자동 테스트가 로직을 확인해준다면, 실제 플레이는 화면과 경험의 어색함을 발견해준다는 것도 확인했습니다.

현재는 다음 세 가지 UX를 마지막으로 다듬고 있습니다.

  • 능력치 레벨과 XP 진행도 표시

  • Plan 화면의 Completing / Undoing 상태

  • 실제 밸런스를 바꾸지 않고 final 1 HP gate를 테스트하는 기능

앞으로의 계획

주간 보스 시스템을 production에 배포한 뒤에는 다음 기능들을 순차적으로 확장할 계획입니다.

주간 보스 출시
→ 일정 관리 / 계획 기능 강화
→ 결제 시스템
→ 한국어 / 영어 다국어 시스템
→ 공개 웹사이트
→ SEO
→ AI 기반 계획 기능
→ PWA / 모바일 베타
→ 네이티브 모바일 확장

특히 앞으로는 결제 시스템, 한국어·영어 다국어 지원, SEO와 공개 웹사이트를 추가하면서 Questly를 개인 개발 프로젝트에서 실제 서비스로 확장해갈 예정입니다.

이번 작업을 한 문장으로 정리하면 다음과 같습니다.

이전에는 Questly를 안전하고 정확하게 만드는 데 집중했다면, 이제는 그 구조를 실제로 빠르고 재미있게 느껴지는 제품으로 만드는 단계에 들어왔습니다.

함께 이야기해요 0

로그인하고 댓글을 남겨 주세요

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기