webresto/restoapp

RestoApp

外卖电商后端核心仓库。

https://npmjs.org/package/@webresto/core

为实现与各类服务的集成，我们使用名为https://github.com/webresto/core/tree/staging/adapters%E7%9A%84%E6%8A%BD%E8%B1%A1%E7%B1%BB%E3%80%82

概述

本项目是外卖服务的后端系统，旨在提供快速部署和搭建在线点餐与配送平台的能力。它基于Node.js开发，可通过模块管理器轻松安装和配置模块。

加入我们的社区

加入我们的社区，获取所有对外卖服务感兴趣者的支持。这里是餐厅经营者和开发者协作开发餐厅系统的平台。获取最新资讯，分享创意。期待您的加入！

https://img.shields.io/badge/%E5%8A%A0%E5%85%A5-***-%237289DA?logo=***&style=flat-square]([] https://img.shields.io/badge/%E5%8A%A0%E5%85%A5-***-%232CA5E0?logo=***&style=flat-square]([] https://img.shields.io/badge/%E5%8A%A0%E5%85%A5-***-%2325D366?logo=***&style=flat-square]([***]

核心功能与特性

• 模块化架构：可通过应用商店安装各类模块，扩展平台功能。
• 移动应用支持：支持iOS和Android平台的移动应用，为用户提供便捷的移动端点餐方式。
• 安装向导：部署系统后会显示安装向导，可配置各项参数并快速启动外卖网站。
• Docker简易安装：系统以Docker容器形式提供，无需深入编程知识即可轻松部署和安装。
• 白标解决方案：可将项目用作自有外卖服务的白标解决方案。
• 模块与扩展：可开发自定义模块或通过应用商店购买额外功能和增强组件。
• PRO版本高级功能：付费PRO版本提供扩展功能，包括配送联盟（用于管理一个或多个城市的多个配送点）。
• 区域化营销定制：可为不同地区、城市和区域定制菜单、价格、促销活动和方案。
• ERP、RMS系统集成：通过与任何配送系统集成实现餐厅自动化，网站仅显示最新菜单，自动更新停售菜品。
• 在线支付集成：通过银行API集成在线支付服务。
• 厨房视频流：设置厨房在线视频流，在用户下单后显示营业时间。
• 地图配送定制：将配送地图划分为不同区域，考虑价格、配送时间、距离、天气条件和道路拥堵情况。
• 营销定制功能：创建自定义的奖励、折扣、附加费、 promo码、轮盘和礼品券系统，将社交媒体页面与用户仪表板同步。
• 管理面板：提供管理面板，用于管理和配置平台设置，监督业务运营。
• 可视化编程：利用可视化编程环境拦截前端和后端事件，无需大量编程知识即可修改和实现自定义功能。
• 用户仪表板：在网站上管理所有配送相关信息，包括菜单、订单历史和配送地址。

事件管理器

应用架构设计支持拦截前端和后端事件。这些事件会传递到Node可视化编程环境，可在其中修改事件并向客户端提供必要信息。这支持运行A/B测试、实现自定义功能，无需深入编程知识即可实时修改。

移动应用

移动应用设计为Web应用的封装形式。这确保Web版本和移动应用使用相同代码，简化维护和开发。为网站创建的所有功能也可用于移动应用，且可根据品牌风格定制。

PRO版本购买联系

如需支持或购买PRO版本，请通过***联系我们：

*** @webresto_support

安装指南

系统通过Docker容器安装，仅需15分钟。安装完成后会显示安装向导，可配置参数并启动外卖网站。

Docker

此Docker镜像代表配置好的RestoApp后端项目，适用于Docker容器环境。核心设计是所有模块位于modules文件夹中，在应用启动时作为钩子加载。还需显式指定生产配置。这些均通过相应文件夹传入Docker容器并正常运行。

由于以Sails框架为基础，需显式或间接指定钩子的来源。

快速启动

使用Docker运行应用：

bash
docker run --name restoapp -p 8080:8080 docker.xuanyuan.run/webresto/restoapp:latest

容器启动后，打开浏览器并访问http://localhost:8080%E5%8D%B3%E5%8F%AF%E4%BD%BF%E7%94%A8RestoApp%E5%BA%94%E7%94%A8%E3%80%82

从源码构建

从源码构建Docker镜像：

bash
docker build -t webresto/restoapp:latest .

然后运行容器：

bash
docker run --name restoapp -p 8080:8080 docker.xuanyuan.run/webresto/restoapp:latest

设置说明

目前仅支持通过Docker安装。请查看镜像https://hub.docker.com/repository/docker/webresto/restoapp/general%E3%80%82

使用方法

镜像结构

镜像由监督程序管理，用于重启。早期版本中，监督程序可能内置在容器本身（甚至Sails应用内部）。

初始数据（Seeds）

容器支持从seeds文件夹加载初始数据，该文件夹中包含数据数组的*.json文件。当以process.env.DB_MIGRATE = "drop"或process.env.FORCE_SEED = "TRUE"启动时，会自动启动数据导入流程。

seeds/assets文件夹中的所有内容会复制到.tmp/public并覆盖现有文件。还可在seeds/queue文件中指定JS文件的加载顺序，每行一个文件（无需指定扩展名）。

示例：

group
# 注释
dish

环境变量

环境变量从.env文件加载到容器中（区分大小写）。

构建与运行命令

bash
docker build -t webresto/restoapp:$(git rev-parse --abbrev-ref HEAD) .
docker push webresto/restoapp:$(git rev-parse --abbrev-ref HEAD)

本地构建：

bash
docker build -t webresto/restoapp:$(git rev-parse --abbrev-ref HEAD) . -f Dockerfile.local

ENV_LIST

（暂无描述）

依赖管理

如需在容器启动时安装额外模块，添加/app/dependencies文件，其中包含模块列表，每行一个模块。每行将通过npm install $line_module命令执行安装。

示例：

faker
dummy@1.2.0
# 注释

RestoApp模块

如需在容器启动时安装额外RestoApp模块，添加/app/webresto-modules.list文件，其中包含模块列表，每行一个模块。每行将通过webresto install $line_module命令执行安装。

示例：

payment
webhook
# 注释

环境变量说明

• WR_DISABLE_MODULE_EXIST_CHECK：关闭模块文件夹存在性检查（允许基于文件强制重新安装）

感谢与支持

https://browserstack.com/

许可证

https://opensource.org/licenses/MIT 版权所有 © 2018-2025