집중과 보상
상태: 현재 구현 기준 정리 · 최종 수정: 2026-11-01
TO WORK에는 진행 중 태그 선택과 집중 제목, 완료 결과를 2단계로 구성하는 후속 UI 요구사항을 별도로 기록했다. 이 문서의 시작 시 태그 고정·기존 결과 이동 설명은 현재 구현의 기록이다. 후속 구현에서는 태그 변경의 저장·기록 반영을 함께 다루되, 기존 추첨·정산의 중복 방지 계약은 유지한다.
집중 준비
섹션 제목: “집중 준비”- 시간 범위는 10~180분, 5분 단위다. 처음 실행 기본값은 15분이며 빠른 선택은 15·25·45·60·90분이다.
- 기본 태그는 업무·공부·독서·창작·운동·기타다. 사용자 태그는 중복되지 않는 1~30자 이름으로 관리한다.
- 일반 타이머와 보호 집중을 제공한다. 보호 모드는 시작 시 권한과 필요한 보정 상태를 확인한다.
- 진행 중 새 세션은 시작할 수 없다. 탭 이동 후 돌아오면 진행 화면으로 복귀한다.
시작 시 고정하는 것
섹션 제목: “시작 시 고정하는 것”장소·목표 시간·태그·모드·기준정보 사본과 버전·낚싯대·미끼·보너스·시작 주야간을 보존한다. 이후 장착이나 기준정보를 바꾸어도 진행 중 집중의 추첨·정산은 달라지지 않는다.
집중 시간은 단조 시계로 계산하고 잠금·복귀 시 재동기화한다. 보호 집중은 비허용 앱·들어 올림 경고의 유예와 통화 일시정지·허용 앱 예외를 유지한다. 알림 권한 거절만으로 기본 타이머를 막지 않는다. 프로세스 재시작으로 진행을 검증할 수 없는 세션은 정상 성공 보상으로 처리하지 않는다.
정상 완료와 중복 방지
섹션 제목: “정상 완료와 중복 방지”- 선택 지역의 12종을 기준정보 가중치와 고정한 장비 효과로 추첨한다.
- 한 로컬 DB 트랜잭션에서 세션 종료·획득 결과·누적 획득·전시 수량·도감·코인·미끼 소비·저장 대기를 반영한다.
- 결과를 확인하고 해당 수족관으로 이동한다. 같은 세션을 다시 열거나 저장을 재시도해도 재추첨·중복 지급하지 않는다.
기본 종별 weight=1, 성공 기본 보상은 10코인이다. 장비 효과가 0이면 해당 지역 12종 각각의 확률은 1/12이다. 희귀도 이름이 기본 종 확률 차등을 뜻하지 않는다. 장비 확률 효과가 있으면 해당 효과를 적용한다.
전시 수량은 종별 상한까지만 늘어난다. 상한에 도달한 종을 또 잡아도 누적 획득과 코인은 늘며, 다른 종을 다시 뽑지 않는다. 실패·취소·검증 불가에는 성공 보상을 만들지 않는다. 취소한 집중은 사용자 기록·통계·보상에서 제외하며 이미 종료된 성공 결과를 취소로 바꾸지 않는다.
5시간 주야간
섹션 제목: “5시간 주야간”기준점은 2026-10-24 15:00 UTC = 2026-10-25 00:00 한국 시각의 낮 시작이다. 낮 5시간 → 밤 5시간을 계속 반복한다. 실행·자정에 초기화하거나 사용자 기기의 현지 일출·일몰로 바꾸지 않는다.
| 한국 시각 예시 | 시간대 |
|---|---|
| 2026-10-25 00:00~04:59 | 낮 |
| 2026-10-25 05:00~09:59 | 밤 |
| 2026-10-25 10:00~14:59 | 낮 |
집중 중 경계를 넘어도 결과 확인까지 시작 시간대를 유지한다. 완료 결과를 확인한 뒤 현재 시간대로 돌아간다. 시간대가 종별 획득 확률이나 3D 수조 조명을 바꾸지는 않는다.
오프라인과 저장
섹션 제목: “오프라인과 저장”앱은 번들·캐시를 먼저 사용하고 프로세스당 기준정보 조회를 한 번 시도한다. 변경 상태는 전경 2분 주기와 백그라운드 진입 때 모아 저장한다. 로컬 보상은 서버 승인 대기 상태가 아니다.
서버는 설치 인증, 기준정보 조회, 게임 상태·종료 기록 요약 저장을 담당한다. 집중 시작/완료 검증 API나 서버 추첨을 추가하지 않는다. revision 또는 상태 버전 충돌에서는 로컬 데이터를 보존하고 자동 반복을 멈춘다. 계정 복원·자동 다중 기기 병합은 별도 범위다.