移動

document/02_ユーザーストーリー.md

@@ -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タップ以内で完了する