혁신적인 블루투스 카드 리더 기반 모바일 금융 서비스

SSOK은 React Native와 TypeScript로 구축된 차세대 모바일 금융 플랫폼입니다. 블루투스 카드 리더기와의 연동을 통해 안전하고 편리한 결제 경험을 제공합니다.

• 송금 & 결제: 실시간 계좌 이체 및 블루투스 결제
• 계좌 관리: 다중 계좌 연동 및 잔액 조회
• 거래 내역: 상세한 거래 기록

• 다중 인증: PIN, SMS 인증
• 토큰 관리: JWT 기반 자동 토큰 갱신

• 디바이스 관리: 페어링된 디바이스 목록 관리
• 블루투스 송금: 상대방 계좌 정보 없이 송금 가능

• 직관적 UI: Material Design 기반 모던 인터페이스
• 부드러운 애니메이션: React Native Reanimated 활용
• 접근성: 스크린 리더 및 키보드 네비게이션 지원

• React Native: 크로스 플랫폼 네이티브 앱 개발
• TypeScript: 타입 안전성 및 개발 효율성
• Expo Router: File-based routing 시스템
• React Native Reanimated: 고성능 애니메이션

• Zustand: 가벼운 상태 관리 라이브러리
• React Hook Form: 효율적인 폼 처리
• Expo SecureStore: 안전한 로컬 데이터 저장

• Expo Notifications: 푸시 알림 시스템
• React Native BLE Advertise: 블루투스 광고 기능
• React Native BLE PLX: 상대방 기기 스캔

• ESLint & Prettier: 코드 품질 관리
• TypeScript: 정적 타입 검사
• Metro: React Native 번들러
• EAS Build: 클라우드 빌드 시스템

ssok/
├── 📱 app/                  # Expo Router 기반 화면
│   ├── (auth)/             # 인증 플로우
│   ├── (app)/              # 메인 앱
│   │   ├── (tabs)/         # 탭 네비게이션
│   │   ├── transfer/       # 송금 화면
│   │   └── account/        # 계좌 화면
├── 🧩 modules/             # 기능별 모듈
│   ├── auth/               # 인증 시스템
│   ├── bluetooth/          # 블루투스 연동
│   ├── transfer/           # 송금/결제
│   ├── account/            # 계좌 관리
│   ├── settings/           # 사용자 설정
│   └── notification/       # 알림 시스템
├── 🎨 components/          # 공용 UI 컴포넌트
├── 🏪 stores/              # 전역 상태 관리
├── 🔧 utils/               # 유틸리티 함수
├── 🎯 hooks/               # 커스텀 훅
├── 🌈 theme/               # 테마 및 스타일
├── 🔌 services/            # 외부 서비스 연동
└── 📡 api/                 # API 클라이언트

• 독립성: 각 모듈은 독립적으로 개발 및 테스트 가능
• 재사용성: 컴포넌트, 훅, 유틸리티 재사용 극대화
• 확장성: 새로운 기능 모듈 쉽게 추가 가능

• TypeScript First: 모든 코드에 타입 정의
• Functional Components: 함수형 컴포넌트 및 훅 활용
• Clean Code: ESLint, Prettier로 코드 품질 유지
• Documentation: 모든 모듈에 README 및 API 문서 제공

• Zustand: 간단하고 직관적인 전역 상태
• Local State: 컴포넌트별 로컬 상태 최소화
• Derived State: 필요 시 계산된 상태 활용

• Node.js 18+
• pnpm 8+
• Expo CLI
• React Native development environment

# 의존성 설치
pnpm install

# 개발 서버 시작
pnpm start

# iOS 시뮬레이터 실행
pnpm ios

# Android 에뮬레이터 실행
pnpm android

# 환경 변수 설정
cp .env.example .env.local

# EAS 설정 (빌드용)
eas login
eas build:configure

• Modules README: 모듈 구조 및 개발 가이드
• App README: 화면 구조 및 네비게이션
• API Documentation: API 명세 및 사용법

• Auth Module: 인증 시스템
• Bluetooth Module: 블루투스 연동
• Transfer Module: 송금/결제
• Account Module: 계좌 관리
• Settings Module: 사용자 설정

# 단위 테스트
pnpm test

# E2E 테스트
pnpm test:e2e

# 커버리지 확인
pnpm test:coverage

• Unit Tests: 개별 함수 및 컴포넌트 테스트
• Integration Tests: 모듈 간 상호작용 테스트
• E2E Tests: 사용자 시나리오 기반 전체 플로우 테스트

# 개발용 빌드
eas build --profile development

# 프로덕션 빌드
eas build --profile production

# 앱스토어 배포
eas submit --platform ios

# 플레이스토어 배포
eas submit --platform android

• 암호화: 민감한 데이터 AES-256 암호화
• 토큰 관리: JWT 자동 갱신 및 만료 처리
• 로컬 저장: Expo SecureStore 활용

• HTTPS: 모든 API 통신 HTTPS 강제
• Certificate Pinning: SSL 인증서 고정
• Rate Limiting: API 호출 빈도 제한

• 코드 난독화: 프로덕션 빌드 시 코드 보호
• 루팅 탐지: 루팅/탈옥 디바이스 차단
• 디버깅 방지: 릴리즈 모드에서 디버깅 비활성화

• ESLint 규칙 준수
• TypeScript 타입 오류 해결

• GitHub Issues: 버그 리포트 및 기능 요청
• Slack: 실시간 개발 논의
• Jira: 프로젝트 관리 및 태스크 추적