akira/keinasystem
1
0
Fork 0
Code Issues 9 Pull Requests Actions Packages Projects Releases Wiki Activity

移動

Browse Source
This commit is contained in:
Akira
2026-02-15 10:56:50 +09:00
parent 60dca6aab1
commit e4da194ebd
7 changed files with 4 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1078
document/00_Gemini向け統合指示書.md Normal file
View File

File diff suppressed because it is too large Load Diff

156
document/01_プロダクトビジョン.md Normal file
View File

@@ -0,0 +1,156 @@
# プロダクトビジョン
## 🎯 システムの目的
**「作付け計画を起点とした農業経営データの一元管理」**
このシステムは、年間の作付け計画を中心に、以下の3つの課題を解決する：
1. **申請書類の作成負担を減らす**
- 水稲共済細目書（年2回: 2月・5月）
- 中山間地域等直接支払交付金（年1回: 5月）
- これらの申請に必要なデータを、作付け計画から自動生成
2. **実圃場と申請区画のずれを管理する**
- 実際に作業する圃場（39筆）と、申請書上の区画（共済31区画、中山間71区画）が異なる
- 複数の実圃場が1つの申請区画に紐づく関係（M:1）を明示的に管理
- 紐付けは半自動化するが、手動修正も可能にする
3. **将来の拡張を見据えた設計**
- Phase 2: 栽培履歴（播種日、農薬・肥料の散布記録）
- Phase 3: 資材計画（種苗・肥料・農薬の必要量計算）
- Phase 4: 収穫管理・販売管理との連携
---
## 👤 ユーザー像
**主要ユーザー（Sole User）:**
- 65歳の農家（元プログラマー、50歳まで従事）
- ITリテラシー: 高い（自分でシステムを設計・実装できるレベル）
- 経営規模: 39筆の圃場を管理
**利用デバイス:**
- 🖥️ **PC**: 作付け計画の登録・編集、申請書のダウンロード（メイン操作）
- 📱 **スマホ/タブレット**: 圃場での参照（品種確認、面積確認、将来的には栽培履歴）
**利用シーズン:**
- **11月～3月**: 作付け計画の策定・修正（前年度コピー→微調整）
- **2月**: 水稲共済細目書の提出（1回目）
- **5月**: 水稲共済細目書（2回目）＋中山間交付金の申請
- **通年**: スマホでの現場参照
---
## 📊 現状の課題とシステムによる解決
| 課題 | 現状（Before） | システム導入後（After） |
|------|---------------|----------------------|
| 申請書作成 | 紙の台帳から手作業で転記・集計 | ボタン1つでPDFダウンロード→印刷 |
| 圃場と申請区画の対応 | Excelで手動管理、照合が大変 | 自動紐付け＋UI上で視覚的に確認・修正 |
| 前年度データの再利用 | 前年のExcelをコピー→手作業で修正 | 年度コピー機能で一括複製 |
| 作物の変更履歴 | 紙のメモ、記憶頼み | 過去年度の作付け計画を参照可能 |
| 現場での情報確認 | 家に戻って紙の台帳を確認 | スマホでその場で品種・面積を確認 |
---
## ✅ 成功の定義（KPI）
**Phase 1（MVP）の成功指標:**
1. **申請書作成時間の短縮**
- 水稲共済: 手作業2時間 → システム5分（96%削減）
- 中山間: 手作業1時間 → システム3分（95%削減）
2. **データの正確性向上**
- 転記ミスゼロ（自動集計のため）
- 圃場と申請区画の対応ミスゼロ（UIで視覚的に確認）
3. **使いやすさ**
- 作付け計画の登録・修正が、PCで10分以内に完了
- スマホでの圃場情報参照が、3タップ以内で完了
- PDFを印刷してそのまま提出できる品質（レイアウト調整不要）
**Phase 2以降の展望:**
- 栽培履歴の記録により、GAP認証の取得が可能に
- 資材計画の自動化により、発注漏れ・過剰在庫を削減
- 収穫実績と計画の比較により、翌年の計画精度が向上
---
## 🔐 非機能要件
**シンプルさ最優先:**
- シングルユーザー（マルチテナント不要）
- 認証は最小限（メール＋パスワード）
- 複雑な権限管理は不要
**レスポンシブ対応:**
- PC: 作付け計画の編集、申請書ダウンロード
- スマホ/タブレット: 参照メイン（将来的には簡易な記録入力も）
**データの永続性:**
- 最低5年分のデータを保持（補助金の監査対応）
- バックアップ機能（CSV/Excelでのエクスポート）
**パフォーマンス:**
- 圃場一覧の表示: 1秒以内
- 申請書CSVの生成: 3秒以内
- スマホでの圃場詳細表示: 2秒以内
---
## 🚫 やらないこと（Non-Goals）
**Phase 1では以下は含めない:**
- マルチユーザー対応（将来的にも不要の可能性高）
- 地図上での圃場描画・編集（GeoJSON等は後回し）
- 自動ジオコーディング（住所→座標変換は手動でOK）
- リアルタイム同期（オフライン対応は不要）
- モバイルアプリ（PWAで十分）
---
## 🎨 デザイン原則
1. **シンプル・イズ・ベスト**
- 1画面1機能を徹底
- 複雑なUIコンポーネントは避ける（ドラッグ&ドロップ、カレンダーなど）
2. **情報の優先順位を明確に**
- 最もよく使う情報を最も目立つ位置に
- 圃場一覧では「名称」「作付け作物」「面積」を最優先表示
3. **エラーを起こしにくい設計**
- 入力必須項目は最小限に
- 選択式（ドロップダウン）を優先、自由入力は最小限
4. **スマホファースト（参照時）**
- 文字サイズ: 最低16px
- タップ領域: 最低44px×44px
- 横スクロールは避ける
5. **既存データを尊重**
- 役場データ（共済・中山間）の面積不整合は「そういうもの」として扱う
- ユーザーの運用を変えさせない（紙の台帳と同じ感覚で使える）
---
## 📅 開発フェーズ
**Phase 1（MVP）: 2025年2月まで**
- 作付け計画の登録・編集
- 申請書（水稲共済・中山間）のCSV出力
- 圃場一覧の参照（PC/スマホ）
**Phase 2: 2025年3月～**
- 栽培履歴の記録（播種日、農薬散布など）
- 作業予定のカレンダー表示
**Phase 3: 2025年度中**
- 資材計画（種苗・肥料・農薬の必要量計算）
- 収穫記録
**Phase 4: 将来**
- お米販売システムとの連携（API経由）
- スマート農業機器との連携（センサーデータ取込）

312
document/02_ユーザーストーリー.md Normal file
View File

@@ -0,0 +1,312 @@
# ユーザーストーリー
## 📖 ストーリー記法
```
【優先度】タイトル
As a ユーザー（役割）
I want ◯◯したい
So that △△できる（目的・価値）
【受け入れ基準】
- [ ] 条件1
- [ ] 条件2
```
---
## 🔴 Phase 1（MVP）- 必須機能
### P1-1: 作付け計画の一覧表示
**As a** 農家（システムの唯一のユーザー）
**I want** 全ての圃場と、それぞれに何を作付けしたかを一覧で見たい
**So that** 今年の作付け状況を俯瞰でき、未割当の圃場を見つけられる
**【受け入れ基準】**
- [ ] 全39筆の圃場が一覧表示される
- [ ] 各圃場に「名称」「面積」「今年の作付け作物」が表示される
- [ ] 作付け未設定の圃場は警告色（赤/黄）でハイライトされる
- [ ] 年度を切り替えられる（2024年度、2025年度など）
- [ ] PC・スマホ両方で見やすいレイアウト
**【UIイメージ】**
```
┌────────────────────────────────┐
│ 📅 2025年度 作付け計画 │
├────────────────────────────────┤
│ 🔍 検索: [___________] 🔽絞込 │
├────────────────────────────────┤
│┌────┬──────┬────┬──────────┐│
││名称 │面積 │作付 │操作 ││
│├────┼──────┼────┼──────────┤│
││田A │1.2反 │米 │ [編集] ││
││田B │0.5反 │❗未設定│ [割当] ││
│└────┴──────┴────┴──────────┘│
└────────────────────────────────┘
```
---
### P1-2: 圃場への作物割当
**As a** 農家
**I want** 各圃場に作物を割り当てたい
**So that** 今年の作付け計画を記録できる
**【受け入れ基準】**
- [ ] 圃場を選択して「作物」を設定できる
- [ ] 作物は以下から選択:
- 作付けしない: 休耕、緑肥、景観作物、その他野菜
- 作付けする: 米（品種選択）、トウモロコシ、エンドウ、野菜
- [ ] 品種も選択できる（例: 米 → にこまる、たちはるか、たちはるか特栽）
- [ ] 複数の圃場を一括選択して、同じ作物を割り当てられる
- [ ] 割当後、一覧画面に即座に反映される
**【作物マスタ】**
```
作物リスト:
- 米
- トウモロコシ
- エンドウ
- 野菜
- その他（休耕・緑肥・景観作物など）
品種の登録方法:
- すべての作物で統一
- プリセット品種 + その場で追加
- 例:
┌─────────────────────────┐
│ 品種: [にこまる ▼] │
│ - にこまる │
│ - たちはるか │
│ - たちはるか（特栽）│
│ │
│ [+ 新しい品種を追加] │
└─────────────────────────┘
作物「その他」の品種例:
- 完全休耕
- 緑肥（ヘアリーベッチ）
- 緑肥（レンゲ）
- 景観作物（コスモス）
- 景観作物（ヒマワリ）
※「作付けしない」系も特別扱いせず、「その他」として統一
```
---
### P1-3: 水稲共済細目書のPDF出力
**As a** 農家
**I want** 水稲共済細目書に必要なデータをPDFでダウンロードしたい
**So that** 2月と5月の申請時に、印刷してそのまま役場に提出できる
**【受け入れ基準】**
- [ ] 年度を指定してPDFをダウンロードできる
- [ ] PDFは表形式で、以下の列を含む:
```
耕地番号 | 分筆番号 | 地名地番 | 漢字地名 | 本地面積(m2) | 作付品目 | 品種 | 備考
```
- [ ] A4サイズ、縦向き、見やすいフォントサイズ（10pt以上）
- [ ] ヘッダーに「水稲共済細目書（2025年度）」などのタイトル
- [ ] ページ番号（複数ページになる場合）
- [ ] 共済マスタ（31区画）をベースに、紐づく実圃場の作付け情報を集約
- [ ] 複数の実圃場が1つの共済区画に紐づく場合、作物をカンマ区切りで列挙（例: "米,野菜"）
- [ ] 作付け未設定の共済区画も出力（空欄または「未設定」）
- [ ] ダウンロード前にプレビュー表示できる
**【集計ロジック】**
1. 共済マスタ（`水稲共済細目用.ods`の31区画）をループ
2. 各共済区画に紐づく実圃場を取得（`吉田農地台帳`の`細目_耕地番号`/`細目_分筆番号`で結合）
3. 紐づく実圃場の作付け情報を集約（作物名をユニーク化してカンマ区切り）
4. HTMLテンプレートで表を生成 → PDF変換
---
### P1-4: 中山間交付金申請のPDF出力
**As a** 農家
**I want** 中山間地域等直接支払交付金の申請に必要なデータをPDFでダウンロードしたい
**So that** 5月の申請時に、印刷してそのまま役場に提出できる
**【受け入れ基準】**
- [ ] 年度を指定してPDFをダウンロードできる
- [ ] PDFは表形式で、以下の列を含む:
```
ID | 大字 | 字 | 地番 | 農地面積(m2) | 作付品目 | 品種 | 備考
```
- [ ] A4サイズ、縦向き、見やすいフォントサイズ（10pt以上）
- [ ] ヘッダーに「中山間地域等直接支払交付金（2025年度）」などのタイトル
- [ ] 中山間マスタ（71区画）をベースに、紐づく実圃場の作付け情報を集約
- [ ] 作付け未設定の区画も出力（空欄または「未設定」）
- [ ] ダウンロード前にプレビュー表示できる
**【集計ロジック】**
- 水稲共済と同様、中山間マスタをループして実圃場を集約 → PDF生成
---
### P1-5: 前年度作付け計画のコピー
**As a** 農家
**I want** 前年度の作付け計画を丸ごと新年度にコピーしたい
**So that** 毎年ゼロから入力せずに、微調整だけで済む
**【受け入れ基準】**
- [ ] 「前年度をコピー」ボタンを押すと、前年度の作付け情報が新年度に複製される
- [ ] 圃場マスタはコピーしない（マスタは共通）
- [ ] コピー後、作物の種類を個別に変更できる
- [ ] コピー前に確認ダイアログを表示（上書き防止）
---
### P1-6: スマホでの圃場情報参照
**As a** 農家
**I want** 田んぼにいるときに、スマホでその圃場の情報を見たい
**So that** 「この田んぼに植えた品種は何だっけ？」「面積はいくつだっけ？」をその場で確認できる
**【受け入れ基準】**
- [ ] スマホで圃場一覧を見られる
- [ ] 検索・絞り込み機能で目的の圃場を素早く見つけられる
- [ ] 圃場詳細画面で以下を確認:
- 名称
- 住所
- 面積
- 今年の作付け作物・品種
- （将来）過去の作付け履歴
- [ ] 文字サイズ: 16px以上
- [ ] タップ領域: 44px×44px以上
---
## 🟡 Phase 2 - 栽培履歴機能
### P2-1: 播種日・定植日の記録
**As a** 農家
**I want** 各圃場の播種日（種まき日）や定植日を記録したい
**So that** スマホで「いつ植えたか」を確認でき、次の作業（追肥など）のタイミングを判断できる
**【受け入れ基準】**
- [ ] 圃場ごとに「播種日」「定植日」を入力できる
- [ ] カレンダーUIで日付を選択
- [ ] スマホで過去の記録を閲覧できる
---
### P2-2: 農薬・肥料散布の記録
**As a** 農家
**I want** 除草剤や肥料をまいた日を記録したい
**So that** スマホで「いつ除草剤まいたか」を確認でき、次回の散布タイミングを判断できる
**【受け入れ基準】**
- [ ] 圃場ごとに「作業日」「作業内容」「使用資材」を入力
- [ ] 作業内容は選択式（播種、定植、除草剤散布、追肥、収穫など）
- [ ] スマホで作業履歴を時系列で閲覧
---
### P2-3: 作業予定のカレンダー表示
**As a** 農家
**I want** 今後の作業予定をカレンダーで見たい
**So that** 「来週は何をする予定だっけ？」を俯瞰できる
**【受け入れ基準】**
- [ ] 月間カレンダーで作業予定を表示
- [ ] 各圃場の作業予定を色分け
- [ ] 日付をクリックすると、その日の作業一覧を表示
---
## 🟢 Phase 3 - 資材計画機能
### P3-1: 種苗必要量の自動計算
**As a** 農家
**I want** 今年の作付け計画から、必要な種苗の量を自動計算してほしい
**So that** 種の発注漏れや過剰発注を防げる
**【受け入れ基準】**
- [ ] 作物ごとに「面積あたり必要量」をマスタ登録
- [ ] 作付け計画から、作物別の合計面積を算出
- [ ] 必要量を一覧表示（例: にこまる 30kg、トウモロコシ 5袋）
---
### P3-2: 肥料・農薬の必要量計算
**As a** 農家
**I want** 施肥計画や農薬散布計画を立てたい
**So that** 資材の購入計画を立てられる
**【受け入れ基準】**
- [ ] 作物ごとの施肥基準をマスタ登録
- [ ] 作付け面積から必要な肥料量を計算
- [ ] 農薬も同様に計算
---
## 🔵 Phase 4 - 収穫・販売管理
### P4-1: 収穫記録
**As a** 農家
**I want** 収穫量を記録したい
**So that** 計画と実績を比較し、来年の計画精度を上げられる
---
### P4-2: お米販売システムとの連携
**As a** 農家
**I want** 作付け計画と収穫実績を、お米販売システムに自動連携したい
**So that** 在庫管理や販売計画を効率化できる
---
## 📊 優先度マトリクス
| ストーリー | 優先度 | Phase | 工数（想定） |
|-----------|--------|-------|------------|
| P1-1: 作付け計画一覧 | 🔴 高 | 1 | 2日 |
| P1-2: 作物割当 | 🔴 高 | 1 | 3日 |
| P1-3: 水稲共済PDF出力 | 🔴 高 | 1 | 3日 |
| P1-4: 中山間PDF出力 | 🔴 高 | 1 | 2日 |
| P1-5: 前年度コピー | 🔴 高 | 1 | 1日 |
| P1-6: スマホ参照 | 🔴 高 | 1 | 1日 |
| P2-1: 播種日記録 | 🟡 中 | 2 | 2日 |
| P2-2: 作業履歴 | 🟡 中 | 2 | 3日 |
| P2-3: カレンダー | 🟡 中 | 2 | 3日 |
| P3-1: 種苗計算 | 🟢 低 | 3 | 2日 |
| P3-2: 資材計算 | 🟢 低 | 3 | 2日 |
| P4-1: 収穫記録 | 🔵 将来 | 4 | TBD |
| P4-2: 販売連携 | 🔵 将来 | 4 | TBD |
---
## 🎯 Phase 1 完成の定義
以下が全て完了したら、Phase 1（MVP）は完成とする：
1. **機能要件**
- [ ] 作付け計画を登録・編集できる
- [ ] 水稲共済細目書のPDFを出力できる
- [ ] 中山間交付金申請のPDFを出力できる
- [ ] 前年度の作付けをコピーできる
- [ ] スマホで圃場情報を参照できる
2. **品質要件**
- [ ] PCで快適に操作できる（レスポンス1秒以内）
- [ ] スマホで見やすい（文字サイズ16px以上）
- [ ] 出力されるPDFが正確で見やすい（手動検証でOK）
- [ ] PDFをA4用紙に印刷してそのまま提出できる
3. **ユーザビリティ**
- [ ] 作付け計画の登録が10分以内で完了する
- [ ] 申請書のダウンロードが3クリック以内で完了する
- [ ] スマホでの圃場検索が3タップ以内で完了する

437
document/03_データ仕様書.md Normal file
View File

@@ -0,0 +1,437 @@
# データ仕様書
## 📊 データ構造の全体像
このシステムで扱うデータは3種類：
1. **実圃場データ**（吉田農地台帳.ods）- 実際に作業する農地
2. **共済マスタ**（水稲共済細目用.ods）- 申請書用の区画
3. **中山間マスタ**（中山間.ods）- 申請書用の区画
**紐付けの関係:**
- 実圃場 → 共済区画: **M対1**（複数の実圃場が1つの共済区画に対応）
- 実圃場 → 中山間区画: **M対1**（複数の実圃場が1つの中山間区画に対応）
```mermaid
erDiagram
実圃場 }o--|| 共済区画 : "紐づく(M:1)"
実圃場 }o--|| 中山間区画 : "紐づく(M:1)"
実圃場 ||--o{ 作付け計画 : "持つ(1:N)"
実圃場 {
int id PK
string 名称
string 住所
float 面積_反
string 地主
int 細目_耕地番号 "共済紐付けキー"
int 細目_分筆番号 "共済紐付けキー"
int 中山間_ID "中山間紐付けキー"
}
共済区画 {
int id PK
string 地名_地番
int 耕地番号
int 分筆番号
float 本地面積_m2
string 漢字地名
}
中山間区画 {
int id PK
int ID
string 大字
string 字
int 地番
int 農地面積_m2
int 交付金額
}
作付け計画 {
int id PK
int 実圃場_id FK
int 年度
string 作物
string 品種
date 播種日
date 収穫日
}
```
---
## 1. 実圃場データ（吉田農地台帳.ods）
### ファイル情報
- **行数:** 39行（39筆の圃場）
- **列数:** 7列
### カラム定義
| カラム名 | データ型 | 必須 | 説明 | 例 |
|---------|---------|-----|------|---|
| 名称 | string | ○ | 圃場の名称（自由記述） | "口神　１反２畝" |
| 住所 | string | ○ | 圃場の住所 | "口神ノ川１９８（笹ヶ谷374-1)" |
| 面積(反) | float | ○ | 面積（単位: 反）※1反=1000m2=10a | 1.20 |
| 地主 | string | ○ | 地主の氏名 | "山崎　出祥" |
| 細目_耕地番号 | int | ○ | 共済マスタとの紐付けキー（1/2） | 2 |
| 細目_分筆番号 | int | ○ | 共済マスタとの紐付けキー（2/2） | 1 |
| 中山間_ID | int | △ | 中山間マスタとの紐付けキー | 50 |
### データサンプル
```
名称 住所 面積(反) 細目_耕地番号 細目_分筆番号 中山間_ID
口神　１反２畝 口神ノ川１９８（笹ヶ谷374-1) 1.20 2 1 50
口神　北東 口神ノ川１９８（笹ヶ谷374-1) 0.40 2 2 50
口神　北中 口神ノ川１９８（笹ヶ谷374-1) 0.43 2 2 50
```
### 特記事項
- **中山間_IDは一部NULL**: 39筆中2筆が中山間の対象外（`NaN`）
- **同じ共済区画に複数の実圃場**: 例えば共済キー「2-2」には3つの実圃場が紐づく
- **面積単位**: DB内部では「反」と「m2」の両方を保持する（変換: 1反=1000m2）
---
## 2. 共済マスタ（水稲共済細目用.ods）
### ファイル情報
- **行数:** 31行（31区画）
- **列数:** 5列
### カラム定義
| カラム名 | データ型 | 必須 | 説明 | 例 |
|---------|---------|-----|------|---|
| 地名 地番 | string | ○ | 地名と地番（スペース区切り） | "四万十町 ササガタニ 374-1" |
| 耕地番号 | int | ○ | 共済区画の識別子（1/2） | 2 |
| 分筆番号 | int | ○ | 共済区画の識別子（2/2） | 1 |
| 本地面積 (m2) | float | ○ | 申請上の面積（単位: m2） | 25.4 |
| 漢字地名 | string | ○ | 漢字表記の地名 | "四万十町 笹ヶ谷 374-1" |
### データサンプル
```
地名 地番 耕地番号 分筆番号 本地面積(m2) 漢字地名
四万十町 ササガタニ 374-1 2 1 25.4 四万十町 笹ヶ谷 374-1
四万十町 ササガタニ 374-1 2 2 12.0 四万十町 笹ヶ谷 374-1
```
### 特記事項
- **面積の不整合は許容**: 役場データが古いため、実圃場の合計面積と一致しないことがある
- 例: 共済キー「2-2」の面積は12.0m2だが、実圃場の合計は1.33反=1330m2
- これは「そういうもの」として扱い、システム側で修正しない
- **重複キーなし**: (耕地番号, 分筆番号)の組み合わせは一意
---
## 3. 中山間マスタ（中山間.ods）
### ファイル情報
- **行数:** 71行（71区画）
- **列数:** 17列（うち使用するのは一部）
### カラム定義（主要なもの）
| カラム名 | データ型 | 必須 | 説明 | 例 |
|---------|---------|-----|------|---|
| ID | int | ○ | 中山間区画の識別子 | 50 |
| 大字 | string | ○ | 大字名 | "口神ノ川" |
| 字 | string | ○ | 字名 | "壱町切" |
| 地番 | int | ○ | 地番 | 1694 |
| 農地面積 | int | ○ | 面積（単位: m2） | 2900 |
| 作付け品目 | string | △ | （役場が記入、システムでは上書き） | "ニラ" |
| 交付金額 | int | △ | 交付金額 | 37700 |
### データサンプル
```
ID 大字 字 地番 農地面積 作付け品目 交付金額
50 口神ノ川 笹ヶ谷 374 2698 米 xxxxxx
```
### 特記事項
- **使用する列は限定的**: システムでは主に「ID」「大字」「字」「地番」「農地面積」を使用
- **作付け品目は上書き**: 役場が記入した「作付け品目」は参考情報で、システムで上書きする
- **面積の不整合は許容**: 共済マスタと同様、実圃場との差異は受け入れる
---
## 4. 作付け計画データ（システム内部）
### テーブル定義
| カラム名 | データ型 | 必須 | 説明 |
|---------|---------|-----|------|
| id | int | ○ | 主キー（自動採番） |
| field_id | int | ○ | 実圃場ID（外部キー） |
| year | int | ○ | 年度（2025など） |
| crop | string | ○ | 作物（「米」「トウモロコシ」など） |
| variety | string | △ | 品種（「にこまる」など） |
| planting_date | date | △ | 播種日/定植日（Phase 2） |
| harvest_date | date | △ | 収穫日（Phase 2） |
| notes | text | △ | 備考 |
### 制約
- **ユニーク制約**: (field_id, year) - 1つの圃場に対して1年度につき1つの作付け計画のみ
- Phase 2で二毛作対応する場合は、この制約を見直す
---
## 5. 作物マスタ
### 作物リスト
- 米
- トウモロコシ
- エンドウ
- 野菜
- その他
### 品種の登録方法
**すべての作物で統一されたUI:**
- プリセット品種から選択
- その場で新しい品種を追加可能
- 作物による操作の違いなし
### プリセット品種の例
#### 米
- にこまる
- たちはるか
- たちはるか（特栽）
#### トウモロコシ
- （ユーザーが追加）
#### エンドウ
- 久留米豊
#### 野菜
- （ユーザーが追加）
#### その他
- 完全休耕
- 緑肥（ヘアリーベッチ）
- 緑肥（レンゲ）
- 景観作物（コスモス）
- 景観作物（ヒマワリ）
### 実装上の注意
- すべての作物で `Variety` テーブルに品種を登録
- 「作付けしない」系を特別扱いしない
- UIは完全に統一
---
## 6. データインポート仕様
### 初期セットアップ時
1. **共済マスタのインポート**
- `水稲共済細目用.ods` を読み込み
- `OfficialKyosaiField` テーブルに保存
2. **中山間マスタのインポート**
- `中山間.ods` を読み込み
- `OfficialChusankanField` テーブルに保存
3. **実圃場データのインポート**
- `吉田農地台帳.ods` を読み込み
- `Field` テーブルに保存
- 同時に共済・中山間マスタとの紐付けを確立:
- `細目_耕地番号` + `細目_分筆番号` → `OfficialKyosaiField.id` を外部キーとして保存
- `中山間_ID` → `OfficialChusankanField.id` を外部キーとして保存
### 紐付けロジック
```python
# 共済マスタとの紐付け
kyosai_record = OfficialKyosaiField.objects.get(
k_num=row['細目_耕地番号'],
s_num=row['細目_分筆番号']
)
field.kyosai_field_ref = kyosai_record.id
# 中山間マスタとの紐付け
if pd.notna(row['中山間_ID']):
chusankan_record = OfficialChusankanField.objects.get(
c_id=int(row['中山間_ID'])
)
field.chusankan_field_ref = chusankan_record.id
```
---
## 7. 申請書PDF出力ロジック
### 水稲共済細目書
**出力形式:**
- A4サイズ、縦向き
- ヘッダー: 「水稲共済細目書（◯◯年度）」
- 表形式（罫線あり）
- フォントサイズ: 10pt
- ページ番号（複数ページの場合）
**表の列:**
```
耕地番号 | 分筆番号 | 地名地番 | 漢字地名 | 本地面積(m2) | 作付品目 | 品種 | 備考
1 | 1 | 四万十町... | 四万十町... | 2.2 | 米 |にこまる|
2 | 1 | 四万十町... | 四万十町... | 25.4 | 米 |にこまる|
2 | 2 | 四万十町... | 四万十町... | 12.0 |米,野菜|にこまる,トマト|複数圃場
```
**集計ロジック:**
```python
def generate_kyosai_pdf(year):
# 1. データ集約（CSVと同じロジック）
output_rows = []
for kyosai in OfficialKyosaiField.objects.all().order_by('k_num', 's_num'):
fields = Field.objects.filter(kyosai_field_ref=kyosai.id)
plans = Plan.objects.filter(field__in=fields, year=year)
crops = list(set([p.crop.name for p in plans if p.crop]))
varieties = list(set([p.variety.name for p in plans if p.variety]))
row = {
'耕地番号': kyosai.k_num,
'分筆番号': kyosai.s_num,
'地名地番': kyosai.address,
'漢字地名': kyosai.kanji_name,
'本地面積(m2)': kyosai.area,
'作付品目': ','.join(crops) if crops else '未設定',
'品種': ','.join(varieties) if varieties else '',
'備考': f'{len(fields)}筆合算' if len(fields) > 1 else ''
}
output_rows.append(row)
# 2. HTMLテンプレートで表を生成
html = render_to_string('reports/kyosai_template.html', {
'year': year,
'rows': output_rows
})
# 3. HTML → PDF変換
pdf = HTML(string=html).write_pdf()
return pdf
```
**HTMLテンプレート例（reports/kyosai_template.html）:**
```html
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<style>
@page { size: A4; margin: 2cm; }
body { font-family: "MS Gothic", monospace; font-size: 10pt; }
h1 { text-align: center; font-size: 14pt; margin-bottom: 20px; }
table { width: 100%; border-collapse: collapse; }
th, td { border: 1px solid black; padding: 5px; text-align: center; }
th { background-color: #f0f0f0; }
</style>
</head>
<body>
<h1>水稲共済細目書（{{ year }}年度）</h1>
<table>
<thead>
<tr>
<th>耕地番号</th>
<th>分筆番号</th>
<th>地名地番</th>
<th>漢字地名</th>
<th>本地面積(m2)</th>
<th>作付品目</th>
<th>品種</th>
<th>備考</th>
</tr>
</thead>
<tbody>
{% for row in rows %}
<tr>
<td>{{ row.耕地番号 }}</td>
<td>{{ row.分筆番号 }}</td>
<td>{{ row.地名地番 }}</td>
<td>{{ row.漢字地名 }}</td>
<td>{{ row.本地面積(m2) }}</td>
<td>{{ row.作付品目 }}</td>
<td>{{ row.品種 }}</td>
<td>{{ row.備考 }}</td>
</tr>
{% endfor %}
</tbody>
</table>
</body>
</html>
```
### 中山間交付金申請
**出力形式:**
- A4サイズ、縦向き
- ヘッダー: 「中山間地域等直接支払交付金（◯◯年度）」
- 表形式（罫線あり）
**表の列:**
```
ID | 大字 | 字 | 地番 | 農地面積(m2) | 作付品目 | 品種 | 備考
50 | 口神ノ川 | 笹ヶ谷 | 374 | 2698 | 米,野菜 | にこまる,トマト | 7筆合算
```
**集計ロジック:**
- 水稲共済と同様、中山間マスタをループして実圃場を集約 → HTMLテンプレート → PDF
---
## 8. データ移行・メンテナンス
### 年度更新
- **圃場マスタ**: 年度をまたいで共通（更新不要）
- **作付け計画**: 年度ごとに独立（前年度コピー機能で複製）
### マスタデータの更新
- **共済・中山間マスタ**: 役場から新しいファイルをもらった場合、再インポート
- 既存データは上書きせず、差分を確認してマージ
- または、全削除→再インポートの2段階処理
### バックアップ
- 全テーブルをCSV/Excelでエクスポート可能にする
- 最低5年分のデータを保持（補助金監査対応）
---
## 9. 面積単位の扱い
システム内部では以下のように統一:
| 表示単位 | DB保存 | 変換式 |
|---------|--------|--------|
| 反（たん） | m2 | 1反 = 1000m2 |
| アール（a） | m2 | 1a = 100m2 |
| ヘクタール（ha） | m2 | 1ha = 10000m2 |
**実装方針:**
- DB内部は全て `m2` で保存（整数型）
- 表示時にユーザー設定に応じて変換（デフォルトは「反」）
- 入力時は「反」で受け付け、内部で `m2` に変換
---
## 10. データ整合性チェック
### チェック項目
1. **紐付けの存在確認**
- 実圃場の `細目_耕地番号`/`細目_分筆番号` が共済マスタに存在するか
- 実圃場の `中山間_ID` が中山間マスタに存在するか
2. **面積の整合性（参考情報）**
- 1つの共済区画に紐づく実圃場の合計面積と、共済マスタの面積を比較
- ⚠️ 不整合があっても警告のみ（修正はしない）
3. **作付け未設定の検出**
- 指定年度で作付け計画が未設定の圃場をリストアップ
### 実装
- インポート時にバリデーションを実行
- 管理画面で「データ整合性レポート」を表示

694
document/04_画面設計書.md Normal file
View File

@@ -0,0 +1,694 @@
# 画面設計書
## 🎨 デザイン原則（再掲）
1. **シンプル・イズ・ベスト**: 1画面1機能
2. **情報の優先順位**: 最重要情報を最も目立つ位置に
3. **エラーを起こしにくい**: 選択式優先、自由入力最小限
4. **スマホファースト（参照時）**: 文字16px以上、タップ領域44px以上
5. **既存データを尊重**: 紙の台帳と同じ感覚で使える
---
## 📱 画面一覧
### Phase 1（MVP）
1. **ログイン画面**
2. **ダッシュボード**（将来拡張用、Phase 1では簡易版）
3. **作付け計画一覧**（メイン画面）
4. **作付け計画編集**（モーダル/サイドパネル）
5. **圃場詳細**（スマホ参照用）
6. **申請書ダウンロード**
7. **データ管理**（インポート・エクスポート）
### Phase 2以降
8. 栽培履歴入力
9. 作業カレンダー
10. 資材計画
---
## 画面1: ログイン画面
### 目的
シンプルな認証（メール＋パスワード）
### レイアウト（PC/スマホ共通）
```
┌─────────────────────────────────────┐
│ │
│ 🌾 Keina System │
│ 作付け計画管理システム │
│ │
│ ┌───────────────────────┐ │
│ │ メールアドレス │ │
│ │ [___________________] │ │
│ └───────────────────────┘ │
│ │
│ ┌───────────────────────┐ │
│ │ パスワード │ │
│ │ [___________________] │ │
│ └───────────────────────┘ │
│ │
│ [ ログイン ] │
│ │
└─────────────────────────────────────┘
```
### 機能要件
- [ ] メールアドレスとパスワードで認証
- [ ] ログイン成功 → ダッシュボードへ遷移
- [ ] ログイン失敗 → エラーメッセージ表示
- [ ] 「パスワードを忘れた」リンク（Phase 2）
---
## 画面2: ダッシュボード
### 目的
システムの入り口（Phase 1では簡易版、将来拡張）
### レイアウト（PC）
```
┌────────────────────────────────────────────────────┐
│ 🌾 Keina System 2025年度 ▼ 👤ログアウト │
├────────────────────────────────────────────────────┤
│ │
│ 📊 概要 │
│ ┌────────────────┬────────────────┬─────────────┐│
│ │ 全圃場数 │ 作付け済み │ 未割当 ││
│ │ 39筆 │ 35筆 │ 4筆 ❗ ││
│ └────────────────┴────────────────┴─────────────┘│
│ │
│ 🔗 クイックアクセス │
│ ┌──────────────────────────────────────────────┐│
│ │ [📝 作付け計画を編集] [📄 申請書ダウンロード] ││
│ └──────────────────────────────────────────────┘│
│ │
│ 📌 最近の変更 │
│ • 2025/02/10: 田A に「米（にこまる）」を割当 │
│ • 2025/02/09: 田B を「休耕」に変更 │
│ │
└────────────────────────────────────────────────────┘
```
### 機能要件（Phase 1）
- [ ] 年度選択（ドロップダウン）
- [ ] 作付け状況のサマリー表示
- [ ] 「作付け計画を編集」→ 画面3へ
- [ ] 「申請書ダウンロード」→ 画面6へ
---
## 画面3: 作付け計画一覧（メイン画面）
### 目的
全圃場の作付け状況を一覧で確認・編集
### レイアウト（PC）
```
┌──────────────────────────────────────────────────────────────────┐
│ 🌾 Keina System > 作付け計画一覧 2025年度 ▼ 👤ログアウト │
├──────┬───────────────────────────────────────────────────────────┤
│ │ │
│ 📊 │ 🔍 [検索: 圃場名・住所_____________] 🔽絞込: [全て▼] │
│ 集計 │ │
│ │ ☐ 未割当のみ表示 [📋 前年度をコピー] [📊 申請書作成] │
│ ────────────────────────────────────────────────────────────────│
│ 米 │ No. ☐ 名称 住所 面積 作付 品種 操作 │
│15.3反│ ────────────────────────────────────────────────────────│
│┣にこ │ 1 ☐ おまけ 口神ノ川... 0.2反 米 にこまる [編集]│
││10.2反│ 2 ☐ 口神１反 口神ノ川... 1.2反 米 にこまる [編集]│
│┗たち │ 3 ☐ 口神北東 口神ノ川... 0.4反 野菜 トマト [編集]│
││5.1反│ 4 ☐ 口神北中 口神ノ川... 0.4反 ❗未設定 [割当]│
│ │ 5 ☐ 口神北西 口神ノ川... 0.5反 その他 完全休耕 [編集]│
│野菜 │ │
│3.2反 │ ... (39行) │
│ │ │
│その他│ ────────────────────────────────────────────────────────│
│1.5反 │ ページ: 1 / 2 表示件数: [25件▼] │
│ │ │
│未設定│ │
│2.0反❗ │
└──────┴───────────────────────────────────────────────────────────┘
```
**サイドバー（開閉可能）:**
```
┌──────────────┐
│ [≡] 集計 │← トグルボタンで開閉
├──────────────┤
│ 合計 40.0反 │
│ │
│ 米 │
│ 15.3反 │
│ ├にこまる │
│ │ 10.2反 │
│ └たちはるか │
│ 5.1反 │
│ │
│ 野菜 │
│ 3.2反 │
│ ├トマト │
│ │ 1.8反 │
│ └キュウリ │
│ 1.4反 │
│ │
│ トウモロコシ │
│ 2.5反 │
│ │
│ エンドウ │
│ 1.8反 │
│ │
│ その他 │
│ 1.5反 │
│ ├完全休耕 │
│ │ 0.8反 │
│ └緑肥 │
│ 0.7反 │
│ │
│ ❗未設定 │
│ 2.0反 │
└──────────────┘
```
**サイドバー閉じた状態:**
```
┌───┐
│[☰]│← クリックで開く
└───┘
```
### レイアウト（スマホ）
```
┌────────────────────────────────┐
│ 🌾 作付け計画 2025年度 ▼ ☰ │
├────────────────────────────────┤
│ 🔍 [検索_______________] [🔽] │
│ │
│ [📊 集計を表示] [前年度コピー]│← 集計はモーダル
├────────────────────────────────┤
│ ┌────────────────────────────┐│
│ │ おまけ ││
│ │ 口神ノ川足川 351 ││
│ │ 0.2反 | 米（にこまる） ││
│ │ [編集] ││
│ └────────────────────────────┘│
│ │
│ ┌────────────────────────────┐│
│ │ 口神 北中 ││
│ │ 口神ノ川１９８... ││
│ │ 0.4反 | ❗未設定 ││
│ │ [割当] ││
│ └────────────────────────────┘│
│ │
│ ... (39圃場) │
└────────────────────────────────┘
```
**スマホ: 集計モーダル**
```
┌────────────────────────────────┐
│ 集計 [×] │
├────────────────────────────────┤
│ │
│ 合計面積: 40.0反 │
│ │
│ 米: 15.3反 │
│ ├ にこまる: 10.2反 │
│ └ たちはるか: 5.1反 │
│ │
│ 野菜: 3.2反 │
│ ├ トマト: 1.8反 │
│ └ キュウリ: 1.4反 │
│ │
│ トウモロコシ: 2.5反 │
│ │
│ エンドウ: 1.8反 │
│ │
│ その他: 1.5反 │
│ ├ 完全休耕: 0.8反 │
│ └ 緑肥: 0.7反 │
│ │
│ ❗未設定: 2.0反 │
│ │
│ [閉じる] │
└────────────────────────────────┘
```
### 機能要件
- [ ] 全圃場を一覧表示（39行）
- [ ] 各行に以下を表示:
- チェックボックス（一括操作用）
- 名称
- 住所
- 面積（反）
- 作付け作物（未設定の場合は警告色）
- 品種
- [編集]ボタン
- [ ] 検索機能:
- 圃場名・住所で部分一致検索
- リアルタイム絞り込み
- [ ] フィルタ機能:
- 作物で絞り込み（米、野菜、休耕など）
- 「未割当のみ」トグル
- [ ] 一括操作:
- 複数行を選択 → 「一括割当」ボタン表示
- 同じ作物を一括で割り当て
- [ ] [前年度をコピー]ボタン:
- 確認ダイアログ表示
- 前年度の作付けを全圃場にコピー
- [ ] [申請書作成]ボタン:
- 画面6へ遷移
- [ ] **集計サイドバー（PC）**:
- トグルボタンで開閉
- 作物別の合計面積
- 品種別の内訳（ツリー表示）
- 未設定の面積を警告表示
- [ ] **集計モーダル（スマホ）**:
- [📊 集計を表示]ボタンでモーダル表示
- PC版と同じ内容を縦スクロール表示
### デザインノート
- **未割当の強調**: 赤または黄色の背景色
- **チェックボックスの位置**: 行の左端（スマホでも押しやすい）
- **スマホ版**: カード型レイアウト（1圃場1カード）
- **サイドバーの幅**: 200px（固定）
- **集計の更新**: 作付け計画を編集するたびにリアルタイム更新
---
## 画面4: 作付け計画編集（モーダル）
### 目的
個別の圃場に作物を割り当てる
### レイアウト（PC - モーダルウィンドウ）
```
┌────────────────────────────────────┐
│ 作付け計画を編集 [×] │
├────────────────────────────────────┤
│ │
│ 圃場: 口神 北中 │
│ 住所: 口神ノ川１９８（笹ヶ谷374-1) │
│ 面積: 0.4反 (400m2) │
│ │
│ ───────────────────────────────── │
│ │
│ 作物 * │
│ ┌────────────────────────────────┐│
│ │ [米 ▼] ││
│ └────────────────────────────────┘│
│ │
│ 品種 * │
│ ┌────────────────────────────────┐│
│ │ [にこまる ▼] ││
│ │ - にこまる ││
│ │ - たちはるか ││
│ │ - たちはるか（特栽） ││
│ └────────────────────────────────┘│
│ [+ 新しい品種を追加] │
│ │
│ 備考 │
│ ┌────────────────────────────────┐│
│ │ [_____________________________]││
│ └────────────────────────────────┘│
│ │
│ [キャンセル] [保存] │
│ │
└────────────────────────────────────┘
```
### 作物選択のドロップダウン
```
┌────────────────────────────────────┐
│ • 米 │
│ • トウモロコシ │
│ • エンドウ │
│ • 野菜 │
│ • その他 │
└────────────────────────────────────┘
```
### 品種選択（すべての作物で統一）
**作物=「米」の場合:**
```
┌────────────────────────────────────┐
│ • にこまる │
│ • たちはるか │
│ • たちはるか（特栽） │
│ ──────────────────────────────── │
│ [+ 新しい品種を追加] │
└────────────────────────────────────┘
クリックすると:
┌────────────────────────────────────┐
│ 新しい品種名を入力: │
│ [___________________________] │
│ │
│ [キャンセル] [追加] │
└────────────────────────────────────┘
```
**作物=「トウモロコシ」の場合:**
```
┌────────────────────────────────────┐
│ （まだ品種が登録されていません） │
│ ──────────────────────────────── │
│ [+ 新しい品種を追加] │
└────────────────────────────────────┘
```
**作物=「その他」の場合:**
```
┌────────────────────────────────────┐
│ • 完全休耕 │
│ • 緑肥（ヘアリーベッチ） │
│ • 緑肥（レンゲ） │
│ • 景観作物（コスモス） │
│ • 景観作物（ヒマワリ） │
│ ──────────────────────────────── │
│ [+ 新しい品種を追加] │
└────────────────────────────────────┘
```
### 機能要件
- [ ] 作物をドロップダウンで選択
- [ ] **すべての作物で品種選択UIは統一**
- プリセット品種のドロップダウン
- [+ 新しい品種を追加]ボタンは常に表示
- 作物による操作の違いなし
- [ ] 新しい品種の追加:
- [+ 新しい品種を追加]をクリック
- インライン入力フィールド表示
- 入力後、その場でプリセットに追加
- データベースに永続化（次回から選択可能）
- [ ] 備考欄（任意）
- [ ] [保存]ボタン → 作付け計画を保存して一覧に戻る
- [ ] [キャンセル]ボタン → 変更を破棄して一覧に戻る
- [ ] **集計のリアルタイム更新**:
- 保存すると、サイドバーの集計が即座に更新される
### 一括割当の場合
- モーダルのタイトルを「一括割当」に変更
- 「圃場: 5件選択中」と表示
- 保存時、選択中の全圃場に同じ作付けを適用
### デザインノート
- **UIの統一性**: どの作物を選んでも操作フローが同じ
- **品種の追加**: その場で追加できる（別画面に遷移しない）
- **プリセットの管理**: 一度追加した品種は、全ユーザーで共有（マスタ化）
---
## 画面5: 圃場詳細（スマホ参照用）
### 目的
田んぼにいるときに、その圃場の情報を確認
### レイアウト（スマホ）
```
┌────────────────────────────────┐
│ ← 一覧に戻る 2025年度 │
├────────────────────────────────┤
│ │
│ 口神 北中 │
│ │
│ 📍 住所 │
│ 口神ノ川１９８（笹ヶ谷374-1) │
│ │
│ 📏 面積 │
│ 0.4反 (400m2) │
│ │
│ 🌾 今年の作付け │
│ 米（にこまる） │
│ │
│ 📋 共済情報 │
│ 耕地番号: 2 / 分筆: 2 │
│ │
│ 📋 中山間情報 │
│ ID: 50 │
│ │
│ ───────────────────────────── │
│ │
│ 📅 過去の作付け履歴（Phase 2） │
│ • 2024年: 米（にこまる） │
│ • 2023年: 米（にこまる） │
│ • 2022年: 休耕 │
│ │
└────────────────────────────────┘
```
### 機能要件
- [ ] 圃場の基本情報を見やすく表示
- [ ] 文字サイズ: 18px以上（スマホで見やすく）
- [ ] 余白: 十分に確保（誤タップ防止）
- [ ] 将来的に栽培履歴も表示（Phase 2）
---
## 画面6: 申請書ダウンロード
### 目的
水稲共済細目書・中山間交付金のPDFをダウンロード
### レイアウト（PC）
```
┌────────────────────────────────────────────────────┐
│ 🌾 Keina System > 申請書ダウンロード 👤ログアウト │
├────────────────────────────────────────────────────┤
│ │
│ 年度: [2025年度 ▼] │
│ │
│ ┌────────────────────────────────────────────────┐│
│ │ 📄 水稲共済細目書 ││
│ │ ││
│ │ 提出時期: 2月・5月（年2回） ││
│ │ 区画数: 31区画 ││
│ │ ││
│ │ ⚠️ 未割当の圃場: 4筆 ││
│ │ → 作付け計画を完成させてください ││
│ │ ││
│ │ [プレビュー] [PDFダウンロード] ││
│ └────────────────────────────────────────────────┘│
│ │
│ ┌────────────────────────────────────────────────┐│
│ │ 📄 中山間地域等直接支払交付金 ││
│ │ ││
│ │ 提出時期: 5月（年1回） ││
│ │ 区画数: 71区画 ││
│ │ ││
│ │ ✅ 全て割当済み ││
│ │ ││
│ │ [プレビュー] [PDFダウンロード] ││
│ └────────────────────────────────────────────────┘│
│ │
└────────────────────────────────────────────────────┘
```
### 機能要件
- [ ] 年度を選択
- [ ] 各申請書について:
- 区画数を表示
- 未割当の警告（ある場合）
- [プレビュー]ボタン → 新しいタブでPDFプレビュー
- [PDFダウンロード]ボタン → ファイルダウンロード
- [ ] ダウンロードされるPDFのファイル名:
- 水稲共済: `水稲共済細目書_2025年度.pdf`
- 中山間: `中山間交付金_2025年度.pdf`
- [ ] PDFはA4サイズ、印刷してそのまま提出可能
### プレビュー機能
[プレビュー]ボタンをクリックすると、新しいタブでPDFを表示：
```
┌────────────────────────────────────────────────────┐
│ ← 戻る 水稲共済細目書_2025年度.pdf [印刷] [⬇] │
├────────────────────────────────────────────────────┤
│ │
│ 水稲共済細目書（2025年度） │
│ │
│ ┌────────────────────────────────────────────────┐│
│ │ 耕地 分筆 地名地番 面積 作付 品種 ││
│ │ ──────────────────────────────────────────── ││
│ │ 1 1 四万十町 ... 2.2 米 にこまる ││
│ │ 2 1 四万十町 ... 25.4 米 にこまる ││
│ │ 2 2 四万十町 ... 12.0 米,野菜 ... ││
│ │ ││
│ │ ... (31行) ││
│ └────────────────────────────────────────────────┘│
│ │
│ 1 / 2 │
└────────────────────────────────────────────────────┘
```
- [ ] ブラウザの標準PDFビューアで表示
- [ ] 印刷ボタンで直接印刷可能
- [ ] ダウンロードボタンでローカル保存
---
## 画面7: データ管理
### 目的
圃場マスタや申請マスタのインポート・エクスポート
### レイアウト（PC）
```
┌────────────────────────────────────────────────────┐
│ 🌾 Keina System > データ管理 👤ログアウト │
├────────────────────────────────────────────────────┤
│ │
│ 📥 データインポート │
│ │
│ タブ: [吉田農地台帳] [共済マスタ] [中山間マスタ] │
│ │
│ ┌────────────────────────────────────────────────┐│
│ │ 吉田農地台帳 (実圃場データ) ││
│ │ ││
│ │ 最終更新: 2025/02/01 ││
│ │ 登録圃場数: 39筆 ││
│ │ ││
│ │ ファイルを選択: [ファイルを選択] 📎 ││
│ │ ││
│ │ ⚠️ 既存データは上書きされます ││
│ │ ││
│ │ [プレビュー] [インポート実行] ││
│ └────────────────────────────────────────────────┘│
│ │
│ 📤 データエクスポート │
│ │
│ • [全圃場データ (CSV)] ※バックアップ用 │
│ • [作付け計画 (CSV)] ※バックアップ用 │
│ • [バックアップ (全データ ZIP)] │
│ │
│ 📄 申請書PDF生成 │
│ → 「申請書ダウンロード」画面へ │
│ │
└────────────────────────────────────────────────────┘
```
### 機能要件
- [ ] 3種類のマスタをタブで切り替え
- [ ] ファイルアップロード（ODS/Excel対応）
- [ ] プレビュー機能（インポート前に確認）
- [ ] インポート実行（確認ダイアログ付き）
- [ ] エクスポート機能（CSV/ZIP）
---
## 🎨 UI共通仕様
### カラーパレット
```
プライマリカラー（緑系）:
#2E7D32 濃い緑（ヘッダー、ボタン）
#4CAF50 緑（アクセント）
#81C784 淡い緑（ホバー）
セカンダリカラー（土系）:
#8D6E63 茶色（サブヘッダー）
#BCAAA4 淡い茶（背景）
警告・状態色:
#F44336 赤（エラー、未設定）
#FF9800 オレンジ（警告）
#4CAF50 緑（成功）
#2196F3 青（情報）
グレースケール:
#212121 ダークグレー（テキスト）
#757575 グレー（サブテキスト）
#E0E0E0 ライトグレー（ボーダー）
#FAFAFA ホワイト（背景）
```
### タイポグラフィ
```
フォント:
- システムフォント優先
- 日本語: "Hiragino Sans", "Yu Gothic", sans-serif
- 英数字: "Roboto", "Helvetica", sans-serif
サイズ:
- 見出し(h1): 28px / 太字
- 見出し(h2): 22px / 太字
- 本文: 16px / 通常
- 小文字: 14px / 通常
行間:
- 本文: 1.6
- 見出し: 1.3
```
### スペーシング
```
余白の基本単位: 8px
8px: 最小余白
16px: 標準余白（要素間）
24px: セクション間
32px: 画面の上下余白
```
### レスポンシブブレークポイント
```
スマートフォン: 〜767px
タブレット: 768px〜1023px
PC: 1024px〜
```
---
## 🖱️ インタラクション
### ボタン
- **プライマリボタン**: 緑背景、白文字、影付き
- **セカンダリボタン**: 白背景、緑文字、ボーダー付き
- **ホバー**: 10%明るく、カーソルpointer
- **押下**: 5%暗く、影を小さく
### モーダル
- **背景**: 半透明黒（opacity: 0.5）
- **アニメーション**: フェードイン（0.2秒）
- **閉じる**: 背景クリック or [×]ボタン or Escキー
### トースト通知
- **位置**: 画面右上
- **表示時間**: 3秒（自動消去）
- **種類**: 成功（緑）、エラー（赤）、警告（オレンジ）、情報（青）
---
## 📱 スマホ特有の配慮
### タップ領域
- **最小サイズ**: 44px × 44px
- **余白**: ボタン間は最低8px
### スクロール
- **慣性スクロール**: `-webkit-overflow-scrolling: touch`
- **無限スクロール**: 不要（全39筆なので一覧でOK）
### 入力
- **キーボードタイプ**: 適切に指定（email, number, textなど）
- **オートコンプリート**: 有効化
### ナビゲーション
- **ハンバーガーメニュー**: 右上に配置
- **戻るボタン**: 画面左上に配置

326
document/05_実装優先順位.md Normal file
View File

@@ -0,0 +1,326 @@
# 実装優先順位とマイルストーン
## 🎯 MVP（Phase 1）の完成定義
以下の全てが完了したら、Phase 1は完成とする：
### 機能完成基準
- [ ] ログイン・認証機能
- [ ] 作付け計画の一覧表示（PC/スマホ）
- [ ] 作付け計画の編集（個別・一括）
- [ ] 水稲共済細目書のCSV出力
- [ ] 中山間交付金のCSV出力
- [ ] 前年度作付けのコピー機能
- [ ] 3種類のマスタデータインポート
### 品質基準
- [ ] PCで快適に操作できる（レスポンス1秒以内）
- [ ] スマホで見やすい（文字16px以上）
- [ ] 出力されるCSVが正確（手動検証でOK）
### ユーザビリティ基準
- [ ] 作付け計画の登録が10分以内で完了
- [ ] 申請書のダウンロードが3クリック以内
- [ ] スマホでの圃場検索が3タップ以内
**目標完成日: 2025年2月末（水稲共済の1回目申請に間に合わせる）**
---
## 📅 実装スケジュール（10日間想定）
### Day 1-2: 環境構築 & 基盤実装
**Day 1: プロジェクトセットアップ**
- [ ] Dockerコンテナの構築
- PostgreSQL (PostGIS拡張)
- Django (バックエンド)
- Next.js (フロントエンド)
- [ ] Djangoプロジェクト初期化
- `django-admin startproject`
- GIS設定 (`GDAL`, `GEOS`)
- 環境変数管理 (`.env`)
- [ ] Next.jsプロジェクト初期化
- `create-next-app`
- Tailwind CSS設定
- 環境変数管理
**Day 2: 認証機能**
- [ ] Django: ユーザーモデル (メール認証)
- [ ] Django: JWT認証設定 (`djoser`, `djangorestframework-simplejwt`)
- [ ] Next.js: ログイン画面
- [ ] Next.js: 認証コンテキスト (`AuthContext`)
- [ ] 動作確認: ログイン→ダッシュボード遷移
---
### Day 3-4: データモデル & インポート機能
**Day 3: データベース設計**
- [ ] Django: モデル定義
- `Field` (実圃場)
- `OfficialKyosaiField` (共済マスタ)
- `OfficialChusankanField` (中山間マスタ)
- `Plan` (作付け計画)
- `Crop` (作物マスタ)
- `Variety` (品種マスタ)
- [ ] マイグレーション実行
- [ ] 管理画面での動作確認
**Day 4: インポート機能**
- [ ] Django: インポートAPI実装
- `pandas` + `odfpy` でODS読み込み
- 共済マスタインポート
- 中山間マスタインポート
- 吉田農地台帳インポート（紐付け処理含む）
- [ ] Next.js: データ管理画面
- ファイルアップロードUI
- プレビュー表示
- インポート実行ボタン
- [ ] 動作確認: 実際のODSファイルをインポート
---
### Day 5-6: 作付け計画機能（コア機能）
**Day 5: 作付け計画API**
- [ ] Django: 作物・品種マスタの初期データ投入
- 作物: 米、トウモロコシ、エンドウ、野菜、その他
- 品種: 米（にこまる等）、その他（完全休耕等）
- [ ] Django: 作付け計画API
- 一覧取得 (`GET /api/plans/?year=2025`)
- 作成・更新 (`POST /api/plans/`, `PATCH /api/plans/{id}/`)
- 一括更新 (`POST /api/plans/bulk/`)
- 前年度コピー (`POST /api/plans/copy_from_previous_year/`)
- **品種追加API** (`POST /api/varieties/`) - その場で品種を追加
- **集計API** (`GET /api/plans/summary/?year=2025`) - サイドバー用
- [ ] API動作確認 (Postman or curl)
**Day 6: 作付け計画UI**
- [ ] Next.js: 作付け計画一覧画面
- テーブル表示
- 検索・フィルタ機能
- 未割当のハイライト
- **集計サイドバー（開閉可能）**
- 作物別・品種別の合計面積
- リアルタイム更新
- **スマホ: 集計モーダル表示**
- [ ] Next.js: 作付け計画編集モーダル
- 作物選択（ドロップダウン）
- **品種選択（統一UI）**
- プリセット品種のドロップダウン
- [+ 新しい品種を追加]ボタン
- すべての作物で同じ操作
- 一括割当対応
- [ ] Next.js: 前年度コピーボタン
- [ ] 動作確認: 作付け計画を実際に入力
---
### Day 7-8: 申請書出力機能
**Day 7: 申請書ロジック実装**
- [ ] Django: 水稲共済細目書PDF生成
- 共済マスタをベースに集約
- 紐づく実圃場の作付けを名寄せ
- HTMLテンプレート作成
- WeasyPrintでPDF変換
- [ ] Django: 中山間交付金PDF生成
- 中山間マスタをベースに集約
- HTMLテンプレート作成
- [ ] 動作確認: PDFの内容と見た目を手動チェック
**Day 8: 申請書ダウンロードUI**
- [ ] Next.js: 申請書ダウンロード画面
- 年度選択
- プレビュー表示（新しいタブでPDF）
- PDFダウンロードボタン
- [ ] 動作確認: PDFをダウンロードして印刷してみる
---
### Day 9: スマホ対応 & UI調整
**Day 9: レスポンシブ対応**
- [ ] Next.js: スマホ用レイアウト調整
- 作付け計画一覧（カード型）
- 圃場詳細画面
- タップ領域の調整
- [ ] 文字サイズ・余白の調整
- [ ] 動作確認: 実機またはChrome DevToolsのモバイルビュー
---
### Day 10: テスト & 微調整
**Day 10: 総合テスト**
- [ ] 全機能の動作確認
- ログイン→作付け計画編集→申請書ダウンロードの一連の流れ
- 前年度コピー→編集→保存
- スマホでの参照
- [ ] バグ修正
- [ ] ドキュメント整備（README.md、使い方ガイド）
- [ ] 本番デプロイ準備（Dockerイメージのビルド）
---
## 🔧 技術スタックの詳細
### バックエンド (Django)
| 項目 | 採用技術 | 理由 |
|------|---------|------|
| フレームワーク | Django 5.0 | 安定性、豊富なエコシステム |
| REST API | Django REST Framework | 標準的なAPI構築ツール |
| 認証 | djoser + SimpleJWT | JWT認証の簡単な実装 |
| GIS | GeoDjango (PostGIS) | 地理情報の扱いに最適 |
| ファイル解析 | pandas + odfpy | ODS/Excelの読み込みに対応 |
| PDF生成 | WeasyPrint | HTML→PDF変換、日本語対応 |
| データベース | PostgreSQL 16 + PostGIS 3.4 | 空間データの保存・検索 |
### フロントエンド (Next.js)
| 項目 | 採用技術 | 理由 |
|------|---------|------|
| フレームワーク | Next.js 14 (App Router) | SSR/SSG対応、モダンな開発体験 |
| スタイリング | Tailwind CSS | 高速なUI開発 |
| 状態管理 | React Context API | シンプルな認証状態管理 |
| HTTPクライアント | fetch API (native) | 軽量、標準API |
| テーブル | react-table (TanStack Table) | 高機能なテーブルコンポーネント |
### インフラ (Docker)
| 項目 | 採用技術 | 理由 |
|------|---------|------|
| コンテナ化 | Docker Compose | 開発・本番環境の統一 |
| データベース | postgis/postgis:16-3.4 | PostGIS公式イメージ |
| リバースプロキシ | Nginx (開発環境) | 静的ファイル配信 |
---
## 📦 実装の粒度（コードレベル）
### 最小限の実装で済むもの
- ログイン画面: メール+パスワードのみ（パスワードリセットは後回し）
- ダッシュボード: サマリー表示のみ（グラフは不要）
- 地図機能: Phase 1では不要（住所テキストのみ）
### しっかり作り込むもの
- 作付け計画一覧: 検索・フィルタ・ソート機能
- 編集モーダル: 入力バリデーション、エラー表示
- 申請書CSV: 正確なデータ集計ロジック
### Phase 2以降に回すもの
- 栽培履歴（播種日、作業記録）
- カレンダー表示
- 資材計画
- 過去年度の比較
---
## 🚀 デプロイ計画
### 開発環境
- ローカルマシン: Docker Compose
- URL: `http://localhost:3000`
### 本番環境（Phase 1後）
- サーバー: VPS or クラウド（AWS/GCP/さくらVPS）
- ドメイン: `keina.example.com` (仮)
- HTTPS: Let's Encrypt
- リバースプロキシ: Traefik or Nginx
### バックアップ戦略
- データベース: 毎日自動バックアップ（`pg_dump`）
- ファイル: CSVエクスポートでユーザー自身がバックアップ
---
## 🧪 テスト戦略
### Phase 1では自動テスト不要
- **理由**: シングルユーザー、手動検証で十分
- **代わりに**: 手動チェックリストで品質保証
### 手動チェックリスト
#### 機能テスト
- [ ] ログインできる
- [ ] 作付け計画を登録できる
- [ ] 作付け計画を編集できる
- [ ] 一括割当ができる
- [ ] 前年度コピーができる
- [ ] 水稲共済PDFをダウンロードできる
- [ ] 中山間PDFをダウンロードできる
- [ ] PDFをプレビュー表示できる
- [ ] スマホで圃場詳細を見られる
#### データ整合性テスト
- [ ] 共済PDFの耕地番号が正しい
- [ ] 中山間PDFのIDが正しい
- [ ] 作物の名寄せが正しい（重複排除）
- [ ] 未割当の圃場が適切に扱われる
- [ ] PDFの表レイアウトが整っている
- [ ] PDFをA4用紙に印刷して見やすい
#### UI/UXテスト
- [ ] PCで見やすい（文字サイズ、余白）
- [ ] スマホで見やすい（タップ領域、スクロール）
- [ ] エラーメッセージがわかりやすい
- [ ] ローディング中の表示
---
## 🔍 潜在的な技術的課題と対策
### 課題1: PostGISの設定
**問題**: Dockerコンテナ内でGDAL/GEOSのパスが通らない
**対策**: 公式PostGISイメージを使用、Djangoの`GDAL_LIBRARY_PATH`を明示的に設定
### 課題2: ODSファイルの文字コード
**問題**: 日本語の文字化け
**対策**: `pd.read_excel(..., engine='odf')` でUTF-8として読み込み
### 課題3: 作物の名寄せロジック
**問題**: 複数の実圃場が1つの共済区画に紐づく場合の集約
**対策**: Pythonのセットで重複排除 → カンマ区切りで結合
### 課題4: スマホでのテーブル表示
**問題**: 横スクロールが発生
**対策**: カード型レイアウトに変更（Tailwindの`@media`クエリ）
### 課題5: 大量データのパフォーマンス
**問題**: Phase 2以降、栽培履歴が増えると遅くなる
**対策**: ページネーション、インデックス最適化（Phase 2で対応）
---
## 📝 開発時の注意点
### コーディング規約
- **Python**: PEP 8準拠、型ヒント推奨
- **JavaScript**: ESLint + Prettier、関数コンポーネント優先
- **命名**: 英語（camelCase or snake_case）、略語は避ける
### コミットメッセージ
```
feat: 作付け計画一覧APIを実装
fix: 共済CSVの面積計算バグを修正
docs: READMEにセットアップ手順を追加
style: Tailwindクラスを整理
```
### ブランチ戦略
- `main`: 本番環境
- `develop`: 開発環境
- `feature/*`: 機能開発
---
## 🎉 Phase 1完成後の振り返り
完成したら、以下を実施：
1. **使用感チェック**: 実際に作付け計画を入力してみる
2. **申請書検証**: 出力されたCSVを役場の書式と照合
3. **改善点の洗い出し**: 「ここがもっとこうだったら...」を記録
4. **Phase 2の要件整理**: 栽培履歴機能の詳細を詰める