TODO-HUNTER : ~ RETURN OF SCROLL ~

프로젝트 소개

투두리스트 사용시 현실에서 즉각적인 성장을 체감하기 어려워 습관 형성이 힘든 문제점을 발견하고,
유저 상호작용과 시각적 성장 요소를 추가한 게이미피케이션(gamification) 웹 서비스입니다.

👉 할일 사냥하러 가기! (배포 링크)

• 개발 기간 : 2025.02.14 ~ (진행중)

시작 가이드

git clone https://github.com/ggoldJeongg/todo-hunter
cd todo-hunter
npm install
npm run dev

TEST ID : test / TEST PASSWORD : testcode

version : Typescript 5+ / React 19+ / Next.js 15+ / Node v22.14.0 (25.03.20 기준 LTS)

기술 스택

CATEGORY	SKILLS
FrontEnd
Database & ORM
Deploy
Collaboration

기능 소개

영상	1. 퀘스트 페이지
	- 할일 추가/삭제/완료 반복 여부에 따라 일일 / 주간 할일 지정 - 할일 완료시 카테고리별 스탯, 일일 진행 상태 % 증가 - pixi.js를 활용한 캐릭터 공격 모션 처리

영상	2. 광장
	- pixi.js를 활용한 캐릭터와 npc 상호작용 기능 - 할일 돌림판, 휴식 행동 추천 인터랙티브 npc 구현

영상	3. 캐릭터 페이지
	- 유저의 당일 진척도, 카테고리별 완료 수치를 시각적으로 확인 - 진행률 계산: 오늘 추가된 퀘스트 목록을 조회한 뒤, 완료된 퀘스트 개수를 기반으로 진행률 (%)을 계산하여 반환하는 usecase 구현 - pixi.js를 활용한 할일 완료 정원 가꾸기 기능 구현

영상	4. 칭호 페이지
	- titles 테이블에 저장된 칭호 목록 확인 가능 - 특정 조건 달성시 칭호 획득 가능 - 수집형 컨텐츠를 통해 가변적 보상으로 만족할 수 있도록 함

영상	5. 주간 엔딩 페이지
	- 칭호 조건에 따른 일요일 엔딩 스토리 확인 - 텍스트 + 이미지 처리를 통한 스토리 전달 - 주기적 DB 업데이트 스케줄링: node-cron을 활용하여 특정 요일과 시간에 character 및 status 테이블의 데이터를 자동 업데이트, 주간엔딩 실행

배포 전략

- main repository와 node-cron 구동을 위한 cron repository를 동시 운영을 위해 CI/CD를 구축하여 자동화를 통한 효율적인 배포를 진행함.

관련 링크 : 👉cron-job repository