从0到1搭建智慧旅游平台:一套后端跑通游前、游中、游后
信息说明: 本文为晓创智游文旅平台项目说明,端口、账号与依赖版本以项目 README 与代码仓库最新配置为准。
核心提醒: 演示账号与支付流程仅用于本地学习,正式部署前请替换数据库口令、接入真实支付与登录鉴权。
本文结构
① 01 项目背景:从观光打卡到深度体验 ② 02 核心功能:一条链路,多端一致 ③ 03 项目结构:多端清晰分层 ④ 04 使用技术:前后端统一选型 ⑤ 05 运行环境 ⑥ 06 账号说明 ⑦ 07 待完善功能
一个面向城市文旅场景的一体化平台,覆盖游客端「游前种草、游中消费、游后分享」的完整链路,并提供后台运营管理能力。项目采用「一套后端 + 多端前台」架构:H5、PC 网站、Flutter App、微信小程序四类游客端共用同一套 Spring Boot API,另有独立的运营管理后台。
一 · 01 项目背景:从观光打卡到深度体验
随着文旅消费从「观光打卡」转向「深度体验」,游客在出行前需要高效发现目的地、规划行程,在旅途中需要便捷预订门票、住宿、美食和停车,在结束后又希望记录足迹、分享攻略。传统的文旅产品往往把内容、交易和社区割裂开,运营方也难以统一管理各渠道的内容与订单。
晓创智游把首页推荐、发现种草、社区互动、行程规划、在线预订、即时客服和后台运营整合到同一体系中,让游客获得连贯体验,让运营方实现统一管理。
二 · 02 核心功能:一条链路,多端一致
游客端能力
•首页:城市切换、首页聚合推荐(轮播、景区、门票、非遗、社区内容等)
•发现:内容 Feed 流、发现详情
•社区:广场、找搭子、关注动态,支持发帖、帖子详情与评论
•行程:行程列表、发布行程、足迹打卡
•分类浏览:景区票务、自驾路线、美宿、美食、停车场
•详情与预订:景区详情、非遗体验详情,支持下单
•订单:订单确认、支付、结果页、订单列表
•消息与客服:站内消息、消息详情、基于 WebSocket 的即时聊天客服
•个人中心:登录、预约、收藏、足迹、票夹、钱包、导览地图、出发清单、意见反馈、设置
游客端界面

首页

首页开屏

发现 Feed

发现推荐

社区广场

社区找搭子

帖子详情

景区票务

景点列表

景点详情

自驾路线

美宿列表

风味美食

美食列表

智慧停车

导览地图

我的行程

订单确认
管理端能力
•登录鉴权(X-Admin-Token)
•数据看板
•内容运营:ContentItem 增删改查,覆盖景点、门票、发现、社区、首页配置等
•城市管理、首页配置
•订单管理(查询 / 改状态)、行程管理、用户与反馈管理
管理端界面

数据看板

内容运营·热门活动

内容运营·社区帖子

订单管理

行程管理
三 · 03 项目结构:多端清晰分层
``text cultural-tourism-sys/ ├── cultural-tourism-server/ # 后端服务(Spring Boot 3 + MySQL + Netty IM) ├── cultural-tourism-h5/ # 移动端 H5(Vite + React + TypeScript) ├── cultural-tourism-web/ # PC 网站(Vite + React + TypeScript) ├── cultural-tourism-web-manager/ # 运营管理后台(Vite + React + Ant Design) ├── cultural-tourism-app/ # 移动端 App(Flutter) ├── cultural-tourism-wechat/ # 微信小程序(原生 + TypeScript) └── screen/ # 界面截图等资源 ``
后端核心目录:
``text cultural-tourism-server/src/main/java/com/xczy/tourism/ ├── controller/ # REST 接口 ├── service/ # 业务逻辑 ├── repository/ # JPA 数据访问 ├── entity/ # 实体 ├── config/ # 配置与种子数据初始化 ├── common/ # 统一响应、异常处理 └── im/ # Netty WebSocket 即时通讯 ``
各前端的业务页面按「首页 / 发现 / 社区 / 行程 / 我的」以及「票务 / 路线 / 美宿 / 美食 / 停车」等分类组织。
四 · 04 使用技术:前后端统一选型
后端:
•Java 21、Spring Boot 3.3.6
•Spring Web、Spring Data JPA、Spring Validation
•MySQL 8(MySQL Connector/J)
•Netty(WebSocket 即时通讯)
•Lombok
前端(H5 / PC):
•Vite 8、React 19、TypeScript
•React Router 7
•Leaflet(地图)、Lucide React(图标)
•oxlint(代码检查)
管理端:在 H5 / PC 技术栈基础上,使用 Ant Design 6 + dayjs。
App:Flutter、Dart 3、go_router、provider、http、shared_preferences、flutter_map、flutter_svg、intl。
微信小程序:原生微信小程序 + TypeScript,自定义 TabBar、组件化开发。
五 · 05 运行环境
数据库初始化:
``sql CREATE DATABASE IF NOT EXISTS cultural_tourism DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ``
应用首次启动会自动建表,并从 classpath:data/mock-data.json 导入演示数据。
后端启动:
``bash cd cultural-tourism-server mvn spring-boot:run ``
前端(H5 / PC / 管理端)启动方式一致:
``bash cd cultural-tourism-h5 # 或 cultural-tourism-web、cultural-tourism-web-manager npm install npm run dev ``
App 启动:
``bash cd cultural-tourism-app flutter pub get flutter run ``
微信小程序使用微信开发者工具导入 cultural-tourism-wechat 目录即可,项目 AppID 为 wxc9ca20bc02079f6d。
六 · 06 账号说明
管理端登录:
游客端演示账号(密码均为 123456):
即时通讯(IM)演示账号:
MySQL 连接账号:
七 · 07 待完善功能
•支付目前为模拟流程,尚未接入微信支付 / 支付宝真实支付
•内容与用户数据以 Mock / 种子数据为主,后续可接入真实内容采编、对象存储和 CDN
•微信小程序为演示 AppID,真实发布前需完成微信登录、手机号授权、定位与支付等能力接入
•Android 端发布签名尚未配置,正式打包前需补全
•IM 当前以私聊客服为主,群聊、消息撤回、离线消息等能力可按需扩展
•管理端权限为单一管理员,多角色、细粒度权限控制可进一步细化
•后端单测 / 前端自动化测试覆盖可继续补充
相关文章
发表评论
评论列表
- 这篇文章还没有收到评论,赶紧来抢沙发吧~