Simply Run / Move with intent

모바일 우선 러닝 대시보드이자 App Store용 iOS 앱입니다. 웹에서는 러닝 요약을 JSONBin에 저장하고, iOS 앱에서는 사용자 기기에만 저장합니다. GPX 및 운동 경로 좌표는 서버로 보내지 않고 현재 세션에만 보관합니다. 지도는 MapLibre GL JS와 OpenFreeMap을 사용합니다.

핵심 기능

• 주간 목표, 최근 러닝, 월간 통계, 페이스 추세와 구간 분석
• GPX 파싱, 날짜 기반 기록 연결, 경로 애니메이션
• Apple 건강 export.xml 러닝 요약 가져오기
• Apple Watch 및 Apple 건강의 러닝·운동 경로 가져오기
• iOS 앱에서 선택한 러닝과 GPX 경로를 Apple HealthKit에 저장
• AI 코치와 로컬 기본 코칭
• 설치 가능한 PWA와 모바일 하단 내비게이션

데이터 원칙

• 웹 JSONBin 저장: 날짜, 시작 시각, 거리, 시간, 페이스, 평균 심박수, 칼로리, 메모, 출처
• iOS 기기 저장: 동일한 러닝 요약
• 세션 저장: GPX 및 Apple 건강 운동 경로 좌표
• 저장하지 않음: GPX 원본, 위치 좌표, JSONBin 키

JSONBin 요청은 브라우저가 아닌 /api/runs 서버 함수에서 처리합니다. X-Master-Key는 서버에서만 추가되므로 클라이언트 번들에 키가 포함되지 않습니다. iOS 네이티브 앱은 JSONBin을 사용하지 않습니다.

로컬 실행

npm install
npm run dev

루트에 .env를 만들고 다음 서버 전용 값을 설정합니다.

JSONBIN_API_KEY=your_master_key_here
JSONBIN_BIN_ID=your_bin_id_here
ANTHROPIC_API_KEY=optional_anthropic_key

VITE_ 접두사는 브라우저에 값을 노출하므로 사용하지 않습니다.

확인 명령

npm run lint
npm run build

Vercel

프로젝트 환경 변수에 JSONBIN_API_KEY, JSONBIN_BIN_ID를 등록합니다. AI 코치를 원하면 ANTHROPIC_API_KEY도 추가합니다. GitHub의 master 브랜치가 연결되어 있으면 push 후 자동 배포됩니다.

iMac에서 iOS 마무리

Apple HealthKit은 브라우저/PWA에서 직접 사용할 수 없으므로 iOS 네이티브 앱이 필요합니다. iOS 프로젝트와 HealthKit 플러그인은 저장소에 포함되어 있습니다.

npm install
npm run ios:sync
npm run ios:open

Xcode에서 다음만 완료합니다.

1. App 타깃의 Signing & Capabilities에서 Apple Developer Team을 선택합니다.
2. HealthKit capability가 표시되는지 확인합니다. 없으면 + Capability에서 HealthKit을 추가합니다.
3. Bundle Identifier com.xploride.running이 계정에서 사용 가능하지 않으면 고유한 값으로 변경합니다.
4. 실제 iPhone을 연결해 빌드하고 건강 접근을 허용합니다. HealthKit 쓰기는 시뮬레이터보다 실제 기기 검증이 적합합니다.
5. 앱 설정의 APPLE 건강 동기화에서 Apple Watch 러닝을 가져옵니다.
6. 기록 화면에서 건강 저장을 눌러 GPX 또는 수동 기록이 Apple 건강에 저장되는지 확인합니다.

서명과 HealthKit capability 활성화에는 Apple Developer 계정과 macOS/Xcode가 필요합니다. Windows에서는 웹 빌드와 iOS 프로젝트 생성·동기화까지만 가능합니다.