구현 현황과 남은 과제
상태: 현재 구현 기준 정리 · 최종 수정: 2026-11-01
확인 기준
섹션 제목: “확인 기준”이 문서의 현재 구현은 2026-11-01 저장소 338b46a를 기준으로 한다. 코드에서 확인한 동작, 과거 결과 노트의 검증, 이번 문서 사이트 검증을 구분한다. 운영 서버·실제 앱의 최신 배포 상태를 점검한 보고서가 아니다.
| 영역 | 저장소에서 확인한 상태 | 대표 근거 |
|---|---|---|
| 탐색 | 첫 화면 집중, 하단 5탭과 상단 보조 화면, 탭 상태 유지 | lib/app_router.dart |
| 집중 | 시간·태그·세션 고정·주야간과 로컬 정산 | lib/focus/, lib/storage/, lib/fishing/ |
| 경제 | 상품 10개, 확률 bps·코인 잔여·미끼 예약/소비 | shared/game-config.v2.json, AGENTS.md |
| 수집 | 네 지역 48종·종별 상한·임시 전시와 실제 보유 분리 | shared/catalog.json, AGENTS.md |
| 연출 | 주간 계곡·산호·북극 동적 장면, 그 외 정적 경로 | FishingSceneKind.forScene |
| 저장 | 로컬 우선, 익명 설치 인증·상태/기록 요약 동기화 | backend/README.md |
과거 검증 기록
섹션 제목: “과거 검증 기록”- 계곡 1인칭 통합 결과는 전체 Flutter 테스트 461개 통과, 분석 정상과 웹 미리보기 테스트 결과를 기록했다.
- 산호 1인칭 적용 결과는 전체 Flutter 테스트 467개 통과, 웹 빌드와 네이티브 엔진 캡처를 기록했다. 후속 물고기·빛 개선은 별도 결과 노트에 있다.
- 북극 1인칭 결과는 전체 Flutter 테스트 478개 통과, 분석 정상과 native/Canvas 렌더링 계약 검사를 기록했다.
위 숫자는 각 과거 작업 시점의 기록이며 이번 문서 작업에서 앱 테스트 478개를 다시 실행했다는 뜻이 아니다. 네이티브 Flutter 엔진 캡처도 Android/iOS 실기기 촬영·실제 FPS 측정과 구분한다.
남은 과제
섹션 제목: “남은 과제”UI 담당자가 작업할 태그·집중 제목·완료 화면은 TO WORK — 집중 UI 작업 목록을 따른다. Forest 스크린샷 7장과 새 요구사항을 대응했으며, 앱 구현이나 기기 검증이 완료된 목록은 아니다.
| 항목 | 현재 한계·재현 조건 | 후속 확인 |
|---|---|---|
| 투과 모서리 이음선 | 고품질 3배 확대에서 생물이 잘리거나 두 겹처럼 보임 | 공용 물 셰이더와 심해 고정 표현을 함께 보존하며 조사 |
| 처음 가는 수조 전환 | S22 Ultra 과거 측정에서 첫 전환 지연 | 이득 대비 비용으로 예열 보류, 새 실측 시 조건 명시 |
| 계곡 웹 잎 | CanvasKit 미리보기에서 잎 검은 표시 | 네이티브 정상과 구분해 웹 sampler 경로 조사 |
| 실제 기기 품질 | 저사양 Android, 일부 북극·집중 GPU·장시간 발열/전력 미완료 | 승인된 Android 실기기·iOS 실기기에서 확인 |
| 메시지 통합 검사 | Flutter/웹의 메시지 입구를 한 번에 연결한 검사가 부족 | 별도 끝에서 끝까지 검사 |
| Windows 앱 미리보기 테스트 | 심볼릭 링크 권한 부족 시 일부 검사 실패 | 실행 성공과 테스트 권한 문제 구분 |
| 코드 정리 | 미사용 선언과 의도적으로 남긴 유사 종별 함수 | 식별성과 궤적 안전망을 유지하며 별도 진행 |
상세 원문은 docs/follow-ups.md다. 여기서 과제를 요약했다고 원문의 완료 상태를 바꾸거나 삭제하지 않는다.
이번 문서 사이트의 검수
섹션 제목: “이번 문서 사이트의 검수”대상은 Astro 문서 내용·링크·이미지 참조·HTML/Markdown·실행 도구다. 최종 결과와 실행 명령은 DocsSite/README.md의 검증 기록에 남긴다. Android/iOS 앱 실행이나 물·빛 GPU 성능을 이번 작업에서 검증한 것으로 간주하지 않는다.
사용자가 선택한 기초 구현 + 사용자 시각 조정에 따라 사이트 위치·크기·색·외관 검수는 사용자 담당이며 미완료다. 홈·본문·탐색 메뉴를 휴대폰과 데스크톱에서 확인한 뒤 src/styles/custom.css와 문서 이미지 크기를 조정할 수 있다. Windows에서 실행하지 않았다면 Windows 더블클릭 실검증도 완료로 기록하지 않는다.