jacehub/데일리 퀘스트
최근 수정 시각: 2026-07-11 00:13:16
1. 무엇을 하나
데일리 퀘스트는 앱에서 발생한 행동 이벤트를 오늘의 목표로 집계한다. 목표 1회는 단순 완료로, 2회 이상은 횟수형 목표로 동작한다. 각 퀘스트에는 오늘의 현재 횟수, 목표 횟수, 완료 상태, 연속 달성일과 최근 21일 잔디가 표시된다.
2. 준비하기
퀘스트 화면은 현재 브라우저의 jacehub 보관소 PIN과 즐겨찾기 목록을 사용한다.
- jacehub/크레덴셜에서 보관소를 저장하거나 불러온다.
- jacehub/프로젝트 대시보드에서 퀘스트를 만들 앱을 즐겨찾기에 추가한다.
- 상단 퀘스트 링크 또는 퀘스트 주소로 이동한다.
PIN이 없으면 화면 상단에 “허브에서 보관소를 먼저 연결하세요”라는 안내가 보이고 기존 진행 데이터는 불러오지 않는다.
3. 퀘스트 만들기
- 앱에서 즐겨찾기 앱을 고른다.
- 행동을 고른다. 현재 rituall은
아침 의식 완료,저녁 의식 완료가 이름 있는 선택지로 제공된다. - 앱 안의 아무 이벤트나 세려면 앱 단위 — 아무 행동이나를, 별도 이벤트명을 쓰려면
직접 입력…을 고른다. - 제목을 적고 목표 횟수를 1·2·3·5·7·10회 중에서 선택한다.
- 추가를 누른다.
이름 있는 행동을 고르면 제목이 비어 있을 때 행동 라벨이 자동 제안된다. 생성된 퀘스트는 앱별 그룹으로 나타나며 삭제는 확인창을 거쳐 퀘스트와 연결된 일별 진행 데이터를 함께 지운다.
4. 진행이 쌓이는 방식
연동 앱은 행동이 일어날 때 POST /api/ingest로 앱 이름과 선택적 이벤트 타입을 보낸다. 서버는 KST 날짜를 기준으로 같은 앱·행동의 활성 퀘스트를 찾고 원시 이벤트와 일별 집계를 함께 기록한다. 목표 횟수에 도달하면 그날이 완료 처리된다.
앱 단위 퀘스트는 이벤트 타입과 무관하게 해당 앱의 행동을 센다. 특정 행동 퀘스트는 이벤트 타입이 정확히 일치할 때만 증가한다. 화면을 연 상태에서 이벤트가 발생했다면 새로고침해 최신 집계를 확인한다.
5. 팁과 주의
- 날짜 경계는 KST다. 자정 전후 활동은 서버가 받은 시각을 KST로 바꿔 해당 날짜에 넣는다.
- 현재 화면의 이름 있는 행동 카탈로그는 rituall 중심이다. 다른 앱 이벤트는
직접 입력…으로 만들 수 있지만 연동 앱이 같은 문자열을 보내야 한다. - 스트릭은 완료된 날짜가 연속한 수다. 일부 진척만 있는 날은 잔디에 약하게 표시되지만 스트릭에는 포함되지 않는다.
- PIN은 개인용 편의 인증이다. 강한 계정 인증으로 간주하지 않는다.