mirror of
https://github.com/grocy/grocy.git
synced 2026-03-28 07:39:25 +01:00
ERP beyond your fridge - Grocy is a web-based self-hosted groceries & household management solution for your home
This change updates the GitHub Actions workflow to implement a versioned Docker tagging strategy, as requested. - The workflow now reads the version from `version.json`. - It generates semantic version tags (e.g., `v4.5.0`, `v4.5`, `v4`) for the Docker image, in addition to the `latest` tag. - This makes the image tagging consistent with the practices of `linuxserver/grocy`. |
||
|---|---|---|
| .devtools | ||
| .github | ||
| .tx | ||
| .vscode | ||
| changelog | ||
| controllers | ||
| data | ||
| docs | ||
| helpers | ||
| localization | ||
| middleware | ||
| migrations | ||
| plugins | ||
| public | ||
| services | ||
| views | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| .php-cs-fixer.php | ||
| .yarnrc | ||
| app.php | ||
| composer.json | ||
| composer.lock | ||
| config-dist.php | ||
| Dockerfile | ||
| grocy.openapi.json | ||
| LICENSE | ||
| package.json | ||
| README.md | ||
| routes.php | ||
| TODO.md | ||
| update.sh | ||
| version.json | ||
| yarn.lock | ||
AnticlockwiseGrocy - 逆时针
一个专为中国家庭打造的家庭物品管理神器
让我们一起,有效管理库存,利用资源,实现断舍离,减少浪费,聚焦重点。
核心理念
在现代快节奏的生活中,我们常常被繁杂的家务和无尽的物品所困扰。AnticlockwiseGrocy(逆时针)旨在帮助您和您的家庭:
- 告别混乱:清晰记录每件物品的位置、数量和保质期,让您的家井井有条。
- 践行断舍离:通过“闲置物品”报告等功能,轻松识别长期不用的物品,向不必要的囤积说再见。
- 减少浪费:智能提醒即将过期的食品,让每一份食材都物尽其用。
- 高效生活:无论是购物清单、菜谱计划还是家务分配,都为您安排得明明白白。
我们相信,通过管理好身边的“物”,可以更好地管理我们的时间与生活,将精力聚焦于更重要的人和事。
功能亮点
- 库存管理:随时掌握家中食品、日用品等所有物品的库存情况。
- 购物清单:智能生成购物清单,缺少的物品一目了然,避免重复购买。
- 菜谱计划:轻松规划每周菜单,并根据菜谱自动检查库存。
- 家务管理:创建家务计划,并分配给家庭成员,让家务不再是难题。
- 闲置物品报告:一键找出那些被遗忘在角落的物品,帮助您做出“断舍离”的决策。
- 保质期提醒:自动提醒即将过期的产品,有效减少食物浪费。
- 专为中国优化:内置了“斤”、“克”、“个”等符合中国人使用习惯的数量单位。
如何安装和使用
我们深知不是每个人都是技术专家。因此,我们正在努力提供更简单的安装方式。
方式一:使用 Docker(推荐)
对于有一定技术基础的用户,我们推荐使用 Docker 进行安装。这是最快、最稳定的方式。
我们的 Docker 镜像基于本项目的源代码构建,默认使用中文界面,并已为您准备好一切。
-
拉取镜像
docker pull nishizhen/anticlockwisegrocy:latest -
运行容器
docker run -d \ --name=anticlockwisegrocy \ -p 9283:80 \ -v /path/to/your/data:/config \ nishizhen/anticlockwisegrocy:latest请注意:
-p 9283:80:将容器的 80 端口映射到您服务器的 9283 端口。您可以根据需要更改9283。-v /path/to/your/data:/config:将您的数据持久化存储在本地。请务必将/path/to/your/data替换为您服务器上的一个真实路径,例如/home/user/grocy_data。
-
访问应用 打开浏览器,访问
http://<您的服务器IP>:9283。 默认登录用户为admin,密码为admin,请在登录后立即修改密码。
方式二:手动安装
如果您熟悉网站搭建,可以按照以下步骤进行手动安装:
- 下载 最新发布版。
- 将
config-dist.php复制为data/config.php,并根据您的需求进行修改。 - 确保
data目录具有写入权限。 - 将您的网站服务器根目录指向
public目录。 - 默认登录用户为
admin,密码为admin,请在登录后立即修改密码。
更多详细的安装说明和帮助,请参考原版 Grocy 的文档。我们正在努力编写更符合中国用户习惯的中文文档。
未来计划 (Roadmap)
为了让 AnticlockwiseGrocy 更贴近中国家庭的需求,我们规划了以下功能(欢迎您提供宝贵的建议!):
- [进行中] 更强大的条码扫描:集成更适合中国市场的商品条码查询服务,实现扫码即可录入商品信息。
- [计划中] 与微信集成:
- 通过微信接收保质期提醒、购物清单通知。
- 与家人通过微信共享购物清单。
- [计划中] 中式菜谱优化:
- 接入“下厨房”等中文菜谱网站,一键导入菜谱。
- 根据农历节气,智能推荐时令菜谱(如:端午节推荐粽子,中秋节推荐月饼)。
- [计划中] 更多“断舍离”辅助功能:
- “捐赠/丢弃”建议功能,智能识别可处理的闲置物品。
- 可视化浪费报告,追踪被丢弃物品的价值,让您对消费有更清晰的认识。
- [计划中] 移动端体验优化:
- 针对手机进行界面优化,使其更符合移动优先的使用习惯。
- 开发微信小程序或 PWA 应用,提供更流畅的移动体验。
- [计划中] 一键部署方案:
- 提供在阿里云、腾讯云等国内主流云服务商上的一键部署脚本。
- 探索更简单的桌面版或轻量级部署方案。
参与贡献
本项目是开源的,我们欢迎任何形式的贡献,无论是代码、文档、还是一个好的想法。
- 问题反馈与功能建议:请通过 Issue Tracker 告诉我们。
- 参与翻译:如果您想帮助我们改进翻译,可以访问 Transifex。
本项目基于 Grocy 进行二次开发,感谢原作者 Bernd Bestel 的辛勤付出。