177 lines
4.7 KiB
Markdown
177 lines
4.7 KiB
Markdown
|
# 门店管理模块
|
||
|
|
|
||
|
|
## 概述
|
||
|
|
|
||
|
|
门店管理模块负责门店信息管理、入驻审核、银行卡上报等。
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 门店管理
|
||
|
|
|
||
|
|
### 接口
|
||
|
|
|
||
|
|
| 方法 | 路径 | 说明 |
|
||
|
|
|------|------|------|
|
||
|
|
| GET | `store/list` | 门店列表 |
|
||
|
|
| GET | `store/detail` | 门店详情 |
|
||
|
|
| POST | `store/create` | 创建门店 |
|
||
|
|
| POST | `store/update` | 更新门店 |
|
||
|
|
| POST | `store/audit` | 审核门店 |
|
||
|
|
| GET | `store/option` | 门店选项 |
|
||
|
|
|
||
|
|
### 关联类
|
||
|
|
|
||
|
|
| 类 | 文件 | 说明 |
|
||
|
|
|----|------|------|
|
||
|
|
| `StoreController` | `app/Http/Controllers/admin/system/StoreController.php` | 控制器 |
|
||
|
|
| `StoreService` | `app/Service/admin/system/StoreService.php` | 业务服务 |
|
||
|
|
|
||
|
|
### 关联模型
|
||
|
|
|
||
|
|
| 模型 | 表名 | 说明 |
|
||
|
|
|------|------|------|
|
||
|
|
| `StoreInputModel` | `xk_store_input` | 门店预填表单 |
|
||
|
|
| `StoreModel` | `yii_store` | 门店表 |
|
||
|
|
|
||
|
|
### 门店类型
|
||
|
|
|
||
|
|
| 类型 | 值 | 说明 |
|
||
|
|
|------|-----|------|
|
||
|
|
| 诊所 | 0 | 中医/西医诊所 |
|
||
|
|
| 药店 | 1 | 药品零售店 |
|
||
|
|
|
||
|
|
### 诊所类型
|
||
|
|
|
||
|
|
| 类型 | 值 | 说明 |
|
||
|
|
|------|-----|------|
|
||
|
|
| 西医 | 1 | 西医诊所 |
|
||
|
|
| 中医 | 2 | 中医诊所 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 门店预填
|
||
|
|
|
||
|
|
### 接口
|
||
|
|
|
||
|
|
| 方法 | 路径 | 说明 |
|
||
|
|
|------|------|------|
|
||
|
|
| GET | `store-input/list` | 预填列表 |
|
||
|
|
| GET | `store-input/detail` | 预填详情 |
|
||
|
|
| POST | `store-input/create` | 创建预填 |
|
||
|
|
| POST | `store-input/update` | 更新预填 |
|
||
|
|
| POST | `store-input/audit` | 审核预填 |
|
||
|
|
| POST | `store-input/upload-contract` | 上传合同 |
|
||
|
|
| POST | `store-input/add-nav` | 添加轮播图 |
|
||
|
|
|
||
|
|
### 关联类
|
||
|
|
|
||
|
|
| 类 | 文件 | 说明 |
|
||
|
|
|----|------|------|
|
||
|
|
| `StoreInputController` | `app/Http/Controllers/admin/system/StoreInputController.php` | 控制器 |
|
||
|
|
| `StoreInputService` | `app/Service/admin/system/StoreInputService.php` | 业务服务 |
|
||
|
|
|
||
|
|
### 关联模型
|
||
|
|
|
||
|
|
| 模型 | 表名 | 说明 |
|
||
|
|
|------|------|------|
|
||
|
|
| `StoreInputModel` | `xk_store_input` | 门店预填表单 |
|
||
|
|
| `StoreInputContractModel` | `xk_store_input_contract` | 门店合同文件 |
|
||
|
|
| `StoreInputNavModel` | `xk_store_input_nav` | 门店轮播图 |
|
||
|
|
|
||
|
|
### 门店审核流程
|
||
|
|
|
||
|
|
```mermaid
|
||
|
|
sequenceDiagram
|
||
|
|
participant S as 门店
|
||
|
|
participant A as 管理员
|
||
|
|
participant C as StoreInputController
|
||
|
|
participant SVC as StoreInputService
|
||
|
|
participant M as StoreInputModel
|
||
|
|
|
||
|
|
S->>C: POST store-input/create
|
||
|
|
C->>SVC: create(data)
|
||
|
|
SVC->>M: create(data)
|
||
|
|
M-->>C: store_input_id
|
||
|
|
C-->>S: 提交成功，等待审核
|
||
|
|
|
||
|
|
A->>C: POST store-input/audit
|
||
|
|
C->>SVC: audit(id, status, remark)
|
||
|
|
SVC->>M: update(status, audit_time)
|
||
|
|
|
||
|
|
alt 审核通过
|
||
|
|
SVC->>SVC: syncToStore(store_input)
|
||
|
|
SVC-->>C: 门店创建成功
|
||
|
|
else 审核拒绝
|
||
|
|
SVC-->>C: 已拒绝
|
||
|
|
end
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 医生预填
|
||
|
|
|
||
|
|
### 接口
|
||
|
|
|
||
|
|
| 方法 | 路径 | 说明 |
|
||
|
|
|------|------|------|
|
||
|
|
| GET | `doctor-input/list` | 预填列表 |
|
||
|
|
| GET | `doctor-input/detail` | 预填详情 |
|
||
|
|
| POST | `doctor-input/create` | 创建预填 |
|
||
|
|
| POST | `doctor-input/update` | 更新预填 |
|
||
|
|
| POST | `doctor-input/audit` | 审核预填 |
|
||
|
|
|
||
|
|
### 关联类
|
||
|
|
|
||
|
|
| 类 | 文件 | 说明 |
|
||
|
|
|----|------|------|
|
||
|
|
| `DoctorInputController` | `app/Http/Controllers/admin/system/DoctorInputController.php` | 控制器 |
|
||
|
|
| `DoctorInputService` | `app/Service/admin/system/DoctorInputService.php` | 业务服务 |
|
||
|
|
|
||
|
|
### 关联模型
|
||
|
|
|
||
|
|
| 模型 | 表名 | 说明 |
|
||
|
|
|------|------|------|
|
||
|
|
| `DoctorInputModel` | `xk_doctor_input` | 医生预填表单 |
|
||
|
|
| `DoctorInputStoreModel` | `xk_doctor_input_store` | 医生-门店绑定 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 银行卡上报
|
||
|
|
|
||
|
|
### 接口
|
||
|
|
|
||
|
|
| 方法 | 路径 | 说明 |
|
||
|
|
|------|------|------|
|
||
|
|
| GET | `store-bank-card-report/list` | 上报列表 |
|
||
|
|
| GET | `store-bank-card-report/detail` | 上报详情 |
|
||
|
|
| POST | `store-bank-card-report/create` | 创建上报 |
|
||
|
|
| POST | `store-bank-card-report/update` | 更新上报 |
|
||
|
|
| GET | `store-bank-card-report/sync-status` | 同步状态 |
|
||
|
|
|
||
|
|
### 关联类
|
||
|
|
|
||
|
|
| 类 | 文件 | 说明 |
|
||
|
|
|----|------|------|
|
||
|
|
| `StoreBankCardReportController` | `app/Http/Controllers/admin/system/StoreBankCardReportController.php` | 控制器 |
|
||
|
|
| `StoreBankCardReportService` | `app/Service/admin/system/StoreBankCardReportService.php` | 业务服务 |
|
||
|
|
| `SyncStoreBankCardStatusCommand` | `app/Console/Commands/SyncStoreBankCardStatusCommand.php` | 状态同步命令 |
|
||
|
|
|
||
|
|
### 关联模型
|
||
|
|
|
||
|
|
| 模型 | 表名 | 说明 |
|
||
|
|
|------|------|------|
|
||
|
|
| `StoreBankCardReportModel` | `xk_store_bank_card_report` | 门店银行卡上报 |
|
||
|
|
|
||
|
|
### 上报状态流程
|
||
|
|
|
||
|
|
```mermaid
|
||
|
|
stateDiagram-v2
|
||
|
|
[*] --> 待上报: 创建上报
|
||
|
|
待上报 --> 上报中: 提交易票联
|
||
|
|
上报中 --> 已通过: 审核通过
|
||
|
|
上报中 --> 已拒绝: 审核拒绝
|
||
|
|
已拒绝 --> 待上报: 重新上报
|
||
|
|
已通过 --> 已修改: 信息变更
|
||
|
|
已修改 --> 上报中: 重新上报
|
||
|
|
```
|