一、项目背景与意义
乡村文化旅游是推动乡村振兴的重要引擎，承载着传承乡土文化、激活乡村经济、促进城乡融合的多重使命。山西省作为中华文明的重要发祥地之一，拥有丰富多元的乡村文化遗产——从晋商故里的古村大院到黄河岸边的农耕民俗，从太行山麓的非遗技艺到吕梁山间的红色记忆，三晋大地的乡村文化资源底蕴深厚、特色鲜明。然而，受地理条件、信息基础设施和传播渠道等因素制约，山西乡村的文化旅游资源和特色产品长期面临“养在深闺人未识”的困境。传统营销方式以线下推介和口口相传为主，信息触达范围有限，难以将乡村的文化魅力与产品价值有效传递给更广泛的消费群体。
近年来，国家大力推进数字乡村战略，明确将智慧旅游和农村电商作为乡村振兴的重要抓手。在山西省，数字文旅建设已取得显著成效——山西省数字文旅地图已整合全省531处景区、182项非遗项目和300余家星级酒店，上线首日注册用户即突破10万人次，“非遗直播间”带动非遗文创线上销售额突破8000万元。与此同时，长治、晋中等地涌现出以VR全景导览、农产品直播带货为特色的乡村文旅数字化实践，为乡村文旅的数字化转型积累了丰富经验。
在此背景下，本文设计并实现了一个乡村文旅系统，旨在为用户提供便捷的乡村文化旅游与产品购买平台，通过数字化方式推广山西乡村文化与特色产品。系统以“文化展示+旅游导览+产品电商”为核心模式，力求将山西乡村的文化旅游资源进行系统化的线上整合与呈现，为游客提供从“种草”到“出行”再到“购买”的一站式服务。
二、系统技术选型
本系统采用前后端分离的架构模式，前端包含用户端和管理后台两个部分，后端统一基于Spring Boot框架构建RESTful API。
-
用户端：使用Vue2框架，结合Vant移动端组件库构建响应式用户界面，适配手机和电脑屏幕，确保用户在不同设备上均能获得良好的浏览体验。Vant的轻量化特点适合乡村旅游场景下移动端高频访问的需求。
-
管理后台：使用Vue2框架配合Element UI组件库构建后台管理界面，为系统管理员提供清晰、高效的运营管理工具。
-
后端框架：Spring Boot，提供自动配置、内嵌容器、快速构建等能力，作为整个系统的服务端基础，负责业务逻辑处理和数据接口提供。
-
持久层：MyBatis Plus，在MyBatis基础上增强了CRUD操作和分页查询功能，提升数据库访问效率。
-
数据库：MySQL，存储用户信息、乡村文化资源、旅游路线、特色产品、订单、评论反馈等业务数据。
-
缓存：Redis，存储用户会话、热门文旅资源缓存、商品分类数据，降低数据库查询压力，提高接口响应速度。
-
对象存储：阿里云OSS或腾讯云COS，用于存储乡村文化图片、视频、VR全景资源等多媒体文件，通过CDN加速分发。
-
全文检索：Elasticsearch，用于乡村文旅资源（景点、非遗项目、特色产品等）的全文检索，帮助用户快速发现感兴趣的内容。
-
身份认证：使用JWT进行用户身份认证，用户登录后生成Token，后续请求携带Token完成身份验证和权限控制。
技术选型理由如下：
- Spring Boot作为Java企业级开发的主流框架，成熟稳定、生态丰富，能够快速构建高可用的RESTful API服务。
- Vue2轻量灵活，配合Vant组件库可快速构建移动优先的响应式界面，满足游客在旅途中通过手机访问系统的核心场景；Element UI则提供了完善的后台管理组件，适合管理端的快速开发。
- MySQL存储结构化数据，Redis缓存热点数据，两者结合保障了系统在旅游旺季和推广活动期间的用户访问体验。
- Elasticsearch的引入为文旅资源的检索提供了高效、精准的搜索能力，是内容型旅游平台提升用户体验的关键技术支撑。
三、系统功能模块设计
系统从用户角色维度划分为普通用户端和管理员端两大模块，各端功能紧密围绕乡村文化旅游与产品推广设计。
（一）用户端功能
用户端面向所有游客和文化爱好者，提供乡村文旅资源发现、旅游规划、特色产品购买和个人管理服务：
注册与登录：用户通过手机号或邮箱注册账号，登录后即可浏览乡村文旅内容、规划旅游行程、购买特色产品。
首页与推荐：用户进入系统首页，可查看系统推荐的山西乡村文旅目的地、热门非遗项目、特色产品等。首页采用瀑布流或卡片式布局展示文旅资源精华，吸引用户深入探索。
乡村文旅资源浏览：系统按地域（如晋北、晋中、晋南、晋东南）和类型（古村落、非遗技艺、民俗节庆、自然风光、红色文化等）对山西乡村文旅资源进行分类组织。每个资源的详情页包括文化背景介绍、历史渊源、特色看点、地理位置、交通指南、周边配套等信息。资源展示采用图文、视频等多模态方式，部分重点景区可接入VR全景功能，让用户“足不出户逛乡村”。
非遗文化展示：系统专门设置非遗文化板块，展示山西乡村的各级非物质文化遗产项目（如剪纸、面塑、晋绣、木版年画、锣鼓杂戏等），包括项目概述、传承人信息、技艺特色、代表作品等。非遗项目与特色产品相关联，用户浏览非遗文化后可直接跳转至相关文创产品的购买页面。
旅游路线规划：系统提供乡村主题旅游路线的推荐与定制功能。用户可根据兴趣（如“古村落探访”“非遗体验之旅”“红色乡村行”等）和出行天数选择推荐路线，查看详细的行程安排、景点串联、食宿推荐等信息。用户也可自行组合感兴趣的乡村目的地，生成个性化路线。
特色产品商城：用户可以在系统的“乡村好物”板块浏览和购买山西乡村特色产品（如小米、核桃、红枣、醋、杂粮、非遗手工艺品、文创衍生品等）。商品支持按分类、产地、价格等维度筛选，每个商品详情页展示产品介绍、产地故事、价格、库存和用户评价。通过“旅游+电商”模式，实现从“游玩体验”到“消费转化”的闭环。
订单管理：用户可以在个人中心查看所有订单状态（待付款、待发货、待收货、已完成、已取消），支持取消订单、确认收货等操作。
评论与分享：用户可对乡村文旅资源和特色产品进行评价和评分，并可将感兴趣的内容分享至微信、微博等社交平台，扩大乡村文旅资源的传播范围。
个人中心：用户可以修改个人信息、管理收货地址、查看浏览历史和收藏记录。
（二）管理员端功能
管理员端负责系统的日常运营与内容维护，主要功能包括：
用户管理：管理员查看和管理注册用户信息，进行账号状态管理和权限分配。
文旅资源管理：管理员负责乡村文旅资源的录入、编辑与下架，维护每个资源的名称、分类、文化背景介绍、多模态资料（图片、视频、VR全景）、地理位置、推荐指数等信息。资源发布前需进行内容审核，确保信息的准确性和文化表述的规范性。
非遗项目管理：管理员维护非遗项目的信息，包括项目名称、所属地区、级别（国家级/省级/市级）、传承人、技艺特色、代表作品图片等。
旅游路线管理：管理员设计和管理推荐旅游路线，包括路线名称、主题分类、行程天数、路线介绍、每日行程安排、推荐食宿、预估费用等。
商品管理：管理员管理特色产品商城的商品信息，包括商品的添加、编辑、上下架、库存管理、价格设置、与非遗项目的关联等。商品上架需关联产地故事或文化背景，增强产品的文化附加值。
订单管理：管理员查看和处理所有交易订单，处理售后问题和退款申请。
公告管理：管理员发布系统公告、文旅活动通知、促销信息等，用户端在首页或公告栏查看。
数据统计：系统自动统计文旅资源浏览量、商品销量、订单金额、用户活跃度等核心数据，通过ECharts可视化图表展示平台运营状况，为运营决策提供数据支持。
四、核心功能实现
（一）乡村文旅资源数字化展示
乡村文旅资源的数字化展示是系统的核心功能，其实现在于将山西乡村丰富的文化内容进行系统化、结构化的线上呈现：
多级分类体系：系统按地理区域和资源类型两个维度构建分类体系。地理维度涵盖山西省11个地级市的乡村文旅资源；类型维度包括古村落、非遗技艺、民俗节庆、自然风光、红色文化、特色美食等，用户可按任一维度检索。
多模态内容组织：每个文旅资源详情页包含文化背景文字描述、高清图片集、短视频介绍，部分重点资源可接入VR全景展示。图片和视频资源存储于OSS对象存储服务中，通过CDN加速分发，保障用户在不同网络环境下的流畅体验。
结构化信息层级：参照学术研究中对乡村智慧旅游系统的设计规范，资源的呈现遵循从“概况”到“文化内涵”再到“实用信息”的信息层级，帮助用户由浅入深地了解乡村文旅资源。
（二）旅游路线规划功能实现
旅游路线规划帮助用户将分散的文旅资源串联成完整的旅行计划，其实现流程如下：
路线模板管理：管理员在后台设计主题旅游路线，每个路线模板包含行程天数、每日安排的景点/活动、推荐住宿与餐饮、行程亮点说明等。路线模板发布后供用户参考和收藏。
用户个性化定制：用户可在系统推荐的路线基础上进行个性化调整——增减目的地、调整顺序、更换住宿选项等。调整后的路线可保存至个人中心，方便出行时随时查看。
路线展示优化：路线详情页以时间线形式展示每日行程，搭配地图示意（可集成高德或百度地图API展示景点位置和路线串联），帮助用户直观理解行程安排。
（三）特色产品电商模块实现
特色产品商城是实现“以文促旅、以旅带商”闭环的关键环节：
商品发布与管理：管理员在后台录入山西乡村特色产品信息，包括商品名称、所属产地/非遗项目、商品描述、文化故事、价格、库存、主图和详情图等。商品与文旅资源或非遗项目建立关联关系——用户在浏览古村落或非遗文化时，可直接跳转至关联的特色产品页面，实现“文化种草—商业转化”的无缝衔接。
购物车与下单：用户将商品加入购物车后统一提交订单。系统校验库存、计算总价，生成订单记录（待付款、待发货、待收货、已完成、已取消）。
在线支付：系统对接微信支付接口，用户下单后完成在线支付。支付成功后订单进入待发货状态，管理员收到通知并安排发货。
物流跟踪：用户可在订单详情页查看物流状态，交易完成后可对商品进行评价。
（四）全文检索实现
为帮助用户在丰富的乡村文旅资源和特色产品中快速定位感兴趣的内容，系统基于Elasticsearch构建统一检索引擎：
索引设计：在Elasticsearch中分别为文旅资源、非遗项目、特色产品创建索引，映射字段包括名称（text类型，ik分词器）、文化背景/描述（text类型）、地域（keyword类型）、分类（keyword类型）等。
数据同步：文旅资源、非遗项目、特色产品发布和更新时，后端同步将数据写入ES索引。系统初始化时提供全量同步脚本。
搜索接口：用户输入关键词后，后端构建ES查询语句，对多个字段进行multi-match查询，并按相关性得分排序返回结果，同时支持分类筛选和按热度/时间排序。
（五）权限控制体系
系统区分普通用户和管理员两种角色，权限控制基于JWT实现：
- 用户登录后，后端生成包含用户角色（ROLE_USER或ROLE_ADMIN）的JWT Token。
- 前端每次请求在HTTP Header中携带Token，后端拦截器解析Token并验证身份和权限。
- 普通用户只能访问用户端接口，进行文旅资源浏览、路线规划、商品购买等操作；管理员才能访问管理端接口，执行内容管理、订单处理、数据统计等操作。
- 所有敏感操作（商品上下架、订单状态变更、文旅资源发布等）均记录操作日志，便于安全审计。
五、系统亮点与创新
专注山西乡村文旅的特色定位：系统聚焦山西省乡村文化旅游资源的数字化推广与特色产品电商，区别于泛化的旅游平台，以山西乡村丰富的古村落、非遗技艺、民俗文化和特色农产品为核心内容，形成了鲜明的地域文化特色和差异化竞争优势。
“文化展示+旅游导览+产品电商”一体化模式：系统将乡村文化的深度展示、旅游路线的便捷规划和特色产品的在线购买有机融合。用户在了解文化内涵的过程中完成从“种草”到“出行”再到“消费”的完整闭环，既满足了游客的文旅信息需求，也为乡村经济发展注入了数字化动力。
多维度、沉浸式的文化体验：系统通过图文、视频、VR全景等多模态方式呈现乡村文旅资源，结构化的信息层级设计让用户循序渐进地了解乡村文化的全貌，提升了文化传播的深度和感染力。
数据驱动助力乡村产业：系统积累的浏览数据、搜索数据和交易数据，通过管理端的统计看板转化为可视化报告，为乡村文旅资源的推广策略和特色产品的选品运营提供数据支撑，实现从经验驱动向数据驱动的运营升级。
六、总结
本文设计并实现了一个乡村文旅系统，以Spring Boot和Vue2为技术基础，采用前后端分离架构，聚焦山西省乡村文化旅游资源的数字化推广与特色产品交易。系统覆盖了文旅资源展示、非遗文化传播、旅游路线规划、特色产品商城、用户互动与订单管理等核心功能模块，构建了“文化展示+旅游导览+产品电商”一体化的服务平台。
通过该系统的应用，山西乡村丰富的文旅资源得以突破地域和传播渠道的限制，以数字化的方式触达更广泛的受众；乡村特色产品获得了线上销售渠道，实现了文化与经济的双重价值转化；游客获得了从信息获取到行程规划再到产品购买的便捷体验。系统的设计与实施为山西省乡村文旅产业的数字化转型提供了切实可行的技术方案，也为“数字乡村”战略在文旅领域的落地实践贡献了有益探索。未来，系统可进一步引入AI智能推荐（根据用户兴趣推荐文旅目的地和旅游路线）、乡村文旅数据可视化大屏、AR实景导览、乡村民宿预订与评价体系等功能，持续提升平台的智能化水平和服务能力，为山西乡村文旅产业的高质量发展贡献更多技术力量。
