aoepeople/meals

🍽 AOEpeople/meals

镜像概述和主要用途

Meals 是一个开源Web应用，专为公司食堂的午餐管理设计。它支持员工餐食选择、访客邀请、交易记录跟踪及支付管理，并提供管理员和财务角色的专业功能，以简化食堂日常运营和财务管理。

!https://raw.githubusercontent.com/AOEpeople/meals/master/app/Resources/images/meals_screenshot.png

---

https://github.com/AOEpeople/meals/actions/workflows/main.yml/badge.svg](https://github.com/AOEpeople/meals/actions/workflows/main.yml)

核心功能和特性

用户功能

餐食报名

通过Keycloak使用LDAP凭证登录，在首页选择偏好的餐食。

邀请访客用餐

登录LDAP凭证后，每周各天会显示分享图标。可向访客发送链接，访客输入姓名和公司信息即可报名特定日期的餐食。

交易历史

点击余额，可查看上月最后一天的余额及当月所有交易概览。

***债务支付

在交易历史中，可通过***支付债务。

管理员功能

通用

管理员可访问所有用户功能。

菜单（周列表）

• 路径：/menu
• 访问方式：在管理员导航栏选择"菜单"
• 操作：创建新周、编辑现有周

描述：显示当前和即将到来的周列表。已创建/编辑的周显示为绿色，未创建的周显示灰色背景。

菜单（周详情视图）

• 路径：/menu/{YYYY}W{KW}/new 或 /menu/{week-id}/edit
• 访问方式：在管理员导航栏选择"菜单"，点击列表中的周
• 操作：禁用整周或特定日期

描述：可为选定的周选择所需菜品，也可在节假日等情况下禁用特定日期或整周。

菜品管理

• 路径：/dish
• 访问方式：在管理员导航栏选择"菜品"
• 操作：添加变体、创建/编辑/删除菜品

菜品变体管理

• 路径：/dish
• 访问方式：在管理员导航栏选择"菜品"
• 操作：添加变体、编辑/删除菜品

描述：列出特定菜品的所有现有变体，可编辑和删除。点击"添加变体"可为菜品添加新变体。

（菜品）分类管理

• 路径：/category
• 访问方式：在管理员导航栏选择"分类"
• 操作：创建/编辑/删除分类

描述：列出所有现有菜品分类，可编辑和删除。点击"创建分类"可新建分类。

成本管理

• 路径：/print/costsheet
• 访问方式：在管理员导航栏选择"成本"
• 操作：为用户记录交易、"现金 register"（会计账簿）

描述：列出所有用户及其未偿还债务，债务分为6列：总计、当月（当月截至当天的所有债务）、过去三个月各一列、三个月前债务总和一列。点击加号可为用户添加交易（正数或负数），点击三点按钮可结算离职员工账户（仅正数金额可结算），结算日志位于 app/logs 文件夹。

会计账簿

• 路径：/accounting/book
• 访问方式：在管理员导航栏选择"成本"，点击"现金 register"按钮

描述：列出上月为用户记录的所有交易。

财务功能

通用

财务角色可访问所有用户功能和财务标签。

交易管理

• 路径：/accounting/book/finance/list
• 访问方式：在财务导航栏选择"财务"
• 操作：选择日期列出所有交易并导出为PDF。

使用场景和适用范围

适用于需要管理公司食堂午餐的企业，可协调员工餐食选择、访客用餐安排、成本核算及财务跟踪，尤其适合有固定食堂且需要规范化管理的组织。

使用方法和配置说明

开发环境安装

使用 ddev 进行本地开发，ddev 是一个使用 Docker 简化本地开发的 CLI 工具。确保已安装 ddev、mkcert 和 docker，执行以下命令启动：

ddev start

在浏览器中访问 [***] :tada:
若 ddev 未自动配置，需手动添加到本地 hosts 文件：127.0.0.1 meals.test

重建生产环境前端资源

bash
# 进入容器
ddev ssh

# 切换目录
cd app/Resources

# 构建生产资源
yarn build

运行代码检查

bash
# SASS 文件 stylelint 检查
ddev ssh
cd /var/www/html/app/Resources
yarn lint-sass

SSH 访问

bash
ddev ssh

常用命令

bash
php app/console doctrine:schema:update --force

故障排除

SQLSTATE[42S22]: Column not found: 1054 Unknown column

bash
php app/console doctrine:schema:update --force --env=dev

开发者信息

用户角色

系统使用以下角色：

• ROLE_USER：允许参与餐食的所有用户
• ROLE_KITCHEN_STAFF：允许创建和编辑菜品及餐食
• ROLE_GUEST：受邀用餐的访客、客户等
• ROLE_ADMIN：管理员用户
• ROLE_FINANCE：财务用户

测试数据

加载测试数据：

bash
php app/console doctrine:fixtures:load --env=dev

将生成菜品、餐食和用户。可使用 "john"、"jane"、"alice"、"bob" 登录，密码与用户名相同。用户 "kochomi" 可修改菜品和编辑餐食。

运行测试

部分测试需要数据库支持，测试数据库配置需在 app/config/parameters.yml 中设置 database_name_testing，凭据与开发环境相同。

运行 phpunit 前确保数据库 schema 已更新：

bash
# 创建测试数据库和用户
sudo -i
mysql
> CREATE USER 'mealz_test'@'localhost' IDENTIFIED BY 'mealz_test';
> CREATE DATABASE mealz_test;
> GRANT ALL PRIVILEGES ON mealz_test.* TO 'mealz_test'@'localhost';

# 更新测试环境 schema
php app/console doctrine:schema:update --env=test --force

# 运行测试
bin/phpunit -c app/config/commons/development/phpunit.xml

注意：

• 使用 --filter CLASSNAME 可测试单个测试类
• 禁用 xdebug 可提升性能