xk-docs/docs/projects/xk-api/modules/store.md

门店管理模块

概述

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

---

门店管理

接口

方法	路径	说明
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	门店轮播图

门店审核流程

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	门店银行卡上报

上报状态流程

stateDiagram-v2
    [*] --> 待上报: 创建上报
    待上报 --> 上报中: 提交易票联
    上报中 --> 已通过: 审核通过
    上报中 --> 已拒绝: 审核拒绝
    已拒绝 --> 待上报: 重新上报
    已通过 --> 已修改: 信息变更
    已修改 --> 上报中: 重新上报