Go to file
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
ai-service 관계 메모 실제 반영(2.7-E) 구현: draftRequest에 RelationshipNote 전달 + 프롬프트 주입 2026-08-03 05:37:33 +00:00
backend 제품명 변경(분신→와카뷰) + 소프트 그라디언트/글래스모피즘 UI + 브랜드 로딩 화면 2026-07-31 01:15:42 +00:00
core-backend 오프라인 메시지 큐(N4-11) 구현: since_id 캐치업 + WS 재연결 backoff 2026-08-03 07:26:37 +00:00
deploy feat(deploy): Docker Compose stack for msn.iykyka.com (N2-B) 2026-07-31 02:26:40 +00:00
docs 오프라인 메시지 큐(N4-11) 구현: since_id 캐치업 + WS 재연결 backoff 2026-08-03 07:26:37 +00:00
mobile 오프라인 메시지 큐(N4-11) 구현: since_id 캐치업 + WS 재연결 backoff 2026-08-03 07:26:37 +00:00
poc/tone-corpus Merge origin/main: keep gradient/glassmorphism UI, port demo-invite + boot hardening, purge 분신 branding 2026-07-31 01:30:50 +00:00
scripts docs(ops): complete N3 stabilize — backup, tester guide, smoke results 2026-07-31 04:06:09 +00:00
secrets feat(fcm): send pushes via HTTP v1 service account 2026-07-31 07:33:23 +00:00
.dockerignore feat(deploy): Docker Compose stack for msn.iykyka.com (N2-B) 2026-07-31 02:26:40 +00:00
.env.example feat(fcm): send pushes via HTTP v1 service account 2026-07-31 07:33:23 +00:00
.gitignore feat(fcm): send pushes via HTTP v1 service account 2026-07-31 07:33:23 +00:00
AGENTS.md docs: add deploy/residual checklist (N1–N5) after Phase 1 A–C 2026-07-31 01:54:55 +00:00
CLAUDE.md docs: add deploy/residual checklist (N1–N5) after Phase 1 A–C 2026-07-31 01:54:55 +00:00
README.md docs: record Gemini key live on msn.iykyka.com (draft status=ok) 2026-07-31 04:19:44 +00:00
docker-compose.yml feat(fcm): send pushes via HTTP v1 service account 2026-07-31 07:33:23 +00:00

README.md

hikikomori / 와카뷰 (가칭)

카카오톡 대안 메신저 — "나를 대신해 남과 대화하는 AI 와카뷰".

구조

경로 역할
docs/ 기획·PRD·기술설계·로드맵·PoC 계획
core-backend/ Go 코어 (가입·메시지·WebSocket·자율성·안전장치)
ai-service/ Python AI 내부 API (/draft, /escalate/check)
backend/ 초기 Python 프로토타입 (참고용)
poc/tone-corpus/ PoC 실험 스크립트
mobile/ Flutter 클라이언트 (Android 우선)

문서

AI 에이전트 규칙

  • AGENTS.md · CLAUDE.md
  • 브랜치: 작업·머지는 항상 main
  • 리모트: GitHub origin + Gitea gitea(iykyka) — main 갱신 후 ./scripts/push-both.sh

현재 단계

  • Phase 1 A~C + N2 컷오버 + N3 안정화 완료 — 라이브: https://msn.iykyka.com
  • 테스터 안내: docs/tester-guide.md · 데모 코드 DEMO-YKAVU
  • 다음 (선택): N4 FCM·Android QA
  • 맨 마지막: N5 / D — 사람 PoC (docs/roadmap.md §3). §3 기본값 추측 금지
  • 프로토타입 공유 URL은 docs/prototype.mdSHARE_URL에 Master가 기입

로컬 실행 (요약)

# 터미널 1 — AI 서비스
cd ai-service && pip install -r requirements.txt
export GEMINI_API_KEY=...   # or repo-root .env
uvicorn app.main:app --port 8001

# 터미널 2 — 코어 백엔드
cd core-backend
export ADMIN_API_TOKEN=dev-admin-token
go run . migrate && go run .

# 초대 코드 발급 예:
# curl -X POST http://localhost:8080/invites -H "Authorization: Bearer $ADMIN_API_TOKEN"

# 터미널 3 — Flutter (Android)
cd mobile && flutter run --dart-define=CORE_API_BASE=http://10.0.2.2:8080

Docker (N2-B / msn.iykyka.com)

cp .env.example .env   # ADMIN_API_TOKEN, POSTGRES_PASSWORD 필수
# 로컬: PUBLIC_API_BASE=http://localhost:8088
docker compose up -d --build
curl -sS http://localhost:8088/health

Postgres·AI는 내부망만. 엣지 프록시는 web:80(또는 WEB_HOST_PORT)만 공개.