hikikomori / 와카뷰 (Ykavu)
카카오톡 대안 메신저 — "나를 대신해 남과 대화하는 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 우선 · Web 배포) |
secrets/ |
FCM 등 시크릿 마운트용 (git에 실파일 커밋 금지) |
문서 지도
권위 순서·에이전트 규칙: AGENTS.md · CLAUDE.md.
기획 · 결정
실행 · 잔여 작업 (여기가 본체)
남은 일: 웹은 web-upgrade.md / deploy-checklist §N4-W. Android/FCM 실기기·APK·SHARE_URL·PoC는 §N4·§N5.
배포 · 운영
PoC · 회의
AI 에이전트 규칙
AGENTS.md · CLAUDE.md- 브랜치: 작업·머지는 항상
main
- 리모트: GitHub
origin + Gitea gitea(iykyka) — main 갱신 후 ./scripts/push-both.sh
- Q9 (L2 수신 트리거 자동응대)는 Master 확정 전 구현 금지
현재 단계
- Phase 1 A~C + Track A/B/C + Q8(로그인·설정·로그아웃) 코드 완료
- 라이브:
https://msn.iykyka.com · 데모 코드 DEMO-YKAVU
- 진행 중 (설계 완료·구현 Wi 승인 대기): 웹 고도화
docs/web-upgrade.md (W0 경계 done · W1~W7 todo)
- 후순위 (Master): Android N4 —
google-services.json · 실기기 FCM · UI 탭 · APK · SHARE_URL
- 결정 대기: Q9 — L2 의미 (카피 정렬 ± 수신 자동응대) — 웹 트랙에도 비범위
- 맨 마지막: N5 / D — 사람 PoC. §3 기본값 추측 금지
상세 현황: docs/deploy-checklist.md §0.
로컬 실행 (요약)
# 터미널 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)만 공개.
ec5761d602