Question 1

なぜ Endurain Goals ウィジェットが Garmin と Strava からの重複した非表示アクティビティをカウントするのですか？

Accepted Answer

これは Endurain v0.17.6 のバグです。「hidden」としてマークされたアクティビティが依然として Goals の合計に含まれ、Garmin と Strava からの重複インポートが二重にカウントされていました。Endurain v0.18.3 以降にアップグレードしてください。そこでは、「hidden」のアクティビティが Goals の計算から正しく除外されます。

Question 2

Endurainのアップロードが500エラー 'Multiple rows were found when one or none was required' で失敗する場合の修正方法

Accepted Answer

これは、2つのアクティビティが同じ開始時刻を共有している場合に発生します。`get_activity_by_start_time` が `MultipleResultsFound` を送出し、そのタイムスタンプでの以降のアップロードがすべて HTTP 500 で失敗します。v0.19.x では、同じファイルを2回アップロードすることで（同時でも、順番に実行した場合でも）この問題が発生する可能性があります。

**修正:** 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コントラクトのバグです。存在しないアクティビティに対して、エンドポイントがリテラルの`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 の既知のバグです: Polar Flow は RPE が入力されていない場合に workout_rpe = 0(セッションフィールド 193)を書き込みますが、Endurain の ActivityCore バリデーションでは 10 以上の値が要求されるため、Pydantic ValidationError(Input should be greater than or equal to 10)が発生し、ファイル全体が processing_failed として拒否されます。修正: Endurain v0.20.2 以降にアップグレードしてください。これらのバージョンでは 10 未満の値は未設定として扱われます。v0.20.1 の回避策: FIT SDK/デコーダーツールで FIT ファイルを編集し、セッションフィールド 193(workout_rpe)を 0 から FIT の無効値 0xFF に変更し、ファイルの CRC を再計算してから、Web 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

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト