Adjust rice transplant plan to store installed box counts

document/16_マスタードキュメント_田植え計画編.md

@@ -1,7 +1,7 @@
 # マスタードキュメント：田植え計画機能
 
 > **作成**: 2026-04-04
-> **最終更新**: 2026-04-04
+> **最終更新**: 2026-04-05
 > **対象機能**: 田植え計画（年度・品種を軸に複数回作成できる苗箱・種もみ使用量計画）
 > **実装状況**: MVP実装完了
 
@@ -10,7 +10,7 @@
 ## 概要
 
 農業生産者が「年度 × 品種」を軸に、田植え前の播種・育苗準備量を見積もる機能。
-各圃場について「反当何枚の苗箱を使うか」「苗箱1枚あたり種もみを何g使うか」を記録し、圃場別・計画全体の苗箱枚数と種もみ使用量を自動集計する。
+各圃場について「実際に設置する苗箱枚数」と「苗箱1枚あたり種もみを何g使うか」を記録し、圃場別・計画全体の苗箱枚数と種もみ使用量を自動集計する。
 
 圃場候補は既存の作付け計画から自動取得し、種もみ在庫は作物単位、反当苗箱枚数の初期値は品種単位で管理する。
 同じ年度・同じ品種でも、播種時期や育苗ロットを分けるために複数の田植え計画を作成できる。
@@ -21,7 +21,7 @@
 |---|---|
 | 田植え計画の作成・編集・削除 | 育苗日程のカレンダー管理 |
 | 作付け計画からの候補圃場自動取得 | 実播種実績の記録 |
-| 圃場ごとの苗箱枚数/反の個別調整 | 種もみロット管理 |
+| 圃場ごとの設置苗箱枚数の個別調整 | 種もみロット管理 |
 | 圃場ごとの種もみg/箱の個別調整 | 在庫の自動引当 |
 | 苗箱合計・種もみkg合計の自動集計 | PDF出力 |
 | 作物ごとの種もみ在庫kg管理 | 品種ごとの播種日管理 |
@@ -35,23 +35,24 @@
 2. 対象圃場は、その年度・品種の作付け計画が登録されている圃場から取得する
 3. 種もみ在庫は作物単位で管理する
 4. 反当苗箱枚数の初期値は品種単位で管理する
-5. ただし実際の計画値は圃場単位で上書きできる
-6. 種もみg/箱は計画全体のデフォルト値を持ちつつ、圃場単位で上書きできる
-7. 在庫不足はエラーで保存停止せず、一覧・編集画面で残在庫見込みとして可視化する
-8. 同じ年度・同じ品種で複数の計画を作成してよい
-9. 複数回に分ける場合は、`計画名` で「第1回」「第2回」「4/10播種分」などを区別する
+5. 画面上では `反当苗箱枚数 × 面積(反)` を設置苗箱枚数のデフォルト候補として表示する
+6. 実際に保存するのは圃場ごとの `設置苗箱枚数` であり、手動調整後の値をそのまま保持する
+7. 種もみg/箱は計画全体のデフォルト値を持ちつつ、圃場単位で上書きできる
+8. 在庫不足はエラーで保存停止せず、一覧・編集画面で残在庫見込みとして可視化する
+9. 同じ年度・同じ品種で複数の計画を作成してよい
+10. 複数回に分ける場合は、`計画名` で「第1回」「第2回」「4/10播種分」などを区別する
 
 ---
 
 ## 計算式
 
-### 圃場ごとの苗箱合計
+### 圃場ごとの設置苗箱枚数デフォルト候補
 
-`苗箱合計 = 圃場面積(反) × 反当苗箱枚数`
+`設置苗箱枚数デフォルト = 圃場面積(反) × 反当苗箱枚数`
 
 ### 圃場ごとの種もみ使用量
 
-`種もみkg = 苗箱合計 × 苗箱1枚あたり種もみ(g) ÷ 1000`
+`種もみkg = 設置苗箱枚数 × 苗箱1枚あたり種もみ(g) ÷ 1000`
 
 ### 計画全体の残在庫見込み
 
@@ -98,7 +99,7 @@
 | 項目 | 型 | 説明 |
 |---|---|---|
 | field_count | int | 対象圃場数 |
-| total_seedling_boxes | decimal | 苗箱枚数合計 |
+| total_seedling_boxes | decimal | 設置苗箱枚数合計 |
 | total_seed_kg | decimal | 種もみ使用量合計(kg) |
 | crop_seed_inventory_kg | decimal | 作物在庫(kg) |
 | remaining_seed_kg | decimal | 残在庫見込み(kg) |
@@ -110,7 +111,7 @@
 | id | int | PK | |
 | plan | FK(RiceTransplantPlan) | CASCADE | |
 | field | FK(fields.Field) | CASCADE | |
-| seedling_boxes_per_tan | decimal(6,2) | required | 反当苗箱枚数 |
+| installed_seedling_boxes | decimal(8,2) | required | 設置苗箱枚数 |
 | seed_grams_per_box | decimal(8,2) | required | 苗箱1枚あたり種もみ(g) |
 
 - `unique_together = ['plan', 'field']`
@@ -122,7 +123,8 @@
 |---|---|---|
 | field_name | string | 圃場名 |
 | field_area_tan | decimal | 圃場面積(反) |
-| planned_boxes | decimal | 圃場ごとの苗箱合計 |
+| default_seedling_boxes | decimal | `反当苗箱枚数 × 面積(反)` で求めたデフォルト候補 |
+| planned_boxes | decimal | 圃場ごとの設置苗箱枚数 |
 | planned_seed_kg | decimal | 圃場ごとの種もみkg |
 
 ---
@@ -165,8 +167,9 @@
       "field": 5,
       "field_name": "田中上",
       "field_area_tan": "1.2000",
-      "seedling_boxes_per_tan": "12.00",
+      "installed_seedling_boxes": "14.40",
       "seed_grams_per_box": "200.00",
+      "default_seedling_boxes": "14.40",
       "planned_boxes": "14.40",
       "planned_seed_kg": "2.880"
     }
@@ -186,12 +189,12 @@ POST/PUT リクエスト例:
   "entries": [
     {
       "field_id": 5,
-      "seedling_boxes_per_tan": "12.00",
+      "installed_seedling_boxes": "14.40",
       "seed_grams_per_box": "200.00"
     },
     {
       "field_id": 6,
-      "seedling_boxes_per_tan": "11.50",
+      "installed_seedling_boxes": "13.80",
       "seed_grams_per_box": "190.00"
     }
   ]
@@ -245,12 +248,15 @@ POST/PUT リクエスト例:
   - 圃場の追加・除外が可能
 - 初期値:
   - `反当苗箱枚数` は品種マスタの `default_seedling_boxes_per_tan`
+  - `設置苗箱枚数デフォルト` は `反当苗箱枚数 × 面積(反)` で求める
   - `種もみg/箱` は計画ヘッダの `default_seed_grams_per_box`
 - 圃場テーブル:
   - 圃場
   - 面積(反)
-  - 反当苗箱枚数
+  - 設置苗箱枚数デフォルト（ラベル表示）
+  - 設置苗箱枚数（入力欄）
   - 種もみg/箱
+  - デフォルト反映ボタン
   - 苗箱合計
   - 種もみkg
 - サマリー:
@@ -278,7 +284,7 @@ POST/PUT リクエスト例:
 1. 計画名は必須
 2. 品種は必須
 3. 圃場は1件以上必要
-4. `seedling_boxes_per_tan` と `seed_grams_per_box` は 0 以上の数値を想定
+4. `installed_seedling_boxes` と `seed_grams_per_box` は 0 以上の数値を想定
 5. 在庫不足でも保存は許可し、UIで不足を可視化する
 6. 候補圃場の抽出元は既存 `Plan`（作付け計画）であるため、先に作付け計画が必要