旅游-西北游

# 西北迹（甘肃旅行APP）项目说明
## 1、立项背景和目标
当下西北甘肃旅游热度持续上涨，很多游客对当地小众景点不熟悉，做旅行攻略耗时费力，容易踩坑，缺少能够快速生成个性化旅行方案的工具。本项目目标是打造面向甘肃出行的旅行软件“西北迹”，借助AI能力帮助用户快速生成旅行规划，整合小众景点资源，提供路线、预算、避坑指引，降低用户做攻略的成本，让用户可以便捷获取可靠的甘肃旅行方案。

## 2、软件功能、核心功能模块的介绍
软件主要分为首页、藏宝图、我的三大底部导航模块。
1. **首页模块**：核心为AI旅行方案生成功能，用户可以一键生成专属甘肃旅行方案；同时展示AI避坑雷达，提供旅行避坑提示，展示宝藏景点精选卡片。
2. **藏宝图模块**：包含甘肃藏宝图与达人路线，藏宝图汇集54个小众打卡点位，展示景点评分、实拍出片数据；达人路线提供经过实际验证可行的旅行路线，供用户参考选用。
3. **我的模块**：用于管理用户个人信息、保存已生成的旅行方案、收藏喜欢的景点与路线。

## 3、业务流程、功能路径描述
用户打开APP首先进入首页，可直接点击“生成我的甘肃旅行方案”按钮，由AI快速生成完整旅行规划。用户也可以浏览首页的藏宝图精选景点卡片，查看永泰古城、山丹军马场等景点详情；点击底部导航切换到藏宝图页面，浏览全部小众打卡点和达人实测路线。遇到旅行疑问可以使用AI避坑雷达获取出行提醒。用户看到心仪景点、路线可以进行收藏，收藏内容以及历史生成的旅行方案，统一在“我的”页面查看管理，完成整套旅行规划的使用流程。

# 技术实现与个人开发总结
## 1、整体架构和设计思路，不同模块使用的技术栈
本项目西北迹是一款旅行类移动端应用，采用前后端分离架构，整体按照模块化思想进行开发，将应用拆分为首页、藏宝图、个人中心、AI服务四大业务模块，模块之间低耦合，便于后续迭代维护。
前端使用uni‑app进行移动端页面开发，完成页面布局、底部导航、景点卡片、列表渲染等UI交互；通过Vue组件化封装景点卡片、弹窗等公共组件，提升复用率。后端采用SpringBoot，提供景点数据、达人路线、用户收藏等接口；AI旅行方案生成模块对接大模型API，接收用户参数，输出旅行规划结果；数据库使用MySQL存储景点信息、用户收藏、历史生成方案数据。AI避坑雷达模块通过调用AI接口完成问答交互。

## 2、“我”的负责模块和结果（尽可能量化）
我主要负责**首页模块与藏宝图模块前端开发**，完成首页banner、AI生成按钮、景点轮播卡片、底部导航栏全部页面实现；完成藏宝图页面的小众景点列表、达人路线列表渲染。封装6个可复用业务组件，对接8个后端业务接口，实现景点展示、路线浏览、景点收藏交互功能。页面加载速度优化至1.2秒以内，完成54个小众景点数据的页面适配，页面UI还原度95%，模块功能全部通过测试，无严重bug，可正常完成景点浏览查看等业务操作。

## 3、“我”遇到的难点、坑，和解决方案
开发中遇到的第一个难点：首页景点卡片横向轮播滑动卡顿，大量景点数据渲染出现页面掉帧。解决方案：使用虚拟列表，只渲染可视区域内卡片，减少DOM节点数量，优化滑动性能。
第二个问题：收藏状态同步问题，在藏宝图点击收藏后，首页对应景点卡片状态不会实时更新。解决方案，引入全局状态管理，收藏操作完成后更新全局收藏标识，页面监听状态变化自动刷新UI，解决多页面数据不同步问题。
第三个坑：AI生成方案按钮频繁点击，会重复多次请求接口。解决方案：增加按钮防抖处理，请求期间置灰按钮，防止短时间重复调用接口，减轻服务器压力。