分配 distribute

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

DistributeAmountController 6/7 在用

POST /distributeAmount/deleteDistributeBatch 在用管理后台 #

删除批次（级联删除明细 + 清理递延台账） · DistributeAmountController

基本信息

控制器	com.jxxx.dscp.api.controller.distribute.DistributeAmountController#deleteDistributeBatch
所属模块	分配 `distribute`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表distribute_batchdistribute_deferred_ledgerdistribute_detail

ControllerDistributeAmountController#deleteDistributeBatch

MapperDistributeBatchService.getMapper#selectById ⇒ 表 distribute_batch

MapperDistributeDeferredLedgerService.getMapper#delete ⇒ 表 distribute_deferred_ledger

MapperDistributeBatchService.getMapper#deleteById ⇒ 表 distribute_batch

ServiceDistributeDetailService#queryList （DistributeDetailServiceImpl）

MapperDistributeDetailMapper#selectList ⇒ 表 distribute_detail

ServiceDistributeDetailService#delete （DistributeDetailServiceImpl）

MapperDistributeDetailMapper#deleteById ⇒ 表 distribute_detail

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`distribute_batch`.`id`	id

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /distributeAmount/deleteDistributeBatch

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志distribute / 删除分配批次

逻辑摘要查询详情（distributeBatchService.getMapper）；列表查询（distributeDetailService.queryList）；查询详情（distributeDeferredLedgerService.getMapper）

内联注释

清理该月份对应的递延台账

前端调用方

dscp-html-manage deleteDistributeBatch exact

POST /distributeAmount/executeCalc 在用管理后台 #

执行计算（保存到数据库），支持多月 · DistributeAmountController

基本信息

控制器	com.jxxx.dscp.api.controller.distribute.DistributeAmountController#executeCalc
所属模块	分配 `distribute`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表distribute_batchcard_modeldistribute_detail

ControllerDistributeAmountController#executeCalc

ServiceDistributeAmountService#executeCalc （DistributeAmountServiceImpl）

MapperDistributeBatchService.getMapper#selectList ⇒ 表 distribute_batch

MapperDistributeBatchService.getMapper#delete ⇒ 表 distribute_batch

MapperCardModelService.getMapper#selectById ⇒ 表 card_model

ServiceDistributeDetailService#delete （DistributeDetailServiceImpl）

MapperDistributeDetailMapper#deleteById ⇒ 表 distribute_detail

ServiceDistributeBatchService#add （DistributeBatchServiceImpl）

MapperDistributeBatchMapper#insert ⇒ 表 distribute_batch

ServiceDistributeDetailService#add （DistributeDetailServiceImpl）

MapperDistributeDetailMapper#insert ⇒ 表 distribute_detail

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

SessionUserService.getSessionIdChaosTransactionTemplate.execute

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　DistributeAmountCalcRequest

字段	类型	必填	取值/校验	表 / 列	说明
year	Integer	是	必填/Min(value=2020, message="年份不合法")/Max(value=2099, message="年份不合法")	`distribute_batch`.`year`
month	Integer	否	可选(@MvcOptional)	`distribute_batch`.`month`
months	List<Integer>	否	可选(@MvcOptional)	—	多月批量计算（可选，优先于 month）
cardModelIds	List<Long>	否	可选(@MvcOptional)	—	指定卡种ID列表（可选，为空时计算全部三类卡）
ratio	Integer	否	可选(@MvcOptional)	`distribute_batch`.`ratio`	分润比例（可选，百分比整数，如 80 表示 80%，默认 80）
calcMode	String	否	可选(@MvcOptional)	`distribute_batch`.`calc_mode`	计算模式：ratio（按比例，默认）/ fixed（固定金额）
fixedAmount	Long	否	可选(@MvcOptional)	`distribute_batch`.`fixed_amount`	固定金额（单位：分），calcMode 为 fixed 时使用

响应参数

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

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

data 结构　List<DistributeBatch>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`distribute_batch`.`id`
batchNo	String	`distribute_batch`.`batch_no`	批次编号
year	Integer	`distribute_batch`.`year`	年份
month	Integer	`distribute_batch`.`month`	月份
quarter	Integer	`distribute_batch`.`quarter`	季度
cardModelId	Long	`distribute_batch`.`card_model_id`	卡种ID
cardModelName	String	`distribute_batch`.`card_model_name`	卡种名称
cardModelPrice	Integer	`distribute_batch`.`card_model_price`	卡种售价（分）
validUserCount	Integer	`distribute_batch`.`valid_user_count`	当月有效用户数
totalDistributeAmount	Long	`distribute_batch`.`total_distribute_amount`	该卡种当月可分配总额（分）
parkCount	Integer	`distribute_batch`.`park_count`	参与分配的景区数量
status	Integer	`distribute_batch`.`status`	状态：1已计算, 2已确认, 3已导出
execTime	Date	`distribute_batch`.`exec_time`	执行时间
execBy	Long	`distribute_batch`.`exec_by`	执行人
ratio	Integer	`distribute_batch`.`ratio`	分润比例（百分比整数，如 80 表示 80%）
calcMode	String	`distribute_batch`.`calc_mode`	计算模式：ratio（按比例）/ fixed（固定金额），默认 ratio
fixedAmount	Long	`distribute_batch`.`fixed_amount`	固定金额（单位：分），calcMode 为 fixed 时使用
isDeleted	Boolean	`distribute_batch`.`is_deleted`	逻辑删除
createdBy	Long	`distribute_batch`.`created_by`	创建人
createdTime	Date	`distribute_batch`.`created_time`	创建时间
updatedBy	Long	`distribute_batch`.`updated_by`	更新人
updatedTime	Date	`distribute_batch`.`updated_time`	更新时间

示例

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

POST /distributeAmount/executeCalc

{
  "body": {
    "year": 0,
    "month": 0,
    "months": "",
    "cardModelIds": "",
    "ratio": 0,
    "calcMode": "",
    "fixedAmount": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "batchNo": "",
      "year": 0,
      "month": 0,
      "quarter": 0,
      "cardModelId": 1,
      "cardModelName": "",
      "cardModelPrice": 0,
      "validUserCount": 1,
      "totalDistributeAmount": 0,
      "parkCount": 0,
      "status": 0,
      "execTime": "2026-01-01 12:00:00",
      "execBy": 0,
      "ratio": 0,
      "calcMode": "",
      "fixedAmount": 0,
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

操作日志distribute / 执行分配计算

逻辑摘要调用 isNotEmpty（CollUtil.isNotEmpty）；调用 executeCalc（distributeAmountService.executeCalc）

前端调用方

dscp-html-manage executeCalc exact

POST /distributeAmount/exportDistributeDetail 未使用管理后台 #

导出明细为 Excel · DistributeAmountController

基本信息

控制器	com.jxxx.dscp.api.controller.distribute.DistributeAmountController#exportDistributeDetail
所属模块	分配 `distribute`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表distribute_batchdistribute_detail

ControllerDistributeAmountController#exportDistributeDetail

MapperDistributeBatchService.getMapper#selectById ⇒ 表 distribute_batch

ServiceDistributeDetailService#queryList （DistributeDetailServiceImpl）

MapperDistributeDetailMapper#selectList ⇒ 表 distribute_detail

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/distributeAmount/exportDistributeDetail
uat	https://dscp-uat.hn12301.net/manage-api/distributeAmount/exportDistributeDetail
pro	https://dscp-uat.hn12301.net/manage-api/distributeAmount/exportDistributeDetail	（仓库 .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 —— 无返回数据

示例

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

POST /distributeAmount/exportDistributeDetail

响应示例

（void，无响应体）

处理逻辑

逻辑摘要查询详情（distributeBatchService.getMapper）；列表查询（distributeDetailService.queryList）；调用 write（ExcelUtils.write）

前端调用方

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

POST /distributeAmount/getDistributeBatch 在用管理后台 #

批次详情 · DistributeAmountController

基本信息

控制器	com.jxxx.dscp.api.controller.distribute.DistributeAmountController#getDistributeBatch
所属模块	分配 `distribute`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表distribute_batch

ControllerDistributeAmountController#getDistributeBatch

MapperDistributeBatchService.getMapper#selectById ⇒ 表 distribute_batch

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`distribute_batch`.`id`	id

响应参数

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

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

data 结构　DistributeBatch　（object）

字段	类型	表 / 列	说明
id	Long	`distribute_batch`.`id`
batchNo	String	`distribute_batch`.`batch_no`	批次编号
year	Integer	`distribute_batch`.`year`	年份
month	Integer	`distribute_batch`.`month`	月份
quarter	Integer	`distribute_batch`.`quarter`	季度
cardModelId	Long	`distribute_batch`.`card_model_id`	卡种ID
cardModelName	String	`distribute_batch`.`card_model_name`	卡种名称
cardModelPrice	Integer	`distribute_batch`.`card_model_price`	卡种售价（分）
validUserCount	Integer	`distribute_batch`.`valid_user_count`	当月有效用户数
totalDistributeAmount	Long	`distribute_batch`.`total_distribute_amount`	该卡种当月可分配总额（分）
parkCount	Integer	`distribute_batch`.`park_count`	参与分配的景区数量
status	Integer	`distribute_batch`.`status`	状态：1已计算, 2已确认, 3已导出
execTime	Date	`distribute_batch`.`exec_time`	执行时间
execBy	Long	`distribute_batch`.`exec_by`	执行人
ratio	Integer	`distribute_batch`.`ratio`	分润比例（百分比整数，如 80 表示 80%）
calcMode	String	`distribute_batch`.`calc_mode`	计算模式：ratio（按比例）/ fixed（固定金额），默认 ratio
fixedAmount	Long	`distribute_batch`.`fixed_amount`	固定金额（单位：分），calcMode 为 fixed 时使用
isDeleted	Boolean	`distribute_batch`.`is_deleted`	逻辑删除
createdBy	Long	`distribute_batch`.`created_by`	创建人
createdTime	Date	`distribute_batch`.`created_time`	创建时间
updatedBy	Long	`distribute_batch`.`updated_by`	更新人
updatedTime	Date	`distribute_batch`.`updated_time`	更新时间

示例

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

POST /distributeAmount/getDistributeBatch

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "batchNo": "",
    "year": 0,
    "month": 0,
    "quarter": 0,
    "cardModelId": 1,
    "cardModelName": "",
    "cardModelPrice": 0,
    "validUserCount": 1,
    "totalDistributeAmount": 0,
    "parkCount": 0,
    "status": 0,
    "execTime": "2026-01-01 12:00:00",
    "execBy": 0,
    "ratio": 0,
    "calcMode": "",
    "fixedAmount": 0,
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（distributeBatchService.getMapper）

前端调用方

dscp-html-manage getDistributeBatch exact

POST /distributeAmount/previewCalc 在用管理后台 #

预览计算（不保存），每月数据独立展示 · DistributeAmountController

基本信息

控制器	com.jxxx.dscp.api.controller.distribute.DistributeAmountController#previewCalc
所属模块	分配 `distribute`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

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

ControllerDistributeAmountController#previewCalc

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

DistributeAmountService.previewCalc

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　DistributeAmountCalcRequest

字段	类型	必填	取值/校验	表 / 列	说明
year	Integer	是	必填/Min(value=2020, message="年份不合法")/Max(value=2099, message="年份不合法")	—
month	Integer	否	可选(@MvcOptional)	—
months	List<Integer>	否	可选(@MvcOptional)	—	多月批量计算（可选，优先于 month）
cardModelIds	List<Long>	否	可选(@MvcOptional)	—	指定卡种ID列表（可选，为空时计算全部三类卡）
ratio	Integer	否	可选(@MvcOptional)	—	分润比例（可选，百分比整数，如 80 表示 80%，默认 80）
calcMode	String	否	可选(@MvcOptional)	—	计算模式：ratio（按比例，默认）/ fixed（固定金额）
fixedAmount	Long	否	可选(@MvcOptional)	—	固定金额（单位：分），calcMode 为 fixed 时使用

响应参数

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

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

data 结构　List<Map<String, Object>>　（list）

标量/Map/外部类型：List<Map<String, Object>>

示例

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

POST /distributeAmount/previewCalc

{
  "body": {
    "year": 0,
    "month": 0,
    "months": "",
    "cardModelIds": "",
    "ratio": 0,
    "calcMode": "",
    "fixedAmount": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": []
}

处理逻辑

逻辑摘要调用 isNotEmpty（CollUtil.isNotEmpty）；调用 previewCalc（distributeAmountService.previewCalc）

前端调用方

dscp-html-manage previewCalc exact

POST /distributeAmount/queryDistributeBatchPage 在用管理后台 #

批次列表分页查询 · DistributeAmountController

基本信息

控制器	com.jxxx.dscp.api.controller.distribute.DistributeAmountController#queryDistributeBatchPage
所属模块	分配 `distribute`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表distribute_batch

ControllerDistributeAmountController#queryDistributeBatchPage

转换BeanUtils.map → DistributeBatchQuery

转换BeanUtils.map → PageParam

MapperDistributeBatchService.getMapper#queryPage ⇒ 表 distribute_batch

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

DistributeBatchService.applyWrapper

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　DistributeBatchPageRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 PageParam）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 PageParam）
year	Integer		`distribute_batch`.`year`
month	Integer		`distribute_batch`.`month`
quarter	Integer		`distribute_batch`.`quarter`
cardModelName	String		`distribute_batch`.`card_model_name`

响应参数

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

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

data 结构　PageInfo<DistributeBatch>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`distribute_batch`.`id`
batchNo	String	`distribute_batch`.`batch_no`	批次编号
year	Integer	`distribute_batch`.`year`	年份
month	Integer	`distribute_batch`.`month`	月份
quarter	Integer	`distribute_batch`.`quarter`	季度
cardModelId	Long	`distribute_batch`.`card_model_id`	卡种ID
cardModelName	String	`distribute_batch`.`card_model_name`	卡种名称
cardModelPrice	Integer	`distribute_batch`.`card_model_price`	卡种售价（分）
validUserCount	Integer	`distribute_batch`.`valid_user_count`	当月有效用户数
totalDistributeAmount	Long	`distribute_batch`.`total_distribute_amount`	该卡种当月可分配总额（分）
parkCount	Integer	`distribute_batch`.`park_count`	参与分配的景区数量
status	Integer	`distribute_batch`.`status`	状态：1已计算, 2已确认, 3已导出
execTime	Date	`distribute_batch`.`exec_time`	执行时间
execBy	Long	`distribute_batch`.`exec_by`	执行人
ratio	Integer	`distribute_batch`.`ratio`	分润比例（百分比整数，如 80 表示 80%）
calcMode	String	`distribute_batch`.`calc_mode`	计算模式：ratio（按比例）/ fixed（固定金额），默认 ratio
fixedAmount	Long	`distribute_batch`.`fixed_amount`	固定金额（单位：分），calcMode 为 fixed 时使用
isDeleted	Boolean	`distribute_batch`.`is_deleted`	逻辑删除
createdBy	Long	`distribute_batch`.`created_by`	创建人
createdTime	Date	`distribute_batch`.`created_time`	创建时间
updatedBy	Long	`distribute_batch`.`updated_by`	更新人
updatedTime	Date	`distribute_batch`.`updated_time`	更新时间

示例

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

POST /distributeAmount/queryDistributeBatchPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "year": 0,
    "month": 0,
    "quarter": 0,
    "cardModelName": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "batchNo": "",
        "year": 0,
        "month": 0,
        "quarter": 0,
        "cardModelId": 1,
        "cardModelName": "",
        "cardModelPrice": 0,
        "validUserCount": 1,
        "totalDistributeAmount": 0,
        "parkCount": 0,
        "status": 0,
        "execTime": "2026-01-01 12:00:00",
        "execBy": 0,
        "ratio": 0,
        "calcMode": "",
        "fixedAmount": 0,
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 applyWrapper（distributeBatchService.applyWrapper）；查询详情（distributeBatchService.getMapper）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryDistributeBatchPage exact

POST /distributeAmount/queryDistributeDetailPage 在用管理后台 #

明细列表分页查询 · DistributeAmountController

基本信息

控制器	com.jxxx.dscp.api.controller.distribute.DistributeAmountController#queryDistributeDetailPage
所属模块	分配 `distribute`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表distribute_detail

ControllerDistributeAmountController#queryDistributeDetailPage

转换BeanUtils.map → DistributeDetailQuery

转换BeanUtils.map → PageParam

MapperDistributeDetailService.getMapper#queryPage ⇒ 表 distribute_detail

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

DistributeDetailService.applyWrapper

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　DistributeDetailPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 PageParam）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 PageParam）
batchId	Long	是	必填	`distribute_detail`.`batch_id`
sceneryName	String			`distribute_detail`.`scenery_name`

响应参数

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

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

data 结构　PageInfo<DistributeDetail>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`distribute_detail`.`id`
batchId	Long	`distribute_detail`.`batch_id`	关联 distribute_batch.id
shopId	Long	`distribute_detail`.`shop_id`	景区ID
sceneryName	String	`distribute_detail`.`scenery_name`	景区名称
recent6mEntryCount	Integer	`distribute_detail`.`recent6m_entry_count`	最近6个月入园人次总和
monthlyAvgEntry	Integer	`distribute_detail`.`monthly_avg_entry`	floor(6个月总人次/6)
ticketUniformPrice	Long	`distribute_detail`.`ticket_uniform_price`	景区签约价（分）
distributeFactorValue	Long	`distribute_detail`.`distribute_factor_value`	分子值（签约价×月均人次）
distributeFactor	BigDecimal	`distribute_detail`.`distribute_factor`	分配系数
distributeAmount	Long	`distribute_detail`.`distribute_amount`	分配金额（分）
monthlyEntryCount	Integer	`distribute_detail`.`monthly_entry_count`	当月入园人次
deferredEntries	Integer	`distribute_detail`.`deferred_entries`	历史递延人次（来自台账）
distributedEntries	Integer	`distribute_detail`.`distributed_entries`	当月参与分配人次（= monthlyEntryCount/6 + deferredEntries）
distributableAmount	Long	`distribute_detail`.`distributable_amount`	可分配签约额（分）= ticketUniformPrice × distributedEntries
resourceId	Long	—	景区资源ID（仅计算时使用，不持久化）
isDeleted	Boolean	`distribute_detail`.`is_deleted`	逻辑删除
createdBy	Long	`distribute_detail`.`created_by`	创建人
createdTime	Date	`distribute_detail`.`created_time`	创建时间
updatedBy	Long	`distribute_detail`.`updated_by`	更新人
updatedTime	Date	`distribute_detail`.`updated_time`	更新时间

示例

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

POST /distributeAmount/queryDistributeDetailPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "batchId": 1,
    "sceneryName": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "batchId": 1,
        "shopId": 1,
        "sceneryName": "",
        "recent6mEntryCount": 0,
        "monthlyAvgEntry": 0,
        "ticketUniformPrice": 0,
        "distributeFactorValue": 0,
        "distributeFactor": 0,
        "distributeAmount": 0,
        "monthlyEntryCount": 0,
        "deferredEntries": 0,
        "distributedEntries": 0,
        "distributableAmount": 0,
        "resourceId": 1,
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 applyWrapper（distributeDetailService.applyWrapper）；查询详情（distributeDetailService.getMapper）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryDistributeDetailPage exact