Web 版 AI 旅行规划师

基于 React + Node.js + 阿里云百炼的智能旅行规划系统，提供 AI 生成行程、地图可视化等功能。

🎯 助教快速运行指南

最简单的运行方式（推荐）：

# 仅需两条命令（需要安装 Docker）
docker pull crpi-dx5a494scg4cqf6f.cn-hangzhou.personal.cr.aliyuncs.com/travel-planne/travel-planner:latest
docker run -d -p 3000:3000 crpi-dx5a494scg4cqf6f.cn-hangzhou.personal.cr.aliyuncs.com/travel-planne/travel-planner:latest

# 浏览器访问 http://localhost:3000

说明：

• ✅ 无需克隆代码
• ✅ 无需安装 Node.js
• ✅ API Keys 已内置（高德地图 + 阿里云百炼，有效期至 2026-02-11）
• ✅ 30秒内启动完成

---

功能特点

• 🤖 AI 规划：集成阿里云百炼大模型，生成个性化旅行建议
• 🗺️ 地图可视化：集成高德地图，展示行程路线和景点信息
• 🗺️ 地图可视化：基于高德地图展示行程路线
• 👤 用户系统：支持注册、登录、保存行程
• 🔄 实时同步：云端存储，多设备访问
• 📱 响应式设计：支持桌面端和移动端

技术栈

• 前端：React + Vite
• 后端：Node + Express
• 认证/存储：Supabase
• 语音识别：Web Speech API + 科大讯飞（后备）
• 地图服务：高德地图
• 大语言模型：通义千问3 Max

快速开始

1. 环境要求

• Node.js 18+
• npm 或 yarn
• Docker（可选，用于容器化部署）

2. 安装依赖

# 后端依赖
cd backend
npm install

# 前端依赖
cd frontend
npm install

Docker 快速启动（推荐）

# 拉取最新镜像
docker pull crpi-dx5a494scg4cqf6f.cn-hangzhou.personal.cr.aliyuncs.com/travel-planne/travel-planner:latest

# 运行容器
docker run -d \
  -p 3000:3000 \
  --name travel-planner \
  crpi-dx5a494scg4cqf6f.cn-hangzhou.personal.cr.aliyuncs.com/travel-planne/travel-planner:latest

# 查看容器状态
docker ps

# 查看日志
docker logs travel-planner

# 停止容器
docker stop travel-planner

# 访问应用
# 浏览器打开 http://localhost:3000

镜像信息：

• 公网地址：crpi-dx5a494scg4cqf6f.cn-hangzhou.personal.cr.aliyuncs.com/travel-planne/travel-planner
• 专有网络：crpi-dx5a494scg4cqf6f-vpc.cn-hangzhou.personal.cr.aliyuncs.com/travel-planne/travel-planner
• 镜像大小：约 200MB
• 自动构建：每次推送到 main 分支自动构建并推送最新镜像

环境变量配置

项目使用以下 API Key：

# 高德地图 API Key (有效期至 2026-02-11)
QIANWEN_API_KEY=your-qianwen-api-key
SUPABASE_URL=https://your-project-ref.supabase.co
SUPABASE_ANON_KEY=your-supabase-anon-key
SUPABASE_SERVICE_KEY=your-supabase-service-role-key
AMAP_API_KEY=your-amap-api-key
XUNFEI_APP_ID=your-xunfei-app-id
XUNFEI_API_KEY=your-xunfei-api-key

# 阿里云百炼 API Key (有效期至 2026-02-11)
VITE_SUPABASE_URL=https://your-project-ref.supabase.co
VITE_SUPABASE_ANON_KEY=your-supabase-anon-key
VITE_AMAP_KEY=your-amap-api-key
VITE_API_BASE=http://localhost:3000

方式二：从源码运行（需要 Node.js 18+）

# 1. 克隆仓库
git clone https://github.com/ProfessorZhi/travel-planner.git
cd travel-planner

# 2. 安装依赖
cd backend && npm install
cd ../frontend && npm install

# 3. 启动后端 (http://localhost:4000)
cd backend && npm start &

# 4. 启动前端 (http://localhost:3000)
cd ../frontend && npm run dev

5. Docker 部署

# 构建并启动所有服务
docker-compose up --build

# 仅重新构建某个服务
docker-compose up --build backend

项目结构

.
├── backend/                # 后端源码
│   ├── utils/             # 工具函数
│   │   └── qianwen.js     # 通义千问 API 调用
│   ├── index.js           # 主入口
│   └── Dockerfile         # 后端容器配置
├── frontend/              # 前端源码
│   ├── src/              
│   │   ├── components/    # React 组件
│   │   └── utils/        # 前端工具
│   └── Dockerfile        # 前端容器配置
└── docker-compose.yml    # 容器编排配置

API 文档

主要接口

1. 行程规划

POST /api/plan
Content-Type: application/json

{
  "input": "我想去日本，预算1万元，喜欢美食和动漫文化，5天行程"
}

2. 用户认证

POST /api/auth/register
POST /api/auth/login
GET /api/plans  # 获取已保存的行程

Supabase 数据库初始化

1. 创建 travel_plans 表：

create table public.travel_plans (
    id uuid default uuid_generate_v4() primary key,
    user_id uuid references auth.users,
    input text,
    plan jsonb,
    created_at timestamp with time zone default timezone('utc'::text, now())
);

-- 设置 RLS 策略
alter table public.travel_plans enable row level security;

create policy "Users can read their own plans"
    on public.travel_plans for select
    using ( auth.uid() = user_id );

create policy "Users can insert their own plans"
    on public.travel_plans for insert
    with check ( auth.uid() = user_id );

CI/CD 配置

GitHub Actions 配置

在仓库的 Settings -> Secrets 中添加以下变量：

• ALIYUN_REGISTRY: 阿里云容器镜像服务地址
• ALIYUN_USERNAME: 阿里云账号
• ALIYUN_PASSWORD: 阿里云访问密钥

阿里云容器服务配置

1. 创建命名空间（可选）
2. 创建镜像仓库
3. 获取访问凭证

评分要求与提交

1. 创建 PDF 文档，包含：

   • GitHub 仓库地址
   • 运行说明（本文档）
   • API 密钥配置指南

2. 在 README 中说明：

   • 项目功能演示视频/截图
   • 开发过程记录
   • 遇到的问题与解决方案

3. 确保所有 API Key 已从代码中移除，改为通过环境变量注入

开发团队

（项目信息）

许可证

MIT