# order-sys-be

**Repository Path**: homeleaf/order-sys-be

## Basic Information

- **Project Name**: order-sys-be
- **Description**: 订餐系统-后端（快捷开发版本）
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2018-05-30
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 管理系统

## 创建数据库
```sql
CREATE DATABASE IF NOT EXISTS db_order_system
DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;
```
## 创建数据库表
```bash
composer init-db
```

## 判断数据库是否存在
```sql
SELECT SCHEMA_NAME
FROM INFORMATION_SCHEMA.SCHEMATA
WHERE SCHEMA_NAME = 'db_order_system';
```

## 添加默认平台角色
```sql
INSERT INTO `role` (`id`, `name`, `cn_name`, `manage`, `predefine`) VALUES
(2, 'supervisor', '总管', 1, 0),
(3, 'salesman', '业务员', 1, 0);
```

## 业务域名
* 平台管理端: cwg.gsw945.com     /admin
* 商户/小程序api: cwg.gsw945.com     /api
* 顾客H5端: customer.scaotu.cn
* 微信登录跳转: wechat-redirect.gsw945.com

## 业务实体-中/英文-统一称谓

#### 管理端

* 总管: `supervisor`
* 业务员: `salesman`
* 商户: `merchant`

#### 商户端

* 门店: `store`
* 桌台: `desk`
* 桌台二维码: `desk_qrcode`
* 菜品: `cuisine`
* 食材: `material`
* 服务员: `waiter`
* 收银员: `cashier`

## 业务实体间关系与业务流程

#### 管理端

- `<程序>` 初始化 `[总管]`
- `[总管]` (用户名+密码)登录(PC)-->绑定/解绑/重绑(微信)
- `[总管]` 添加 `[业务员]`
- `[总管]`操作，用户微信扫码，绑定`[业务员]`帐号
- `[业务员]` 添加 `[商户]`
- `[业务员]`操作，用户微信扫码，认领`[商户]`，`<程序>` 生成  `[门店]`，并绑定到`[商户]`
- `[业务员]` 在微信和支付宝管理平台，为用户申请子服务商帐号，并在成功后绑定到`[商户]`


#### 商户端

- 商户桌面软件生成二维码，用户微信扫描，`<程序>`获取用户微信信息，依此查询，`[商户]`(店主)登录成功，进入[`商户]`后台
- `[商户]`(店主)设置`[门店`]信息
- `[商户]`(店主)添加`[服务员]`或`[收银员]`
- `[商户]`(店主)操作，微信用户微信扫码，绑定成为`[服务员]`或`[收银员]`
- `[商户]`(店主)添加`[菜品]`(关联到商户)，设置规格及定价，设置`[食材]`及用量
- `[商户]`(店主)添加`[桌台]`(关联到商户)，绑定`[桌台二维码`]
- - 用户(食客)结帐，出示微信付款码，`[收银员]`扫描用户(食客)付款码，用户端发起支付请求

#### 用户端

- 用户(食客)微信扫描`[桌台二维码`]，进入点菜系统，进行点菜，用户(食客)提交点菜信息，生成`[订单]`
- `[服务员]`确认`[订单]`，打印订单
- `<程序>`创建`[支付订单]`，完成后推送订单消息到用户微信，同步推送支付成功通知到用户端

注: 一个用户可同时绑定成为`[服务员]`或`[收银员]`，但需要多次扫码，一次智能绑定一种角色

## 第三方库/框架-文档-参考

#### 存储
* [Filesystem API](https://flysystem.thephpleague.com/docs/usage/filesystem-api/)
* [flysystem-aws-s3-v3-minio](https://github.com/coraxster/flysystem-aws-s3-v3-minio)

#### Web框架
* [Slim Documentation](https://www.slimframework.com/docs/)
* [Twig Documentation](https://twig.symfony.com/doc/2.x/)

#### 数据库
* [Eloquent ORM](https://laravel-china.org/docs/laravel/5.5/eloquent)
* [数据库：入门](https://laravel-china.org/docs/laravel/5.5/database)
* [查询构造器](https://laravel-china.org/docs/laravel/5.5/queries)
* [数据库迁移](https://laravel-china.org/docs/laravel/5.5/migrations)

#### 杂项
* [Slim Add Ons: Templates](https://www.slimframework.com/docs/v3/features/templates.html)
* [Using Eloquent with Slim](https://www.slimframework.com/docs/v3/cookbook/database-eloquent.html)