门店管理员后端模块设置详解

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

一、角色权限管理模块

1.1 门店角色管理 - StoreRolesController

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

方法	用途	作用范围
`index`	角色管理首页，展示门店所有角色列表	门店级别
`getRoles`	获取角色列表数据（AJAX分页）	门店级别
`rolesAdd`	添加角色页面，支持选择权限	门店级别
`getAllJurList`	获取门店所有可用权限树形列表	门店级别
`rolesAddAjax`	提交新建角色，含权限ID列表	门店级别
`changeStatus`	启用/禁用角色（状态切换）	门店级别
`rolesDel`	删除角色（需确认无用户关联）	门店级别

1.2 商户角色管理 - MerchantRolesController

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

方法	用途	作用范围
`index`	商户角色管理首页	商户级别
`getRoles`	获取商户角色列表	商户级别
`rolesAdd`	添加商户角色页面	商户级别
`getAllJurList`	获取商户所有权限列表	商户级别
`rolesAddAjax`	提交新建商户角色	商户级别
`changeStatus`	启用/禁用商户角色	商户级别
`rolesDel`	删除商户角色	商户级别

1.3 权限分配 - JurisdictionController

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

方法	用途	作用范围
`index`	权限分配首页，展示权限树形结构	门店/商户
`setJurisdiction`	保存权限分配结果到用户或角色	门店/商户

1.4 门店用户管理 - StoreJurUsersController

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

方法	用途	作用范围
`index`	门店用户列表首页	门店级别
`getUser`	获取单个用户详情信息	门店级别
`userAdd`	添加门店用户页面（选择角色）	门店级别
`getStoreRoleList`	获取当前门店的角色下拉列表	门店级别
`userAddAjax`	提交新建用户（账号、密码、角色）	门店级别
`changeStatus`	启用/禁用用户账号	门店级别
`usersDel`	删除门店用户	门店级别

1.5 商户用户管理 - MerchantJurUsersController

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

方法	用途	作用范围
`index`	商户用户列表首页	商户级别
`getUser`	获取商户用户详情	商户级别
`userAdd`	添加商户用户页面	商户级别
`getStoreRoleList`	获取商户角色列表	商户级别
`userAddAjax`	提交新建商户用户	商户级别
`changeStatus`	启用/禁用商户用户	商户级别
`usersDel`	删除商户用户	商户级别

二、门店基础设置 - StoreSetController

文件： Application/Retail/Controller/StoreSetController.class.php（71KB，71个方法）

2.1 版本与更新

方法	用途	作用范围
`VersionUpdate`	检查系统版本更新信息	全局
`setVersionUpdate`	执行版本更新操作	全局

2.2 基础设置

方法	用途	作用范围
`baseSet`	门店基本设置页面（含基础信息配置）	门店
`baseSetBasics`	门店基础信息保存（名称、地址、电话）	门店
`getStoreConfig`	获取门店配置信息	门店
`getShopConfig`	获取店铺配置（含扩展信息）	门店
`setShopConfig`	设置店铺配置	门店
`saveAllStoreSettings`	批量保存门店所有设置	门店

2.3 商品编码与条码

方法	用途	作用范围
`getGoodsCodeGenerateType`	获取商品编码生成方式（手动/自动）	门店
`goodsCodeGenerateTypeSwitch`	切换商品编码生成类型开关	门店

2.4 销售报表与成本

方法	用途	作用范围
`SetSalesReportIncludedInCost`	设置销售报表是否包含成本数据	门店
`getSalesReportIncludedInCost`	获取销售报表是否含成本配置	门店
`SetPurchasePriceEvenlyDistributed`	设置采购价均匀分摊到商品	门店
`getPurchasePriceEvenlyDistributed`	获取采购价分摊设置	门店
`setCalculationMethodSellingPriceBillCommodities`	设置销售单商品计算方式（数量×单价）	门店
`getCalculationMethodSellingPriceBillCommodities`	获取销售单计算方式配置	门店

2.5 退款与退货

方法	用途	作用范围
`setRefundOrderCostPriceType`	设置退货订单商品退货成本价类型（原价/最新采购价）	门店
`getRefundOrderCostPriceType`	获取退货订单成本价类型设置	门店
`setRefundTimeLimit`	设置退款换货时间限制（type:1商城 2店内）	门店

2.6 跨店与采购

方法	用途	作用范围
`setAllowSellOtherStoreGoods`	设置是否允许销售其他门店商品	门店
`getAllowSellOtherStoreGoods`	获取跨店销售设置状态	门店
`spurchaseTypeSwitch`	采购类型开关（采购订单/库存）	门店
`getSpurChaseTypeSwitch`	获取采购类型开关状态	门店
`modifyPriceState`	采购修改售价开关（允许/禁止）	门店

2.7 餐饮相关

方法	用途	作用范围
`getMealGoodsSet`	获取餐饮商品堂食/外卖设置	门店
`getMealGoodsSetSwitch`	获取餐饮商品开关状态	门店

2.8 收银功能开关

方法	用途	作用范围
`openPreferential`	打开/关闭折上折优惠功能	门店
`openManualDiscount`	打开/关闭单品手动折扣功能	门店
`openEmptySell`	打开/关闭商品库存为0允许出售	门店
`openResolution`	打开/关闭商品出售自动拆分	门店
`storeItemSwitch`	门店项目开关（如服务项目）	门店
`saveSelfCheckoutCounterCash`	保存自营收银柜台现金配置	门店
`saveCreateOrderTaxSet`	保存订单税率设置（增值税发票）	门店

2.9 配送与客服

方法	用途	作用范围
`setDefaultDelivery`	设置默认配送方式（快递/自提/送货上门）	门店
`setCustomerService`	设置客服类型（在线客服/电话客服）	门店
`getCustomerService`	获取客服类型配置	门店

2.10 订单与售后

方法	用途	作用范围
`OrderStateModify`	修改自动修改商城订单状态（发货/收货确认）	门店
`smallState`	自动抹零设置（分以下抹零/四舍五入）	门店
`DepositBalanceAct`	找零金额自动存入会员余额设置	门店
`takeStockInventory`	盘点是否显示库存开关（开启显示实际库存）	门店

2.11 商品标签

方法	用途	作用范围
`getLabel`	获取商品详情页标签列表	门店
`labelAdd`	添加或编辑商品详情页标签	门店
`labelStatus`	修改商品标签状态（启用/禁用）	门店
`delLabel`	删除商品详情页标签	门店

2.12 图片与显示

方法	用途	作用范围
`setDefaultImg`	设置默认商品图片（无图片时显示）	门店
`fontSet`	进销存打印字体大小设置	门店
`screen_percent`	收银副屏宣传图比例修改（横屏/竖屏）	门店

2.13 支付与安全

方法	用途	作用范围
`densityFree`	免密支付开关（小额免密）	门店

2.14 多语言与汇率

方法	用途	作用范围
`exchangeRate`	汇率设置页面（支持多币种）	门店
`get_store_language`	获取门店语言设置（中文/英文/其他）	门店
`set_store_language`	设置门店界面语言	门店

2.15 全局设置

方法	用途	作用范围
`getAllStoreSettings`	获取门店所有设置（一次性加载）	门店

三、商户基础设置 - BaseSetController

文件： Application/Retail/Controller/BaseSetController.class.php（11KB）

3.1 其他支付方式

方法	用途	作用范围
`index`	商户基本设置首页	商户
`changeOtherPay`	修改其他支付方式开启/关闭状态	商户
`getOtherPay`	获取已配置的其他支付方式列表	商户
`addOtherPay`	添加自定义支付方式（如饭卡、购物卡）	商户
`delOtherPay`	删除其他支付方式	商户
`upOtherPayName`	修改其他支付方式名称	商户
`changeOtherPayStatus`	修改其他支付方式状态（启用/停用）	商户

3.2 订单与退款

方法	用途	作用范围
`saveOrderSet`	保存退款顺序设置（退款优先级）	商户
`payToVip`	修改退款支付到会员余额开关	商户
`payCouponType`	代金券核销类型设置（指定商品ID/指定条码/全场通用）	商户

四、支付设置 - PaysetController

文件： Application/Retail/Controller/PaysetController.class.php（10KB）

4.1 支付基础配置

方法	用途	作用范围
`paySet`	支付设置页面（微信/支付宝/现金/会员卡）	商户
`get_pay_pattern`	获取商户已开通的支付通道列表	商户
`doSetPaySet`	保存支付通道配置（APPID/密钥/证书）	商户
`customSettings`	新大陆商户自定义配置入口	商户
`upload`	上传微信/支付宝证书文件	商户

4.2 商户入驻（新大陆）

方法	用途	作用范围
`merchantEntry`	新大陆新版商户入驻页面	商户
`initialNewPaySet`	获取初始新大陆进件信息	商户
`getMccArr`	获取商户经营类目MCC码列表	全局
`toIncomingParts`	第一次提交商户进件信息到新大陆	商户
`submitApply`	提交商户入驻申请	商户
`searchEntryApply`	查询商户入驻申请状态	商户
`applyChange`	商户申请信息变更（如结算账户变更）	商户
`deleteEntry`	删除商户新大陆支付配置	商户

4.3 地区与银行

方法	用途	作用范围
`getProvince`	获取省份列表（用于进件地址）	全局
`getSubordinate`	获取下级地区（市/区）	全局
`getArea`	获取区/县列表	全局
`getBank`	获取银行列表（支行联行号）	全局
`getWcLbnkNo`	获取微信支付银行卡联行号	商户

4.4 支付进件更新

方法	用途	作用范围
`updateNewPaySet`	保存/更新新大陆进件信息	商户
`uploads`	上传商户资质图片（营业执照/身份证）	商户

4.5 打款与结算

方法	用途	作用范围
`remit`	打款设置页面（结算周期/T+1或D+1）	商户
`getRemitData`	获取打款设置信息	商户
`saveRemitData`	保存打款/结算配置	商户

五、微信配置 - WxconfigController

文件： Application/Retail/Controller/WxconfigController.class.php（19KB）

5.1 公众号基础配置

方法	用途	作用范围
`wxconfig`	微信公众号配置页面	商户
`getWxconfig`	获取微信公众号配置信息	商户
`upWxImg`	上传微信缩略图到素材库	商户
`upload`	上传微信认证文件/证书	商户
`getwxImg`	获取微信素材图片	商户
`wxupdate`	保存微信公众号配置（AppID/AppSecret）	商户
`reset`	重置用户的微信授权信息	商户

5.2 微信授权

方法	用途	作用范围
`authindex`	微信授权跳转页面	商户
`authSuccess`	微信授权成功回调处理	商户
`get_authorizer_info`	获取授权方账号基本信息（昵称/头像）	商户

5.3 自定义菜单

方法	用途	作用范围
`getMenu`	获取当前微信公众号自定义菜单	商户
`upMenu`	上传菜单配置（按钮结构/响应动作）	商户
`menu`	添加微信自定义菜单页面	商户
`release`	发布自定义菜单到微信公众号	商户

5.4 JS配置

方法	用途	作用范围
`getPlugUrl`	获取插件URL（微信JSSDK）	商户
`morejs`	更多JS配置（分享/支付/扫码）	商户

六、小程序配置 - XcxConfigController

文件： Application/Retail/Controller/XcxConfigController.class.php（10KB）

6.1 基础配置

方法	用途	作用范围
`wxconfig`	小程序配置首页	商户
`getXcxConfig`	获取小程序配置信息	商户
`setting`	小程序自动跳转最近门店设置	商户
`saveStoreSetting`	保存小程序门店设置	商户
`getBaseData`	获取小程序基本信息（名称/描述）	商户

6.2 小程序授权与发布

方法	用途	作用范围
`authIndex`	小程序授权跳转页面	商户
`authSuccess`	小程序授权成功回调	商户
`submitAudit`	提交小程序版本审核	商户
`undoCodeAudit`	撤回小程序审核申请	商户
`release`	发布小程序正式版本	商户
`reBack`	回退小程序到上一个版本	商户
`getPreviewQrImg`	获取小程序预览二维码（体验版）	商户
`changeOnlineStatus`	修改小程序充值入口显示状态	商户

6.3 用户绑定

方法	用途	作用范围
`bindUser`	绑定小程序开发/体验用户	商户

6.4 轮播图管理

方法	用途	作用范围
`slideshow`	小程序首页轮播图设置页面	商户
`getBanner`	获取轮播图列表	商户
`addSlideShow`	添加轮播图（图片/跳转链接）	商户
`delSlideShow`	删除轮播图	商户

6.5 附近小程序

方法	用途	作用范围
`saveNearby`	修改小程序是否开启"附近门店"入口	商户
`setNearby`	加载小程序附近门店设置模板	商户

七、会员配置 - VipconfigController

文件： Application/Retail/Controller/VipconfigController.class.php（22KB）

7.1 会员基础配置

方法	用途	作用范围
`index`	会员配置首页（积分规则/升级条件）	商户
`index2`	会员配置首页（备用/简化版）	商户
`vipconfigset`	常规会员积分设置（消费1元=XX积分）	商户
`plus_vipconfigset`	Plus会员专属权益配置	商户
`saveIntegralSet`	积分抵现规则设置（100积分=1元）	商户
`upload`	上传会员相关图片/资质	商户

7.2 会员福利

方法	用途	作用范围
`welfare`	会员注册福利页面（新会员注册赠礼）	商户
`getWelfare`	获取会员福利列表	商户
`setWelfare`	设置会员福利（注册送积分/优惠券）	商户
`getCanUseMCoupon`	获取可用优惠券列表（过滤库存不足）	商户

7.3 会员状态管理

方法	用途	作用范围
`changestatus`	修改会员状态（启用/禁用/冻结）	商户
`delTemporaryVip`	删除测试/临时会员数据	商户

八、门店管理 - StoreController

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

8.1 门店增删改查

方法	用途	作用范围
`index`	门店管理首页	商户
`store`	门店管理主页	商户
`getStoreList`	获取商户下所有门店列表（分页）	商户
`addstore`	添加门店页面	商户
`doAddStore`	执行添加门店（名称/地址/电话/经纬度）	商户
`editstore`	编辑门店页面	商户
`doEditStore`	执行编辑门店信息	商户
`delstore`	删除门店（软删除）	商户

8.2 门店配置

方法	用途	作用范围
`manageSet`	行业门店开启/关闭设置（零售/餐饮/服务）	门店
`store_type_set`	门店类型设置（直营/加盟/联营）	门店
`setRechargeParam`	设置门店充值参数（充值送活动）	门店
`setStoreParam`	设置门店营业参数（营业时间/人均消费）	门店
`dadadelivery`	达达配送对接配置（商户ID/密钥）	门店
`getStoreLimitList`	获取门店限制列表（区域/品类限制）	门店

8.3 地区与位置

方法	用途	作用范围
`getCity`	根据省份获取城市列表	全局
`Province`	获取所有省份列表	全局
`City`	根据省份ID获取城市数据	全局
`Area`	根据城市ID获取区县数据	全局

8.4 二维码与推广

方法	用途	作用范围
`get_qrcode`	获取门店小程序码（用于物料印刷）	门店
`qrcode`	生成门店小程序二维码（含参数）	门店
`downloadImg`	下载门店小程序二维码图片到本地	门店

8.5 订单处理

方法	用途	作用范围
`handleOrder`	处理门店订单（统计/分账）	门店
`otherPay`	查询其他支付流水	门店
`handleOther`	处理其他支付数据	门店
`combinationPay`	处理组合支付（现金+会员+优惠券）	门店
`quickPay`	处理快捷收银（快速收款）	门店
`handleStoreRecharge`	处理门店会员充值	门店
`handleMerchantRecharge`	处理商户统一充值	商户

8.6 统计数据

方法	用途	作用范围
`statistics`	门店经营统计（销售额/订单数/毛利）	门店
`getStoreSaleDataList`	商户销售统计数据列表（按门店/时间）	商户
`handleStoreAllData`	处理门店全部经营数据	门店
`handleRechargeAllData`	处理充值全部数据（余额变动）	门店

8.7 短信通知

方法	用途	作用范围
`sendDelPhoneMessage`	删除门店时发送短信通知	商户

8.8 跳转与导航

方法	用途	作用范围
`toStore`	跳转到门店详情页面	全局

九、权限层级结构

商户 (merchant_id)
│
├── 商户用户管理 (MerchantJurUsersController)
│   ├── 商户角色 (MerchantRolesController)
│   │   └── 权限分配 (JurisdictionController)
│   │
│   └── 商户基础设置 (BaseSetController)
│       ├── 其他支付方式
│       ├── 订单退款设置
│       └── 代金券规则
│
├── 支付设置 (PaysetController)
│   ├── 微信/支付宝通道
│   ├── 商户入驻(新大陆)
│   └── 打款结算
│
├── 微信配置 (WxconfigController)
│   ├── 公众号配置
│   ├── 自定义菜单
│   └── JS-SDK
│
├── 小程序配置 (XcxConfigController)
│   ├── 授权发布
│   ├── 轮播图
│   └── 附近门店
│
├── 会员配置 (VipconfigController)
│   ├── 积分规则
│   ├── Plus会员
│   └── 会员福利
│
└── 门店 (store_id)
    ├── 门店用户管理 (StoreJurUsersController)
    │   └── 门店角色 (StoreRolesController)
    │
    └── 门店设置 (StoreSetController)
        ├── 基础信息
        ├── 销售报表
        ├── 收银开关
        ├── 配送客服
        ├── 商品标签
        └── 多语言汇率

十、设置项速查表

按功能分类

功能	设置项
门店信息	名称、地址、电话、经纬度、营业时间
销售报表	是否含成本、采购价分摊、退款成本价类型
收银功能	优惠折扣、空卖允许、抹零、找零存余额
商品管理	编码生成方式、库存为0可售、详情标签、默认图片
支付	微信/支付宝/现金/会员卡、其他支付、免密支付
配送	默认配送方式、达达配送对接
客服	客服类型、在线客服/电话客服
会员	积分规则、积分抵现、Plus会员、注册福利
小程序	授权发布、轮播图、附近门店、审核发布
微信	公众号配置、自定义菜单、JS-SDK
订单	退款时间限制、自动确认收货、商城订单状态
打印	字体大小、副屏比例
多语言	门店语言、汇率设置