认证/登录 auth

模块 auth：共 11 个接口 —— 7 个被前端调用（在用），4 个未被调用（含 0 个开放/回调/内部）。用下方筛选可只看“在用/未使用”，或在右栏目录按名称过滤。

AuthController 7/11 在用

POST /auth/checkerLogin 在用App #

权限-核销员登录 · AuthController

基本信息

控制器	com.jxxx.dscp.api.controller.auth.AuthController#checkerLogin
所属模块	认证/登录 `auth`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表checker_relationcheckersystem_oauth2_access_tokenskusku_entrancechecker_cqy_relationchecker_tickets_relationtickets_skuchecker_configsystem_operate_log

ControllerAuthController#checkerLogin

转换BeanUtils.map → CheckerLoginResponse

MapperCheckerRelationService.getMapper#selectOne ⇒ 表 checker_relation

ServiceCheckerService#get （CheckerServiceImpl）

MapperCheckerMapper#selectById ⇒ 表 checker

ServiceOauth2AccessTokenService#queryList （Oauth2AccessTokenServiceImpl）

MapperOauth2AccessTokenMapper#selectList ⇒ 表 system_oauth2_access_token

ServiceCheckerRelationService#queryList （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#selectList ⇒ 表 checker_relation

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

ServiceSkuEntranceService#queryList （SkuEntranceServiceImpl）

MapperSkuEntranceMapper#selectList ⇒ 表 sku_entrance

ServiceCheckerCqyRelationService#queryList （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#selectList ⇒ 表 checker_cqy_relation

ServiceCheckerTicketsRelationService#queryList （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#selectList ⇒ 表 checker_tickets_relation

ServiceTicketsSkuService#get （TicketsSkuServiceImpl）

MapperTicketsSkuMapper#selectById ⇒ 表 tickets_sku

ServiceCheckerConfigService#queryList （CheckerConfigServiceImpl）

MapperCheckerConfigMapper#selectList ⇒ 表 checker_config

ServiceCheckerRelationService#get （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#selectById ⇒ 表 checker_relation

ServiceCheckerRelationService#update （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#updateById ⇒ 表 checker_relation

ServiceCheckerRelationService#add （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#insert ⇒ 表 checker_relation

ServiceCheckerService#update （CheckerServiceImpl）

MapperCheckerMapper#updateById ⇒ 表 checker

ServiceSystemOperateLogService#add （SystemOperateLogServiceImpl）

MapperSystemOperateLogMapper#insert ⇒ 表 system_operate_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 6

Oauth2AccessTokenService.createAccessTokenOauth2ClientService.mustGetAuthService.setAuthAccIdMerchantCache.getShopCache.getZhyCardService.verifyLogin

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/app-api/auth/checkerLogin
uat	https://dscp-uat.hn12301.net/app-api/auth/checkerLogin
pro	https://dscp-uat.hn12301.net/app-api/auth/checkerLogin	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CheckerLoginRequest

字段	类型	必填	取值/校验	表 / 列	说明
mobile	String	是	必填	`checker`.`mobile`	用户名
password	String	是	必填	`checker`.`password`	密码

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　CheckerLoginResponse　（object）

字段	类型	取值/校验	表 / 列	说明
userId	Long		`system_oauth2_access_token`.`user_id`	登录用户id
checkerName	String		—
accessToken	String		`system_oauth2_access_token`.`access_token`	访问令牌
refreshToken	String		`system_oauth2_access_token`.`refresh_token`	刷新令牌
expiresTime	Date		`system_oauth2_access_token`.`expires_time`	过期时间
shopName	String		—
skuInfo	List<SkuEntranceDto>		—
skuInfo[].id	Long		`checker_relation`.`id`
skuInfo[].skuName	String		`sku`.`sku_name`	sku名称
skuInfo[].entrenceList	List<SkuEntrance>		—
entrenceList[].id	Long		`checker_relation`.`id`	ID，主键
entrenceList[].skuId	Long		`checker_relation`.`sku_id`	所属关联sku表id
entrenceList[].entranceName	String		`sku_entrance`.`entrance_name`	景区入口名称
entrenceList[].merchantId	Long		`checker_relation`.`merchant_id`	所属商户id
entrenceList[].shopId	Long		`checker_relation`.`shop_id`	所属商铺id
entrenceList[].goodsId	Long		`checker_relation`.`goods_id`	商品ID，关联商品表id
entrenceList[].createdBy	String		`sku`.`created_by`	创建人id
entrenceList[].createdTime	Date		`system_oauth2_access_token`.`created_time`	创建时间
cqySkuList	List<SkuEntranceDto>		—
cqySkuList[].id	Long		`checker_relation`.`id`
cqySkuList[].skuName	String		`sku`.`sku_name`	sku名称
cqySkuList[].entrenceList	List<SkuEntrance>		—
entrenceList[].id	Long		`checker_relation`.`id`	ID，主键
entrenceList[].skuId	Long		`checker_relation`.`sku_id`	所属关联sku表id
entrenceList[].entranceName	String		`sku_entrance`.`entrance_name`	景区入口名称
entrenceList[].merchantId	Long		`checker_relation`.`merchant_id`	所属商户id
entrenceList[].shopId	Long		`checker_relation`.`shop_id`	所属商铺id
entrenceList[].goodsId	Long		`checker_relation`.`goods_id`	商品ID，关联商品表id
entrenceList[].createdBy	String		`sku`.`created_by`	创建人id
entrenceList[].createdTime	Date		`system_oauth2_access_token`.`created_time`	创建时间
ticketsSkuList	List<TicketsSku>		—
ticketsSkuList[].id	Long		`checker_relation`.`id`	商品id，主键
ticketsSkuList[].merchantId	Long		`checker_relation`.`merchant_id`	所属商户id
ticketsSkuList[].shopId	Long		`checker_relation`.`shop_id`	所属商铺id
ticketsSkuList[].ticketsId	Long		`checker_tickets_relation`.`tickets_id`	单票ID，关联单票表id
ticketsSkuList[].skuName	String		`sku`.`sku_name`	sku名称
ticketsSkuList[].typeId	String		`tickets_sku`.`type_id`	sku类型
ticketsSkuList[].typeInfo	String		`tickets_sku`.`type_info`	适用人群说明
ticketsSkuList[].stockNumType	Boolean		`tickets_sku`.`stock_num_type`	是否无限库存
ticketsSkuList[].stockDateType	Boolean		`tickets_sku`.`stock_date_type`	库存形式:日历库存、时间段库存
ticketsSkuList[].bookType	Integer		`tickets_sku`.`book_type`	预定时间:1=可订当天,0=可订明日
ticketsSkuList[].bookTimeLimit	LocalTime		`tickets_sku`.`book_time_limit`	预订限制时间：订当天时，表示xx时间之前可订当天；订明日时，表示xx时间之前可订明日
ticketsSkuList[].idLimitFlag	Boolean		`tickets_sku`.`id_limit_flag`	身份证是否限购
ticketsSkuList[].idLimitDays	Integer		`tickets_sku`.`id_limit_days`	身份证限制天数
ticketsSkuList[].idLimitNum	Integer		`tickets_sku`.`id_limit_num`	身份证限制张数
ticketsSkuList[].speedInfo	String		`tickets_sku`.`speed_info`	出票速度
ticketsSkuList[].basePrice	Integer		`tickets_sku`.`base_price`	默认价(分)
ticketsSkuList[].contentWith	String		`tickets_sku`.`content_with`	费用包含
ticketsSkuList[].contentWithout	String		`tickets_sku`.`content_without`	费用不包含
ticketsSkuList[].enterDemand	String		`tickets_sku`.`enter_demand`	入园要求
ticketsSkuList[].enterType	String		`tickets_sku`.`enter_type`	入园方式
ticketsSkuList[].enterChangeFlag	Boolean		`tickets_sku`.`enter_change_flag`
ticketsSkuList[].changePostion	String		`tickets_sku`.`change_postion`	换票地点
ticketsSkuList[].changeStart	LocalTime		`tickets_sku`.`change_start`	换票起始
ticketsSkuList[].changeEnd	LocalTime		`tickets_sku`.`change_end`	换票截止
ticketsSkuList[].enterPostion	String		`tickets_sku`.`enter_postion`	入园地点
ticketsSkuList[].enterStart	LocalTime		`tickets_sku`.`enter_start`	入园起始
ticketsSkuList[].enterEnd	LocalTime		`tickets_sku`.`enter_end`	入园截止
ticketsSkuList[].refundType	Integer		`tickets_sku`.`refund_type`	退款规则
ticketsSkuList[].refundDays	Integer		`tickets_sku`.`refund_days`	可退款时间：选择天数和时间，在这之前的可退款。之后的不能退款。0天为使用当天。
ticketsSkuList[].refundTime	LocalTime		`tickets_sku`.`refund_time`	可退款时间
ticketsSkuList[].refundPolicy	String		`tickets_sku`.`refund_policy`	退款政策
ticketsSkuList[].remark	String		`tickets_sku`.`remark`	补充说明
ticketsSkuList[].receiptPolicy	String		`tickets_sku`.`receipt_policy`	发票说明
ticketsSkuList[].isDeleted	Boolean		`system_oauth2_access_token`.`is_deleted`	是否删除
ticketsSkuList[].status	TicketsStatus	1已上架2编辑中3已下架	`checker`.`status`
ticketsSkuList[].createdBy	String		`sku`.`created_by`	创建人
ticketsSkuList[].createdTime	Date		`system_oauth2_access_token`.`created_time`	创建时间
ticketsSkuList[].updatedBy	String		`sku`.`updated_by`	修改人
ticketsSkuList[].updatedTime	Date		`checker`.`updated_time`	修改时间
merchantName	String		—
sskFlag	boolean		—
configList	List<CheckerConfig>		—
configList[].id	Long		`checker_relation`.`id`	id
configList[].checkerId	Long		`checker_relation`.`checker_id`	核销人员id
configList[].configType	Integer		`checker_config`.`config_type`	类型
configList[].item	String		`checker_config`.`item`	配置项
configList[].value	String		`checker_config`.`value`	配置值
configList[].remark	String		`tickets_sku`.`remark`	备注
configList[].isDeleted	Boolean		`system_oauth2_access_token`.`is_deleted`	是否删除
configList[].createdTime	Date		`system_oauth2_access_token`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /auth/checkerLogin

{
  "body": {
    "mobile": "13800000000",
    "password": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "userId": 1,
    "checkerName": "",
    "accessToken": "",
    "refreshToken": "",
    "expiresTime": "2026-01-01 12:00:00",
    "shopName": "",
    "skuInfo": [
      {
        "id": 1,
        "skuName": "",
        "entrenceList": [
          {
            "id": 1,
            "skuId": 1,
            "entranceName": "",
            "merchantId": 1,
            "shopId": 1,
            "goodsId": 1,
            "createdBy": "",
            "createdTime": "2026-01-01 12:00:00"
          }
        ]
      }
    ],
    "cqySkuList": [
      {
        "id": 1,
        "skuName": "",
        "entrenceList": [
          {
            "id": 1,
            "skuId": 1,
            "entranceName": "",
            "merchantId": 1,
            "shopId": 1,
            "goodsId": 1,
            "createdBy": "",
            "createdTime": "2026-01-01 12:00:00"
          }
        ]
      }
    ],
    "ticketsSkuList": [
      {
        "id": 1,
        "merchantId": 1,
        "shopId": 1,
        "ticketsId": 1,
        "skuName": "",
        "typeId": "",
        "typeInfo": "",
        "stockNumType": false,
        "stockDateType": false,
        "bookType": 0,
        "bookTimeLimit": "2026-01-01 12:00:00",
        "idLimitFlag": false,
        "idLimitDays": 1,
        "idLimitNum": 1,
        "speedInfo": "",
        "basePrice": 0,
        "contentWith": "",
        "contentWithout": "",
        "enterDemand": "",
        "enterType": "",
        "enterChangeFlag": false,
        "changePostion": "",
        "changeStart": "",
        "changeEnd": "",
        "enterPostion": "",
        "enterStart": "",
        "enterEnd": "",
        "refundType": 0,
        "refundDays": 0,
        "refundTime": "2026-01-01 12:00:00",
        "refundPolicy": "",
        "remark": "",
        "receiptPolicy": "",
        "isDeleted": false,
        "status": "1",
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "merchantName": "",
    "sskFlag": false,
    "configList": [
      {
        "id": 1,
        "checkerId": 1,
        "configType": 0,
        "item": "",
        "value": "",
        "remark": "",
        "isDeleted": false,
        "createdTime": "2026-01-01 12:00:00"
      }
    ]
  }
}

处理逻辑

逻辑摘要查询详情（checkerService.get）；调用 equals（StringUtils.equals）；调用 date（DateUtil.date）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

查询用户信息
增加租户识别，防止查询出两条数据报错
创建token
获取景区信息
skuList.addAll(tempSku);
Merchant merchant = merchantCache.get(sku.getMerchantId());
设置商品关联
设置票种关联信息

前端调用方

writeoff Login exact

POST /auth/checkerLogout 在用App #

核销员登出 · AuthController

基本信息

控制器	com.jxxx.dscp.api.controller.auth.AuthController#checkerLogout
所属模块	认证/登录 `auth`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerAuthController#checkerLogout

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

AuthService.deleteAuthAccId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/app-api/auth/checkerLogout
uat	https://dscp-uat.hn12301.net/app-api/auth/checkerLogout
pro	https://dscp-uat.hn12301.net/app-api/auth/checkerLogout	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /auth/checkerLogout

响应示例

（void，无响应体）

处理逻辑

操作日志auth / 核销员登出

逻辑摘要删除（authService.deleteAuthAccId）

内联注释

删除授权用户id

前端调用方

writeoff checkerLogout exact

GET /auth/getRandomCodeImg 未使用管理后台 #

权限-获取图形验证码 · AuthController

基本信息

控制器	com.jxxx.dscp.api.controller.auth.AuthController#getRandomCodeImg
所属模块	认证/登录 `auth`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	GET

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerAuthController#getRandomCodeImg

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

AuthService.setAuthValue

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/auth/getRandomCodeImg
uat	https://dscp-uat.hn12301.net/manage-api/auth/getRandomCodeImg
pro	https://dscp-uat.hn12301.net/manage-api/auth/getRandomCodeImg	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HttpServletResponse

请求体类型：HttpServletResponse（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

GET /auth/getRandomCodeImg

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 randomNumbers（RandomUtil.randomNumbers）；调用 setAuthValue（authService.setAuthValue）；调用 outputImage（RandomVerifyImgCodeUtil.outputImage）

内联注释

生成四位数的随机验证码
将随机码设置在会话中,超时时间5分钟
设置响应头信息
设置相应类型，告诉浏览器输出的内容为图片
设置响应头信息，告诉浏览器不要缓存此内容
生成图片规格w宽 h高

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /auth/login 在用管理后台 #

权限-登录 · AuthController

基本信息

控制器	com.jxxx.dscp.api.controller.auth.AuthController#login
所属模块	认证/登录 `auth`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表system_usersystem_user_relationsystem_oauth2_access_token

ControllerAuthController#login

转换BeanUtils.map → LoginResponse

ServiceUserService#get （UserServiceImpl）

MapperUserMapper#selectById ⇒ 表 system_user

ServiceUserRelationService#queryList （UserRelationServiceImpl）

MapperUserRelationMapper#selectList ⇒ 表 system_user_relation

ServiceOauth2AccessTokenService#get （Oauth2AccessTokenServiceImpl）

MapperOauth2AccessTokenMapper#selectById ⇒ 表 system_oauth2_access_token

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 7

String.equalsAuthService.getAuthValueAuthService.deletePasswordEncoder.matchesOauth2AccessTokenService.createAccessTokenOauth2ClientService.mustGetAuthService.setAuthAccId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/auth/login
uat	https://dscp-uat.hn12301.net/manage-api/auth/login
pro	https://dscp-uat.hn12301.net/manage-api/auth/login	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　LoginRequest

字段	类型	必填	取值/校验	表 / 列	说明
username	String	是	必填	`system_user`.`username`	用户名
password	String	是	必填	`system_user`.`password`	密码

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　LoginResponse　（object）

字段	类型	表 / 列	说明
userId	Long	`system_user_relation`.`user_id`	登录用户id
openId	String	—	用户OPENID
mobile	String	`system_user`.`mobile`	手机号
accessToken	String	`system_oauth2_access_token`.`access_token`	访问令牌
refreshToken	String	`system_oauth2_access_token`.`refresh_token`	刷新令牌
expiresTime	Date	`system_oauth2_access_token`.`expires_time`	过期时间

示例

请求示例（自动生成，仅结构参考）

POST /auth/login

{
  "body": {
    "username": "",
    "password": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "userId": 1,
    "openId": "",
    "mobile": "13800000000",
    "accessToken": "",
    "refreshToken": "",
    "expiresTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（authService.getAuthValue）；调用 isBlank（StringUtil.isBlank）；删除（authService.delete）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

if (!SUPER_CAPTCHA.equals(request.getVerifyCode())) {
// 验证码校验
if (StringUtil.isBlank(sessionVerifyCode)) {
throw ResCode.VERIFY_CODE_IS_NULL.toException("请先获取验证码");
}
if (!sessionVerifyCode.equalsIgnoreCase(request.getVerifyCode())) {
// 移除之前的图片验证码信息
authService.delete(SessionConstants.IMG_CAPTCHA);

前端调用方

dscp-html-manage login exact

POST /auth/logout 在用管理后台 #

权限-登出 · AuthController

基本信息

控制器	com.jxxx.dscp.api.controller.auth.AuthController#logout
所属模块	认证/登录 `auth`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerAuthController#logout

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

AuthService.deleteAuthAccId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/auth/logout
uat	https://dscp-uat.hn12301.net/manage-api/auth/logout
pro	https://dscp-uat.hn12301.net/manage-api/auth/logout	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /auth/logout

响应示例

（void，无响应体）

处理逻辑

操作日志auth / 登出

逻辑摘要删除（authService.deleteAuthAccId）

内联注释

删除授权用户id

前端调用方

dscp-html-manage loginOut exact

POST /auth/oauth2 未使用App #

小程序授权登录 · AuthController

基本信息

控制器	com.jxxx.dscp.api.controller.auth.AuthController#oauth2
所属模块	认证/登录 `auth`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表membercard_bindsystem_oauth2_access_token

ControllerAuthController#oauth2

转换BeanUtils.map → LoginResponse

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceMemberService#update （MemberServiceImpl）

MapperMemberMapper#updateById ⇒ 表 member

ServiceMemberService#add （MemberServiceImpl）

MapperMemberMapper#insert ⇒ 表 member

ServiceCardBindService#queryList （CardBindServiceImpl）

MapperCardBindMapper#selectList ⇒ 表 card_bind

ServiceOauth2AccessTokenService#get （Oauth2AccessTokenServiceImpl）

MapperOauth2AccessTokenMapper#selectById ⇒ 表 system_oauth2_access_token

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 8

MPConfig.getMpAppIdMPConfig.getMpAppSecretMemberService.getMemberChaosTransactionTemplate.executeCardBindService.updateListOauth2AccessTokenService.createAccessTokenOauth2ClientService.mustGetAuthService.setAuthAccId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/app-api/auth/oauth2
uat	https://dscp-uat.hn12301.net/app-api/auth/oauth2
pro	https://dscp-uat.hn12301.net/app-api/auth/oauth2	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HttpServletResponse

请求体类型：HttpServletResponse（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　LoginResponse　（object）

字段	类型	表 / 列	说明
userId	Long	`system_oauth2_access_token`.`user_id`	登录用户id
openId	String	`member`.`open_id`	用户OPENID
mobile	String	`member`.`mobile`	手机号
accessToken	String	`system_oauth2_access_token`.`access_token`	访问令牌
refreshToken	String	`system_oauth2_access_token`.`refresh_token`	刷新令牌
expiresTime	Date	`card_bind`.`expires_time`	过期时间

示例

请求示例（自动生成，仅结构参考）

POST /auth/oauth2

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "userId": 1,
    "openId": "",
    "mobile": "13800000000",
    "accessToken": "",
    "refreshToken": "",
    "expiresTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

操作日志auth / 小程序授权登录

逻辑摘要查询详情（WeixinUtils.getJsCode2AccessToken）；查询详情（memberService.get）；查询详情（memberService.getMember）

内联注释

将请求、响应的编码均设置为UTF-8（防止中文乱码）
用户同意授权后，能获取到code
用户同意授权
网页授权接口访问凭证
用户标识
解密获取用户手机号码
被加密的数据
加密秘钥

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /auth/oauth2Login 未使用H5 #

c端模拟授权登录 · AuthController

基本信息

控制器	com.jxxx.dscp.api.controller.auth.AuthController#oauth2Login
所属模块	认证/登录 `auth`
暴露渠道	H5 （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表membercard_bindsystem_oauth2_access_token

ControllerAuthController#oauth2Login

转换BeanUtils.map → LoginResponse

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceMemberService#update （MemberServiceImpl）

MapperMemberMapper#updateById ⇒ 表 member

ServiceMemberService#add （MemberServiceImpl）

MapperMemberMapper#insert ⇒ 表 member

ServiceCardBindService#queryList （CardBindServiceImpl）

MapperCardBindMapper#selectList ⇒ 表 card_bind

ServiceOauth2AccessTokenService#get （Oauth2AccessTokenServiceImpl）

MapperOauth2AccessTokenMapper#selectById ⇒ 表 system_oauth2_access_token

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 5

ChaosTransactionTemplate.executeCardBindService.updateListOauth2AccessTokenService.createAccessTokenOauth2ClientService.mustGetAuthService.setAuthAccId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/h5-api/auth/oauth2Login
uat	https://dscp-uat.hn12301.net/h5-api/auth/oauth2Login
pro	https://dscp-uat.hn12301.net/h5-api/auth/oauth2Login	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　Oauth2LoginRequest

字段	类型	必填	取值/校验	表 / 列	说明
mobile	String	是	必填	`member`.`mobile`	openId
openId	String	是	必填	`member`.`open_id`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　LoginResponse　（object）

字段	类型	表 / 列	说明
userId	Long	`system_oauth2_access_token`.`user_id`	登录用户id
openId	String	`member`.`open_id`	用户OPENID
mobile	String	`member`.`mobile`	手机号
accessToken	String	`system_oauth2_access_token`.`access_token`	访问令牌
refreshToken	String	`system_oauth2_access_token`.`refresh_token`	刷新令牌
expiresTime	Date	`card_bind`.`expires_time`	过期时间

示例

请求示例（自动生成，仅结构参考）

POST /auth/oauth2Login

{
  "body": {
    "mobile": "13800000000",
    "openId": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "userId": 1,
    "openId": "",
    "mobile": "13800000000",
    "accessToken": "",
    "refreshToken": "",
    "expiresTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

操作日志auth / C端模拟授权登录

逻辑摘要查询详情（memberService.get）；更新（memberService.update）；调用 date（DateUtil.date）

内联注释

查询会员信息
会员存在，则绑定openId
会员不存在，新增会员信息
根据手机号码查询会员绑卡列表
更新绑定信息
根据手机号码查询卡池列表
更新卡池信息
回滚事务

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /auth/oauth2session 未使用H5 #

权限-H5网页授权登录 · AuthController

基本信息

控制器	com.jxxx.dscp.api.controller.auth.AuthController#oauth2session
所属模块	认证/登录 `auth`
暴露渠道	H5 （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表membersystem_oauth2_access_token

ControllerAuthController#oauth2session

转换BeanUtils.map → LoginResponse

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceMemberService#update （MemberServiceImpl）

MapperMemberMapper#updateById ⇒ 表 member

ServiceMemberService#add （MemberServiceImpl）

MapperMemberMapper#insert ⇒ 表 member

ServiceOauth2AccessTokenService#get （Oauth2AccessTokenServiceImpl）

MapperOauth2AccessTokenMapper#selectById ⇒ 表 system_oauth2_access_token

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 6

WeixinConfig.getAppIdWeixinConfig.getAppSecretChaosTransactionTemplate.executeOauth2AccessTokenService.createAccessTokenOauth2ClientService.mustGetAuthService.setAuthAccId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/h5-api/auth/oauth2session
uat	https://dscp-uat.hn12301.net/h5-api/auth/oauth2session
pro	https://dscp-uat.hn12301.net/h5-api/auth/oauth2session	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　Oauth2SessionRequest

字段	类型	必填	取值/校验	表 / 列	说明
code	String	是	必填	—	code

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　LoginResponse　（object）

字段	类型	表 / 列	说明
userId	Long	`system_oauth2_access_token`.`user_id`	登录用户id
openId	String	`member`.`open_id`	用户OPENID
mobile	String	`member`.`mobile`	手机号
accessToken	String	`system_oauth2_access_token`.`access_token`	访问令牌
refreshToken	String	`system_oauth2_access_token`.`refresh_token`	刷新令牌
expiresTime	Date	`system_oauth2_access_token`.`expires_time`	过期时间

示例

请求示例（自动生成，仅结构参考）

POST /auth/oauth2session

{
  "body": {
    "code": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "userId": 1,
    "openId": "",
    "mobile": "13800000000",
    "accessToken": "",
    "refreshToken": "",
    "expiresTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

操作日志auth / H5网页授权登录

逻辑摘要查询详情（WeixinUtils.getOauth2AccessToken）；查询详情（WeixinUtils.getSNSUserInfo）；查询详情（memberService.get）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

用户同意授权
获取网页授权access_token
获取用户openId
网页授权接口访问凭证
获取用户信息
查询会员信息
会员存在，则绑定openId
.openId(openId)

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /auth/queryPermissionList 在用管理后台 #

权限-列表查询 · AuthController

基本信息

控制器	com.jxxx.dscp.api.controller.auth.AuthController#queryPermissionList
所属模块	认证/登录 `auth`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表system_user_rolesystem_rolesystem_role_menusystem_menu

ControllerAuthController#queryPermissionList

ServiceUserRoleService#queryList （UserRoleServiceImpl）

MapperUserRoleMapper#selectList ⇒ 表 system_user_role

ServiceRoleService#queryList （RoleServiceImpl）

MapperRoleMapper#selectList ⇒ 表 system_role

ServiceRoleMenuService#queryList （RoleMenuServiceImpl）

MapperRoleMenuMapper#selectList ⇒ 表 system_role_menu

ServiceMenuService#queryList （MenuServiceImpl）

MapperMenuMapper#selectList ⇒ 表 system_menu

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

UserService.mustGetSessionUserService.getSessionIdSessionUserService.getSessionUser

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/auth/queryPermissionList
uat	https://dscp-uat.hn12301.net/manage-api/auth/queryPermissionList
pro	https://dscp-uat.hn12301.net/manage-api/auth/queryPermissionList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　AuthPermissionResponse　（object）

字段	类型	取值/校验	表 / 列	说明
user	UserSimpleResponse		—	登录用户信息
user.id	Long		`system_user_role`.`id`	用户ID
user.nickname	String		—	用户昵称
user.remark	String		`system_role`.`remark`	备注
user.deptId	Long		—	部门ID
user.postIds	List<Long>		—	岗位编号数组
user.email	String		—	用户邮箱
user.mobile	String		—	手机号码
user.sex	Integer		—	用户性别
user.avatar	String		—	头像地址
user.merchantId	Long		`system_user_role`.`merchant_id`	商户id
user.shopId	Long		`system_user_role`.`shop_id`	商铺id
user.tenantId	Long		`system_user_role`.`tenant_id`	租户编号
user.privilegeType	UserPrivilegeType	2平台级用户商户商铺	—	用户权限类型
roles	List<String>		—	角色标识列表
permissions	List<String>		—	操作权限数据
menus	List<MenuResponse>		—	菜单列表
menus[].id	Long		`system_user_role`.`id`	菜单ID
menus[].name	String		`system_role`.`name`	菜单名称
menus[].permission	String		`system_menu`.`permission`	权限标识
menus[].type	MenuType	1目录2菜单3按钮	`system_menu`.`type`	菜单类型
menus[].sort	Integer		`system_role`.`sort`	显示顺序
menus[].parentId	Long		`system_menu`.`parent_id`	父菜单ID
menus[].path	String		`system_menu`.`path`	路由地址
menus[].icon	String		`system_menu`.`icon`	菜单图标
menus[].component	String		`system_menu`.`component`	组件路径
menus[].componentName	String		`system_menu`.`component_name`	组件名
menus[].isEnabled	Boolean		`system_role`.`is_enabled`	菜单状态
menus[].visible	Boolean		`system_menu`.`visible`	是否可见
menus[].keepAlive	Boolean		`system_menu`.`keep_alive`	是否缓存
menus[].alwaysShow	Boolean		`system_menu`.`always_show`	是否总是显示
menus[].children	List<MenuResponse>		—	子列表
children[].…	（循环引用，已折叠）		—

示例

请求示例（自动生成，仅结构参考）

POST /auth/queryPermissionList

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "user": {
      "id": 1,
      "nickname": "",
      "remark": "",
      "deptId": 1,
      "postIds": "",
      "email": "",
      "mobile": "13800000000",
      "sex": 0,
      "avatar": "",
      "merchantId": 1,
      "shopId": 1,
      "tenantId": 1,
      "privilegeType": "2"
    },
    "roles": "",
    "permissions": "",
    "menus": [
      {
        "id": 1,
        "name": "",
        "permission": "",
        "type": "1",
        "sort": 0,
        "parentId": 1,
        "path": "",
        "icon": "",
        "component": "",
        "componentName": "",
        "isEnabled": false,
        "visible": false,
        "keepAlive": false,
        "alwaysShow": false,
        "children": [
          {}
        ]
      }
    ]
  }
}

处理逻辑

逻辑摘要调用 mustGet（userService.mustGet）；查询详情（sessionService.getSessionId）；列表查询（userRoleService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

1.1 获得用户信息
1.2 获得角色列表
1.3 获得菜单列表
2. 拼接结果返回

前端调用方

dscp-html-manage getInfo exact

POST /auth/simulateLogin 在用管理后台 #

权限-登录 · AuthController

基本信息

控制器	com.jxxx.dscp.api.controller.auth.AuthController#simulateLogin
所属模块	认证/登录 `auth`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表system_usersystem_user_relationsystem_oauth2_access_token

ControllerAuthController#simulateLogin

转换BeanUtils.map → LoginResponse

ServiceUserService#get （UserServiceImpl）

MapperUserMapper#selectById ⇒ 表 system_user

ServiceUserRelationService#queryList （UserRelationServiceImpl）

MapperUserRelationMapper#selectList ⇒ 表 system_user_relation

ServiceOauth2AccessTokenService#get （Oauth2AccessTokenServiceImpl）

MapperOauth2AccessTokenMapper#selectById ⇒ 表 system_oauth2_access_token

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

Oauth2AccessTokenService.createAccessTokenOauth2ClientService.mustGetAuthService.setAuthAccId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/auth/simulateLogin
uat	https://dscp-uat.hn12301.net/manage-api/auth/simulateLogin
pro	https://dscp-uat.hn12301.net/manage-api/auth/simulateLogin	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　LoginRequest

字段	类型	必填	取值/校验	表 / 列	说明
username	String	是	必填	`system_user`.`username`	用户名
password	String	是	必填	`system_user`.`password`	密码

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　LoginResponse　（object）

字段	类型	表 / 列	说明
userId	Long	`system_user_relation`.`user_id`	登录用户id
openId	String	—	用户OPENID
mobile	String	`system_user`.`mobile`	手机号
accessToken	String	`system_oauth2_access_token`.`access_token`	访问令牌
refreshToken	String	`system_oauth2_access_token`.`refresh_token`	刷新令牌
expiresTime	Date	`system_oauth2_access_token`.`expires_time`	过期时间

示例

请求示例（自动生成，仅结构参考）

POST /auth/simulateLogin

{
  "body": {
    "username": "",
    "password": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "userId": 1,
    "openId": "",
    "mobile": "13800000000",
    "accessToken": "",
    "refreshToken": "",
    "expiresTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

操作日志auth / 模拟登录

逻辑摘要查询详情（userService.get）；列表查询（userRelationService.queryList）；查询详情（oauth2AccessTokenService.get）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

查询用户信息
查询用户组织关系
查询是否已登录过
创建token
设置会话信息
TODO 创建登录日志

前端调用方

dscp-html-manage simulateLogin exact

POST /auth/oauth2MeiKe 在用H5 #

认证-美科H5网页授权（code 换 openId） · AuthController

基本信息

控制器	com.jxxx.dscp.api.controller.auth.AuthController#oauth2MeiKe
所属模块	认证/登录 `auth`
暴露渠道	H5 （@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表membersystem_oauth2_access_token

ControllerAuthController#oauth2MeiKe

ServicememberService#get

MapperMemberMapper#get ⇒ 表 member

ServicememberService#update

MapperMemberMapper#update ⇒ 表 member

ServicememberService#add

MapperMemberMapper#add ⇒ 表 member

Serviceoauth2AccessTokenService#get

MapperOauth2AccessTokenMapper#get ⇒ 表 system_oauth2_access_token

Serviceoauth2AccessTokenService#createAccessToken

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/h5-api/auth/oauth2MeiKe
uat	https://dscp-uat.hn12301.net/h5-api/auth/oauth2MeiKe
pro	https://dscp-uat.hn12301.net/h5-api/auth/oauth2MeiKe	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

无（该方法不从请求体取参）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　LoginResponse　（object）

字段	类型	表 / 列	说明
userId	Long	—	登录用户id
openId	String	—	用户OPENID
mobile	String	—	手机号
accessToken	String	—	访问令牌
refreshToken	String	—	刷新令牌
expiresTime	Date	—	过期时间

示例

请求示例

（无请求体）

响应示例

{
  "userId": 0,
  "openId": "",
  "mobile": "",
  "accessToken": "",
  "refreshToken": "",
  "expiresTime": ""
}

处理逻辑

操作日志auth / 美科H5网页授权登录

逻辑摘要memberService.get；memberService.update；memberService.add；oauth2AccessTokenService.get；oauth2AccessTokenService.createAccessToken；authService.setAuthAccId（辅助：authService.setAuthAccId）；完整实现见源码 AuthController#oauth2MeiKe

内联注释

用户同意授权
获取网页授权access_token
获取用户openId
网页授权接口访问凭证
获取用户信息
SNSUserInfo snsUserInfo = WeixinUtils.getSNSUserInfo(accessT
查询会员信息
Member member = memberService.get(MemberQuery.builder().open

前端调用方

zhy-h5 oauth2MeiKe exact