grocy/README.md

AnticlockwiseGrocy - 逆时针

一个专为中国家庭打造的家庭物品管理神器

让我们一起，有效管理库存，利用资源，实现断舍离，减少浪费，聚焦重点。

---

核心理念

在现代快节奏的生活中，我们常常被繁杂的家务和无尽的物品所困扰。AnticlockwiseGrocy（逆时针）旨在帮助您和您的家庭：

• 告别混乱：清晰记录每件物品的位置、数量和保质期，让您的家井井有条。
• 践行断舍离：通过“闲置物品”报告等功能，轻松识别长期不用的物品，向不必要的囤积说再见。
• 减少浪费：智能提醒即将过期的食品，让每一份食材都物尽其用。
• 高效生活：无论是购物清单、菜谱计划还是家务分配，都为您安排得明明白白。

我们相信，通过管理好身边的“物”，可以更好地管理我们的时间与生活，将精力聚焦于更重要的人和事。

功能亮点

• 库存管理：随时掌握家中食品、日用品等所有物品的库存情况。
• 购物清单：智能生成购物清单，缺少的物品一目了然，避免重复购买。
• 菜谱计划：轻松规划每周菜单，并根据菜谱自动检查库存。
• 家务管理：创建家务计划，并分配给家庭成员，让家务不再是难题。
• 闲置物品报告：一键找出那些被遗忘在角落的物品，帮助您做出“断舍离”的决策。
• 保质期提醒：自动提醒即将过期的产品，有效减少食物浪费。
• 专为中国优化：内置了“斤”、“克”、“个”等符合中国人使用习惯的数量单位。

如何安装和使用

我们深知不是每个人都是技术专家。因此，我们正在努力提供更简单的安装方式。

方式一：使用 Docker（推荐）

对于有一定技术基础的用户，我们推荐使用 Docker 进行安装。这是最快、最稳定的方式。

我们的 Docker 镜像基于本项目的源代码构建，默认使用中文界面，并已为您准备好一切。

1. 拉取镜像

   docker pull nishizhen/anticlockwisegrocy:latest
   

2. 运行容器

   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。

3. 访问应用 打开浏览器，访问 http://<您的服务器IP>:9283。 默认登录用户为 admin，密码为 admin，请在登录后立即修改密码。

方式二：手动安装

如果您熟悉网站搭建，可以按照以下步骤进行手动安装：

1. 下载 最新发布版。
2. 将 config-dist.php 复制为 data/config.php，并根据您的需求进行修改。
3. 确保 data 目录具有写入权限。
4. 将您的网站服务器根目录指向 public 目录。
5. 默认登录用户为 admin，密码为 admin，请在登录后立即修改密码。

更多详细的安装说明和帮助，请参考原版 Grocy 的文档。我们正在努力编写更符合中国用户习惯的中文文档。

未来计划 (Roadmap)

为了让 AnticlockwiseGrocy 更贴近中国家庭的需求，我们规划了以下功能（欢迎您提供宝贵的建议！）：

• [进行中] 更强大的条码扫描：集成更适合中国市场的商品条码查询服务，实现扫码即可录入商品信息。
• [计划中] 与微信集成：
  • 通过微信接收保质期提醒、购物清单通知。
  • 与家人通过微信共享购物清单。
• [计划中] 中式菜谱优化：
  • 接入“下厨房”等中文菜谱网站，一键导入菜谱。
  • 根据农历节气，智能推荐时令菜谱（如：端午节推荐粽子，中秋节推荐月饼）。
• [计划中] 更多“断舍离”辅助功能：
  • “捐赠/丢弃”建议功能，智能识别可处理的闲置物品。
  • 可视化浪费报告，追踪被丢弃物品的价值，让您对消费有更清晰的认识。
• [计划中] 移动端体验优化：
  • 针对手机进行界面优化，使其更符合移动优先的使用习惯。
  • 开发微信小程序或 PWA 应用，提供更流畅的移动体验。
• [计划中] 一键部署方案：
  • 提供在阿里云、腾讯云等国内主流云服务商上的一键部署脚本。
  • 探索更简单的桌面版或轻量级部署方案。

参与贡献

本项目是开源的，我们欢迎任何形式的贡献，无论是代码、文档、还是一个好的想法。

• 问题反馈与功能建议：请通过 Issue Tracker 告诉我们。
• 参与翻译：如果您想帮助我们改进翻译，可以访问 Transifex。

---

本项目基于 Grocy 进行二次开发，感谢原作者 Bernd Bestel 的辛勤付出。