# SupplyFlow

> 備品・消耗品の購入申請から、承認・差戻し、発注更新、納品確認までを一連の流れで追える業務フローサンプルです。

SupplyFlow は、FlowBlueprints が提供する業務フローサンプルプロダクトです。
Laravel 13 / PHP 8.4 / Blade + Tailwind CSS + Alpine.js で構築されています。

## サイト構成

- [トップページ](https://supplyflow.evisu-works.jp/): プロダクト概要・課題提起・デモ導線
- [設計判断](https://supplyflow.evisu-works.jp/design-decisions): 設計意図・スコープ・拡張ポイント

## このサンプルが解決する課題

備品や消耗品の購入申請が口頭・チャット・メールに分散すると、以下の問題が起きやすくなります。

- 承認済みかどうかが分からない
- 差戻し理由が残らない
- 発注されたか追えない
- 納品確認まで終わったか分からない

SupplyFlow は、これらを「申請が今どこにあり、次に誰が何をするか」が見える形に整理します。

## 主な機能

- 購入申請の作成（申請者）
- 承認または差戻し（承認者）
- 発注更新（総務・購買担当）
- 納品確認（総務・購買担当）
- 申請状況と履歴の確認（全ロール）

## 技術スタック

- Laravel 13 / PHP 8.4
- Blade + Tailwind CSS v4 + Alpine.js
- MySQL 8.0 / Redis 7
- Docker Compose
- Single Action Controller パターン
- UseCase / QueryService レイヤー分離

## 設計方針

- 1 Controller 1 Action（Single Action Controller）
- 状態更新は専用画面で行う（一覧上で直接変更しない）
- 差戻し理由を履歴に残す
- 1ユーザー1ロール（兼任不可）
- 自己承認禁止

## 詳細情報

- [llms-full.txt](https://supplyflow.evisu-works.jp/llms-full.txt): 詳細な技術情報・アーキテクチャ説明