Question 1

Endurain Goals 위젯이 Garmin과 Strava에서 온 중복된 숨겨진 활동을 왜 집계하나요?

Accepted Answer

이는 Endurain v0.17.6의 버그입니다: "hidden"으로 표시된 활동이 여전히 Goals 합계에 포함되어 Garmin 및 Strava에서 중복 가져온 활동이 두 번 집계되었습니다. Endurain v0.18.3 이상으로 업그레이드하세요. 해당 버전에서는 숨겨진 활동이 목표 계산에서 올바르게 제외됩니다.

Question 2

500 오류 'Multiple rows were found when one or none was required'로 Endurain 업로드가 실패하는 문제를 해결하는 방법

Accepted Answer

이 문제는 두 활동이 동일한 시작 시간을 공유할 때 발생합니다: `get_activity_by_start_time`이 `MultipleResultsFound`를 발생시키고, 이후 해당 타임스탬프에서의 모든 업로드가 HTTP 500으로 실패합니다. v0.19.x에서 동일한 파일을 두 번(동시에 또는 순차적으로) 업로드하면 이 문제가 유발될 수 있습니다.

**해결 방법:** Endurain v0.20.0 이상으로 업그레이드하세요. 이제 중복 항목은 검토를 위해 숨겨진 상태로 저장되며, 동일한 파일을 반복해서 업로드해도 500 오류 대신 no-op(아무 작업도 수행되지 않음)으로 처리됩니다.

**v0.19.x에서의 임시 해결 방법:** 시작 시간을 공유하는 중복 활동 중 하나를 삭제한 다음 업로드를 다시 시도하세요. 중복 행이 제거될 때까지 해당 타임스탬프에서의 업로드는 계속 실패합니다.

Question 3

왜 Endurain에서 GET /api/v1/activities/{id}는 삭제되었거나 존재하지 않는 활동에 대해 404 대신 본문이 "null"인 200을 반환하나요?

Accepted Answer

이는 Endurain v0.19.2 및 이전 버전에 존재하는 알려진 API 계약(contract) 버그입니다. 엔드포인트가 누락된 활동에 대해 리터럴 `null` 본문과 함께 `200 OK`를 반환하며, 이는 `Activity` 스키마를 기대하는 생성된 클라이언트를 깨뜨립니다. **수정 방법:** Endurain v0.20.0으로 업그레이드하세요. 이 버전에서는 엔드포인트가 `{"detail": "..."}` 본문과 함께 `404`를 올바르게 반환합니다. **이전 버전에서의 해결 방법:** 클라이언트에서 정확히 `null`과 동일한 응답 본문을 '찾을 수 없음'으로 처리하세요. 예를 들어, HTTP 상태 코드에 의존하는 대신 역직렬화하기 전에 원시 본문을 문자열 매칭으로 확인하는 방식입니다.

Question 4

Polar Flow FIT 파일을 Endurain으로 가져올 때 'processing_failed' 오류를 해결하는 방법

Accepted Answer

이것은 Endurain v0.20.1의 알려진 버그입니다: RPE가 입력되지 않았을 때 Polar Flow가 `workout_rpe = 0`(session field 193)을 기록하지만, Endurain의 ActivityCore 유효성 검사는 10 이상의 값을 요구하므로 Pydantic ValidationError(`Input should be greater than or equal to 10`)가 발생하고 전체 파일이 `processing_failed`로 거부됩니다. **해결 방법:** 10 미만의 값이 설정되지 않은 것으로 처리되는 Endurain v0.20.2 이상으로 업그레이드하세요. **v0.20.1용 임시 해결 방법:** FIT SDK/디코더 도구로 FIT 파일을 편집하여 session field 193(workout_rpe)을 0에서 FIT 무효 값 0xFF로 변경하고, 파일 CRC를 다시 계산한 다음, 웹 UI, `POST /api/v1/activities/upload` 또는 일괄 가져오기를 통해 다시 업로드하세요.

Question 5

로컬 Endurain Docker 설정에서 Strava를 연결할 때 발생하는 500 Internal Server Error를 어떻게 수정하나요?

Accepted Answer

이 오류는 일반적으로 유효하지 않거나 누락된 FERNET_KEY 때문에 발생합니다. Endurain은 이를 사용해 Strava 클라이언트 시크릿을 암호화하므로, 키가 유효하지 않으면 Strava 클라이언트 구성을 저장할 때 HTTP 500으로 실패합니다.

유효한 Fernet 키를 생성하세요:

python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

Docker 환경에서 설정하세요. 예를 들어 docker-compose.yml에서:

services:
  endurain:
    environment:
      FERNET_KEY: "your-generated-fernet-key"

그런 다음 컨테이너를 다시 생성하세요:

docker compose down
docker compose up -d

수정 후에는 유효하지 않은 Fernet 키가 있으면 애플리케이션이 시작 중에 명확한 오류와 함께 실패하며, 시작한 뒤 Strava 연동을 저장할 때 500 오류를 반환하지 않습니다.

Endurain

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트