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

111 lines
4.2 KiB
Markdown
Raw Normal View History

2026-04-16 09:24:26 +09:00
# 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 패리티/상위호환 판단 매트릭스