# 门店管理模块

## 概述

门店管理模块负责门店信息管理、入驻审核、银行卡上报等。

---

## 门店管理

### 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| 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
    [*] --> 待上报: 创建上报
    待上报 --> 上报中: 提交易票联
    上报中 --> 已通过: 审核通过
    上报中 --> 已拒绝: 审核拒绝
    已拒绝 --> 待上报: 重新上报
    已通过 --> 已修改: 信息变更
    已修改 --> 上报中: 重新上报
```