Go to file
Claude 64323b824e
feat: implement 단톡 따라잡기 (group catch-up summary) — roadmap.md §2.7-A
Closes the biggest content gap found against PRD.md §3.1 P0: group chat
catch-up was one of only two v1 MVP scenarios and had zero implementation.

Backend (core-backend):
- ConversationParticipant.LastReadMessageID read marker.
- POST /conversations/:id/read advances the caller's marker (never backward).
- GET /conversations/:id/summary builds context from messages since that
  marker and calls ai-service's new POST /summarize; returns unread_count
  and needs_reply.
- GET /conversations now reports unread_count per room.
- Safety: group conversations now unconditionally block twin-authored
  sends (POST /conversations/:id/messages), regardless of the sender's
  global autonomy level. PRD.md §2.3-③ requires this scenario stay L0-fixed
  with no auto-send; autonomy level is a per-user global setting today, so
  this closes the only path a global L2 whitelist match could otherwise
  auto-send into a group.

AI service (ai-service): new summarize.py module (same Gemini-call shape as
generation.py's draft_reply, no escalation/identity gating since nothing
generated here is ever sent) + POST /summarize.

Mobile: "새 대화" dialog now supports adding/removing multiple peer fields
(2+ peers -> is_group:true automatically); unread badge on conversation
rows; ChatScreen takes isGroup and renders its L1 panel as L0-locked for
groups; new "안 본 동안 요약" AppBar action opens a dialog with the summary
and, when a reply looks needed, a button that feeds straight into the
existing draft-request flow.

Verified with a real Flutter build against a live core-backend + ai-service
instance (Playwright driving 3 demo accounts through group creation, unread
badges, and the summary dialog) — this caught a real ordering bug: marking
the read marker on chat *open* meant the summary was always empty by the
time you could tap it, since opening the room already advanced the marker
past everything you'd come to catch up on. Fixed by marking read on screen
*exit* (dispose) instead, so the marker reflects what was unread that whole
visit and updates once you leave.

go test / pytest / flutter analyze+test all pass.
2026-08-03 03:16:54 +00:00
ai-service feat: implement 단톡 따라잡기 (group catch-up summary) — roadmap.md §2.7-A 2026-08-03 03:16:54 +00:00
backend 제품명 변경(분신→와카뷰) + 소프트 그라디언트/글래스모피즘 UI + 브랜드 로딩 화면 2026-07-31 01:15:42 +00:00
core-backend feat: implement 단톡 따라잡기 (group catch-up summary) — roadmap.md §2.7-A 2026-08-03 03:16:54 +00:00
deploy feat(deploy): Docker Compose stack for msn.iykyka.com (N2-B) 2026-07-31 02:26:40 +00:00
docs feat: implement 단톡 따라잡기 (group catch-up summary) — roadmap.md §2.7-A 2026-08-03 03:16:54 +00:00
mobile feat: implement 단톡 따라잡기 (group catch-up summary) — roadmap.md §2.7-A 2026-08-03 03:16:54 +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)만 공개.