穷游费用对比系统 Pro

:backpack: 穷游费用对比系统 Pro
智能规划 · 实时数据 · 全网比价 · 一键预订

:open_book: 项目简介
穷游费用对比系统是一款专为背包客和穷游爱好者打造的一站式旅行费用规划工具。系统整合了火车票、机票、酒店、景点门票等多维度数据,通过智能算法为用户推荐最省钱的旅行方案。

:sparkles: 核心特性
:magnifying_glass_tilted_left: 全网比价:一键对比多个平台的交通、住宿价格
:bar_chart: 实时数据:模拟真实API数据源,支持定时更新
:money_bag: 费用汇总:自动计算最低预算和舒适预算
:wrapped_gift: 优惠活动:聚合各平台优惠券和促销活动
:link: 一键预订:直达第三方平台,快速完成预订
:mobile_phone: 响应式设计:完美适配桌面端和移动端
:rocket: 快速开始
环境要求
Node.js >= 18.0.0
npm >= 9.0.0
现代浏览器(Chrome/Firefox/Safari/Edge)
安装步骤
克隆项目

Bash

git clone https://github.com/yourusername/travel-price-comparison.git
cd travel-price-comparison
安装后端依赖

Bash

cd backend
npm install
启动后端服务

Bash

npm start

或开发模式

npm run dev
打开前端页面 直接用浏览器打开 frontend/index.html 文件
默认端口
后端API:http://localhost:3000
前端页面:file://frontend/index.html 或通过 Live Server
:file_folder: 项目结构

Plain Text

travel-price-comparison/
├── :open_file_folder: frontend/ # 前端代码
│ ├── index.html # 主页面
│ ├── css/
│ │ └── style.css # 样式文件
│ └── js/
│ └── app.js # 前端逻辑
├── :open_file_folder: backend/ # 后端代码
│ ├── server.js # Express服务器
│ ├── package.json # 依赖配置
│ └── .env.example # 环境变量示例
├── :open_file_folder: docs/ # 文档
│ ├── API.md # API接口文档
│ └── DEPLOY.md # 部署指南
├── :open_file_folder: assets/ # 静态资源
│ └── screenshots/ # 项目截图
└── README.md # 项目说明
:hammer_and_wrench: 技术栈
前端
HTML5 + CSS3 - 页面结构和样式
Vanilla JavaScript - 原生JavaScript,无框架依赖
CSS Grid/Flexbox - 响应式布局
CSS Variables - 主题色彩管理
Fetch API - 数据请求
后端
Node.js - 运行环境
Express.js - Web框架
CORS - 跨域支持
node-cron - 定时任务
express-rate-limit - 限流保护
:satellite_antenna: API 接口
火车票查询

http

GET /api/trains?from=北京&to=上海&date=2024-01-01
机票查询

http

GET /api/flights?from=北京&to=上海&date=2024-01-01
酒店查询

http

GET /api/hotels?city=上海&checkin=2024-01-01&checkout=2024-01-03
景点查询

http

GET /api/attractions?city=上海
优惠活动

http

GET /api/promotions
综合比价

http

GET /api/compare?from=北京&to=上海&date=2024-01-01&travelers=2&days=3
:bullseye: 功能模块

  1. 行程规划
    出发地/目的地选择
    出行日期设定
    人数和天数配置
    餐饮预算设置
  2. 交通比价
    :high_speed_train: 火车票:高铁/动车/普快/特快
    :airplane: 机票:多航司价格对比
    :bus: 大巴:短途出行方案
    实时显示折扣信息
  3. 住宿比价
    :hotel: 酒店:经济型/快捷/舒适型
    :house: 民宿:特色民宿推荐
    :backpack: 青旅:背包客首选
    价格/评分/位置综合排序
  4. 景点推荐
    :ticket: 门票价格查询
    :round_pushpin: 热门景点推荐
    :light_bulb: 省钱攻略提示
    :free_button: 免费景点标注
  5. 费用汇总
    :money_bag: 最低总预算
    :glowing_star: 舒适总预算
    :bar_chart: 分项费用明细
    :chart_increasing: 价格趋势分析
  6. 优惠活动
    :wrapped_gift: 优惠券聚合
    :credit_card: 促销码展示
    :alarm_clock: 有效期提醒
    :link: 一键跳转领取
    :cityscape_at_dusk: 支持城市
    目前支持以下热门旅游城市:

城市 交通 酒店 景点
北京 :white_check_mark: :white_check_mark: :white_check_mark:
上海 :white_check_mark: :white_check_mark: :white_check_mark:
广州 :white_check_mark: :white_check_mark: :white_check_mark:
深圳 :white_check_mark: :white_check_mark: :white_check_mark:
杭州 :white_check_mark: :white_check_mark: :white_check_mark:
成都 :white_check_mark: :white_check_mark: :white_check_mark:
西安 :white_check_mark: :white_check_mark: :white_check_mark:
:artist_palette: 界面预览
首页
首页截图

交通比价
交通截图

酒店比价
酒店截图

费用汇总
汇总截图

:wrench: 配置说明
环境变量
创建 .env 文件:

env

PORT=3000
NODE_ENV=development
API_RATE_LIMIT=100
CACHE_TTL=1800
数据源配置
在 backend/server.js 中配置数据源:

JavaScript

const trainDataSource = {
‘北京-上海’: [
{ trainNo: ‘G1’, type: ‘高铁’, price: { second: 553, first: 933 } }
]
};
:chart_increasing: 性能优化
:white_check_mark: 数据缓存机制(30分钟更新)
:white_check_mark: API请求限流保护
:white_check_mark: 前端懒加载
:white_check_mark: 图片懒加载
:white_check_mark: CSS/JS压缩
:locked: 安全特性
:white_check_mark: CORS跨域配置
:white_check_mark: 请求频率限制
:white_check_mark: 输入参数验证
:white_check_mark: XSS防护
:memo: 更新日志
v1.0.0 (2024-01-01)
:sparkles: 初始版本发布
:high_speed_train: 火车票查询功能
:airplane: 机票查询功能
:hotel: 酒店查询功能
:ticket: 景点查询功能
:money_bag: 费用汇总功能
:wrapped_gift: 优惠活动功能
:handshake: 贡献指南
欢迎提交 Issue 和 Pull Request!

Fork 本项目
创建特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m ‘Add some AmazingFeature’)
推送分支 (git push origin feature/AmazingFeature)
创建 Pull Request
:page_facing_up: 开源协议
本项目基于 MIT 协议开源。

:folded_hands: 致谢
感谢各OTA平台提供的数据支持
感谢开源社区的贡献
感谢所有用户的反馈和建议
:postbox: 联系我们https://github.com/chenmin7/travel-price-comparison
项目主页:https://github.com/yourusername/travel-price-comparison
问题反馈:https://github.com/yourusername/travel-price-comparison/issues
邮箱:1287183332@qq.com
Made with :heart: for backpackers