iykyka/mobile
Claude 193b15d58a
오프라인 메시지 큐(N4-11) 구현: since_id 캐치업 + WS 재연결 backoff
서버가 이미 모든 메시지를 DB에 durable하게 저장하므로 별도 큐를 새로
만들지 않고, 연결이 끊겼던 클라이언트가 그 DB에서 놓친 부분만 다시
받아오는 방식으로 풀었다.

- core-backend: GET /conversations/:id/messages?since_id=<id> 추가
  (파라미터 없으면 기존 전체 히스토리 그대로, 비정상 값은 400, 최댓값
  초과는 빈 배열). TestListMessagesSinceID로 확인.
- mobile/ws_client.dart: 소켓 onDone/onError에서 그냥 멈추던 것을
  backoff(1s→2s→4s→8s→...→30s 캡, 성공 시 리셋) 재연결로 교체하고,
  재연결 성공 신호를 reconnects 스트림으로 노출.
- mobile/chat_screen.dart: WidgetsBindingObserver를 추가해 소켓
  재연결 신호 + didChangeAppLifecycleState(resumed) 양쪽에서 since_id
  캐치업을 호출, 기존 메시지와 id 기준으로 중복 없이 병합.
- mobile/services/message_sync.dart: backoff 계산과 중복 없는 병합을
  순수 함수로 뽑아 message_sync_test.dart에서 결정적으로 검증.

실제 소켓 재연결 타이밍이나 앱 백그라운드/포그라운드 전환에서 OS가
소켓을 어떻게 처리하는지는 단위 테스트로 증명할 수 없어 실기기
Android QA가 남아 있음 — roadmap.md/deploy-checklist.md N4-11에
부분 검증으로 기록.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014YSB5PqF38raTxP5ABgr9m
2026-08-03 07:26:37 +00:00
..
android feat(n4): wire FCM token path and document Master secrets 2026-07-31 04:51:57 +00:00
lib 오프라인 메시지 큐(N4-11) 구현: since_id 캐치업 + WS 재연결 backoff 2026-08-03 07:26:37 +00:00
test 오프라인 메시지 큐(N4-11) 구현: since_id 캐치업 + WS 재연결 backoff 2026-08-03 07:26:37 +00:00
web 제품명 변경(분신→와카뷰) + 소프트 그라디언트/글래스모피즘 UI + 브랜드 로딩 화면 2026-07-31 01:15:42 +00:00
.gitignore Add Flutter mobile client skeleton and defer human PoC to last 2026-07-30 04:16:41 +00:00
.metadata fix Flutter Web/Chrome compile by stubbing SQLCipher DB 2026-07-30 07:05:31 +00:00
Dockerfile feat(deploy): Docker Compose stack for msn.iykyka.com (N2-B) 2026-07-31 02:26:40 +00:00
Dockerfile.prebuilt feat(deploy): Docker Compose stack for msn.iykyka.com (N2-B) 2026-07-31 02:26:40 +00:00
README.md feat(n4): wire FCM token path and document Master secrets 2026-07-31 04:51:57 +00:00
analysis_options.yaml Add Flutter mobile client skeleton and defer human PoC to last 2026-07-30 04:16:41 +00:00
pubspec.lock 답장 마감 알림(2.7-F) 구현: 온디바이스 스누즈 저장 + 인앱 배지 + 로컬 알림(부분 검증) 2026-08-03 05:55:30 +00:00
pubspec.yaml 답장 마감 알림(2.7-F) 구현: 온디바이스 스누즈 저장 + 인앱 배지 + 로컬 알림(부분 검증) 2026-08-03 05:55:30 +00:00

README.md

와카뷰 mobile (Flutter)

Phase 1 클라이언트 (docs/roadmap.md §2.3 / A3). v1은 Android 빌드만 대상으로 한다 (docs/tech-design.md §8).

지금 있는 것

  • 초대 코드 가입 (POST /auth/signup) + Bearer 세션
  • 말투 샘플 온보딩(기기 로컬 저장; 최종 카피는 PoC 이후)
  • 대화방 목록/생성 (GET/POST /conversations) — 수동 ID 입력 제거
  • 연락처 CRUD + 대화 시작 (/users/:id/contacts)
  • 채팅 히스토리 로드 + WebSocket 수신
  • 와카뷰 초안 / L1 승인(수정·버리기·재초안·승인 발송)
  • 와카뷰 뱃지 · 거부권 · 되돌리기
  • 사후 알림 함 (GET /users/:id/escalation-logs)
  • 자율성 L0~L2 + 화이트리스트 CRUD UI

실행

# core-backend + ai-service 가 떠 있어야 실제 호출이 된다
cd mobile
flutter pub get

# Android 에뮬레이터 → 호스트의 core-backend(기본 8080)
flutter run --dart-define=CORE_API_BASE=http://10.0.2.2:8080

# 실기기/로컬 네트워크
flutter run --dart-define=CORE_API_BASE=http://<your-lan-ip>:8080

E2E

API 레벨 (클라우드/CI에서 실행 가능)

# core-backend :8080 + ai-service :8001 기동 후
export ADMIN_API_TOKEN=dev-admin-token
python3 scripts/e2e_a3.py

A3 체크리스트(가입·연락처·대화·히스토리·draft/L1·에스컬레이션·되돌리기·거부권·화이트리스트)를 HTTP로 검증한다.

에뮬레이터/실기기 UI 탭 (Android SDK 필요)

  1. 초대 코드로 가입 → 말투 샘플 저장(또는 나중에)
  2. 연락처에 상대 사용자 ID 등록 → 대화 시작
  3. 메시지 전송 · 새로고침 후 히스토리 유지
  4. 초안 요청 → L1 패널에서 수정/버리기/승인 발송 → 와카뷰 뱃지 확인
  5. 민감 문장으로 에스컬레이션 → 사후 알림 함 진입
  6. 와카뷰 메시지 되돌리기 · 거부권
  7. 자율성 L0~L2 + 화이트리스트 추가/삭제

로컬 DB (drift + SQLCipher)

말투 샘플·온보딩 플래그는 lib/db/ 암호화 SQLite에 저장한다. 패스프레이즈는 flutter_secure_storage. Linux 개발 호스트에 libsqlcipher.so가 없으면 메모리 폴백으로 기동한다(Android 릴리즈 경로에서는 SQLCipher 사용).

# Linux에서 drift 테스트/암호화 DB를 쓰려면
sudo apt-get install -y libsqlite3-dev libsqlcipher1

푸시 (FCM)

  • 코드: lib/services/push_token_service.dart — Firebase 가능 시 실 토큰, 아니면 install:
  • Master 설정: docs/fcm-setup.md (google-services.json + FCM_SERVER_KEY)

아직 없는 것

  • Master Firebase 시크릿 주입 후 실기기 푸시 스모크 (N4-1/3/4)
  • 오프라인 메시지 큐 / 멀티디바이스 실시간 설정 동기화 고도화
  • 온보딩 말투 UX 디테일 (PoC #1 결과는 맨 마지막에 반영)
  • iOS 빌드 (v1 범위 밖)