docs(ops): complete N3 stabilize — backup, tester guide, smoke results
Record invite/metrics/dashboard/draft(no_key) checks, pg_dump restore rehearsal, and tester-facing guide for msn.iykyka.com. Co-authored-by: okuma <o0kuma@users.noreply.github.com>
This commit is contained in:
Cursor Agent
parent
597c9f07cc
commit
9065479e87
|
|
@ -30,10 +30,10 @@
|
|||
|
||||
## 현재 단계
|
||||
|
||||
- Phase 1 **A~C** + **N2 Docker 컷오버 완료** — 라이브: [`https://msn.iykyka.com`](https://msn.iykyka.com)
|
||||
- **다음:** [`docs/deploy-checklist.md`](./docs/deploy-checklist.md) N3 안정화 → N4 FCM/Android QA
|
||||
- **맨 마지막:** N5 / D — 사람 PoC #1/#3·Q3 인터뷰 (`docs/roadmap.md` §3). §3 기본값 추측 금지
|
||||
- 테스터 데모 초대: **`DEMO-YKAVU`**
|
||||
- Phase 1 **A~C** + **N2 컷오버 + N3 안정화 완료** — 라이브: [`https://msn.iykyka.com`](https://msn.iykyka.com)
|
||||
- 테스터 안내: [`docs/tester-guide.md`](./docs/tester-guide.md) · 데모 코드 **`DEMO-YKAVU`**
|
||||
- **다음:** 서버 `GEMINI_API_KEY` 주입(실초안) 및/또는 N4 FCM·Android QA
|
||||
- **맨 마지막:** N5 / D — 사람 PoC (`docs/roadmap.md` §3). §3 기본값 추측 금지
|
||||
- 프로토타입 공유 URL은 [`docs/prototype.md`](./docs/prototype.md)의 `SHARE_URL`에 Master가 기입
|
||||
|
||||
## 로컬 실행 (요약)
|
||||
|
|
|
|||
|
|
@ -29,7 +29,7 @@ Phase 1 **A~C** 이후 실행 트랙. 작업 단위를 하나씩 처리한다.
|
|||
### NOW
|
||||
|
||||
- 앱 코드는 클로즈드 베타 직전 수준
|
||||
- 프로덕션 Docker **이미지·compose 준비 완료**. `msn.iykyka.com` **컷오버는 SSH/Portainer 자격 대기**
|
||||
- **`https://msn.iykyka.com` 라이브 + N3 안정화 완료**. Gemini 키 미설정(`no_key`). 다음: N4 또는 키 주입
|
||||
- 실 FCM · Android UI 수동 QA · 사람 PoC 실행은 남음
|
||||
|
||||
### NEXT 순서
|
||||
|
|
@ -128,12 +128,12 @@ N2-A 전체 확정. 다음 구현 트랙은 **N1 스모크 → N2-B (Dockerfile/
|
|||
|
||||
| ID | 작업 | Status | 완료 조건 |
|
||||
|----|------|--------|-----------|
|
||||
| **N3-1** | 헬스/로그 | todo | OOM·CORS·502 없음 |
|
||||
| **N3-2** | 초대 발급 리허설 | todo | `docs/invite-ops.md` 절차 1회 |
|
||||
| **N3-3** | admin metrics | todo | `/admin/metrics`·`/admin/dashboard` 토큰 조회 |
|
||||
| **N3-4** | Gemini | todo | draft 1회 실호출 또는 mock 정책 명시 |
|
||||
| **N3-5** | 백업 리허설 | todo | Postgres 덤프/복구 1회 (`pg_dump` 등) |
|
||||
| **N3-6** | 테스터 안내 | todo | URL + 초대(`DEMO-YKAVU` 또는 개인 코드) + 주의사항 |
|
||||
| **N3-1** | 헬스/로그 | **done** (2026-07-31) | 전 컨테이너 healthy. 공개 `/health` OK. 최근 로그에 OOM/502 없음 |
|
||||
| **N3-2** | 초대 발급 리허설 | **done** (2026-07-31) | `POST /invites` note=`N3-rehearsal` 발급·`GET /invites` 목록 확인 |
|
||||
| **N3-3** | admin metrics | **done** (2026-07-31) | Bearer로 `/admin/metrics`·`/admin/dashboard` 200 |
|
||||
| **N3-4** | Gemini | **done** (정책) | draft → `status=no_key` (서버 `GEMINI_API_KEY` 비어 있음). 키 넣으면 실호출로 전환 |
|
||||
| **N3-5** | 백업 리허설 | **done** (2026-07-31) | `pg_dump` gzip → restore test DB → drop. [`ops-backup.md`](./ops-backup.md) |
|
||||
| **N3-6** | 테스터 안내 | **done** (2026-07-31) | [`tester-guide.md`](./tester-guide.md) |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -192,7 +192,8 @@ N1~N4(배포·품질에 필요한 최소분) 이후에만 착수. `roadmap.md` P
|
|||
1. ~~N2-A1~A6 결정 체크~~ **done**
|
||||
2. ~~N1 스모크~~ **done** (E2E 16/16 + DEMO API 경로; 브라우저 UI 탭은 테스터)
|
||||
3. ~~N2-B1~B7 이미지·compose~~ **done** (파일 랜딩·이미지 빌드)
|
||||
4. **N2-B8~B12** Portainer/SSH 컷오버 ← **blocked (자격 필요)** — [`deploy-portainer.md`](./deploy-portainer.md)
|
||||
5. **N3-6** 테스터 안내
|
||||
4. ~~N2-B8~B12 컷오버~~ **done** (`msn.iykyka.com` 라이브)
|
||||
5. ~~N3 배포 안정화~~ **done** — 다음: **N4 FCM/Android QA** 또는 서버에 `GEMINI_API_KEY` 주입
|
||||
|
||||
|
||||
완료 시 본 표의 Status를 `done`으로 바꾸고, [`roadmap.md`](./roadmap.md) §4/§5의 대응 `[~]`/`[ ]`도 같이 갱신한다.
|
||||
|
|
|
|||
|
|
@ -0,0 +1,28 @@
|
|||
# Postgres 백업·복구 (N3-5)
|
||||
|
||||
서버 path: `~/project/ykavu`
|
||||
덤프 위치: `~/backups/ykavu/ykavu-YYYYMMDDThhmmssZ.sql.gz`
|
||||
|
||||
## 백업
|
||||
|
||||
```bash
|
||||
cd ~/project/ykavu
|
||||
./scripts/backup-postgres.sh
|
||||
# 또는
|
||||
docker compose exec -T postgres pg_dump -U ykavu ykavu | gzip > ~/backups/ykavu/ykavu-$(date -u +%Y%m%dT%H%M%SZ).sql.gz
|
||||
```
|
||||
|
||||
리허설(2026-07-31): 덤프 → `ykavu_restore_test` DB로 복구 → `\dt` 11테이블 · users count 확인 → 테스트 DB 삭제 OK.
|
||||
|
||||
## 복구 (주의: 운영 DB 덮어쓰기)
|
||||
|
||||
```bash
|
||||
cd ~/project/ykavu
|
||||
# 1) 서비스 중지 권장
|
||||
docker compose stop core-backend web
|
||||
# 2) 기존 DB 드롭/재생성 또는 새 DB로 검증 후 전환
|
||||
gunzip -c ~/backups/ykavu/ykavu-XXXX.sql.gz | docker compose exec -T postgres psql -U ykavu -d ykavu
|
||||
docker compose start core-backend web
|
||||
```
|
||||
|
||||
권장: 먼저 별도 DB(`ykavu_restore_test`)에 복구해 검증한 뒤 컷오버.
|
||||
|
|
@ -0,0 +1,48 @@
|
|||
# 와카뷰 테스터 안내 (N3-6)
|
||||
|
||||
## 접속
|
||||
|
||||
- 웹: **https://msn.iykyka.com**
|
||||
- 공용 데모 초대 코드: **`DEMO-YKAVU`**
|
||||
- 표시 이름 예시: `테스터` (원하는 이름으로 변경 가능)
|
||||
|
||||
같은 코드를 여러 명이 쓸 수 있습니다 (`ALLOW_DEMO_INVITE=1`).
|
||||
|
||||
## 권장 플로우 (5분)
|
||||
|
||||
1. 가입 — 초대 코드 `DEMO-YKAVU` 입력
|
||||
2. 말투 샘플 온보딩 — 몇 줄 적거나 스킵
|
||||
3. 연락처에 상대 유저 등록 → 대화 시작
|
||||
4. 메시지 전송 · 분신 초안(L1) 한 번 시도
|
||||
5. (선택) 자율성 L0~L2 / 거부권 / 사후알림 함 확인
|
||||
|
||||
## 알아둘 점
|
||||
|
||||
- **초안(AI)**: 서버에 `GEMINI_API_KEY`가 없으면 초안이 `no_key`로 나오고, 예시 문구만 채워질 수 있습니다. 키가 들어가면 실제 Gemini 초안이 나옵니다.
|
||||
- 푸시(FCM)는 아직 플레이스홀더 단계일 수 있습니다.
|
||||
- 문제/스크린샷은 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` (호스트에서)
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
#!/usr/bin/env bash
|
||||
# Run on the deploy host from the compose project directory (e.g. ~/project/ykavu).
|
||||
# Creates gzipped pg_dump under ~/backups/ykavu and prunes older than keep-count.
|
||||
set -euo pipefail
|
||||
|
||||
KEEP="${BACKUP_KEEP:-10}"
|
||||
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||||
cd "$ROOT"
|
||||
OUT_DIR="${BACKUP_DIR:-$HOME/backups/ykavu}"
|
||||
mkdir -p "$OUT_DIR"
|
||||
STAMP="$(date -u +%Y%m%dT%H%M%SZ)"
|
||||
DUMP="$OUT_DIR/ykavu-$STAMP.sql.gz"
|
||||
|
||||
docker compose exec -T postgres pg_dump -U "${POSTGRES_USER:-ykavu}" "${POSTGRES_DB:-ykavu}" | gzip >"$DUMP"
|
||||
ls -lh "$DUMP"
|
||||
ls -1t "$OUT_DIR"/ykavu-*.sql.gz | tail -n +"$((KEEP + 1))" | xargs -r rm -f
|
||||
echo "OK $DUMP"
|
||||
Loading…
Reference in New Issue