iykyka/docs/tester-guide.md

3.6 KiB

와카뷰 테스터 안내 (N3-6 / Track B)

접속

  • 웹: https://msn.iykyka.com (데모/프리뷰 1차 표면)
  • 권장 브라우저: Desktop Chrome
  • 공용 데모 초대 코드: DEMO-YKAVU
  • 표시 이름 예시: 테스터 (원하는 이름으로 변경 가능 — 이미 가입 탭 재로그인 시 같은 이름 필요)

같은 코드를 여러 명이 쓸 수 있습니다 (ALLOW_DEMO_INVITE=1).

API 메타: GET https://msn.iykyka.com/demopairing_steps / notes 포함.

웹 프리뷰 팁 (N4-W)

  1. 넓은 화면(≥900px) — 왼쪽 대화 목록 · 오른쪽 채팅이 나란히 보입니다.
  2. 내 ID 복사 — 목록 상단 칩 또는 설정 → 계정 행을 탭합니다.
  3. 브라우저 알림 — 설정 → 「브라우저 알림」에서 허용하면 답장 마감 리마인드를 받을 수 있습니다(거부해도 인앱 배지는 동작).
  4. 홈 화면 추가(PWA) — Chrome 주소창 옆 설치 아이콘 또는 메뉴 → 「앱 설치」.
  5. 로그아웃 — 설정 → 로그아웃 → 입장 화면 「이미 가입」으로 복귀.
  6. 캐시가 옛 버전일 때 — 강력 새로고침, 또는 DevTools → Application → Service Workers → Unregister 후 새로고침.

상세 설계: web-upgrade.md.

권장 페어링 플로우 (5~10분)

두 명(또는 시크릿 창 두 개)으로 진행합니다. 대화는 닉네임이 아니라 숫자 사용자 ID로 연결됩니다.

  1. 가입 — 「새로 가입」탭 · 초대 코드 DEMO-YKAVU (각자 다른 표시 이름 권장). 시크릿 창 두 개로 두 사용자 가능.
  2. 말투 샘플 — 몇 줄 적거나 스킵 (하드 리프레시 후에도 유지됨)
  3. 내 ID 복사 — 대화 목록 상단「내 사용자 ID」칩을 탭해 복사하고 상대에게 전달
  4. 연락처 추가 — 상대 표시 이름 + 상대의 숫자 ID(필수) → 추가 → 「대화」
  5. 메시지 — 사람 모드로 한두 줄 주고받기 · 채팅 앱바의 「실시간」상태 확인
  6. 와카뷰 초안 — 설정 → 자율성에서 L1 → 채팅에서 초안 → 수정/승인하고 보내기
  7. (선택) L0에서는「입력창으로 옮기기」만 됩니다. L2·거부권·사후알림 함·이따 답장도 눌러 보세요.

ID 없는 옛 연락처

이름만 넣고 ID를 비운 연락처는 대화가 안 됩니다. 연락처 화면에서 **「ID 입력」**으로 숫자 ID를 채우면 됩니다 (삭제 후 재추가 불필요).

알아둘 점

  • 초안(AI): Gemini 키가 서버에 설정되어 있어 실제 초안이 생성됩니다.
  • L0(비서): 와카뷰 발송이 서버에서 막혀 있습니다. 초안 → 입력창 → 직접 전송.
  • 푸시: Android·Web Push는 Master Firebase 설정 후 (docs/fcm-setup.md, web-upgrade W4). 그전엔 install: 플레이스홀더.
  • 문제/스크린샷은 Master에게 전달해 주세요.
  • 민감 정보·실명 대화는 베타 특성상 최소화해 주세요.

개인 초대 (운영자)

공용 코드 대신 1회용 코드가 필요하면:

curl -sS -X POST https://msn.iykyka.com/invites \
  -H "Authorization: Bearer $ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"note":"테스터-이름","expires_in_days":14}'

절차 상세: invite-ops.md

장애 시 운영자 체크

cd ~/project/ykavu
docker compose ps
curl -sS https://msn.iykyka.com/health
docker compose logs --tail=100 core-backend ai-service web

백업: ./scripts/backup-postgres.sh (호스트에서)