在庫補充・倉庫間融通アプリ

# 在庫補充・倉庫間融通アプリ 仕様指示書

## 1. 目的

複数倉庫にある約20商品について、販売実績と前年同時期データをもとに需要を予測し、各倉庫への補充数量を自動提案する。拠点倉庫からの補充だけでなく、余剰在庫を持つ倉庫から不足倉庫への倉庫間融通も提案できるようにする。

## 2. 前提

- 倉庫は複数。例: 拠点倉庫Z、通常倉庫A/B/C。
- 商品数は約20商品。
- 販売データは日別、商品別、倉庫別に保持する。
- 在庫は商品別、倉庫別に保持する。
- 補充提案は自動計算し、担当者が承認・修正・キャンセルできる。
- 補充、出荷、入庫、キャンセルは年月日付きの履歴として残す。

## 3. 主な機能

### 3.1 マスタ管理

商品、倉庫、倉庫間移動ルール、補充設定を管理する。

商品マスタ項目:

| 項目 | 内容 |
|---|---|
| 商品ID | 一意のID |
| 商品名 | 商品名 |
| 補充単位 | 1個、10個、ケース単位など |
| 最小補充数 | 最低限提案する数量 |
| 最大在庫数 | 任意 |
| 重要度 | 優先順位計算に使用 |
| 有効フラグ | 管理対象かどうか |

倉庫マスタ項目:

| 項目 | 内容 |
|---|---|
| 倉庫ID | 一意のID |
| 倉庫名 | 倉庫名 |
| 倉庫種別 | 拠点倉庫 / 通常倉庫 |
| 優先度 | 補充元・補充先の優先順位 |
| 有効フラグ | 管理対象かどうか |

### 3.2 在庫管理

商品別、倉庫別に現在庫を管理する。

| 項目 | 内容 |
|---|---|
| 商品ID | 対象商品 |
| 倉庫ID | 対象倉庫 |
| 現在庫数 | 現在の在庫数 |
| 更新日時 | 最終更新日時 |

### 3.3 販売実績管理

日別、商品別、倉庫別に販売実績を保持する。

| 項目 | 内容 |
|---|---|
| 販売日 | 販売が発生した日 |
| 商品ID | 対象商品 |
| 倉庫ID | 対象倉庫 |
| 販売数 | 販売数量 |

## 4. 需要予測

販売ペースは、直近販売実績と前年同時期販売実績を組み合わせて算出する。

```text
予測1日販売数 =
直近平均販売数 × 直近重み
+ 前年同時期平均販売数 × 前年重み

補正後予測1日販売数 = 予測1日販売数 × 手動倍率
```

直近平均販売数:

```text
直近N日販売数合計 ÷ N日
```

前年同時期平均販売数は、設定により次の方式から選択する。

| 方式 | 内容 |
|---|---|
| 前年同日±N日 | 前年同日の前後N日を対象にする |
| 前年同週 | 前年の同じ週番号を対象にする |
| 前年同月 | 前年同月全体を対象にする |

重み設定例:

| 商品種別 | 直近重み | 前年重み |
|---|---:|---:|
| 通常商品 | 70% | 30% |
| 季節商品 | 40% | 60% |
| 新商品 | 100% | 0% |

設定の優先順位:

1. 商品×倉庫ごとの個別設定
2. 商品ごとの設定
3. 倉庫ごとの設定
4. 全体デフォルト設定

## 5. 補充判定

在庫持ち日数:

```text
在庫持ち日数 = 現在庫数 ÷ 補正後予測1日販売数
```

補正後予測1日販売数が0の場合は、原則として補充不要または算出不可として扱う。

判定ライン例:

| 状態 | 条件 |
|---|---|
| 緊急補充 | 在庫持ち日数が5日以下 |
| 補充提案 | 在庫持ち日数が10日以下 |
| 補充不要 | 在庫持ち日数が10日を超える |

補充必要数:

```text
目標在庫数 = 補正後予測1日販売数 × 目標在庫日数
補充必要数 = 目標在庫数 - 現在庫数
```

補充必要数が0以下の場合は補充不要。補充数量は商品ごとの補充単位で切り上げる。

例:

```text
補充必要数: 43個
補充単位: 10個
補充提案数: 50個
```

## 6. 倉庫間融通

商品ごとに各倉庫を「不足」「適正」「余剰」に分類し、不足倉庫へ余剰倉庫から在庫移動を提案する。拠点倉庫Zだけでなく、A/B/Cなど通常倉庫間でも融通可能にする。

余剰数:

```text
最低保持在庫数 = 補正後予測1日販売数 × 最低保持日数
余剰数 = 現在庫数 - 最低保持在庫数
```

不足数:

```text
不足数 = 目標在庫数 - 現在庫数
```

融通元選定で考慮する条件:

| 条件 | 内容 |
|---|---|
| 倉庫間移動可否 | A→B可、B→C不可など |
| 余剰数 | 融通元に十分な余剰があるか |
| リードタイム | 到着までの日数 |
| 配送コスト | 低コストを優先可能 |
| 倉庫優先度 | 拠点倉庫を先に使うか最後に使うか |
| 商品制約 | 商品ごとの移動可否 |

割当ロジック:

1. 商品ごとに不足倉庫を抽出する。
2. 在庫持ち日数が短い順、重要度が高い順に並べる。
3. 商品ごとに余剰倉庫を抽出する。
4. 移動可否、優先度、リードタイム、コストで融通元を並べる。
5. 不足数が満たされるまで余剰倉庫から割り当てる。
6. 補充単位に合わせて数量を切り上げる。
7. 補充提案として保存する。

## 7. 補充・移動履歴

補充や倉庫間移動は、在庫数を変更するだけでなく、提案から入庫までの業務履歴として保存する。提案時点の計算根拠も残し、後から理由を確認できるようにする。

ステータス:

| ステータス | 内容 |
|---|---|
| 提案中 | システムが自動提案した状態 |
| 承認済 | 担当者が承認した状態 |
| 出荷済 | 移動元から出荷した状態 |
| 一部入庫 | 一部のみ入庫した状態 |
| 入庫済 | 全数入庫した状態 |
| キャンセル | 提案または移動を取り消した状態 |

履歴項目:

| 項目 | 内容 |
|---|---|
| 補充ID | 一意のID |
| 提案日/承認日/出荷日/入庫日 | 各処理日 |
| 移動元倉庫ID | 移動元 |
| 移動先倉庫ID | 移動先 |
| 商品ID | 対象商品 |
| 提案数量 | システム提案数 |
| 実行数量 | 実際に送る数量 |
| 入庫数量 | 実際に入庫した数量 |
| ステータス | 現在状態 |
| 提案理由 | 補充理由 |
| 担当者メモ | 任意 |

保存する計算根拠:

| 項目 | 内容 |
|---|---|
| 提案時現在庫 | 提案時点の在庫 |
| 直近平均販売数 | 直近データの1日平均 |
| 前年平均販売数 | 前年同時期の1日平均 |
| 直近重み/前年重み | 適用した重み |
| 手動倍率 | 補正倍率 |
| 補正後予測1日販売数 | 最終予測値 |
| 在庫持ち日数 | 提案時点の持ち日数 |
| 目標在庫日数 | 適用した目標 |
| 最低保持日数 | 融通元に残す日数 |
| 補充単位 | 丸めに使った単位 |

## 8. 在庫更新

現在庫テーブルと在庫履歴テーブルを分けて管理する。

- 現在庫テーブル: 画面表示、補充計算に使う最新値。
- 在庫履歴テーブル: 販売、補充、移動、調整の増減履歴。

在庫増減種別:

| 種別 | 内容 |
|---|---|
| 販売 | 販売により在庫が減る |
| 補充入庫 | 拠点倉庫や外部から入庫 |
| 倉庫間出庫 | 移動元倉庫から減る |
| 倉庫間入庫 | 移動先倉庫に増える |
| 調整 | 棚卸し差異など |

倉庫間移動時は、出荷済で移動元在庫を減らし、入庫済で移動先在庫を増やす。運用を単純化する場合は、入庫済時点で同時反映する設定も可能にする。

## 9. 設定項目

| 設定 | 内容 |
|---|---|
| 直近集計期間 | 7日、14日、30日など |
| 前年比較方式 | 前年同日±N日、前年同週、前年同月 |
| 直近重み/前年重み | 例: 70% / 30% |
| 手動倍率 | セール、季節要因などの補正 |
| 目標在庫日数 | 補充後に持たせたい日数 |
| 最低保持日数 | 融通元に残す日数 |
| 補充開始ライン | 例: 10日以下 |
| 緊急ライン | 例: 5日以下 |
| 補充単位 | 1個、10個、ケースなど |
| 倉庫間移動可否 | From倉庫、To倉庫ごとに設定 |
| リードタイム/配送コスト | 融通元選定に使用 |

## 10. 画面

| 画面 | 主な内容 |
|---|---|
| ダッシュボード | 補充提案件数、緊急件数、倉庫別不足数、本日の提案 |
| 在庫一覧 | 倉庫、商品、現在庫、予測販売数、在庫持ち日数、状態 |
| 補充提案 | 優先度、商品、移動元、移動先、提案数量、理由、ステータス |
| 提案詳細 | 計算根拠、履歴タイムライン、数量修正、承認、キャンセル |
| 補充・移動履歴 | 提案日、商品、移動元、移動先、数量、ステータス |
| 設定 | 全体設定、商品別設定、倉庫別設定、倉庫間移動設定 |

## 11. データテーブル案

- products: 商品ID、商品名、補充単位、最小補充数、最大在庫数、重要度、有効フラグ
- warehouses: 倉庫ID、倉庫名、倉庫種別、優先度、有効フラグ
- inventory_stocks: 商品ID、倉庫ID、現在庫数、更新日時
- sales_records: 販売日、商品ID、倉庫ID、販売数
- replenishment_settings: 商品ID、倉庫ID、直近日数、前年方式、重み、手動倍率、目標在庫日数、最低保持日数、補充開始ライン、緊急ライン
- warehouse_transfer_rules: 移動元倉庫ID、移動先倉庫ID、移動可否、リードタイム、配送コスト、優先度
- replenishment_proposals: 提案日、商品ID、移動元倉庫ID、移動先倉庫ID、提案数量、承認数量、出荷数量、入庫数量、ステータス、理由、メモ
- proposal_calculation_snapshots: 提案ID、提案時現在庫、直近平均、前年平均、重み、手動倍率、予測販売数、在庫持ち日数、目標在庫日数、最低保持日数、不足数、余剰数、補充単位
- inventory_movements: 移動日、商品ID、倉庫ID、増減種別、数量、移動後在庫、関連補充ID、メモ

## 12. 補充提案バッチ

実行タイミングは毎日定時と手動実行の両方に対応する。

処理手順:

1. 有効な商品、倉庫、現在庫を取得する。
2. 商品×倉庫ごとに直近販売実績と前年同時期実績を集計する。
3. 設定に従って補正後予測1日販売数を算出する。
4. 在庫持ち日数、不足数、余剰数を算出する。
5. 倉庫間移動ルールに従って余剰倉庫から不足倉庫への融通案を作成する。
6. 不足が残る場合は拠点倉庫からの補充案を作成する。
7. 補充単位で数量を切り上げる。
8. 補充提案と計算根拠を保存する。

## 13. 計算例

B倉庫の商品1:

| 項目 | 値 |
|---|---:|
| 現在庫 | 20個 |
| 直近14日平均 | 3.0個/日 |
| 前年同時期平均 | 5.0個/日 |
| 重み | 直近70%、前年30% |
| 目標在庫日数 | 21日 |
| 補充単位 | 10個 |

```text
予測1日販売数 = 3.0 × 0.7 + 5.0 × 0.3 = 3.6個/日
在庫持ち日数 = 20 ÷ 3.6 = 5.5日
目標在庫数 = 3.6 × 21 = 75.6個
補充必要数 = 75.6 - 20 = 55.6個
補充提案数 = 60個
```

提案例:

| 移動元 | 移動先 | 商品 | 提案数量 | 理由 |
|---|---|---|---:|---|
| Z倉庫 | B倉庫 | 商品1 | 60個 | 在庫持ち日数5.5日のため |
| A倉庫 | B倉庫 | 商品1 | 50個 | B倉庫不足、A倉庫に余剰あり |

## 14. MVP範囲

初期開発では、商品管理、倉庫管理、現在庫管理、販売実績登録またはCSV取込、需要予測、補充提案、倉庫間融通、補充履歴、設定管理を実装する。初期段階では複雑なAI予測より、計算根拠が見えるルールベース予測を優先する。

## 15. 受け入れ条件

- 商品×倉庫ごとに現在庫を確認できる。
- 直近実績と前年同時期実績から予測販売数を計算できる。
- 在庫持ち日数、補充必要数、余剰数を計算できる。
- 補充開始ライン以下の商品について補充提案が作成される。
- 余剰倉庫から不足倉庫への倉庫間融通が提案される。
- 提案数量を担当者が修正できる。
- 承認、出荷、入庫、キャンセルのステータス管理ができる。
- 補充提案には計算根拠が保存される。
- 補充・移動履歴を年月日付きで確認できる。