開発ログ

プロジェクト準備完了（WBS 0）

検証計画・設計 HTML 資料、WBS・ガントチャート、リポジトリルールを整備。MS-0 達成。

サーバー実装着手・runbook v1.0 作成

server/（FastAPI + PostgreSQL + docker-compose）、 scripts/test-feedback.ps1、 runbook-phase1-server.html v1.0 を作成。 当初は Tunnel 新規構築（horse-feedback）を想定。

プライベート PC へ開発環境移行

リポジトリをプライベート PC（Windows 11）へ移行し初回コミット（2c6f420）。 開発の主戦場を自宅 Windows PC とする。

協議: PoC Cloudflare Tunnel の再利用可否

論点: WBS 1.1.1 の Tunnel 構築を一から行うか、 過去 PoC（C:\Dev\PoC_スマート農業環境構築）の資産を活用するか。

• PoC 記録および疎通確認により、https://api.dammy-otoko.com/ping が応答（Tunnel 稼働中）と確認
• Named Tunnel poc-api-tunnel、Public Hostname api.dammy-otoko.com → http://api:8000 が本プロジェクトの docker-compose と整合
• DNS 移管（Squarespace → Cloudflare）は PoC で完了済み

決定: Tunnel・DNS・Hostname は再利用し、作業範囲を「cloudflared の接続先を Pi から Windows PC へ移す」に限定する。

参照: Manus 作業記録（Raspberry Pi PoC）、 PoC ナレッジ資料（Phase 1-4）

runbook v1.1・WBS 更新（手順変更を文書化）

runbook-phase1-server.html を v1.1 に更新。 新規 Tunnel 作成手順を「スキップ可能」に変更し、実施順序を Docker 起動 → ローカル API 疎通 → cloudflared 移行 に並べ替え。 WBS・index・README を同期。

Docker Desktop インストール

Windows 11 に Docker Desktop 4.76.0 をインストール（共有アカウントではなく personal アカウント向けの設置）。 初回起動時の Docker Hub サインインはスキップ（ローカル compose 利用のみのため不要）。 インストール先: %LOCALAPPDATA%\Programs\DockerDesktop\

WBS 1.1.2 / 1.1.3 ローカル疎通完了

以下を確認済み。

• docker compose up -d --build db api 成功
• GET /api/v1/health → {"status":"ok"}
• POST /api/v1/feedback → HTTP 201、画像は data/storage/ に保存

課題: test-feedback.ps1 の JSON 送信失敗（Windows）

事象: curl.exe -F "inference_result={...}" で API が inference_result must be valid JSON を返す。

原因: Windows の curl にインライン JSON を渡すとエスケープが壊れる。 Set-Content -Encoding utf8 使用時は BOM が付き JSON パースも失敗。

対応: scripts/inference.json を [System.IO.File]::WriteAllText で生成し、 -F "inference_result=<...json" で送信するようスクリプトを修正。

次の作業（WBS 1.1.1 残）

1. server/.env の TUNNEL_TOKEN を PoC の poc-api-tunnel トークンに設定
2. Raspberry Pi 上の cloudflared を停止（二重コネクタ回避）
3. 本 PC で docker compose --profile tunnel up -d cloudflared
4. test-feedback.ps1 -BaseUrl "https://api.dammy-otoko.com" で MS-1 確認

手順詳細: Phase1 サーバー手順 セクション 6

課題: TUNNEL_TOKEN に Tunnel ID（UUID）を設定

事象: cloudflared が Provided Tunnel token is not valid. で Restarting (255)。Tunnel 経由は Cloudflare error 1033。

原因: TUNNEL_TOKEN に Tunnel ID（UUID 形式）を設定していた。 必要なのは Zero Trust → Configure で取得する eyJ... 形式の Connector トークン。

対応: Cloudflare ダッシュボード（Docker タブまたは Windows 手順内のトークン）から 正しいトークンを server/.env に設定。cloudflared.exe の Windows ネイティブインストールは不要 （本プロジェクトは Docker コンテナで運用）。 詳細: Phase1 ナレッジ K-03

WBS 1.1.1 完了・MS-1 達成

以下を確認し、WBS 1.1 および MS-1 を完了とした。

• Raspberry Pi（~/poc-api）で sudo docker compose stop cloudflared（サービス名 cloudflared）
• 本 PC で docker compose --profile tunnel up -d cloudflared → Up（precheck 成功）
• curl.exe https://api.dammy-otoko.com/api/v1/health → {"status":"ok"}
• test-feedback.ps1 -BaseUrl "https://api.dammy-otoko.com" → HTTP 201、data/storage/ に画像保存

次: WBS 1.2 スタブ Android アプリ。端末からの FB 送信検証（1.2.3）は Flutter 実装後に実施。

課題: Git push に -m を付けて失敗

事象: git add . 後に git push -m "..." を実行し unknown switch 'm'。

原因: コミットメッセージ用の -m は git commit のオプション。 add の次は push ではなく commit が必要。

対応: git commit -m "..." → git push の順で実行。 詳細: Phase1 ナレッジ K-14

WBS 1.2.1 / 1.2.2 Flutter スタブ実装

app/ に Flutter スタブを作成し、F-01〜F-03 を実装。

• F-01 ギャラリー画像選択（image_picker）
• F-02 ダミー推論（ラベル A/B/C、スコア 0.75〜0.99）
• F-03 FB 送信（POST /api/v1/feedback、デフォルト URL: https://api.dammy-otoko.com）
• flutter analyze / flutter test 成功

残: WBS 1.2.3 — 実機でアプリを起動し Tunnel 経由で FB 送信を確認。

cd app
flutter run