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

# ユーザーストーリー

## 📖 ストーリー記法

```
【優先度】タイトル
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タップ以内で完了する