版本 1 - 历史记录 - 技术方案 - AI导游小程序 - 任务管理不周山

1

郑毅洁

# 技术方案

2

3

## 架构

4

5

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

6

7

## 基础设施

8

9

| 类型 | 镜像 | 别名 |

10

|------|------|------|

11

| postgres | postgres:15-alpine | postgres |

12

| redis | redis:7-alpine | redis |

13

14

## 子任务

15

16

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

17

18

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

19

20

分支后缀: `user-auth`

21

22

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

23

24

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

25

26

分支后缀: `ai-chat`

27

28

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

29

30

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

31

32

分支后缀: `map-attractions`

33

34

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

35

36

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

37

38

分支后缀: `trip-planning`

39

40

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

41

42

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

43

44

分支后缀: `attraction-guide`

45

46

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

47

48

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

49

50

分支后缀: `search-recommend`

项目

一般

简介

AI导游小程序

技术方案 » 历史记录 » 版本 1