このプロジェクトについて

# Nebula Cafe — 予測的来店客数および在庫調和システム Nebula Cafeは、Streamlitを使用して構築されたオープンソースの分析ダッシュボードであり、過去のレポート作成を超えて予測的な意思決定を行いたいコーヒーショップのオーナーやマネージャー向けに設計されています。このプロジェクトは「意思決定エンジン」として位置づけられており、顧客の来店数を予測し、食材の再発注を最適化するとともに、温かく魅力的なインターフェースで運用効率とのバランスを取ります。 ## 中核となる目的 従来の過去売上のみを報告するカフェ分析ツールとは異なり、Nebula Cafeは時系列予測（特にLSTMモデル）を使用して最大7日間先の顧客トラフィックを予測します。これにより、ユーザーは以下が可能になります： - 予測される繁忙期に基づいて賢くスタッフを配置する - 生鮮食品の廃棄を減らすためにジャストインタイムで在庫を発注する（最大30%削減 claimed） - イベントやプロモーションのスケジュール調整のために閑散期を特定する - パターンを複数の店舗間で比較する（地域マネージャー用） ## 主要機能 ### 予測的来店客数マッピング - 7日間の顧客数予測を行うLSTMベースの時系列モデル - 信頼区間付きの視覚的タイムライン（「曇った帯」として可視化） - 休日および天気データに基づく動的調整（オプションのAPI統合） ### インテリジェント在庫アドバイザー - 予測売上の水準と現在の在庫レベルを照合 - カラーコード付きの再発注リストを生成：緑色（在庫あり）、琥珀色（2日以内に注文）、赤色（今すぐ注文） - 過去の過剰在庫ミスの学習を通じて将来の推奨事項を改善 ### ユーザーエクスペリエンス - タブレットまたはスマートフォンの画面に適応するドラッグ＆ドロップウィジェットレイアウト - 英語、スペイン語、中国語（普通話）、アラビア語をサポートする多言語UI - ルールベースの内蔵FAQ／サポートボット（外部APIキー不要） - カスタマイズ可能なカラーやフォント用のノーコードテーマエディター - インターネット接続なしでも完全な機能が利用可能なオフラインモード ### プライバシーとデータハンドリング - デフォルトではすべてのデータをローカルで処理；クラウドへのアップロードゼロ - 認証キー不要 - 匿名化集計により顧客の個人識別情報（PII）を保存しないことを保証 - テストや実験のための合成データ生成器（オプション） ## 技術スタック - **フロントエンド：** Streamlit とカスタムCSS（JavaScriptライブラリ不使用） - **バックエンド：** Python 3.10+ および Pandas, NumPy, Prophet を使用した予測 - **データストレージ：** ローカルCSV/JSONファイル（SQLiteサポートはオプション） - **可視化：** Plotly をインタラクティブチャート用に、Matplotlib を静的エクスポート用に使用 - **テスト：** PyTest を単体テストおよび結合テスト用に使用 ## ユースケース - **ソロカフェオーナー：** 予測される閑散期にイベントを計画する - **地域マネージャー：** 店舗間の来店客数を比較してスタッフを再配分する - **焙煎所パートナー：** 週ごとの豆の出荷量を決定するために在庫アドバイザーを使用する - **投資家：** ROI指標と顧客密度トレンドを含む週次レポートをエクスポートする ## ロードマップ（2026年） - **2026年第1四半期：** コア予測モジュールと在庫モジュールを搭載したv1.0リリース - **2026年第2四半期：** 公開メニューのスクレーパーを通じた競合他社価格追跡（オプション） - **2026年第3四半期：** オープンAPI経由でのSquare/Toast POSとの統合 - **2026年第4四半期：** 即時来店客数アラート用のモバイルコンパニオンアプリ（Flutter） ## インストールと使用方法 ユーザーはGitHubページからZIP形式でリポジトリをダウンロードするか、gitクライアントを使ってクローンすることができます。本プロジェクトにはPython 3.10以上とリポジトリに記載されている依存関係が必要です。インストールウィザードは必要ありません—純粋なPythonコードのみです。 ## コミュニティと貢献 以下の内容を含め、貢献は大歓迎です： - 新しい予測モデルの追加（例：ARIMA, Facebook Prophet） - UIのさらなる言語への翻訳 - 環境メトリクス（周囲騒音、温度など）向けの新しいウィジェットのデザイン 本プロジェクトには `docs/` フォルダ内のドキュメントが含まれており、コミュニティサポートにはGitHub issues and discussions が使用されます。 ## ライセンス MITライセンスの下で提供されており、商用・非商用を問わず自由な使用、修正、配布が可能です。 ## 免責事項 本ソフトウェアは「現状のまま」提供され、いかなる保証も伴いません。予測モデルはデモンストレーション用に合成トレーニングデータに依存しており、キャリブレーションなしでは実世界の精度を反映しない場合があります。開発者はダッシュボード出力に基づくビジネス上の意思決定について一切の責任を負いません。サポートボットはスクリプト化されたFAQアシスタントであり、ライブの人間エージェントではありません。ユーザーは常に物理的なカウントによって在庫推奨事項を検証する必要があります。