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

Stashは、自己ホスト型で単一世帯向けの家庭在庫システムであり、主にバーコードやQRコードでラベル付けされたアイテムを扱います。レシピや食事計画ツールではなく、高速な在庫補充・消費フロー、在庫少なさや期限切れの追跡、印刷可能なラベル、アウトバウンドウェブフックによるオプション自動化に焦点を当てています。 主な機能: - 在庫補充(+1)と消費(−1)モードでの連続的なカメラスキャン。フォーマットヒント、高解像度、オートフォーカス、音声ビープ、振動フィードバック、暗所用フラッシュ切り替えが可能です。不明なバーコードは新しいアイテムを作成し、場所としきい値のクイックシートを開きます。 - UPC/EAN、独自発行の内部QRコード(アイテムへのディープリンク)、Matterペアリングコード、手動シリアル番号をサポートする統合されたアイテム+バーコードモデル。単一の印刷ボタンで選択されたバーコードシンボロジーのみを送信できるため、複数のコードを持つアイテムに重要です。 - 単一物理デバイス用の資産モード。状態追跡、シリアル番号バーコード入力、保守履歴ログに対応。資産アイテムはショッピングリストや在庫少なさロジックから除外されます。 - インデントされたツリーとしてレンダリングされるネストされたロケーションとカテゴリ。検索、フィルター、ソート、ページ分割、最後に使用したフィルター/ソート状態の記憶が可能です。一括操作により一度に選択されたアイテムを移動または削除できます。 - アイテム詳細には数量、在庫少なさしきい値、有効期限/保証日付、デフォルト通貨での価格、インラインでの名前/単位編集、添付ファイル、調整/保守ログが含まれます。 - レシート、マニュアル、保証書、写真などのファイル添付。任意の画像をアイテムの代表アバターに設定でき、アップロードされた画像は自動的にリサイズされます。 - ダッシュボードでは総在庫価値、在庫少なさアイテム、間もなく期限切れになるアイテム、最近追加されたアイテムをハイライト表示し、ロケーション、通知、公開URLのオンボーディングチェックリストも提供します。 - 在庫少なさアイテムまたは手動追加エントリから構築されたショッピングリスト。メモと購入済みチェックボックス付き。在庫がしきい値を超えると自動的にリストから削除されます。 - スキャンごとにオプションのプラガブル商品検索(Open Food Facts、UPCItemDB、Naver Shopping)または完全に無効化可能です。 - バーコード値を含むCSVインポート/エクスポート。一括入力やスプレッドシートとの双方向移行に適しています。 - 単一PNGまたはA4ラベルシートPDFとしてのラベル印刷。ピッカーに検索ボックスあり。韓国語タイポグラフィはバンドルされたNoto Sans KRサブセットでサポートされています。 - 期限/保証イベントのウェブプッシュ通知および週次の在庫少なさダイジェスト。 - アン.undoトースト、復元、30日間の自動パージによるソフト削除。 - オフライン対応のPWA:キャッシュされたアプリシェル、キャッシュされたアイテムレスポンス、接続回復時に同期されるオフラインスキャンキュー。 - プリンターやHome Assistant自動化用のアウトバウンド在庫ウェブフック。設定画面で最後の配信失敗が表示され、オプションでHMAC-SHA256署名検証が可能です。 - 管理者/一般ロールを持つマルチユーザー家族アカウント。最初の管理者ブートストラップ、ワンタイム管理者パスワードリセット、すべての場所からのログアウト、バックアップ/復元、ko/en i18nとライト/ダークテーマ。 範囲外:レシピ/食事計画、単一プロセス内の世帯ごとのマルチテナンシー。 展開はDocker Composeまたは1クリックProxmox LXCインストーラーとして利用可能です。ローカル開発環境はPostgreSQL、Prismaマイグレーション、別々のAPI/Web開発サーバーを使用します。イメージはGitHub Container Registryに公開されており、本番ノートにはサブパス配信、ヘルスチェック、シークレット管理に関する情報が含まれています。