← 返回项目库

家庭食品库存管理系统

把家庭食品、保质期、采购和消耗集中管理的本地 Web 工具。

围绕家庭日常食材建立可查询的库存台账：记录数量、存放位置与保质期，在临期或低库存时提供提醒，并把采购、消耗、菜谱和家务安排放进同一套界面。交付版本使用本地 SQLite 演示数据，便于先体验完整流程。

真实界面

项目截图

共 8 张

Capabilities

核心功能

✓库存数量、位置与保质期管理

✓采购、消耗、入库和库存调整

✓低库存与临期提醒

✓购物清单与入库工作流

✓菜谱、食材与饮食计划

✓家务、任务与日历安排

✓条码扫描入口与 REST API 页面

✓本地 SQLite 数据存储

适用场景

家庭食材台账与保质期管理

采购回家后的集中入库与消耗记录

按库存检查菜谱并生成购物清单

在 NAS 或家用小主机上部署私有家庭管理工具

适合谁

希望在 NAS、家用小主机或本地服务器管理食材的家庭用户，以及需要二次开发库存流程的开发者。

商业化思路

开源自部署与二次开发服务；可围绕家庭库存、条码入库、采购流程和菜谱模块提供实施定制。本交付不承诺实时外部食品数据或云端托管。

你会拿到什么

✓Grocy PHP Web 源码与 MIT 许可证文件
✓中文界面与本地 SQLite 演示数据说明
✓Composer/Yarn 构建配置与部署说明

部署流程

1准备 PHP 8.5+、SQLite 扩展、Composer 与 Yarn
2安装 Composer 与 Yarn 依赖并将 Web 根目录指向 public
3复制并按需调整 data/config.php，首次访问 / 完成数据库迁移
4使用浏览器打开服务地址并立即修改演示或管理员凭据

真实验证结果

已通过 8 个真实运行中文界面、HTTP、可见正文、控制台、坏图和横向溢出质量门。

部署前须知

本交付使用本地演示数据；未配置外部 API、云服务或第三方账号。

部署难度

中等

最低配置

PHP 8.5+、SQLite 3.40+ 及 fileinfo、pdo_sqlite、gd、ctype、intl、zlib、mbstring 扩展；建议 1 vCPU、2 GB 内存。构建阶段还需要 Composer 与 Yarn。

开源许可证

MIT License

最后验证

2026-09-02

授权说明

上游仓库提供 MIT License；再分发需保留版权与许可声明。本版本的演示数据和本地配置仅用于验收，不代表外部服务已接入。

Release notes

版本记录

1 个已发布版本

vcn-9de0e6bfdb2c 当前推荐

2026-09-02

基于 Grocy 4.7.0，补充中文演示数据兼容修复与动态 Web App manifest 的稳健解析。

部署要求：PHP 8.5+、SQLite 3.40+ 及项目要求的 PHP 扩展；构建需要 Composer 与 Yarn。

已知问题：演示数据保存在本地 SQLite；未配置外部 API、云服务或第三方账号。

登录后领取