명칭 변경: - decision-log.md Q6 확정: "분신"(가칭) → "와카뷰 (Ykavu)" — 焚身(분신자살) 동음이의 리스크도 있었고 메신저 브랜드로 부르기 무거웠음. Master가 최종 선택한 이름으로 변경(2026-07-31), 파생 문서(AGENTS.md/CLAUDE.md/PRD 등)· Flutter 앱 텍스트·web manifest/index.html·AndroidManifest 라벨까지 전부 반영 - ai-service: 본인확인 고정 문구(identity.py)·시스템 프롬프트(generation.py)도 갱신 — 새 이름 기준으로 "본인이야 와카뷰야?" 류 질문을 감지하도록 정규식도 같이 손봄(단순 문자열 치환만으론 어미 형태가 안 맞아서 테스트 추가/조정) - poc/tone-corpus/의 실험용 프롬프트는 의도적으로 그대로 둠(ai-service README에 이미 명시된 대로 프로덕션과 분리된 실험 도구) UI/UX: - mobile/lib/theme/app_theme.dart: 시드 컬러를 인디고/라벤더로 변경, 화면 전체에 깔리는 소프트 그라디언트(라이트: 라벤더→스카이→핑크 파스텔, 다크: 딥 인디고→ 네이비→플럼) + 카드/인풋/칩을 반투명 "글래스" 서피스로 전환 - mobile/lib/widgets/gradient_backdrop.dart(신규): MaterialApp.builder에 연결해 모든 화면에 자동으로 그라디언트 배경 적용 - mobile/lib/screens/splash_screen.dart(신규) + main.dart 재구성: 기존엔 session.restore()를 기다리는 동안 아무 것도 안 그려서 흰 화면/텍스트만 뜨는 구간이 있었음 — runApp을 먼저 하고 restore 동안 브랜드 스플래시가 뜨도록 변경 - chat_screen·autonomy_settings_screen·data_flow_screen의 커스텀 패널들도 글래스 스타일로 맞춤 BunsinApp -> YkavuApp (mobile/lib/main.dart, test/widget_test.dart 동기화) Flutter SDK가 없는 환경이라 flutter analyze/run으로 직접 컴파일 검증은 못했음 — 중괄호/괄호 균형과 기존에 검증된 API 패턴 위주로 신중하게 작성함. go test· pytest는 전부 통과. |
||
|---|---|---|
| ai-service | ||
| backend | ||
| core-backend | ||
| docs | ||
| mobile | ||
| poc/tone-corpus | ||
| scripts | ||
| .env.example | ||
| .gitignore | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| README.md | ||
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 우선) |
문서
- 기획:
docs/PLANNING.md· 결정:docs/decision-log.md(Q1~Q7 확정) - Vision / PRD / 기술설계:
docs/vision.md·docs/PRD.md·docs/tech-design.md - 로드맵 (작업 체크리스트):
docs/roadmap.md - 베타 직전(C):
docs/invite-ops.md·docs/android-release.md·docs/prototype.md - PoC 계획/준비물:
docs/poc-plan.md·docs/poc-materials.md
AI 에이전트 규칙
현재 단계
- Phase 1 A~C까지 반영됨 (서버·Flutter·베타 직전 문서/배포 경로)
- 다음: D — 사람 PoC #1/#3·Q3 인터뷰 (
docs/roadmap.md§3, 맨 마지막) - 프로토타입 공유 URL은
docs/prototype.md의SHARE_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