哈喽啤鲜生收银与库存管理系统

项目结构说明

本项目采用Docker容器化部署，包含前端、后端、数据库和Nginx服务。

核心文件

• docker-compose.yml - Docker编排配置文件
• Dockerfile.frontend - 前端Docker构建文件
• Dockerfile.backend - 后端Docker构建文件
• nginx.conf - Nginx配置文件
• frontend/ - 前端源代码目录
• backend/ - 后端源代码目录
• nginx/ - Nginx配置目录
• docs/ - 系统文档目录
• images/ - 图片资源目录
• logs/ - 日志目录
• uploads/ - 上传文件目录
• backups/ - 备份文件目录

部署脚本

• update-dev.sh - 开发更新脚本（无需重建镜像）
• rebuild-docker-images.sh - 重建Docker镜像脚本
• update.sh - 系统更新脚本
• backup.sh - 系统备份脚本

文件夹说明

• documentation/ - 项目文档集合
• deployment_scripts/ - 部署脚本集合
• legacy_files/ - 历史修复脚本（不再使用）

开发与部署流程

开发流程

1. 在本地修改前端或后端代码
2. 将代码上传到群晖服务器对应目录：
   • 前端代码 → /volume1/docker/hello/frontend/
   • 后端代码 → /volume1/docker/hello/backend/
3. 使用开发更新脚本应用更改：

   ./update-dev.sh frontend  # 更新前端
   ./update-dev.sh backend   # 更新后端
   ./update-dev.sh all       # 更新全部

4. 访问 http://[群晖IP]:8081 测试功能

详细开发指南请参考 update-dev-guide.md。

部署流程

1. 拉取最新代码：

   git pull

2. 重建Docker镜像（如有必要）：

   ./rebuild-docker-images.sh

3. 备份系统：

   ./backup.sh

目录映射关系

• 项目源代码和Docker配置目录: /volume1/docker/hello
• 持久化数据目录: /volume1/backup/hello-beer

容器信息

• 前端容器: hello-beer-frontend
• 后端容器: hello-beer-backend
• Nginx容器: hello-beer-nginx
• 数据库容器: hello-beer-db

访问信息

• 前端访问: http://[群晖IP]:8081
• 后端API: http://[群晖IP]:3100