# 旅游数据

**Repository Path**: Marthkoper/tourism-data

## Basic Information

- **Project Name**: 旅游数据
- **Description**: 获取实时机票、酒店、景点、行程数据。可以很好的向旅行社、跨国旅行等商家获取第一时间的数据。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-07-10
- **Last Updated**: 2025-10-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 旅游数据采集与管理系统

前端界面预览：[前端代码](https://gitee.com/Martinkeep/flightstrip-frontend)

## 项目简介
这是一个综合性的旅游数据采集与管理系统，主要功能包括：
- 航班信息搜索与监控
- 酒店信息查询
- 景点数据采集
- 系统配置管理
- 数据导出功能
- 邮件通知服务

系统采用微服务架构，包含多个独立的服务模块，可实现航班数据、酒店数据和景点数据的采集、存储和查询功能。

## 功能模块

### 航班搜索服务 (flight-search)
- 实时航班信息查询（单程/往返）
- 数据导出功能（Excel格式）
- 定时任务调度
- 邮件通知功能
- 与携程API对接获取航班数据

### 酒店搜索服务 (hotel-search)
- 城市信息管理
- 酒店信息查询
- 景点信息管理
- 数据导出功能

### 景点搜索服务 (scene-search)
- 景点数据同步与查询
- 过滤条件管理
- 与携程API对接获取景点数据

### 系统服务 (system-search)
- API配置管理
- 邮件配置管理
- 导出配置管理
- 系统状态监控

## 技术架构
本项目采用Spring Cloud微服务架构，主要技术栈包括：
- Spring Boot 2.x
- Spring Cloud Alibaba
- MyBatis Plus
- Feign客户端
- 定时任务调度
- RESTful API设计
- 多模块Maven项目结构

## 使用说明

### 环境要求
- Java 11+
- Maven 3.6+
- MySQL 5.7+
- Redis（可选）

### 安装步骤
1. 克隆项目到本地
2. 创建并配置数据库
3. 修改各模块的application.yml配置文件
4. 使用Maven构建项目
5. 启动各个微服务模块

### API文档
所有接口都使用knife4j进行文档化，启动服务后可通过以下方式访问：
```
http://localhost:7800/doc.html
```

## 配置说明
系统的主要配置通过数据库表进行管理，包括：
- flight_api_config：航班API配置
- hotel_api_config：酒店API配置
- scene_api_config：景点API配置
- export_config：导出功能配置
- email_config：邮件服务配置

## 数据模型
系统涉及的主要数据实体包括：
- 航班信息（单程/往返）
- 酒店信息
- 城市信息
- 景点信息
- 系统配置
- 定时任务
- 执行日志

## 开发者指南
- 所有服务模块都遵循统一的代码规范
- 使用Lombok简化POJO类开发
- 使用Slf4j进行日志记录
- 使用Validation进行参数校验
- 使用统一的ResultVO类封装返回结果

## 许可证
本项目采用Apache License 2.0协议，详情请参见LICENSE文件。