面向文旅小镇的游客动线分析与智慧导览服务平台

项目概述

本系统是面向文旅小镇场景设计的智慧导览与动线分析平台，以河南省焦作市山阳古城文旅小镇为应用背景，集游客端智慧导览、管理端数据运营、动线数据采集与分析于一体。系统采用前后端分离架构，提供景点地图导览、路线规划、访问行为分析等核心功能，助力文旅小镇实现数字化转型。

快速启动

环境要求

• JDK 17+
• Node.js 18+
• MySQL 8.x
• Maven 3.8+

1. 初始化数据库

▼
sql
复制代码
-- 执行初始化脚本（含建表、示例数据）
source tg-backend/src/main/resources/db/init.sql

初始管理员账号：

• 用户名：admin
• 密码：admin123

2. 启动后端

▼
bash
复制代码
cd tg-backend
mvn spring-boot:run
# 或在 IDEA 中直接运行 TownGuideApplication.java

后端服务启动于 http://localhost:8080

3. 启动游客端

▼
bash
复制代码
cd tg-frontend
npm install
npm run dev

游客端访问地址：http://localhost:3000

4. 启动管理后台

▼
bash
复制代码
cd tg-admin
npm install
npm run dev

管理后台访问地址：http://localhost:3001

示例数据说明

系统内置河南省焦作市山阳古城文旅小镇示例数据：

• 5 个分类：景点、餐饮、住宿、购物、服务
• 23 个 POI：涵盖山阳古城主街、韩愈文化广场、太极拳祖祠、嘉应观、云台山观景台等焦作代表性景点及餐饮、住宿、服务设施
• 3 条推荐路线：经典半日游、太极文化深度游、怀药美食休闲游
• 5 条公告：节假日通知、平台上线公告、活动预告等
• 60 条访问日志：覆盖近 30 天的模拟动线数据，用于图表展示

POI 坐标基于焦作市中心区域（经度 113.24xx，纬度 35.21xx），地图默认中心点设置为焦作市区（35.2160, 113.2420）。

动线数据分析

系统通过 visit_log 表采集游客访问行为数据，分析维度包括：

• 近30天访问趋势：按日统计访问量，折线图展示
• 热门POI TOP10：按访问次数排行，横向柱状图展示
• 24小时访问分布：识别客流高峰时段
• 热力图：基于 POI 坐标与访问频次生成热力分布

动线数据采集触发点：游客打开景点详情页时，前端自动调用 /api/visit/log 接口记录访问行为（POI ID + Session ID + 时间戳）。

注意事项

1. 首次运行：确保 MySQL 已启动并执行 init.sql 初始化脚本
2. 端口占用：后端 8080、游客端 3000、管理后台 3001，请确保端口未被占用
3. 图片上传：后端首次运行后会在工作目录自动创建 uploads/ 文件夹
4. 地图底图：游客端地图使用高德地图瓦片服务，需要保持网络连接
5. 跨域配置：前端开发环境通过 Vite 代理转发 /api 请求到后端，生产部署需配置 Nginx 反向代理

项目背景

本项目为毕业设计课题：面向文旅小镇的游客动线分析与智慧导览服务平台

• 应用场景：河南省焦作市山阳古城文旅小镇
• 核心价值：
  • 为游客提供个性化路线规划、景点导览、公告资讯等全方位服务
  • 为运营方提供游客动线数据分析，支撑景区客流管理与资源配置决策
• 创新点：
  • 多源数据融合分析（访问日志 + POI 坐标）
  • Session 级动线追踪，识别游客游览路径规律
  • 前后端分离 + GIS 服务层四级架构设计