技术方案¶

架构¶

前端 React SPA (Vite) + 后端 Go REST API + PostgreSQL + 高德地图API + AI对话服务

基础设施¶

子任务¶

1. 用户认证与个人信息模块¶

实现微信小程序登录授权、用户注册登录、个人信息管理功能。包括：JWT token认证机制、用户基本信息存储、登录状态持久化、个人中心页面（头像昵称修改、历史记录查看）。后端提供用户注册、登录、信息更新API；前端实现登录页面和个人中心页面。

分支后缀: user-auth

2. AI智能导游对话模块¶

实现AI导游核心对话功能。后端集成AI对话API（如OpenAI或国产大模型），实现景点智能问答、行程推荐、历史文化讲解等功能；支持多轮对话上下文管理，对话历史存储在PostgreSQL中。前端实现聊天界面，包含消息列表、输入框、语音输入按钮（可选），支持流式输出显示。UI要求：对话气泡样式清晰，AI回复与用户消息有明显区分，支持Markdown渲染。

分支后缀: ai-chat

3. 地图导航与景点展示模块¶

集成高德地图API，实现景点位置展示、周边搜索、路线规划功能。后端存储景点数据（名称、坐标、描述、图片等），提供景点列表、景点详情、周边推荐API；前端实现地图主页面，包含地图组件、景点标记点、景点列表抽屉、点击标记显示景点详情卡片。UI要求：地图占据主视觉区域，底部浮动景点推荐卡片，右上角搜索按钮。

分支后缀: map-attractions

4. 行程规划与管理模块¶

实现用户行程创建、编辑、管理功能。用户可基于AI推荐或手动选择创建旅行行程，支持多日行程、拖拽排序景点、设置游览时间。后端提供行程CRUD API，行程数据存储在PostgreSQL；前端实现行程编辑页面、行程详情页面、行程日历视图。UI要求：时间轴形式展示行程，支持左右滑动切换日期，景点卡片可拖拽排序。

分支后缀: trip-planning

5. 景点百科与语音导览模块¶

实现景点详细介绍页面和语音讲解功能。后端存储景点百科内容（文字介绍、图片集、音频导览文件），提供景点详情API；前端实现景点详情页，包含图片轮播、详细介绍、语音播放器（支持后台播放）、相关景点推荐。UI要求：沉浸式大图头部，内容区域支持富文本展示，语音播放器固定在底部，支持播放/暂停/进度拖动。

分支后缀: attraction-guide

6. 智能推荐与搜索模块¶

实现景点搜索和个性化推荐功能。后端实现全文搜索（基于PostgreSQL FTS或简单LIKE），根据用户历史偏好、当前位置、热门程度进行景点推荐；提供搜索API、热门推荐API、个性化推荐API。前端实现搜索页面（搜索框+历史搜索+热门搜索）、搜索结果页、首页推荐模块。UI要求：搜索框支持实时搜索建议，推荐卡片采用瀑布流或轮播形式展示。

分支后缀: search-recommend