런칭스프린트] 할 일을 게임처럼, 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를 안전하고 정확하게 만드는 데 집중했다면, 이제는 그 구조를 실제로 빠르고 재미있게 느껴지는 제품으로 만드는 단계에 들어왔습니다.


