HealthKit 통합, 보안 강화 및 프로젝트 문서화 완료

[seunggulee1007]

개요🔎

이 PR은 iOS HealthKit 통합, API 키 보안 강화, 실시간 지도 추적 기능 개선, 그리고 포괄적인 프로젝트 문서화를 포함합니다.

작업사항✍🏻

🏥 HealthKit 통합

• iOS HealthKit 권한 및 설정 추가
• 실시간 심박수 추적 기능 구현
• HealthService 클래스 구현
• health 패키지 의존성 추가

🔒 보안 강화

• Git 히스토리에서 노출된 API 키 완전 제거
  • git-filter-repo를 사용하여 모든 브랜치의 히스토리 정리
  • 노출된 Google Maps API 키 제거
• 환경 변수 기반 API 키 관리 시스템 구축
  • .env 파일을 통한 중앙화된 키 관리
  • 빌드 시 자동으로 Info.plist에 주입하는 스크립트 추가
  • Info.plist는 플레이스홀더만 유지
• API 키 노출 방지 자동화
  • Pre-commit Git Hook 구현
  • Google, AWS, OpenAI API 키 패턴 자동 감지
  • .env 파일 커밋 시도 차단
  • 설치 스크립트 및 상세 문서 제공

🗺️ 지도 기능 개선

• 실시간 GPS 경로 추적 기능 개선
• 디버그 모드에서도 실제 지도 표시
• Google Maps API 키 없이도 안전하게 작동하도록 수정
• 지도 위젯 리팩터링 및 성능 최적화

📱 UI/UX 개선

• 러닝 화면 UI 대폭 개선
• 위젯 구조 리팩터링
• 실시간 통계 표시 개선

📸 스크린샷 및 문서

• iOS 앱 스크린샷 7장 추가
  • 로그인/회원가입
  • 홈 화면
  • 러닝 화면
  • 통계
  • 히스토리
  • 프로필
• 스크린샷 가이드 작성

📚 프로젝트 문서화

• 포트폴리오 문서 완성
  • PORTFOLIO.md 작성
  • 개발자 정보, 프로젝트 소개, 기술 스택 등
• 포괄적인 가이드 문서 추가
  • ARCHITECTURE.md: 아키텍처 설계 문서
  • DEVELOPMENT_WORKFLOW.md: 개발 워크플로우
  • TECH_CHALLENGES.md: 기술적 도전과제 및 해결 방안
  • BUILD_DEPLOY_GUIDE.md: 빌드 및 배포 가이드
  • QUICK_START.md: 빠른 시작 가이드
  • ENV_CONFIG_GUIDE.md: 환경 설정 가이드
  • GOOGLE_MAPS_API_SETUP.md: Google Maps API 설정 가이드
  • README_GUIDE.md: README 작성 가이드
• README.md 대폭 개선
  • 1,000+ 라인의 전문적인 프로젝트 소개
  • 기술 스택, 아키텍처, 주요 기능 상세 설명
  • 설치 및 실행 가이드
  • 스크린샷 및 데모

🔧 개발 환경 개선

• CI/CD 워크플로우 추가
  • GitHub Actions CI 설정
  • 포트폴리오 통계 자동 생성
• TaskMaster 설정 추가
• Android 매니페스트 업데이트

🧪 테스트 추가

• HealthService 테스트
• Home 화면 위젯 테스트
• Running 화면 위젯 테스트
• Running Map 위젯 테스트

🗑️ 불필요한 문서 정리

• 임시/중복 문서 제거 (14개 파일)
  • CRASH_FIX.md
  • ENV_MIGRATION_COMPLETE.md
  • GOOGLE_LOGIN_FIX_GUIDE.md
  • NONCE_*.md
  • REFACTORING_*.md
  • 기타 임시 문서들
• docs/ 디렉토리로 구조 정리

주의사항❗️

🔐 보안 관련 (매우 중요!)

새로운 팀원 또는 프로젝트를 새로 클론하는 경우:

1. Git Hooks 반드시 설치

   ./scripts/install-git-hooks.sh

2. .env 파일 생성 및 설정

   cp .env.example .env
   # .env 파일에 실제 API 키 입력

3. Google Cloud Console 조치

   • 노출된 기존 API 키 삭제: AIzaSyANZQNpa2Or0JuXQNiCU9W9z9PiRMo8ndU
   • 새 API 키 발급 및 제한 설정 (번들 ID, Maps SDK for iOS)

절대 금지:

• ❌ API 키를 코드에 하드코딩
• ❌ .env 파일을 Git에 커밋
• ❌ Git Hooks 우회 (--no-verify)

📱 Xcode 설정 필요

빌드 시 자동으로 API 키를 주입하려면:

1. Xcode에서 Runner 프로젝트 열기
2. Build Phases → + → New Run Script Phase
3. 스크립트 추가:

   "${SRCROOT}/scripts/setup_env.sh"

4. "Compile Sources" 전으로 이동

🧪 테스트

# 전체 테스트 실행
flutter test

# 커버리지 포함
flutter test --coverage

관련 이슈

Closes #28

---

📊 변경 통계

• 86개 파일 변경
• 9,446줄 추가
• 4,419줄 삭제

🎯 주요 성과

✅ 보안: Git 히스토리에서 민감한 정보 완전 제거, 다층 보안 시스템 구축
✅ 기능: HealthKit 통합으로 실시간 건강 데이터 추적
✅ 문서화: 1,000+ 라인의 전문적인 프로젝트 문서
✅ 자동화: CI/CD 파이프라인 및 보안 자동 검사
✅ 품질: 테스트 추가 및 코드 리팩터링

---

⚠️ 이 PR을 머지하기 전에 반드시 Google Cloud Console에서 노출된 API 키를 삭제하세요!