Travel Itinerary Management System

旅行行程管理系统

一个用于管理泰国目的地旅行行程的全栈应用，采用 FastAPI 后端和 Next.js 前端。

项目结构

``` travel-itinerary-system/ ├── backend/ # Python FastAPI 后端 ├── frontend/ # Next.js 前端 └── README.md # 项目文档 ```

后端设置

后端基于 FastAPI、SQLAlchemy 和 SQLite 构建。

前置条件

• Python 3.8+
• pip

安装

1. 进入后端目录： ```bash cd backend ```

2. 创建虚拟环境： ```bash python -m venv venv ```

3. 激活虚拟环境：

   • Windows：venv\Scripts\activate
   • macOS/Linux：source venv/bin/activate

4. 安装依赖： ```bash pip install fastapi uvicorn sqlalchemy pydantic ```

运行后端

1. 使用运行脚本启动应用： ```bash python run.py ```

此操作将：

• 使用示例数据初始化数据库
• 在 http://localhost:8000 启动主 API 服务
• 在 http://localhost:8001 启动推荐服务

API 文档可在 http://localhost:8000/docs 查看。

前端设置

前端基于 Next.js、React 和 Tailwind CSS 构建。

前置条件

• Node.js 16+
• npm 或 yarn

安装

1. 进入前端目录： ```bash cd frontend ```

2. 安装依赖： ```bash npm install

   或

   yarn install ```

运行前端

1. 启动开发服务器： ```bash npm run dev

   或

   yarn dev ```

2. 打开浏览器并访问 http://localhost:3000

使用应用

1. 浏览行程：在行程页面查看所有可用的旅行行程
2. 查看详情：点击某个行程以查看其详细信息
3. 获取推荐：使用推荐页面，根据偏好的旅行时长获取行程推荐
4. 创建行程：使用多步骤表单创建自定义行程

API 端点

• GET /api/itineraries - 获取所有行程
• GET /api/itineraries/{id} - 获取指定行程
• POST /api/itineraries - 创建新行程
• GET /api/recommendations/{nights} - 获取指定时长的推荐行程

数据库架构

应用使用以下数据库模型：

• 行程
• 住宿
• 接送
• 活动

详细信息请参阅前端中的 Schema 页面。