74 lines
3.8 KiB
Markdown
74 lines
3.8 KiB
Markdown
# 와카뷰 테스터 안내 (N3-6 / Track B)
|
|
|
|
## 접속
|
|
|
|
- 웹: **https://msn.iykyka.com** (데모/프리뷰 1차 표면)
|
|
- 권장 브라우저: **Desktop Chrome**
|
|
- 공용 데모 초대 코드: **`DEMO-YKAVU`**
|
|
- 표시 이름 예시: `테스터` (원하는 이름으로 변경 가능 — **이미 가입** 탭 재로그인 시 같은 이름 필요)
|
|
|
|
같은 코드를 여러 명이 쓸 수 있습니다 (`ALLOW_DEMO_INVITE=1`).
|
|
|
|
API 메타: `GET https://msn.iykyka.com/demo` — `pairing_steps` / `notes` 포함.
|
|
|
|
### 웹 프리뷰 팁 (N4-W)
|
|
|
|
1. **넓은 화면(≥900px)** — 왼쪽 대화 목록 · 오른쪽 채팅이 나란히 보입니다.
|
|
2. **내 ID 복사** — 목록 상단 칩 또는 설정 → 계정 행을 탭합니다.
|
|
3. **브라우저 알림** — 설정 → 「브라우저 알림」에서 허용하면 답장 마감 리마인드를 받을 수 있습니다(거부해도 인앱 배지는 동작).
|
|
4. **홈 화면 추가(PWA)** — Chrome 주소창 옆 설치 아이콘 또는 메뉴 → 「앱 설치」.
|
|
5. **로그아웃** — 설정 → 로그아웃 → 입장 화면 「이미 가입」으로 복귀.
|
|
6. **캐시가 옛 버전일 때** — 강력 새로고침, 또는 DevTools → Application → Service Workers → Unregister 후 새로고침.
|
|
|
|
상세 설계: [`web-upgrade.md`](./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).
|
|
웹은 서버 `.env`에 `FIREBASE_*`/`VAPID`가 있고 `web` 이미지를 그 값으로 빌드한 뒤에야 실 토큰이 등록됩니다. 그전엔 `install:` 플레이스홀더.
|
|
Web Push 배포 직후엔 **하드 리프레시**(또는 사이트 데이터 삭제)로 `firebase-messaging-sw.js`를 갱신하세요.
|
|
- 문제/스크린샷은 Master에게 전달해 주세요.
|
|
- 민감 정보·실명 대화는 베타 특성상 최소화해 주세요.
|
|
|
|
## 개인 초대 (운영자)
|
|
|
|
공용 코드 대신 1회용 코드가 필요하면:
|
|
|
|
```bash
|
|
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`](./invite-ops.md)
|
|
|
|
## 장애 시 운영자 체크
|
|
|
|
```bash
|
|
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` (호스트에서)
|