# order-snap

**Repository Path**: hyper-yang/OrderSnap

## Basic Information

- **Project Name**: order-snap
- **Description**: 智能点餐项目--通过调用模型语义分析客户咨询的信息，处理点餐需求。
在调用的服务上可以自行更换成你目前现有api或本地工具。
pinepone向量数据库你可以使用qdrant、es代替
amap地图服务你可以使用baidu地图、google地图替代
LLM大模型选用上必须选择支持embedding_model的平台
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-02
- **Last Updated**: 2025-11-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python, langchain, vectorstore, MCP

## README

# Order Snap 智能点餐系统 

## 项目总体说明

这是一个基于 FastAPI构建的餐饮订单点单服务，旨在通过智能助手提供餐饮订单的创建、查询和管理功能。项目集成了多种工具，包括LLM模型对话功能、语义分析功能、向量数据库检索、地图服务等，目标提供全面、智能且舒适的点餐服务。 

## 功能特性

- 🤖 **智能对话**: 与AI助手进行自然语言交流，获取菜品推荐
- 🚚 **配送查询**: 检查指定地址是否在配送范围内
- 🍽️ **菜品展示**: 浏览完整的菜品列表，包含详细信息

## 使用说明

- 你需要至少准备 (对于快速上手建议在环境变量中配置以下api)

  - DASHSCOPE_API_KEY：[大模型服务平台百炼控制台](https://bailian.console.aliyun.com)

  - AMAP_API_KEY: [高德地图api](https://lbs.amap.com/)

  - PINECONE_API_KEY: [ Pinecone Console](https://app.pinecone.io/)

- 你需要安装依赖

  - pip install -r requirement.txt

  - cd ui
    npm i
    npm run dev

### 智能对话

1. 在文本框中输入需求，如"我想吃川菜"
2. 点击"询问"按钮
3. AI助手会分析需求并推荐合适的菜品

### 配送查询

1. 输入配送地址
2. 选择出行方式（骑行/驾车/直线距离）
3. 点击"查询配送范围"
4. 系统会显示是否在配送范围内及距离信息

### 菜品浏览

1. 页面加载时自动获取菜品列表
2. 可点击"刷新菜单"按钮重新加载
3. 每个菜品显示名称、价格、描述、分类、辣度等信息