iykyk_msn/README.md

IYKYKA (MSN) — 멀티 컨텍스트 메신저

Flutter 클라이언트와 Node.js 서버로 구성된 메신저 예제 프로젝트입니다. 컨텍스트(일상·업무 등)별로 공간을 나누고, 그 안에서 방·메시지·프로필을 사용합니다.

---

사전 요구 사항

구분	내용
서버	Node.js (npm)
모바일	Flutter SDK

---

서버 (REST + WebSocket)

cd server
npm install
npm run dev

항목	값
HTTP	http://127.0.0.1:8787
WebSocket	ws://127.0.0.1:8787/ws?token=JWT
데이터베이스	server/data/msn.db (SQLite, Node 내장 node:sqlite)

데모 계정 (최초 기동 시 시드)

alice@demo.msn이 없으면 서버가 한 번만 데모 데이터를 넣습니다.

이메일	비밀번호	비고
alice@demo.msn	demo1234	일상·데모 회사 컨텍스트 보유. 업무 공간에서 샘플 DM 확인 가능
bob@demo.msn	demo1234	멀티 기기·다른 사용자 테스트용

DB를 처음부터 다시 쓰려면 서버를 끄고 server/data/msn.db를 삭제한 뒤 다시 실행합니다.

---

모바일 (Flutter)

mobile/에서 실행합니다.

cd mobile
flutter pub get
flutter run --dart-define=API_BASE=http://127.0.0.1:8787

• Android 에뮬레이터에서 PC의 로컬 서버에 붙일 때:
  --dart-define=API_BASE=http://10.0.2.2:8787
• android/ / ios/ 폴더가 없다면 mobile/ 안에서 한 번 flutter create . 로 생성합니다.

웹 (flutter run -d chrome)

sqflite가 웹에서 동작하지 않아 채팅 로컬 캐시 전체는 Android / Windows 데스크톱 / iOS 사용을 권장합니다.

Firebase / FCM

푸시 알림·토큰 등록을 쓰려면 flutterfire configure 등으로 firebase_options 및 플랫폼 설정을 맞춰야 합니다. 미구성 시에도 앱은 기동할 수 있도록 처리되어 있습니다.

---

구현된 기능 요약

• JWT 인증, 세션, 선택된 컨텍스트(메신저 공간) — 보안 저장소·설정 연동
• 컨텍스트(일상·업무 등), 이메일 초대, contextId 기준 프로필 API
• 1:1·그룹 방, WebSocket 메시지, 컨텍스트별 로컬 SQLite 메시지 캐시
• 푸시 토큰 등록(FCM 연동 시 서버에 등록), 검색·읽음 처리(서버 확장), 앱 메뉴에서 그룹 방 생성
• 설정(테마·알림), 검색 탭(메시지/방/친구), 전송 재시도 큐, 타이핑·1:1 읽음 표시(WebSocket) 등

---

빌드·검증 (참고)

# 모바일
cd mobile && dart analyze lib && flutter test

# 서버
cd server && npx tsc --noEmit