iykyka/docs/roadmap.md

로드맵 & 마일스톤

decision-log.md의 Q3(자율성 단계), Q7(자체앱→OS레이어 순서)에 따른 단계별 계획. 각 단계는 이전 단계의 핵심 가설이 검증되어야 다음으로 넘어간다 — 일정보다 검증 결과가 게이트다.

Phase 0 — 기술 PoC (착수 즉시)

• 온디바이스 말투 학습 품질 검증 (PLANNING.md §4 PoC #1)
• 에스컬레이션 판정기(규칙 기반) 최소 프로토타입으로 오탐/누락 감 잡기
• 목표: "분신이 나답게 느껴지는가"에 대해 Go/No-Go 판단 근거 확보

Phase 1 — v1 클로즈드 베타 (자체 앱, PRD.md 범위)

• 자율성 L0~L2, 시나리오: 읽씹 종결 + 단톡 따라잡기
• 안드로이드 우선, 초대 기반 소규모 베타 (지인 네트워크)
• 게이트: vision.md 성공 지표(자연스러움 70%, 거부율 10% 미만, 안전선 위반 0건) 충족 여부

Phase 1 상세 작업 분해

원칙상 Phase 0(PoC) 검증 후 착수하는 게 맞지만, PoC 실제 실행(참가자 모집)이 보류된 지금 PoC 결과와 무관한 기반 작업은 병행 착수하고, PoC 결과가 있어야 정할 수 있는 세부 값은 자리만 비워두고 나중에 채우는 방식으로 진행한다. 아래 §3이 그 경계선이다.

이 체크리스트가 Phase 1 작업의 단일 기준이다 — 작업을 시작하기 전에 여기서 다음 항목을 확인하고, 끝나면 체크하고, 새로 발견한 하위 작업은 해당 항목 밑에 추가한다 (AGENTS.md "Phase 1 앱 빌드 작업 규칙" 참고).

1. 착수 전 확정 필요 (기술 스택)

• 기술 스택 결정 — tech-design.md §8 (Flutter/Dart 클라이언트, Go 코어 백엔드 + Python AI 서비스 투트랙, PostgreSQL, WebSocket 릴레이, drift+SQLCipher, Gemini 키 분리)

2. 워크스트림별 작업

2.1 코어 백엔드 (Go, PoC 결과 무관 — 지금 착수 가능)

• 계정/인증 (초대 코드 기반 가입) — core-backend/ (Go, Gin), 중복 코드 409 실제 테스트로 확인함
• 메시지 릴레이 서버 (송수신) — core-backend/ WebSocket + REST, 실제 테스트로 브로드캐스트 확인함. 멀티 디바이스 동기화(같은 유저 여러 기기)는 아직 — 지금은 대화방 단위 인메모리 커넥션 매니저뿐
• DB 스키마: users, contacts, conversations, messages, twin_settings, escalation_logs, whitelist_rules — core-backend/models.go (GORM), backend/app/models.py(Python 프로토타입)와 동일 스키마
• 푸시 알림 서비스 연동

backend/(Python 프로토타입)는 그대로 참고용으로 남겨둔다 — core-backend/(Go)가 실제로 쓰는 것.

2.2 AI 서비스 (Python, PoC 스크립트 → 내부 API로 승격)

• poc/tone-corpus/generate_draft.py·escalation_filter.py·retrieve_style.py를 감싸는 FastAPI 서비스로 승격 (Go 코어가 내부망 HTTP로 호출)
• 자율성 엔진(L0~L2) 오케스트레이션: 에스컬레이션 게이트 → 검색 → 초안 생성 → 승인/자동발송 분기 (tech-design.md §3 흐름 그대로) — 이 오케스트레이션이 Go 코어와 Python AI 서비스 중 어디 책임인지는 구현 시작 시 정할 것 (에스컬레이션 하드게이트는 Go 코어에 두는 게 안전선 원칙상 더 맞을 수 있음)
• 온디바이스 말투 이력 저장 + 서버 최소 전송 원칙 구현
• 사후 알림 + 되돌리기 로그 스키마/API

2.3 클라이언트 (Flutter, 안드로이드 우선 빌드)

• 기본 채팅 UI (대화 목록, 대화방) — 무관, 착수 가능
• 온보딩 플로우(5분 온보딩) 뼈대 — 무관, 착수 가능. 말투 학습 UX 디테일만 PoC#1 결과로 조정
• 분신 뱃지·실시간 본인확인·거부권 UX — 클릭 프로토타입 디자인 그대로 구현 가능
• 자율성 설정 화면(L0~L2, 화이트리스트, 상대별 예외) — 무관, 착수 가능
• 에스컬레이션 배너·사후알림·되돌리기 UI — 무관, 착수 가능

2.4 안전장치 통합 (전 구간 필수, 타협 불가)

• 에스컬레이션 하드게이트가 클라이언트·서버 전 구간에서 우회 불가하게 설계
• 데이터 프라이버시: 온디바이스 암호화, 삭제 플로우, 데이터 흐름 대시보드

2.5 QA/테스트

• escalation_filter.py의 자체 테스트를 정식 테스트 스위트로 승격, generate_draft·retrieve_style도 동일하게
• 자율성 플로우(L0→L1→L2) 통합 테스트
• 온보딩·채팅·설정 수동 QA

2.6 베타 배포 준비

• 초대 기반 베타 가입 플로우
• vision.md 성공 지표(자연스러움·거부율·안전선 위반) 계측용 분석/피드백 수집
• 모니터링 대시보드 (에스컬레이션 트리거율, 생성 지연시간, 오류율)

3. PoC 결과가 있어야 정할 수 있는 것 (맨 마지막 — 그 전엔 손대지 않는다)

§2의 워크스트림(2.1~2.6)이 전부 끝나기 전까지는 이 섹션에 손대지 않는다. 순서를 앞당겨서 미리 추측값을 넣지 않는다 — PoC 데이터 없이 정하면 나중에 다시 뒤집어야 하고, 그게 더 큰 낭비다. §2가 다 끝난 뒤에만 이 섹션으로 돌아온다.

• 자율성 기본값(L1 vs L2 어디서 시작할지) — Q3 인터뷰 필요
• 화이트리스트 기본 주제 목록 — 실사용 데이터 필요
• 신뢰 UX 문구/노출 위치 최종 확정 — PoC#3 결과 필요
• 실제 베타 오픈 시점 — vision.md 게이트 통과 필요

4. 권장 착수 순서 (진행 상황)

순서대로 하나씩 완료하고 다음으로 넘어간다. 6번(§3)은 1~5번이 전부 끝난 뒤에만 시작한다 — 중간에 끼워 넣지 않는다.

1. §1 기술 스택 결정 (Go 코어 + Python AI 서비스로 재확정, backend/는 Python 프로토타입 — 설계 참고용으로 남기고 Go로 포팅 필요)
2. [~] 2.1 코어 백엔드 Go 구현 — core-backend/ 완료(가입·메시지·WebSocket 릴레이, 푸시 알림만 남음). 2.3 Flutter 채팅 UI 뼈대는 아직 — 다음 작업
3. 2.2 AI 서비스 (Python, PoC 스크립트를 FastAPI로 승격)
4. 2.3 나머지 UX(온보딩·설정·뱃지)
5. 2.4/2.5 안전장치·QA
6. §3 확정 (PoC 결과 필요 — 1~5번 전부 끝난 뒤에만) → 2.6 베타 오픈

1~5는 PoC 실제 실행(A트랙)과 병행 가능 — PoC가 늦어져도 인프라 작업은 막히지 않는다. 다만 §3 항목과 최종 베타 오픈은 PoC 결과 없이 확정하지 않는다.

Phase 2 — L3 확장 + 베타 확대

• 자리비움 전면 응대(L3) 추가 — Phase 1에서 신뢰가 검증된 경우에만
• 관계 메모, 답장 마감 알림 등 P1 기능
• 베타 규모를 소규모 지인 네트워크 밖으로 확대

Phase 3 — OS 레이어 진입 (성장 전략)

• 전제: Phase 1 자체 앱 베타에서 핵심 가설이 검증된 뒤에만 착수 (decision-log.md Q7)
• 읽기 전용 허브부터 (발송 권한 없음, 문자·이메일 등 안정적 API 채널 우선)
• OS 레이어 내부 순서: 읽기 전용 → 초안 제안 → 제한적 자동응대(L2 그대로 확장)
• 확산 후 완전한 기능(L3·L4 등)이 필요하면 자체 앱으로 유도 — 시작 순서를 뒤집는 뜻이 아님
• 안드로이드 우선, iOS는 이 단계 반응을 본 뒤 자체 앱 전환 유도 전략으로 대응

Phase 4 — L4 분신 협상 + B2B 확장

• 사용자 기반이 어느 정도 쌓여 네트워크 효과가 의미 있을 때 착수
• 기업용 고객 응대 분신(B2B)은 이 시점 이후 별도 트랙으로 검토

명시적으로 지금 계획하지 않는 것

• Phase 1 게이트를 통과하기 전에 Phase 2 이후 기능을 설계/개발하지 않는다.
• OS 레이어와 자체 앱을 동시에 만들지 않는다 (decision-log.md Q7 근거).