Skip to content

1parado/Travel_microservice_frontend

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Travel Microservice Frontend

智旅云前端项目,基于 Vue 3、Vite、TypeScript、Element Plus、Pinia 和 Vue Router 构建。项目面向在线旅游 OTA 场景,提供航班、酒店、景区、用车、餐厅、社区、会员、购物车、订单、常用乘客、地图和 AI 旅行助手等页面。

功能概览

  • 航班查询与详情查看
  • 酒店搜索与详情查看
  • 景区列表与门票查看
  • 用车服务浏览与预订
  • 餐厅推荐与详情查看
  • 社区游记浏览、创建与详情查看
  • 会员中心、购物车、订单管理
  • 常用乘客管理
  • 地图页面
  • AI 旅行助手页面与全局 AI 悬浮挂件
  • 登录、注册和用户认证状态管理

技术栈

  • Vue 3
  • TypeScript
  • Vite
  • Vue Router
  • Pinia
  • Element Plus
  • Axios
  • pnpm

环境要求

建议使用以下环境:

  • Node.js 18 或更高版本
  • pnpm 8 或更高版本

如果尚未安装 pnpm,可以执行:

npm install -g pnpm

快速开始

安装依赖:

pnpm install

启动开发服务:

pnpm dev

默认访问地址:

http://localhost:5173

构建生产版本:

pnpm build

本地预览生产构建:

pnpm preview

常用命令

pnpm install   # 安装依赖
pnpm dev       # 启动开发环境
pnpm build     # 构建生产产物
pnpm preview   # 预览生产构建

目录结构

frontend/
├── index.html
├── package.json
├── pnpm-lock.yaml
├── vite.config.ts
├── src/
│   ├── api/          # 后端接口封装
│   ├── assets/       # 静态资源和全局 CSS
│   ├── components/   # 公共组件
│   ├── router/       # 路由配置
│   ├── store/        # Pinia 状态管理
│   ├── styles/       # 样式文件
│   ├── utils/        # 工具函数
│   └── views/        # 页面组件
└── .gitignore

路由页面

主要页面包括:

  • /flight:航班搜索
  • /hotel:酒店搜索
  • /scenic:景区列表
  • /car:用车服务
  • /restaurant:餐厅列表
  • /community:社区游记
  • /membership:会员中心
  • /assistant:AI 旅行助手
  • /cart:购物车
  • /order:订单管理
  • /passenger:常用乘客
  • /map:地图
  • /login:登录
  • /register:注册

后端接口

前端接口统一封装在 src/api/ 下,并通过 Axios 发送请求。开发时请确保后端服务已启动,并根据 src/api/http.ts 中的基础地址配置进行联调。

如果后端接口地址不同,请修改 Axios 的 base URL 配置。

AI 助手说明

项目包含两种 AI 助手入口:

  • /assistant:完整 AI 旅行助手页面
  • 全局 AI 悬浮挂件:除助手页外,其他页面右下角显示入口

AI 挂件支持:

  • 展开对话
  • 最小化为悬浮按钮
  • 最大化跳转到 /assistant
  • 关闭当前面板并回到悬浮按钮
  • 与完整助手页共享本次对话记录

Git 与敏感信息

当前目录已添加 .gitignore,默认忽略:

  • node_modules/
  • dist/
  • .env.env.*
  • .npmrc
  • 私钥、证书和临时文件

不要提交真实 API Key、Token、密码、私钥或本地环境配置。如果需要提供示例配置,请使用 .env.example

部署说明

执行生产构建:

pnpm build

构建产物会生成在:

dist/

可以将 dist/ 部署到 Nginx、静态资源服务器或对象存储。若使用 Vue Router 的 history 模式,服务器需要配置前端路由回退到 index.html

Nginx 示例:

location / {
  try_files $uri $uri/ /index.html;
}

常见问题

1. 页面访问后是空白?

请检查:

  • 是否已执行 pnpm install
  • 是否使用 pnpm dev 启动
  • 浏览器控制台是否有接口错误或路由错误

2. 接口请求失败?

请检查:

  • 后端服务是否启动
  • Axios base URL 是否正确
  • 是否存在跨域配置问题
  • 登录态 Token 是否有效

3. 页面样式没有更新?

可以尝试:

Ctrl + F5

或重启开发服务:

pnpm dev

远程仓库

当前前端远程仓库:

https://github.com/1parado/Travel_microservice_frontend.git

Screenshots

The following screenshots are stored in the pic/ directory and will render on GitHub after pushing the repository.

AI客服

AI客服

乘客信息

乘客信息

会员系统

会员系统

地图

地图

拼团

拼团

拼团2

拼团2

景区

景区

用车服务

用车服务

社区

社区

系统架构

系统架构

航班详情

航班详情

订单

订单

购物车

购物车

酒店页面

酒店页面

餐厅

餐厅

首页

首页

About

智旅云前端

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors