grocyダウンロード - grocyソースコードのダウンロード

冷蔵庫を超えた ERP

Grocy は、ウェブベースでセルフホスト型の食料品と家計管理ソリューションです。

これはベルント・ベステルによる趣味のプロジェクトです。

試してみてください

最新安定版の公開デモ（ releaseブランチ）→ https://demo.grocy.info
現在の開発バージョンの公開デモ ( masterブランチ) → https://demo-prerelease.grocy.info

特徴

ウェブサイトをご覧ください。 →https://grocy.info

質問 / ヘルプ / バグレポート / 機能リクエスト

一般的なヘルプと使用方法に関する質問 → r/grocy subreddit
バグレポートと機能リクエスト → 問題トラッカー

グロシーなことに関して私にプライベートメッセージを送ったり、電話をかけたりしないでください。私は問題トラッカーとサブレディットをほぼ毎日チェックしていますが、それ以上のサポートは提供していません。

コミュニティへの貢献

コミュニティが提供したアドオン/ツールのリストについては、Web サイトを参照してください。 → https://grocy.info/addons

インストール方法

通常の (Windows) デスクトップアプリケーションのように Web サーバーを管理せずに Grocy を実行したい場合は、Grocy Desktop をチェックしてください。
最新リリースを直接ダウンロードします。インストールは「次へ」を 2 回クリックするだけです。

Grocy は技術的には非常に単純な PHP アプリケーションなので、実行するための基本的な注意事項は次のとおりです。

最新リリースを解凍する
config-dist.php data/config.phpにコピーし、必要に応じて編集します
dataディレクトリが書き込み可能であることを確認してください
Web サーバーのルートはpublicディレクトリを指す必要があります。
try_files $uri /index.php$is_args$query_string; nginx を使用している場合は location ブロック内で
または、URL 書き換えを無効にします ( data/config.phpのDISABLE_URL_REWRITINGオプションを参照)
→ デフォルトのログインはユーザーadmin 、パスワードadminです。すぐにパスワードを変更してください (右上隅のユーザーメニュー)

あるいは、このリポジトリのクローンを作成し ( releaseブランチは常に最新のリリースバージョンを参照します)、Composer と Yarn の依存関係を手動でインストールします。

その他のインストールガイドとトラブルシューティングのヘルプについては、Web サイトを参照してください。 → https://grocy.info/links

プラットフォームのサポート

PHP 8.2 または 8.3 (SQLite 3.34.0 以降)
必要な PHP 拡張子: fileinfo 、 pdo_sqlite 、 gd 、 ctype 、 intl 、 zlib 、 mbstring
推奨事項: ベンチマークテストでは、より新しい (3.39.4 以降) SQLite バージョンを使用すると、単位変換処理が最大 5 倍高速になることが示されました。
最近の Firefox、Chrome、または Edge

Dockerを使って実行する方法

手順については、grocy/grocy-docker または linuxserver/docker-grocy を参照してください。

アップデート方法

dataディレクトリを保持したまま、最新リリースですべてを上書きします
config-dist.phpで新しい構成オプションを確認し、必要に応じてdata/config.phpに追加します ( config-dist.phpのデフォルト値は、 data/config.phpで定義された設定にない場合に使用されます)。
data/viewcacheディレクトリを空にする
データベース移行を適用するには、メインルートに 1 回アクセスしてください (以下を参照)

Linux で Grocy を実行する場合は、 update.shもあります (スクリプトを実行可能にして ( chmod +x update.sh )、 unzipインストールされていることを確認してください)。これはまさにこれを実行し、さらにバックアップ ( .tgzアーカイブ) を作成します。現在のインストールのdata/backups (60 日より古いバックアップは更新中に削除されます)。

ローカリゼーション

Grocy は完全にローカライズ可能です。デフォルトの言語は英語 (コードに統合されています) ですが、ドイツ語のローカライズは常に私によって維持されます。

あなたの言語が不完全であるか、まだ利用できない場合は、Transifex で Grocy の翻訳を簡単に手伝うことができます。

デフォルトの言語はdata/config.phpで設定できます。たとえばSetting('DEFAULT_LOCALE', 'it');また、ユーザーごとに異なる言語を設定するためのユーザー設定 (ユーザー設定ページを参照) もあります。

プレリリースデモは、少なくとも 70 % 完了した翻訳で利用でき、毎時 10 分ごとに Transifex から翻訳を取得するため、貢献した翻訳の一種のインスタントプレビューを確認できます。ありがとう！

また、完成レベルが 70 % ( stringsリソース) に達した翻訳はリリースに含まれます。

残念ながら、RTL 言語はまだサポートされていません。

モチベーション

家庭を管理する必要があります。 Grocy を使用する前は、最初の自作ソフトウェア (C# Windows フォームアプリケーション) と大量の Excel シートを使用して、これを (ほぼ 10 年間) 行っていました。結局このソフトは使うのが面倒だったし、ExcelはExcelだ。それで、（非常に）長い間、さまざまなことを探して試しましたが、100％適合するものはありませんでした。これが私の目標である「完全な家計管理」です。冷蔵庫をERPしてください！

知っておく価値のあること

REST API

/api にある統合された Swagger UI インスタンスを参照してください。

Web フロントエンドは、ほとんどすべてのことにまさにこの API を使用します。したがって、そこでできることはすべて API 経由でも可能です。

バーコードリーダーとカメラスキャン

一部のフィールド (上にバーコードアイコンが付いているもの) では、バーコードをスキャンして値を選択することもできます。バーコードリーダーがすべてのバーコードの前に、通常は項目名の一部ではない文字 (私は$使用) を付け、スキャン後にTAB送信すると、最も効果的に機能します。

さらに、対応するフィールドの右側にあるカメラボタンを使用して、デバイスのカメラを使用してバーコードをスキャンすることもできます (Quagga2 を搭載、完全にオフライン / クライアント側のカメラストリーム処理。ブラウザのセキュリティ制限により、これに注意してください)安全な接続 ( https:// ) 経由で Grocy を提供する場合にのみ機能します。簡単なビデオデモ: https://www.youtube.com/watch?v=Y5YH6IJFnfc

私の個人的な推奨事項: USB バーコードレーザースキャナーを使用します。安価でありながら、どのような照明条件下でも、どの角度から見ても、1000 % より良く、より速く動作します。

日付フィールドの省略表現を入力します

(生産性) の理由から、すべての日付 (および時刻) 入力 (および表示) フィールドでは、ローカライズに関係なく ISO-8601 形式が使用されます。次の省略表現が使用できます。

MMDD 、適切な表記法で、> 今日の場合は今年の指定された日に展開され、< 今日の場合は来年の指定された日に展開されます。
例: 0517 2024-05-17に変換されます
YYYYMMDD適切な ISO-8601 表記に展開されます
例: 20240417 2024-04-17に変換されます
YYYYMMeまたはYYYYMM+適切な表記で指定された年の指定された月の終わりまで展開されます。
例: 202407e 2024-07-31に変換されます
[+/-]n[d/m/y] 、適切な表記法で日/月/年の数を加算 ( + ) または減算 ( - ) しながら、今日を基準とした日付に展開されます。
例: +1m翌月の同日に換算されます
x 2999-12-31に展開されます (これは「期限切れがない」のエイリアスです)
下/上矢印キーで日付を 1 日ずつ増減します
右/左矢印キーで日付を 1 週間ずつ増減します
Shift + 下/上矢印キーで日付を 1 か月ずつ増減します
Shift + 右/左矢印キーで日付を 1 年ずつ増減します

キーボードのボタンの短縮形

ボタンに太字で強調表示された文字が含まれている場合、これはショートカットキーです。例: ボタン「 P新しい製品として追加」は、キーボードのPキーを使用して「押す」ことができます。

外部サービスによるバーコード検索

バーコードによる外部サービスとの照合により、製品をデータベースに直接追加できます。

これは、製品ピッカーワークフロー「外部バーコード検索 (プラグイン経由)」を使用してその場で実行できます (製品入力フィールドに不明なものを入力すると、ワークフローダイアログが表示されます)。

どのサービスにもプラグインは含まれていません。 data/plugins/DemoBarcodeLookupPlugin.phpのリファレンス実装を参照してください。

データベースの移行

データベーススキーマの移行は、ルート ( / ) ルートにアクセスすると自動的に行われます (左上端のロゴをクリック)。

注意: データベースの移行は、各コミット間ではなく、リリース間で機能することになっています。現在のmasterブランチ (開発バージョン) を実行したい場合は、それ (およびそれ以上) を自分で処理する必要があります。

特定の機能を無効にする

Grocy の特定の機能セットを使用しない場合 (たとえば、「Chores」が必要ない場合)、関連する UI 要素を非表示/無効にするための主要機能セットごとの機能フラグがあります ( config-dist.php参照)。

アプリケーション自体を変更せずに独自の CSS または JS を追加する

data/custom_js.htmlファイルが存在する場合、ファイルの内容は各ページの</body> (本文の終わり) の直前に追加されます。
data/custom_css.htmlファイルが存在する場合、ファイルの内容は各ページの</head> (頭の終わり) の直前に追加されます。

デモモード

MODE設定がdev 、 demo 、またはprereleaseに設定されている場合、アプリケーションはデモモードで動作します。これは、認証が無効になっていることを意味し、データベーススキーマの移行中にいくつかのデモデータが生成されます (クエリパラメーターnodemodataを渡します。例: https://grocy.example.com/?nodemodataをスキップしてください)。