kotalk/문서/00-overview-and-decisions.md

00. Overview And Fixed Decisions

한 줄 요약

Aster Messenger는 한국어 UI를 기본값으로 두고, 업무적 소통과 친근한 소통 모두에서 카카오톡 PC보다 더 적은 클릭과 더 빠른 복귀를 목표로 설계한 Windows 전용 메신저다.

북극성

• 설치 후 60초 안에 첫 대화를 시작한다.
• 첫 실행 후 3초 안에 최근 대화 목록을 본다.
• 핵심 작업은 2클릭 또는 1단축키 안에 끝난다.
• 네트워크가 흔들려도 메시지가 사라지지 않는다.
• 파일, 링크, 안 읽은 대화, 검색이 카카오톡 PC보다 더 빨리 처리된다.
• 화면은 화려하기보다 조용하고 빠르고 또렷해야 한다.

가장 중요한 방향 전환

이 프로젝트는 특정 제품을 복제하는 클론이 아니다. 방향은 아래처럼 고정한다.

• 목표는 국내 사용자가 즉시 익숙하게 쓰는 것
• 차별화는 더 쉬운 가입, 더 강한 검색, 더 빠른 전환, 더 나은 Windows UX
• 기능 경쟁은 MVP, Parity, Superior 단계로 나눠 진행

고정 의사결정

제품 방향

• 대상: Windows 중심 개인 사용자, 지인 그룹, 스터디, 소규모 팀
• 핵심 가치: 빠른 대화 접근, 정돈된 한국어 UX, 안정성, 재발견 경험
• UX 원칙: 첫 30초 가입, 첫 5분 가치 체감, 빈 화면 금지, 실수 복구 가능

제품 언어

• 1차 출시 UI는 한국어 고정
• 번역체 금지
• 기본 문체는 중립 존댓말
• 날짜, 시간, 검색, IME, 버튼 길이, 라벨 말줄임까지 한국어 기준으로 설계

Windows 앱 기술 선택

• WinUI 3 + .NET 8
• CommunityToolkit.Mvvm 기반 MVVM
• SQLite 로컬 캐시
• 정식 배포는 MSIX
• offline-first shell과 트레이/토스트를 핵심 경험으로 본다.

서버 기술 선택

• 서버 프레임워크: ASP.NET Core 8
• 외부 프로토콜: HTTPS REST + WSS
• 데이터 저장: PostgreSQL
• 단기 상태/팬아웃 보조: Redis
• 첨부파일 저장: MinIO
• 리버스 프록시/TLS: Caddy

가입/인증 선택

• 지금 바로 실행할 Alpha: 이름 + 초대코드
• Private/Closed Beta 기본형: 이메일 1회 확인 + 표시 이름
• 자동 로그인: 기기 세션 기반
• 민감 작업: 재인증
• 장기 로드맵: Windows Hello Passkey

운영 방향

• 기존 Rocky Linux VPS에 Docker Compose 스택으로 시작
• 현재 VPS는 다른 서비스 흔적이 있으므로 메신저는 별도 Linux 계정, 별도 Compose 프로젝트, 별도 볼륨, 별도 서브도메인으로 분리
• Private Alpha 전까지 SSH 하드닝 완료

상위호환의 정의

상위호환은 기능 수가 많다는 뜻이 아니다. 이 프로젝트에서 상위호환은 아래 다섯 가지를 뜻한다.

• 더 쉽게 가입하고 다시 들어올 수 있음
• 더 빨리 원하는 대화와 파일을 찾을 수 있음
• 더 적은 클릭으로 읽고 답하고 정리할 수 있음
• 더 분명한 상태와 복구 흐름을 제공함
• 더 자연스러운 Windows 네이티브 경험을 제공함

하지 않는 것

• 카카오톡 상표, 아이콘, 컬러 조합, 카피, 사운드, 캐릭터를 베끼지 않는다.
• 처음부터 모바일과 웹을 동시에 완성하려 하지 않는다.
• 통화, 결제, 대형 커뮤니티, 피드형 콘텐츠는 MVP에서 제외한다.
• E2EE를 마케팅 문구로 먼저 내세우지 않는다.
• 다국어를 1차 범위에 넣지 않는다.

성공 기준

Alpha

• 10명 내외가 도움 없이 가입 성공률 80% 이상
• 설치 후 첫 대화 시작 중앙값 60초 이하
• 메시지 손실 0건

Closed Beta

• 가입 후 첫 대화 시작 중앙값 45초 이하
• 한국어 UI 잘림/겹침 0건
• 패리티 매트릭스 기준 열위 0 또는 비핵심 영역만 열위

Launch

• 핵심 우위 항목 5개 이상 확보
• 가입, 검색, 파일/링크 찾기, 알림 피로도, Windows 네이티브 경험에서 우세

이번 개정에서 추가된 핵심 문서

• 한국어 UI 문체/라벨/빈 상태 기준서
• 즉시 실행 가능한 가입/온보딩/인증 정책 문서
• 카카오톡 PC 패리티/상위호환 판단 매트릭스