Medusa Eats 使用与启动教程
1. 项目介绍
Medusa Eats 是一个基于 Medusa 2.0 和 Next.js 14 构建的全栈食品配送平台,灵感来自于 Uber Eats。该项目提供了一个完整的解决方案,包括餐厅店面、实时订单状态看板、司机和餐厅管理面板等功能。
2. 项目快速启动
安装依赖
首先,您需要在项目的两个主要目录中分别安装依赖。
在 /frontend 目录下运行:
yarn
在 /backend 目录下运行:
yarn
设置环境变量
项目提供了 .env.template 文件来帮助快速设置环境变量。您需要将这些模板文件复制为 .env 文件。
在 /frontend 目录下运行:
cp .env.template .env
在 /backend 目录下运行:
cp .env.template .env
设置和初始化数据库
创建一个名为 medusa-eats 的 PostgreSQL 数据库。然后,在 /backend 目录下运行以下命令来初始化数据库:
yarn setup-db
这将创建数据库,运行迁移并填充一些示例数据。同时,它还会创建一个具有以下凭据的管理员用户:
- 邮箱:admin@email.com
- 密码:supersecret
启动开发环境
确保本地 Redis 和 PostgreSQL 服务器正在运行。
在 /backend 目录下启动 Medusa 开发服务器:
yarn dev
Medusa 服务器将运行在 http://localhost:9000。
在另一个终端中,切换到 /frontend 目录并启动 Next.js 开发服务器:
yarn dev
Next.js 前端将在 http://localhost:3000 上运行。
3. 应用案例和最佳实践
创建用户账户
- 创建餐厅管理员账户:访问
http://localhost:3000/signup,选择 "我是餐厅",为您的餐厅创建管理员账户。 - 创建司机账户:重复上述步骤,但选择 "我是司机"。
下单和处理配送
- 使用隐身窗口或第二个浏览器,分别以餐厅管理员和司机的身份登录。
- 在餐厅 storefront (
http://localhost:3000/) 上选择餐厅,添加菜单项到您的订单中。 - 完成结账流程,实时订单状态看板将显示。
- 登录为餐厅管理员,接受订单。
- 登录为司机,接单并处理配送。
4. 典型生态项目
Medusa Eats 是 Medusa 生态系统中的一个项目,典型的生态项目还包括:
- Medusa Core:Medusa 的核心库,提供电子商务功能。
- Medusa Admin:用于管理商店后台的界面。
- Medusa CLI:命令行工具,用于初始化和扩展 Medusa 项目。
以上是 Medusa Eats 的基本使用和启动教程。希望对您有所帮助!
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



