burrowsa/christmas-bar

Christmas Bar 镜像概述

该镜像提供一个专为圣诞节家庭聚会设计的饮品管理应用，用于跟踪饮品订单和库存水平，支持多终端交互与语音订购功能，提升节日聚会的饮品服务效率。

核心功能

1. Web端应用：基于Vue.js的前端界面，支持安装为独立移动应用，提供订单查看、库存调整等功能。
2. Alexa语音集成：通过Alexa技能实现语音下单，支持家庭成员和饮品名称的同义词识别，缺失信息时自动提示补充。
3. 物理通知器：树莓派驱动的硬件设备，有活跃订单时点亮灯光提醒。
4. 管家权限：超级用户可添加/编辑饮品、调整库存，查看实时订单并处理（取消/确认）。

使用场景

适用于圣诞节家庭聚会等多人场景：家人通过手机Web应用或Alexa语音下单，管家通过专用平板管理库存和订单，物理通知器实时提醒新订单。

架构说明

• 前端：Vue.js + Bootstrap，支持PWA安装，通过socket.io与后端实时通信。
• 后端：Python + Flask部署于EC2，数据及产品图片存储在S3，HTTPS由弹性负载均衡器处理。
• 通信：socket.io实现设备间实时通知，确保订单状态同步。

构建与运行

使用docker-compose快速启动：

bash
sudo docker-compose up --build -d

生产环境部署（Amazon Linux EC2）

1. 安装Docker及Docker Compose：

bash
sudo yum update -y
sudo yum install -y docker
sudo service docker start
sudo systemctl enable docker
sudo usermod -a -G docker ec2-user
sudo curl -L "https://github.com/docker/compose/releases/download/1.23.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
logout

2. 部署应用：

bash
mkdir christmas-bar && cd christmas-bar
wget https://raw.githubusercontent.com/burrowsa/christmas-bar/master/docker-compose.yml
docker-compose pull && docker-compose up -d

持续部署

通过Docker Hub自动构建和Watchtower工具实现持续部署，自动更新镜像并重启服务。