２ ジャガイモ生育障害 AI画像診断アプリ
農家からの生育障害に応える方策として、スマホによる画像診断システムを作成した。
Potato Guard 開発計画書
当初、生育障害のDBをWeb画像から収集して作成しようとしたが、Web画像の利用に制約があるため、利用可能な画像サイトを選定した。画像DB作成に時間を要するため、30種の生育障害を選定するとともにAIの画像診断技術により、生育障害を判定することとした。システムは有料AIを使用することから、公表は実効性を確認する必要がある。
Project フロー
Project Documentation · March 2026
PotatoGuard
Project Flow
ジャガイモ生育障害 画像診断アプリ — 開発フロー・作業状況・今後のロードマップ
完了 Done
進行中 In Progress
次のステップ Next
将来 Future
システム全体像 — How It Works
農家のスマホ
index.html
→
写真撮影
1〜5枚
→
Xserver
diagnose.php
→
Claude API
claude-opus-4-5
→
診断結果
症状・原因・対策
① 農家はAPIキー不要。ブラウザでURLを開くだけ。
② 写真はdiagnose.phpを経由してClaudeに送られる（APIキーはサーバー内に隠蔽）。
③ ClaudeがJSONで診断結果を返し、index.htmlが日本語・英語・ネパール語で表示。
開発フェーズ — Development Phases
1
開発仕様書・設計
Development Specification
✅ 完了
▼
開発仕様書 v1.0
12セクション・全システム設計・リスク分析・フェーズ計画
PotatoGuard_DevSpec_v1.0.docx
アーキテクチャ決定
Webアプリ優先・Claude API使用・Xserverデプロイ・個人開発スケール
多言語方針決定
英語・日本語・ネパール語を静的バンドル。翻訳API不使用
2
アプリ本体・サーバー構築
App + Server Build
✅ 完了
▼
index.html v0.2
スマホ対応・写真1〜5枚・3言語切替・診断結果タブ表示・プログレスバー
index.html
diagnose.php
APIキー隠蔽・CORS設定・画像base64受信・Claude API呼び出し・JSON返却
diagnose.php
症状サンプル集
30例・SVGイラスト・カテゴリフィルター・撮影ガイド付き・モーダル詳細
samples.html
PWA対応
ホーム画面追加・meta theme-color・apple-mobile-web-app対応
3
写真収集・症状サンプル整備
Photo Collection
▶ 次のステップ
▼
SVGイラストを実写真に置き換えます。ライセンス確認済みの画像のみ使用。
全30例に最低1枚ずつ実写真を収集し、photos/フォルダに整理します。
🍄 Fungal
Late Blight
PlantVillage (CC BY-SA)
🍄 Fungal
Early Blight
PlantVillage (CC BY-SA)
🍄 Fungal
Powdery Scab
EPPO Gallery
🍄 Fungal
Black Scurf
EPPO Gallery
🦠 Bacterial
Blackleg
EPPO Gallery
🦠 Bacterial
Common Scab
USDA ARS
🦠 Bacterial
Ring Rot
EPPO Gallery
🧬 Viral
PVY Mosaic
EPPO Gallery
🧬 Viral
PLRV Leafroll
EPPO Gallery
🐛 Pest
Colorado Beetle
USDA ARS (Public Domain)
🐛 Pest
Aphids
Google CC BY
🐛 Pest
Wireworm
USDA ARS (Public Domain)
🌿 Nutrient
N Deficiency
Google CC BY
🌿 Nutrient
K Deficiency
Google CC BY
🌿 Nutrient
Mg Deficiency
Google CC BY
☀️ Abiotic
Drought Stress
Google CC BY
☀️ Abiotic
Frost Damage
Google CC BY
🥔 Physio
Hollow Heart
Google CC BY
📁 収集後のファイル名規則：photos/01_late_blight.jpg（番号_英語名.拡張子）
4
Xserverデプロイ・動作確認
Deployment & Testing
▶ 次のステップ
▼
APIキー設定
diagnose.phpにAnthropicキーを記入。ドメイン名をCORSに設定
Cyberduckでアップロード
FTP接続→ public_html/potatoguard/ に3ファイル配置
スマホ動作確認
iOS Safari・Android Chromeで撮影→診断の全フローをテスト
ホーム画面追加確認
「ホーム画面に追加」でアイコン表示・起動を確認
5
フィールドテスト・改善
Field Testing
◦ 将来
▼
実圃場テスト（日本）
春〜夏の生育期に実際の障害写真で診断精度を確認
ネパール農家テスト
低帯域環境での動作・ネパール語表示の確認
診断精度の記録
誤診例を記録しプロンプト改善に反映
農家フィードバック収集
UI・言語・表示内容の改善点を収集
6
機能拡張（将来）
Future Enhancements
◦ 将来
▼
診断履歴の保存
ブラウザのlocalStorageに診断結果を保存・履歴表示
PDFレポート出力
診断結果をPDFで保存・共有できる機能
障害データベース
確認済み農薬情報・地域別対策をDBで補完
オフライン対応
Service Worker・TFLiteモデルで圏外でも動作
機関連携
CIP（国際ポテトセンター）・農業試験場との協力
リポジトリ構成 — GitHub Repository
potato-guard/# GitHubリポジトリルート
│
├── app/# Webアプリ本体（Xserverにアップロードするファイル）
│ ├── index.html# スマホUI・診断フロー・3言語
│ ├── diagnose.php# APIプロキシ ⚠️ APIキーはGitHubに上げない
│ ├── samples.html# 30例SVGサンプル集
│ └── photos/# 収集した症状写真（Phase 3で追加）
│ ├── 01_late_blight.jpg
│ ├── 02_early_blight.jpg
│ └── …
│
├── docs/# プロジェクト文書
│ ├── README.md# プロジェクト概要・セットアップ手順
│ ├── PotatoGuard_DevSpec_v1.0.docx# 開発仕様書
│ └── project_flow.html# このフロー資料
│
├── .gitignore# APIキーを含むファイルを除外
└── CHANGELOG.md# 更新履歴
GitHubへのアップロード手順
1
ローカルリポジトリを初期化
VS Codeのターミナルで実行します
# プロジェクトフォルダを作成して移動
mkdir potato-guard && cd potato-guard
# Gitリポジトリを初期化
git init
# フォルダ構成を作成
mkdir app app/photos docs
2
.gitignoreを作成（重要）
APIキーが入ったファイルをGitHubに上げないための設定です
# .gitignore の内容
# APIキー入りのPHPファイルは除外
app/diagnose.php
# macOSシステムファイル
.DS_Store
# エディタ設定
.vscode/
3
ファイルを配置してコミット
ダウンロードしたファイルを対応するフォルダに置きます
# app/ フォルダに配置
cp ~/Downloads/index.html app/
cp ~/Downloads/samples.html app/
# diagnose.php は .gitignore で除外 → app/に置くがcommitしない
# docs/ フォルダに配置
cp ~/Downloads/project_flow.html docs/
cp ~/Downloads/PotatoGuard_DevSpec_v1.0.docx docs/
# 全ファイルをステージング
git add .
# 最初のコミット
git commit -m “Initial commit: app v0.2, samples, docs”
4
GitHubにリポジトリを作成してpush
github.comでリポジトリを新規作成後、以下を実行します
# GitHubのリモートを追加（URLは自分のものに変更）
git remote add origin https://github.com/あなたのID/potato-guard.git
# GitHubにpush
git branch -M main
git push -u origin main
5
以降の更新方法
ファイルを編集するたびに以下を実行します
# 変更をステージング
git add app/index.html
# コミット（何を変えたか一言書く）
git commit -m “Fix: ネパール語翻訳を修正”
# GitHubに反映
git push
コスト概算 — Cost Summary
ジャガイモ生育障害 AI画像診断アプリ
🥔 PotatoGuard
AI-Powered Field Diagnosis
Identify potato
disorders instantly
Take a photo of the affected plant. Get symptoms, causes, and treatment in seconds.
1
Take or upload photos (1–5)
Tap to take photo
Or choose from gallery · max 5 photos
2
Field notes (optional)
Analyzing photos…
⚠️ AI-assisted diagnosis. Always verify with a local agronomist before applying pesticides.