campus-imaotai自动化预约系统使用指南

价值定位：解决预约痛点的自动化方案

核心功能与适用场景

campus-imaotai是一款专注于i茅台平台的自动化预约工具，通过程序定时执行预约流程，解决人工抢单效率低、操作繁琐的问题。系统支持多账号管理、地区筛选和预约记录追踪，特别适合需要每日参与茅台预约的用户群体，可节省约90%的手动操作时间。

技术架构解析

系统采用前后端分离架构，包含三大核心组件：

• 前端管理界面（Vue.js构建）：提供用户配置与监控功能
• 后端服务（Java开发）：处理预约逻辑与API交互
• 数据存储层：依赖MySQL（数据持久化）和Redis（缓存加速）

图1：系统用户管理界面，支持多账号配置与状态监控

环境适配：部署前的准备工作

系统环境要求

推荐运行环境配置：

• 操作系统：Linux/Unix（推荐Ubuntu 20.04+）
• 容器引擎：Docker 20.10+（轻量级虚拟化环境）
• 编排工具：Docker Compose 2.0+（容器协调工具）
• 硬件配置：最低1核CPU/2GB内存/10GB磁盘空间

⚠️ 常见问题预判：Windows系统需开启WSL2支持，MacOS需确保Docker Desktop资源分配不低于2GB内存

依赖组件检查

执行以下命令验证环境是否就绪：

docker --version          # 检查Docker版本
docker-compose --version  # 检查Compose版本

预期输出应显示版本号且无错误提示，若命令不存在需先安装对应组件。

实施步骤：从部署到验证的完整流程

1. 代码获取与准备

推荐通过Git克隆项目代码到本地：

git clone https://gitcode.com/GitHub_Trending/ca/campus-imaotai [本地目录]

进入项目根目录后，检查关键配置文件是否存在：

ls -l doc/docker           # 查看Docker相关配置
ls -l campus-modular/src/resources/application-prod.yml  # 检查配置模板

2. 容器化部署执行

使用Docker Compose一键部署服务栈：

cd doc/docker              # 进入部署配置目录
docker-compose up -d       # 启动所有服务组件

命令参数说明：

• -d：后台运行容器（可选参数）
• --force-recreate：强制重建容器（解决配置更新问题时使用）

⚠️ 常见问题预判：若出现端口冲突，需修改docker-compose.yml中的端口映射配置

3. 服务状态验证

执行以下命令检查容器运行状态：

docker-compose ps          # 查看所有服务状态
docker logs -f campus-imaotai-server  # 查看应用日志

当日志出现"Started Application in X seconds"提示时，表示服务启动成功。访问前端界面：http://服务器IP:8160，默认账号密码可在配置文件中查看。

场景拓展：功能应用与优化策略

多账号管理方案

系统支持批量添加预约账号，通过用户管理界面可实现：

1. 点击"添加账号"按钮输入手机号
2. 获取并验证验证码完成绑定
3. 设置预约优先级与地区偏好

图2：账号添加流程界面，支持验证码快速验证

预约策略优化

提高成功率的实用技巧：

• 地区筛选：选择库存充足的非热门城市（如图3门店列表所示）
• 时间配置：设置在预约开始前1-2分钟启动任务
• 任务监控：通过操作日志追踪每次预约执行结果

图3：门店列表管理界面，支持多维度筛选

日常运维建议

• 日志审计：定期检查操作日志（如图4），关注"预约成功"记录
• 配置备份：定期导出application-prod.yml配置文件
• 镜像更新：每季度执行docker-compose pull获取最新镜像

图4：系统操作日志界面，记录所有预约执行情况

生态矩阵：组件协作与扩展能力

核心组件架构

系统各模块协作关系：

• 前端界面（vue_campus_admin）：提供用户交互与配置界面
• 后端服务（campus-modular）：核心预约逻辑与API交互
• 数据存储：MySQL存储用户信息与预约记录，Redis缓存临时数据

扩展能力说明

• 二次开发：通过修改campus-modular/src/main/java/com/oddfar/campus/下的预约策略代码，可定制预约逻辑
• 通知集成：支持通过修改配置文件添加邮件/短信通知接口
• 多平台适配：预留接口支持扩展其他预约平台

部署架构建议

生产环境推荐采用：

• 应用服务器：至少2台实现高可用
• 数据库：主从架构确保数据安全
• 监控系统：集成Prometheus监控服务健康状态

通过以上配置，可构建稳定可靠的茅台酒自动化预约系统，实现无人值守的预约流程。系统设计遵循模块化原则，便于后续功能扩展与维护。