Repository navigation
Feat/lunge repetition counting - #829
Merged
Merged
Conversation
standing_confirm_sec(0.2초)이 3fps 표본 간격(약 0.33~0.4초)보다 짧아, 정점에서 짧게만 서는 빠른 템포에서 두 반복이 하나로 합쳐지던 문제를 수정했다. 표본 간격(dt) 자체가 이미 확인 지연 이상이면 첫 표본만으로 기립을 확정한다 — 고fps 실시간 스트리밍에서는 기존과 동일하게 다중 표본 체류를 요구해 영향이 없다. 2026-09-21 신규 촬영 영상 6개를 사람이 직접 눈으로 검증(프레임 단위, 파일명·AI 결과에 의존하지 않음)하고 원본 무릎 각도 추적표와 대조해 이 문제를 발견했다. 수정 후 normal_01·normal_02는 5/5로 정확히 일치했고, 기존 라벨 영상 회귀도 확인했다(ROI 영상은 5→6회로 개선, 나머지 변화 없음). 상세 방법·영상별 판정· 남은 한계(3fps 표본화로 빠른 정면 촬영에서 일부 반복이 아예 감지되지 않는 문제)는 docs/verification/2026-09-21-verification-report.md 참고. 추가로 풀 스쿼트/하프 스쿼트 깊이 모드 선택의 AI 서버 측 배선(SquatThresholds 프리셋, gRPC depth_mode 필드, 세션별 상태 전달)을 함께 넣었다 — 하프 스쿼트 목표 밴드(115~140도)는 실촬영 검증 전 잠정값이며, backend·frontend 연동은 별도로 진행한다. AI 테스트 205 passed(61 subtests) — 기존 200 대비 신규 5건 추가, 퇴행 없음. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- 스쿼트: 운동 시작 전 풀/하프 모드 선택(V23), 세션별 임계값 프리셋으로 완성 판정, 세션 종료 후 깊이 정확도 점수·등급·회차별 코멘트를 리포트에 노출 - 런지: 캘리브레이션 대기 제거, 스탠스 기반 무릎 사이클 감지로 재설계하고 바닥 판정과 좌/우 귀속을 분리(V22, 측면 촬영 전용) - 런지 좌우 채점을 위해 rep당 반환값을 좌우 평균 → 앞다리(lead leg) 무릎각으로 변경하고, proto에 lead_leg 필드 추가, pose_data에 V24 마이그레이션으로 프레임 단위 저장 - LungeDepthAnalysisCalculator 신규: 스쿼트 FULL 채점 공식 재사용, 좌우 평균·비대칭 코멘트, 같은 다리 내 인접 회차 비교(워킹 런지 대응), 아슬아슬 통과 코멘트 - AI 서버 pytest 206개, 백엔드 gradle test 전체 통과 확인 하프 스쿼트 목표 밴드(115~140도)는 실촬영 검증 전 잠정값이다(docs/decisions 참고). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- 기존에 스쿼트 배치 분석·기준영상 빌더에만 쓰이던 torso_tilt 계산을 스트리밍 경로까지 확장하고(squat_analyzer.py), 런지에도 같은 공식으로 새로 추가(lunge_analyzer.py) — rep 그룹핑용 shoulder/hip 중점을 재사용해 추가 랜드마크 파싱 없이 계산 - proto PoseDataRequest에 torso_tilt_deg 필드 추가, pose_data에 V25 마이그레이션 - SquatTrunkLeanAnalysisCalculator/LungeTrunkLeanAnalysisCalculator 신규: rep 내 평균 기울기로 채점(깊이 점수가 최솟값 프레임을 쓰는 것과 다른 기준 — 자세는 rep 내내 얼마나 무너졌는지가 의미 있음). 스쿼트는 기존 실시간 BACK_BENT 임계값(35도)과 일치시켜 실시간 피드백과 세션 후 점수가 같은 경계를 말하도록 함 - 런지는 의도적 전방 기울임이 정상 기법이라(Farrokhi et al. 2008, JOSPT) 스쿼트보다 훨씬 관대한 밴드(35/55도)를 쓰고, 실촬영 검증 전 잠정값임을 명시 - 무릎 valgus(정면 지표)는 단일 측면/45도 카메라로 신뢰 불가해 이번 범위에서 제외 - AI 서버 pytest 211개, 백엔드 gradle test(report 패키지 전체 + 관련 통합 테스트) 통과 확인 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- "무릎이 발끝을 넘는가"(knee over toe)는 최근 재활 문헌에서 근거 없는 통념으로 반박돼 제외. 대신 Escamilla et al. 계열 연구가 반복 재현한 "짧은 보폭이 깊은 굴곡 구간에서 슬개대퇴 관절 부하를 늘린다"는 검증된 메커니즘을 채택 - lunge_analyzer.py가 "런지 자세인가"만 판정하던 stagger(발목 간 거리/어깨-엉덩이 길이) 값을 버리지 않고 그대로 흘려보내도록 확장 — 체간 기울기 때와 같은 배관 패턴 (proto stagger_ratio 필드, pose_data V26 마이그레이션) - LungeStepLengthAnalysisCalculator 신규: rep의 최심 프레임(깊이 계산기와 같은 대표 프레임) stagger를 채점. 임계값(1.0/0.6)은 실촬영 3개 중 이미 "얕음"으로 확인된 영상이 "정상" 영상보다 stagger도 독립적으로 낮게 나온 관찰(0.88 vs 1.12) + 문헌 근거의 잠정값 — VALIDATE 표기, 확정 주장 안 함 - 런지 전용(스쿼트는 보폭 개념 없음) — 깊이·체간 기울기와 달리 스쿼트 형제 계산기 없음 - AI 서버 pytest 212개, 백엔드 gradle test(report 패키지 전체 + 관련 통합 테스트) 통과 확인 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- 폰에서 앱은 열리는데 API가 전부 "응답 없음"으로 실패하던 문제: PC 방화벽이 도커 포트(백엔드/AI) 접속을 막아서였다. 방화벽을 건드리지 않고 Metro(8081)가 /__backend, /__ai 를 PC 안으로 전달하는 개발용 프록시(metro.config.js)를 추가하고, EXPO_PUBLIC_API_VIA_METRO=1 일 때만 앱이 그 경로를 쓴다(services/devProxy.ts). 릴리스 번들에는 영향이 없다 - 운동 화면: 하프 스쿼트 선택 제거(항상 풀 스쿼트), "녹화" 문구를 "운동 시작/종료"로 변경, 런지 안내 문구를 현재 규칙(측면 촬영·무릎 굽힘 사이클)에 맞게 수정 - 런지도 운동 종료 후 리포트로 이동한다 — 이전에는 "자세 점수는 측정하지 않습니다" 알림만 떠서 새 깊이·체간·보폭 카드가 앱에서 안 보였다. 종료 직후 리포트 선계산 지연(2~3초)은 자동 재시도로 흡수 - 촬영 시 화면 번쩍임: ~3fps takePictureAsync 마다 재생되던 셔터 애니메이션을 animateShutter=false 로 끔 - 스쿼트 체간 기울기 채점 실측 보정: 정상 스쿼트 3개의 rep 평균 기울기가 29.8~31.3도인데 20도를 만점 경계로 잡아 멀쩡한 스쿼트가 FAIR로 깎였다 → 만점 35도(실시간 BACK_BENT 경계와 동일), 45도에서 60점. 런지 체간(실측 10~26도)은 기존 밴드 유지 - 인접 회차 급락 코멘트는 해당 회차가 75점 미만일 때만 낸다(93점인데 "많이 숙여졌어요"가 뜨던 모순 제거) - e1_walkthrough.py: 런지와 새 점수 카드 3종까지 검증, 런지는 avgSyncRate 0을 정상으로 취급 - demo-up.bat: 도커 스택 + Expo 원클릭 기동 실측 e2e(도커 스택, 영상 재생): 스쿼트 5/5·체간 93점, 런지 10/10·깊이/체간/보폭 카드 생성 통과. 폰 카메라 실시간 경로와 폰→프록시 접속은 아직 미검증. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
스쿼트를 고르고 런지를 해도, 런지를 고르고 스쿼트를 해도 횟수가 세지던 문제를 막는다. 두 분석기 모두 «무릎이 100° 근처까지 굽었다 펴졌는가» 만 봐서 둘 다 통과했기 때문이다. 발목 간격과 허벅지 기울기 차이를 함께 보는 stance 모듈을 두 분석기가 공유한다. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
앱이 «똑바로 서기 → 준비 완료 → 운동 중» 을 화면에 보여줄 수 있도록 응답에 스쿼트 카운터의 단계(stage)와 안내 문장(guidance)을 싣는다. 가시성 부족·정상·rep 완료 응답 세 곳 모두 포함. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
- 준비 상태 배너(ReadinessBanner): 전신 보이기 → 똑바로 서기 → 운동 시작 단계를 화면에 표시 - 촬영 해상도 선택(pictureSize)과 EXPO_PUBLIC_FAST_CAPTURE 로 프레임 크기·지연 축소 - rep 완료 시 «✓ N회» 표시, AI 연결 오류·미응답 안내 - 3D 시범 마네킹(MannequinDemo, 오프라인 번들) 과 생성 스크립트(tools/mannequin) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
축별 점수(깊이·체간·보폭) 중 가장 낮은 항목을 처방 문장과 함께 보여주고, 후반부로 갈수록 점수가 떨어지는 경우(피로)와 잘한 점을 함께 표시한다. 보폭·런지 체간은 검증 중인 기준임을 표기. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
알고리즘 상세: 관절각·체간 기울기·횟수 세기, 깊이·체간 점수 수식, DTW 싱크로율과 사용 기술. 관절 추출: MediaPipe 33개 중 스쿼트 8개·런지 12개의 번호와 용도. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
운동 목표와 친구 모임 화면, 웹 인증 저장소, 자세 응답 가로세로 비율, 동작 비교 라이브러리와 3D 비교 확장의 현재 진행 내용을 저장한다. 검증: 동작 비교 32개 통과, AI 응답 5개 통과, TypeScript 타입 검사 통과.
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars. ⚙️ Run configuration
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.