门店用户、角色、权限设置详解

生成时间：2026年5月15日
路径：/www/wwwroot/lingshou/Application/Retail/
相关控制器：StoreRolesController、StoreJurUsersController、MerchantRolesController、MerchantJurUsersController、JurisdictionController
相关模型：JurisdictionGroupModel、JurisdictionListModel、JurisdictionUserModel、JurisdictionGroupModel

一、权限体系架构

1.1 层级关系

商户 (merchant_id)
│
├── 商户用户 (MerchantJurUsers)
│   └── 商户角色 (MerchantRoles)
│       └── 商户权限 (Jurisdiction)
│
└── 门店 (store_id)
    ├── 门店用户 (StoreJurUsers)
    │   └── 门店角色 (StoreRoles)
    │       └── 门店权限 (Jurisdiction)
    │
    └── 权限设置 (JurisdictionController)

1.2 用户类型 (user_type)

1.3 权限类型 (type)

二、门店角色管理 - StoreRolesController

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

2.1 功能方法列表

2.2 角色设置项

2.3 售价限定详解

示例： 设置 discount_limited=1, discount_limited_value=80 表示该角色用户开单时商品售价不能低于原售价的80%

2.4 权限树结构

权限列表为 5级树形结构：

权限分类（type）
└── 父权限（pid=0）
    ├── 子权限1（pid=父ID）
    │   ├── 孙权限1
    │   │   ├── 曾孙权限1
    │   │   │   └── 玄孙权限1
    │   │   └── 曾孙权限2
    │   └── 孙权限2
    └── 子权限2

权限数据表： ls_jurisdiction_list

三、门店用户管理 - StoreJurUsersController

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

3.1 功能方法列表

3.2 用户设置项

3.3 用户验证规则

3.4 用户数量限制

门店可创建的用户数量受 retail_store.limit_user 字段限制：

// 获取门店用户数量限制
$storeInfo['limit_user']

// 获取已创建用户数
$yetNumber = D('retail_cashier')->where(['storeid'=>$storeId,'status'=>1])->count();

// 判断是否已达上限
if(bccomp((string)$yetNumber, (string)$storeInfo['limit_user']) >= 0) {
    // 已达上限，禁止创建
}

四、商户角色管理 - MerchantRolesController

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

4.1 功能方法列表

五、商户用户管理 - MerchantJurUsersController

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

5.1 功能方法列表

六、权限分配 - JurisdictionController

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

6.1 功能方法列表

6.2 权限设置操作

七、权限模型详解

7.1 JurisdictionGroupModel（角色表）

表名： ls_jurisdiction_group

7.2 JurisdictionListModel（权限表）

表名： ls_jurisdiction_list

7.3 JurisdictionUserModel（用户权限关联表）

表名： ls_jurisdiction_user

八、操作流程

8.1 创建角色流程

1. 进入 角色管理 → 添加角色
2. 填写角色名称
3. 设置是否启用
4. 设置是否开启售价限定
   ├── 若开启：选择限定类型（售价比例/批发价）
   └── 若选择售价比例：填写百分比数值
5. 从权限树中选择权限
6. 点击保存

8.2 创建用户流程

1. 进入 用户管理 → 添加用户
2. 填写登录账号（手机号）
3. 填写登录密码
4. 填写用户姓名
5. 选择所属角色
6. 设置是否启用
7. 点击保存
   └── 系统检查：用户数量是否已达上限

8.3 权限分配流程

1. 进入 权限分配 页面
2. 选择要分配的用户或角色
3. 在权限树中勾选需要的权限
4. 点击保存

九、特殊权限控制

9.1 隐藏权限

以下权限ID对店长以下账号隐藏：

9.2 插件权限控制

十、设置项汇总表

10.1 角色设置

10.2 用户设置

10.3 操作设置