코드 주석을 이 저장소 기준으로 정리

This commit is contained in:
Sn-Kinos
2026-10-16 18:04:14 +09:00
parent 80b90aad4c
commit 4236d75fd1
89 changed files with 212 additions and 212 deletions
@@ -146,7 +146,7 @@ class FirestoreQuestRepository implements QuestRepository {
return cards;
}
/// 진행 세션이 있는 걸음 Quest 의 오늘 걸음 — Walk 는 화면 밖 걸음까지 **실제 상태**로 보인다(원장 C-62 · C-83).
/// 진행 세션이 있는 걸음 Quest 의 오늘 걸음 — Walk 는 화면 밖 걸음까지 **실제 상태**로 보인다(정책 원장 C-62 · C-83).
/// Health 를 한 번 읽고, 못 쓰면 이번 실행에서 센서로 센 값, 그것도 없으면 null(세션의 마지막 값).
Future<int?> _walkFor(Map<String, dynamic> quest, Map<String, dynamic> progress) async {
if (QuestType.parse(quest.strOr('type')) != QuestType.steps || progress['session'] is! Map) {
@@ -183,7 +183,7 @@ class FirestoreQuestRepository implements QuestRepository {
s != null &&
!s.fits(Duration(milliseconds: quest.intOr('firstBeatMs')), quest.intOr('totalSegments'));
/// 진행 세션(`questProgress.session` — `fn-quest-progress` 만 쓴다 · 원장 C-83).
/// 진행 세션(`questProgress.session` — `fn-quest-progress` 만 쓴다 · 정책 원장 C-83).
static QuestSession? sessionOf(Map<String, dynamic> progress) {
final raw = progress['session'];
if (raw is! Map) return null;
@@ -560,7 +560,7 @@ class FirestoreQuestRepository implements QuestRepository {
'description': description,
});
/// 진행중 · 일시 정지 · 진행완료 · 중단을 서버 진행 문서에 남긴다(`fn-quest-progress` · 원장 C-83).
/// 진행중 · 일시 정지 · 진행완료 · 중단을 서버 진행 문서에 남긴다(`fn-quest-progress` · 정책 원장 C-83).
///
/// 진행 문서는 규칙상 서버 전용이라 함수로만 쓴다. 보상 상태는 여전히 [verify] 가 지급에 성공한 뒤
/// 서버 카운터로 확정되고, 지급되면 서버가 세션을 지운다.
@@ -839,7 +839,7 @@ class FirestoreQuestRepository implements QuestRepository {
Future<Map<String, dynamic>> _verifyShake(QuestCard card) async {
final run = _shakeRun;
// 끝낸 판을 서버 세션에 남겨 두었다면 그 판정표로 — 목록에서 바로 「보상받기」(원장 C-83).
// 끝낸 판을 서버 세션에 남겨 두었다면 그 판정표로 — 목록에서 바로 「보상받기」(정책 원장 C-83).
final saved = card.session?.state == QuestStage.completed ? card.session : null;
final judgement = run?.judgement() ?? saved?.judgement;
final segments = run?.segments ?? saved?.total ?? 0;