프로젝트 개요
- 테니스 코칭/관리 플랫폼
- AI 기반 테니스 스윙 자세 분석 앱입니다.
- 모바일 카메라로 스윙을 촬영하면 온디바이스 AI가 관절 각도를 측정하고 점수와 피드백을 제공합니다.
- 분석 결과는 서버에 저장되어 이력 조회, 통계, 랭킹 기능을 지원합니다.
- 코치 ↔ 학생 ↔ 레슨 ↔ 일정
-
사용자 (학생/선수)
• 레슨 신청
• 코치 선택
• 일정 확인
-
코치
• 회원 관리
• 레슨 관리
• 일정 관리
-
관리자
• 전체 사용자 관리
• 데이터 통계
• 운영 관리
• 관리자가 전체 흐름 컨트롤 가능
• 데이터 기반 운영 가능
-
주요기능
: 스윙 분석 카메라로 스윙 촬영 → 포즈 감지 → 팔꿈치/무릎/손목 각도 측정 → 점수(0~100) 및 피드백 생성
: 스켈레톤 합성 분석된 관절 랜드마크를 영상에 오버레이하여 저장
: 분석 이력 서버 저장된 분석 결과 목록 조회, 필터(스윙 타입/최소 점수), 페이징, 소프트 삭제
: 통계 총 횟수, 평균/최고 점수, 주별/월별 트렌드 그래프
: 랭킹 전체 사용자 랭킹 (평균 점수 기준), 내 순위 강조
: 비회원 체험 로그인 없이 분석 체험 가능 (저장 기능 비활성화)
: 프로필 관리 닉네임 변경, 프로필 이미지 업로드, 비밀번호 변경, 회원 탈퇴
-
주안점 :
- 인증 방식: JWT (HS256), HttpOnly 쿠키 또는 Authorization 헤더
- 토큰 구조: Access Token (24시간) + Refresh Token (7일)
- CORS: 화이트리스트 (localhost:3000, localhost:8080, https://acecoach.weare.kr)
- 파일 업로드: 확장자 화이트리스트 (.mp4 .mov .avi .m4v), Content-Type 검증, UUID 파일명
- 데이터 삭제: 소프트 삭제 (deleted_flag = 1), 물리 삭제 금지
- 비밀번호: BCrypt 인코딩, 응답 시 항상 null
기술 스택
iOS(Swift)Android(Kotlin)TensorFlowCustomPoseDetectorEMAFSM