门店管理员后端模块详解

生成时间：2026年5月15日
项目路径：/www/wwwroot/lingshou/Application/Retail/

一、角色权限管理

1.1 门店角色管理 - StoreRolesController

文件： Application/Retail/Controller/StoreRolesController.class.php

方法	用途
`index`	角色列表首页
`getRoles`	获取角色列表
`rolesAdd`	添加角色页面
`rolesAddAjax`	AJAX添加角色
`getAllJurList`	获取所有权限列表
`changeStatus`	修改角色状态（启用/禁用）
`rolesDel`	删除角色

作用范围： 门店级别（store_id）

1.2 商户角色管理 - MerchantRolesController

文件： Application/Retail/Controller/MerchantRolesController.class.php

方法	用途
`index`	角色列表首页
`getRoles`	获取角色列表
`rolesAdd`	添加角色页面
`rolesAddAjax`	AJAX添加角色
`getAllJurList`	获取所有权限列表
`changeStatus`	修改角色状态
`rolesDel`	删除角色

作用范围： 商户级别（merchant_id）

1.3 权限分配 - JurisdictionController

文件： Application/Retail/Controller/JurisdictionController.class.php

方法	用途
`index`	权限分配首页
`setJurisdiction`	设置权限

作用范围： 门店/商户角色的权限配置

1.4 权限数据模型 - Common Model

模型	文件位置	用途
`JurisdictionListModel`	`Common/Model/`	权限列表（树形结构）
`JurisdictionUserModel`	`Common/Model/`	用户权限关联
`JurisdictionGroupModel`	`Common/Model/`	权限分组
`StoreJurisdictionModel`	`Common/Model/`	门店权限配置

二、用户管理

2.1 门店用户管理 - StoreJurUsersController

文件： Application/Retail/Controller/StoreJurUsersController.class.php

方法	用途
`index`	用户列表首页
`getUser`	获取用户信息
`userAdd`	添加用户页面
`userAddAjax`	AJAX添加用户
`getStoreRoleList`	获取门店角色列表
`changeStatus`	修改用户状态
`usersDel`	删除用户

作用范围： 门店用户（收银员、店员等）

2.2 商户用户管理 - MerchantJurUsersController

文件： Application/Retail/Controller/MerchantJurUsersController.class.php

方法	用途
`index`	用户列表首页
`getUser`	获取用户信息
`userAdd`	添加用户页面
`userAddAjax`	AJAX添加用户
`getStoreRoleList`	获取商户角色列表
`changeStatus`	修改用户状态
`usersDel`	删除用户

作用范围： 商户管理员

三、门店基础设置 - StoreSetController

文件： Application/Retail/Controller/StoreSetController.class.php（71KB）

3.1 版本与更新

方法	用途	作用范围
`VersionUpdate`	版本更新检查	全局
`setVersionUpdate`	设置版本更新	全局

3.2 基础设置

方法	用途	作用范围
`baseSet`	基础设置页面	门店
`baseSetBasics`	基础信息设置	门店
`getStoreConfig`	获取门店配置	门店
`getShopConfig`	获取店铺配置	门店
`setShopConfig`	设置店铺配置	门店
`saveAllStoreSettings`	保存所有门店设置	门店

3.3 销售相关设置

方法	用途	作用范围
`SetSalesReportIncludedInCost`	销售报表是否包含成本	门店
`getSalesReportIncludedInCost`	获取销售报表成本设置	门店
`SetPurchasePriceEvenlyDistributed`	采购价均匀分摊	门店
`getPurchasePriceEvenlyDistributed`	获取采购价分摊设置	门店
`setCalculationMethodSellingPriceBillCommodities`	销售单商品计算方式	门店
`getCalculationMethodSellingPriceBillCommodities`	获取计算方式	门店
`setRefundOrderCostPriceType`	退款订单成本价类型	门店
`getRefundOrderCostPriceType`	获取退款成本价类型	门店
`setAllowSellOtherStoreGoods`	允许销售其他门店商品	门店
`getAllowSellOtherStoreGoods`	获取跨店销售设置	门店
`spurchaseTypeSwitch`	采购类型开关	门店
`getSpurChaseTypeSwitch`	获取采购类型设置	门店
`goodsCodeGenerateTypeSwitch`	商品编码生成类型	门店
`getGoodsCodeGenerateType`	获取编码生成类型	门店

3.4 收银相关设置

方法	用途	作用范围
`openPreferential`	打开优惠	门店
`openManualDiscount`	打开手动折扣	门店
`openEmptySell`	打开空卖	门店
`openResolution`	打开抹零	门店
`modifyPriceState`	修改价格状态	门店
`saveSelfCheckoutCounterCash`	保存自营收银柜台现金	门店

3.5 配送与客服

方法	用途	作用范围
`setDefaultDelivery`	设置默认配送方式	门店
`setCustomerService`	设置客服	门店
`getCustomerService`	获取客服设置	门店
`getLabel`	获取标签列表	门店
`labelAdd`	添加标签	门店
`labelStatus`	修改标签状态	门店
`delLabel`	删除标签	门店
`densityFree`	免密度设置	门店

3.6 订单与售后

方法	用途	作用范围
`OrderStateModify`	订单状态修改	门店
`smallState`	小状态设置	门店
`DepositBalanceAct`	定金余额活动	门店
`takeStockInventory`	盘点库存	门店
`setRefundTimeLimit`	设置退款时间限制	门店

3.7 打印与显示

方法	用途	作用范围
`setDefaultImg`	设置默认图片	门店
`fontSet`	字体设置	门店
`screen_percent`	屏幕比例	门店

3.8 多语言与汇率

方法	用途	作用范围
`exchangeRate`	汇率设置	门店
`get_store_language`	获取门店语言	门店
`set_store_language`	设置门店语言	门店

四、商户基础设置 - BaseSetController

文件： Application/Retail/Controller/BaseSetController.class.php

4.1 支付设置

方法	用途	作用范围
`changeOtherPay`	修改其他支付方式	商户
`getOtherPay`	获取其他支付方式	商户
`addOtherPay`	添加其他支付方式	商户
`delOtherPay`	删除其他支付方式	商户
`upOtherPayName`	更新支付方式名称	商户
`changeOtherPayStatus`	修改支付方式状态	商户

4.2 订单设置

方法	用途	作用范围
`saveOrderSet`	保存订单设置	商户
`payToVip`	支付到会员	商户
`payCouponType`	支付优惠券类型	商户

五、支付设置 - PaysetController

文件： Application/Retail/Controller/PaysetController.class.php

5.1 支付配置

方法	用途	作用范围
`paySet`	支付设置页面	商户
`get_pay_pattern`	获取支付模式	商户
`doSetPaySet`	执行支付设置	商户
`customSettings`	自定义设置	商户
`upload`	上传证书	商户

5.2 商户入驻

方法	用途	作用范围
`merchantEntry`	商户入驻	商户
`initialNewPaySet`	初始化新支付设置	商户
`getMccArr`	获取MCC码	商户
`getProvince`	获取省份	全局
`getSubordinate`	获取下级地区	全局
`getArea`	获取区域	全局
`getBank`	获取银行列表	全局

5.3 支付申请与变更

方法	用途	作用范围
`updateNewPaySet`	更新新支付设置	商户
`getWcLbnkNo`	获取微信银行卡号	商户
`toIncomingParts`	进入收款部件	商户
`submitApply`	提交申请	商户
`searchEntryApply`	查询入驻申请	商户
`applyChange`	申请变更	商户
`deleteEntry`	删除入驻	商户
`remit`	remittance汇款	商户
`getRemitData`	获取汇款数据	商户
`saveRemitData`	保存汇款数据	商户

六、微信配置 - WxconfigController

文件： Application/Retail/Controller/WxconfigController.class.php

6.1 微信公众号配置

方法	用途	作用范围
`wxconfig`	微信配置页面	商户
`getWxconfig`	获取微信配置	商户
`upWxImg`	上传微信图片	商户
`upload`	上传证书	商户
`getwxImg`	获取微信图片	商户
`wxupdate`	更新微信配置	商户
`reset`	重置配置	商户

6.2 微信授权与菜单

方法	用途	作用范围
`authindex`	授权首页	商户
`authSuccess`	授权成功回调	商户
`get_authorizer_info`	获取授权者信息	商户
`getMenu`	获取菜单	商户
`upMenu`	上传菜单	商户
`menu`	菜单管理	商户
`release`	发布菜单	商户
`morejs`	更多JS配置	商户

七、小程序配置 - XcxConfigController

文件： Application/Retail/Controller/XcxConfigController.class.php

7.1 小程序授权与发布

方法	用途	作用范围
`wxconfig`	小程序配置	商户
`authIndex`	授权首页	商户
`authSuccess`	授权成功	商户
`submitAudit`	提交审核	商户
`undoCodeAudit`	撤销审核	商户
`release`	发布小程序	商户
`reBack`	小程序回退	商户

7.2 小程序轮播与附近

方法	用途	作用范围
`getXcxConfig`	获取小程序配置	商户
`setting`	小程序设置	商户
`saveStoreSetting`	保存门店设置	商户
`slideshow`	轮播图管理	商户
`getBanner`	获取轮播图	商户
`addSlideShow`	添加轮播图	商户
`delSlideShow`	删除轮播图	商户
`saveNearby`	保存附近小程序	商户
`setNearby`	设置附近小程序	商户
`getPreviewQrImg`	获取预览二维码	商户
`changeOnlineStatus`	修改上线状态	商户

7.3 用户绑定

方法	用途	作用范围
`bindUser`	绑定用户	商户

八、会员配置 - VipconfigController

文件： Application/Retail/Controller/VipconfigController.class.php

8.1 会员基础设置

方法	用途	作用范围
`index`	会员配置首页	商户
`index2`	会员配置首页2	商户
`vipconfigset`	会员配置设置	商户
`plus_vipconfigset`	PLUS会员配置	商户
`saveIntegralSet`	保存积分设置	商户
`upload`	上传配置	商户

8.2 会员福利

方法	用途	作用范围
`welfare`	会员福利页面	商户
`setWelfare`	设置福利	商户
`getWelfare`	获取福利设置	商户
`getCanUseMCoupon`	获取可用优惠券	商户

8.3 会员状态管理

方法	用途	作用范围
`changestatus`	修改会员状态	商户
`delTemporaryVip`	删除临时会员	商户

九、门店管理 - StoreController

文件： Application/Retail/Controller/StoreController.class.php（125KB，最大文件）

9.1 门店增删改查

方法	用途	作用范围
`index`	门店首页	商户
`store`	门店管理	商户
`getStoreList`	获取门店列表	商户
`addstore`	添加门店页面	商户
`doAddStore`	执行添加门店	商户
`editstore`	编辑门店页面	商户
`doEditStore`	执行编辑门店	商户
`delstore`	删除门店	商户

9.2 门店配置

方法	用途	作用范围
`manageSet`	管理设置	门店
`store_type_set`	门店类型设置	门店
`setRechargeParam`	设置充值参数	门店
`setStoreParam`	设置门店参数	门店
`dadadelivery`	达达配送	门店
`getStoreLimitList`	获取门店限制列表	门店

9.3 地区与位置

方法	用途	作用范围
`getCity`	获取城市	全局
`Province`	省份	全局
`City`	城市	全局
`Area`	区域	全局

9.4 二维码与推广

方法	用途	作用范围
`get_qrcode`	获取门店二维码	门店
`qrcode`	二维码管理	门店
`downloadImg`	下载图片	门店

9.5 订单处理

方法	用途	作用范围
`handleOrder`	处理订单	门店
`otherPay`	其他支付处理	门店
`combinationPay`	组合支付	门店
`quickPay`	快捷支付	门店
`handleStoreRecharge`	处理门店充值	门店
`handleMerchantRecharge`	处理商户充值	门店

9.6 统计数据

方法	用途	作用范围
`statistics`	统计数据	门店
`getStoreSaleDataList`	获取门店销售数据	门店
`handleStoreAllData`	处理门店全部数据	门店
`handleRechargeAllData`	处理充值全部数据	门店

十、权限层级结构

商户 (merchant_id)
├── 商户角色 (MerchantRolesController)
│   └── 商户用户 (MerchantJurUsersController)
│
└── 门店 (store_id)
    ├── 门店角色 (StoreRolesController)
    │   └── 门店用户 (StoreJurUsersController)
    │
    └── 门店设置 (StoreSetController)
        ├── 销售设置
        ├── 收银设置
        ├── 打印设置
        ├── 配送设置
        └── 会员设置

十一、配置数据存储位置

配置类型	存储表（推测）	作用范围
门店基础信息	`ls_retail_store`	门店
门店扩展配置	`ls_retail_store.ext` (JSON)	门店
角色信息	`ls_store_roles` / `ls_merchant_roles`	角色
用户信息	`ls_store_jur_users` / `ls_merchant_jur_users`	用户
权限列表	`ls_jurisdiction_list`	全局
支付配置	`ls_retail_pay_set`	商户
微信配置	`ls_wx_config`	商户
小程序配置	`ls_xcx_config`	商户
会员配置	`ls_vip_config`	商户