grocy下载 - grocy源码下载

超越冰箱的 ERP

Grocy 是一个基于网络的自托管杂货和家庭管理解决方案，适合您的家庭

这是 Bernd Bestel 的一个业余爱好项目

尝试一下

最新稳定版本的公开演示（ release分支）→ https://demo.grocy.info
当前开发版本的公开演示（ master分支）→ https://demo-prerelease.grocy.info

特征

请参阅网站。 → https://grocy.info

问题/帮助/错误报告/功能请求

一般帮助和使用问题 → r/grocy subreddit
错误报告和功能请求 → 问题跟踪器

请不要给我发私人信息或打电话给我有关任何 Grocy 的事情。我几乎每天都会检查问题跟踪器和 Reddit 子版块，但除此之外不提供任何支持。

社区贡献

请参阅网站以获取社区贡献的附加组件/工具的列表。 → https://grocy.info/addons

如何安装

如果您想运行 Grocy，而无需像普通 (Windows) 桌面应用程序一样管理网络服务器，请查看 Grocy Desktop。
直接下载最新版本——安装无非就是点击两次“下一步”。

从技术上讲，Grocy 是一个非常简单的 PHP 应用程序，因此运行它的基本注意事项是：

解压最新版本
将config-dist.php复制到data/config.php + 根据您的需要进行编辑
确保data目录可写
网络服务器根目录应指向public目录
包含try_files $uri /index.php$is_args$query_string;如果您使用 nginx，则在您的位置块中
或者禁用 URL 重写（请参阅data/config.php中的DISABLE_URL_REWRITING选项）
→ 默认登录用户为admin ，密码为admin ，请立即更改密码（右上角用户菜单）

或者克隆此存储库（ release分支始终引用最新发布的版本）并手动安装 Composer 和 Yarn 依赖项。

请参阅网站以获取更多安装指南和故障排除帮助。 → 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目录
访问主路由一次以应用数据库迁移（见下文）

如果您在 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 你的冰箱！

值得知道的事情

休息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 的某些功能集（例如，如果您不需要“杂务”），则每个主要功能集都有功能标志来隐藏/禁用相关的 UI 元素（请参阅config-dist.php ）。

添加您自己的 CSS 或 JS，而无需修改应用程序本身

当文件data/custom_js.html存在时，该文件的内容将添加到每个页面的</body> （正文末尾）之前
当文件data/custom_css.html存在时，该文件的内容将添加到每个页面的</head> （head 末尾）之前

演示模式

当MODE设置为dev 、 demo或prerelease时，应用程序将在演示模式下工作，这意味着身份验证被禁用，并且在数据库架构迁移期间将生成一些演示数据（传递查询参数nodemodata ，例如https://grocy.example.com/?nodemodata跳过该部分）。