# smart-rail

**Repository Path**: jifeng_git/smart-rail

## Basic Information

- **Project Name**: smart-rail
- **Description**: SmartRail Mini - 入门SpringAI的智能高铁购票系统。实现购票、改签、退票功能，利用SpringAI提升智能推荐与用户体验。适合改造传统项目的首选示例，展示如何集成SpringAI进行系统智能化升级。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-14
- **Last Updated**: 2025-07-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# smart-rail

## 介绍

smart-rail 是一个智能铁路票务管理系统，提供列车信息查询、座位管理、票务预订、改签和退票等功能。系统采用前后端分离架构，后端使用 Spring Boot 框架，前端使用 Vue.js 框架。

## 软件架构

- **后端技术栈**:
  - Spring Boot
  - MyBatis Plus
  - MySQL
  - Redis
  - OpenAI SDK

- **前端技术栈**:
  - Vue.js
  - Vite
  - Axios
  - Element Plus

## 安装教程

1. **后端安装**
   - 安装 JDK 17
   - 安装 MySQL 8.0
   - 安装 Redis
   - 导入 `smart-rail.sql` 数据库文件
   - 修改 `application.yml` 配置文件中的数据库和 Redis 配置
   - 使用 Maven 构建项目: `mvn clean package`
   - 运行项目: `java -jar smart-rail-server.jar`

2. **前端安装**
   - 安装 Node.js 18.x
   - 安装项目依赖: `npm install`
   - 启动开发服务器: `npm run dev`
   - 构建生产环境包: `npm run build`

## 使用说明

- **API 文档**: 使用 Swagger 访问 API 文档: `http://localhost:8080/swagger-ui.html`
- **前端访问**: 打开浏览器访问 `http://localhost:3000`
- **主要功能**:
  - 列车信息查询
  - 座位信息查询
  - 票务预订
  - 订单改签
  - 票务退票
  - 订单管理

## 参与贡献

1. Fork 项目
2. 创建新分支
3. 提交代码
4. 创建 Pull Request

## 特技

- 使用 OpenAI 实现智能客服功能
- 支持流式响应，提供更好的用户体验
- 完善的异常处理机制
- 详细的日志记录
- 支持 CORS 跨域请求
- 使用 MyBatis Plus 提高开发效率
- 使用 Redis 缓存热点数据
- 支持数据库事务管理
- 提供详细的 API 文档
- 使用 Vue.js 实现响应式前端界面

## 许可证

本项目采用 MIT 许可证。详情请查看 LICENSE 文件。