统计 statistics

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

CardModelProfitAccountingController 1/1 在用

POST /profitAccounting/cardModel 在用管理后台 #

（无摘要） · CardModelProfitAccountingController

基本信息

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

调用链路 & 涉及数据表

涉及数据表cardcard_resource_ruleskucard_checkregioncard_bind

ControllerCardModelProfitAccountingController#cardModel

ServiceCardService#queryCardChannelActiveStat （CardServiceImpl）

MapperCardMapper#queryCardChannelActiveStat ⇒ 表 card

MapperCardMapper#queryCardChannelActiveStatAll ⇒ 表 card

MapperCardMapper#queryCardChannelSaleStat ⇒ 表 card

ServiceCardService#queryChannelActiveCardNumber （CardServiceImpl）

MapperCardMapper#queryChannelActiveCardNumber ⇒ 表 card

ServiceCardResourceRuleService#queryList （CardResourceRuleServiceImpl）

MapperCardResourceRuleMapper#selectList ⇒ 表 card_resource_rule

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

ServiceCardCheckService#queryList （CardCheckServiceImpl）

MapperCardCheckMapper#selectList ⇒ 表 card_check

ServiceRegionService#get （RegionServiceImpl）

MapperRegionMapper#selectById ⇒ 表 region

ServiceCardBindService#countBindByCardNo （CardBindServiceImpl）

MapperCardBindMapper#countBindByCardNo ⇒ 表 card_bind

ServiceCardBindService#countBindById （CardBindServiceImpl）

MapperCardBindMapper#countBindById ⇒ 表 card_bind

ServiceCardService#countTotalNum （CardServiceImpl）

MapperCardMapper#countTotalNum ⇒ 表 card

ServiceCardService#countDonationNum （CardServiceImpl）

MapperCardMapper#countDonationNum ⇒ 表 card

ServiceCardService#countYouZhengNum （CardServiceImpl）

MapperCardMapper#countYouZhengNum ⇒ 表 card

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

CardModelCache.getShopCache.get

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardModelProfitAccountingRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardModelId	Long	否	可选(@MvcOptional)	`card`.`card_model_id`
activeTimeRange	Date[]	否	可选(@MvcOptional)	—	激活时间范围

响应参数

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

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

data 结构　CardModelProfitAccountingResponse　（object）

字段	类型	表 / 列
cardModelId	Long	`card`.`card_model_id`
totalActiveCardNum	Integer	—
cardNoNum	Integer	—
totalCheckNum	Integer	—
resourceList	List<CardModelProfitAccountingResource>	—
resourceList[].resourceId	Long	`card_check`.`resource_id`
resourceList[].resourceName	String	`card_resource_rule`.`resource_name`
resourceList[].buyPrice	Integer	`sku`.`buy_price`
resourceList[].checkNum	Integer	—
resourceList[].shopId	Long	`card`.`shop_id`
resourceList[].shopName	String	—
resourceList[].cityId	Long	—
resourceList[].cityName	String	—
oneTimes	Integer	—
twoTimes	Integer	—
threeTimes	Integer	—
fourTimes	Integer	—
fiveTimes	Integer	—
sixTimes	Integer	—
sixPlusTimes	Integer	—
cardBindCardNoCount	Long	—
cardBindIdCount	Long	—
usedPercent	BigDecimal	—
averageUsedTimes	BigDecimal	—
totalNum	Long	—
donationNum	Long	—
youZhengNum	Long	—

示例

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

POST /profitAccounting/cardModel

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardModelId": 1,
    "activeTimeRange": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "cardModelId": 1,
    "totalActiveCardNum": 0,
    "cardNoNum": 0,
    "totalCheckNum": 0,
    "resourceList": [
      {
        "resourceId": 1,
        "resourceName": "",
        "buyPrice": 0,
        "checkNum": 0,
        "shopId": 1,
        "shopName": "",
        "cityId": 1,
        "cityName": ""
      }
    ],
    "oneTimes": 0,
    "twoTimes": 0,
    "threeTimes": 0,
    "fourTimes": 0,
    "fiveTimes": 0,
    "sixTimes": 0,
    "sixPlusTimes": 0,
    "cardBindCardNoCount": 0,
    "cardBindIdCount": 1,
    "usedPercent": 0,
    "averageUsedTimes": 0,
    "totalNum": 0,
    "donationNum": 0,
    "youZhengNum": 0
  }
}

处理逻辑

逻辑摘要调用 queryCardChannelActiveStat（cardService.queryCardChannelActiveStat）；调用 queryChannelActiveCardNumber（cardService.queryChannelActiveCardNumber）；列表查询（cardResourceRuleService.queryList）

内联注释

统计卡种总激活量
response.setCardNoList(cardNoList);
查找卡种所有资源
.status(true)
.resourceStatus(ResourceStatus.UPDATES)
.cardNumberList(cardNoList)
按使用次数统计卡的数量使用情况：1次xxx张，2次xxx张，3次xxx张，4次、5次、6次、6次以上
统计绑卡数量、绑卡人数

前端调用方

dscp-html-manage cardModel exact

CardStatisticsController 3/4 在用

ANY /statistics/exportStatCardIssue 未使用管理后台 #

导出发卡统计 · CardStatisticsController

基本信息

控制器	com.jxxx.dscp.api.controller.statistics.CardStatisticsController#exportStatCardIssue
所属模块	统计 `statistics`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	ANY

调用链路 & 涉及数据表

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

ControllerCardStatisticsController#exportStatCardIssue

ServiceStatisticsService#statCardIssue （StatisticsServiceImpl）

MapperStatisticsMapper#statCardIssues

环境 URL

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

示例

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

ANY /statistics/exportStatCardIssue

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 statCardIssue（statisticsService.statCardIssue）；调用 write（ExcelUtils.write）

内联注释

序号

前端调用方

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

POST /statistics/statCardIssue 在用管理后台 #

旅游卡统计-发卡统计 · CardStatisticsController

基本信息

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

调用链路 & 涉及数据表

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

ControllerCardStatisticsController#statCardIssue

ServiceStatisticsService#statCardIssue （StatisticsServiceImpl）

MapperStatisticsMapper#statCardIssues

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

SessionUserService.isMerchantSessionUserService.getSessionUserSessionUserService.isShop

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardIssueStatRequest

字段	类型	必填	取值/校验	表 / 列	说明
merchantId	Long			—	商户id
shopId	Long			—	商铺id

响应参数

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

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

data 结构　List<CardIssueStatResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
orderNo	Integer	—	序号
cardModelId	Long	—	卡种id
cardModelName	String	—	卡种名称
activeNum	Integer	—	激活数量

示例

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

POST /statistics/statCardIssue

{
  "body": {
    "merchantId": 1,
    "shopId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "orderNo": 0,
      "cardModelId": 1,
      "cardModelName": "",
      "activeNum": 0
    }
  ]
}

处理逻辑

逻辑摘要调用 isMerchant（sessionUserService.isMerchant）；查询详情（sessionUserService.getSessionUser）；调用 isShop（sessionUserService.isShop）

前端调用方

dscp-html-manage statCardIssue exact

POST /statistics/statCardModel 在用开放/回调 #

卡种情况统计 · CardStatisticsController

基本信息

控制器	com.jxxx.dscp.api.controller.statistics.CardStatisticsController#cardActiveStat
所属模块	统计 `statistics`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

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

ControllerCardStatisticsController#cardActiveStat

ServiceStatisticsService#cardActiveStat （StatisticsServiceImpl）

MapperStatisticsMapper#cardActiveStat

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardActiveStatRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardModelId	Long			—
donationFlag	Boolean			—
activeTimeType	Integer			—	1=按日 2=按月
activeTimeRange	Date[]			—
businessName	String	否	可选(@MvcOptional)	—
activeByName	String	否	可选(@MvcOptional)	—

响应参数

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

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

data 结构　PageInfo<CardActiveStatResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
cardModelId	Long	—	旅游卡种ID，关联旅游卡种表ID
cardModelName	String	—	卡种名称，冗余字段
businessId	Long	—	销售(商户/商铺ID) - 销售机构
businessName	String	—	销售商户/商品名称
isDonation	Integer	—
activeById	Long	—	激活人 - 销售账户
activeByName	String	—	激活人名称
dateRange	String	—	周期
activeCount	Long	—	激活数量
noBindCount	Long	—	待绑定数量
bindCount	Long	—	已绑定数量
disableCount	Long	—	禁用数量
expireCount	Long	—	过期数量
chipCount	Long	—	实体卡数量
electronCount	Long	—	电子卡数量

示例

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

POST /statistics/statCardModel

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardModelId": 1,
    "donationFlag": false,
    "activeTimeType": 0,
    "activeTimeRange": "2026-01-01 12:00:00",
    "businessName": "",
    "activeByName": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "cardModelId": 1,
        "cardModelName": "",
        "businessId": 1,
        "businessName": "",
        "isDonation": 0,
        "activeById": 1,
        "activeByName": "",
        "dateRange": "2026-01-01 12:00:00",
        "activeCount": 0,
        "noBindCount": 0,
        "bindCount": 0,
        "disableCount": 0,
        "expireCount": 0,
        "chipCount": 0,
        "electronCount": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 cardActiveStat（statisticsService.cardActiveStat）

前端调用方

dscp-html-manage statCardModel exact

POST /statistics/statCardStat 在用管理后台 #

（无摘要） · CardStatisticsController

基本信息

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

调用链路 & 涉及数据表

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

ControllerCardStatisticsController#statCardStat

ServiceStatisticsService#statCardStat （StatisticsServiceImpl）

MapperStatisticsMapper#statCardStat

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

SessionUserService.isMerchantSessionUserService.getSessionUserSessionUserService.isShop

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardIssueStatRequest

字段	类型	必填	取值/校验	表 / 列	说明
merchantId	Long			—	商户id
shopId	Long			—	商铺id

响应参数

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

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

data 结构　List<CardIssueStatResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
orderNo	Integer	—	序号
cardModelId	Long	—	卡种id
cardModelName	String	—	卡种名称
activeNum	Integer	—	激活数量

示例

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

POST /statistics/statCardStat

{
  "body": {
    "merchantId": 1,
    "shopId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "orderNo": 0,
      "cardModelId": 1,
      "cardModelName": "",
      "activeNum": 0
    }
  ]
}

处理逻辑

逻辑摘要调用 isMerchant（sessionUserService.isMerchant）；查询详情（sessionUserService.getSessionUser）；调用 isShop（sessionUserService.isShop）

前端调用方

dscp-html-manage statCardStat exact

HomeStatisticsController 9/10 在用

POST /statistics/statCardArea 在用管理后台 #

（无摘要） · HomeStatisticsController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_bind

ControllerHomeStatisticsController#statCardArea

ServiceStatisticsService#statCardArea （StatisticsServiceImpl）

MapperCardBindMapper#queryList ⇒ 表 card_bind

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAreaStatRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long			`card_bind`.`card_model_id`
provinceCode	String			—

响应参数

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

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

data 结构　HomeMemberPortraitStatResponse　（object）

字段	类型	表 / 列	说明
genderDistribution	List<BizNumRateStatResponse>	—	性别分dmh
genderDistribution[].label	String	—	标签
genderDistribution[].count	Long	—	计数
genderDistribution[].rate	Double	—	比率
genderDistribution[].code	String	—
genderDistribution[].type	Integer	—
ageDistribution	List<BizNumRateStatResponse>	—	年龄分布
ageDistribution[].label	String	—	标签
ageDistribution[].count	Long	—	计数
ageDistribution[].rate	Double	—	比率
ageDistribution[].code	String	—
ageDistribution[].type	Integer	—
cityDistributions	List<BizNumRateStatResponse>	—	城市分布
cityDistributions[].label	String	—	标签
cityDistributions[].count	Long	—	计数
cityDistributions[].rate	Double	—	比率
cityDistributions[].code	String	—
cityDistributions[].type	Integer	—

示例

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

POST /statistics/statCardArea

{
  "body": {
    "cardModelId": 1,
    "provinceCode": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "genderDistribution": [
      {
        "label": "",
        "count": 0,
        "rate": 0,
        "code": "",
        "type": 0
      }
    ],
    "ageDistribution": [
      {
        "label": "",
        "count": 0,
        "rate": 0,
        "code": "",
        "type": 0
      }
    ],
    "cityDistributions": [
      {
        "label": "",
        "count": 0,
        "rate": 0,
        "code": "",
        "type": 0
      }
    ]
  }
}

处理逻辑

逻辑摘要调用 statCardArea（statisticsService.statCardArea）

前端调用方

dscp-html-manage statCardArea exact

POST /statistics/statHomeCardCheckNum 在用管理后台 #

首页-旅游卡入园人次数统计 · HomeStatisticsController

基本信息

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

调用链路 & 涉及数据表

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

ControllerHomeStatisticsController#statHomeCardCheckNum

ServiceStatisticsService#statHomeCardCheckNum （StatisticsServiceImpl）

MapperStatisticsMapper#statHomeCardCheckNum

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　DatePairRequest

字段	类型	必填	取值/校验	表 / 列	说明
datePair	Date[]	否	可选(@MvcOptional)	—	日期区间

响应参数

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

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

data 结构　List<HomeCardCheckNumStatResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
cardModelName	String	—	卡种名称
checkNum	Integer	—	入园次数

示例

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

POST /statistics/statHomeCardCheckNum

{
  "body": {
    "datePair": "2026-01-01 12:00:00"
  }
}

响应示例

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

处理逻辑

逻辑摘要调用 statHomeCardCheckNum（statisticsService.statHomeCardCheckNum）

前端调用方

dscp-html-manage statHomeCardCheckNum exact

POST /statistics/statHomeCardSalesAmount 在用管理后台 #

首页-旅游卡销售额统计 · HomeStatisticsController

基本信息

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

调用链路 & 涉及数据表

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

ControllerHomeStatisticsController#statHomeCardSalesAmount

ServiceStatisticsService#statHomeCardSalesAmount （StatisticsServiceImpl）

MapperStatisticsMapper#statHomeCardSalesAmount

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　DatePairRequest

字段	类型	必填	取值/校验	表 / 列	说明
datePair	Date[]	否	可选(@MvcOptional)	—	日期区间

响应参数

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

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

data 结构　List<HomeCardSalesAmountStatResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
cardModelName	String	—	卡种名称
salesAmount	BigDecimal	—	旅游卡销售额（元）

示例

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

POST /statistics/statHomeCardSalesAmount

{
  "body": {
    "datePair": "2026-01-01 12:00:00"
  }
}

响应示例

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

处理逻辑

逻辑摘要调用 statHomeCardSalesAmount（statisticsService.statHomeCardSalesAmount）

前端调用方

dscp-html-manage statHomeCardSalesAmount exact

POST /statistics/statHomeCardSalesNum 在用管理后台 #

首页-旅游卡售卡数统计 · HomeStatisticsController

基本信息

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

调用链路 & 涉及数据表

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

ControllerHomeStatisticsController#statHomeCardSalesNum

ServiceStatisticsService#statHomeCardSalesNum （StatisticsServiceImpl）

MapperStatisticsMapper#statHomeCardSalesNum

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　DatePairRequest

字段	类型	必填	取值/校验	表 / 列	说明
datePair	Date[]	否	可选(@MvcOptional)	—	日期区间

响应参数

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

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

data 结构　List<HomeCardSalesNumStatResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
cardModelName	String	—	卡种名称
salesNum	Integer	—	售卡数

示例

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

POST /statistics/statHomeCardSalesNum

{
  "body": {
    "datePair": "2026-01-01 12:00:00"
  }
}

响应示例

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

处理逻辑

逻辑摘要调用 statHomeCardSalesNum（statisticsService.statHomeCardSalesNum）

前端调用方

dscp-html-manage statHomeCardSalesNum exact

POST /statistics/statHomeDailyData 在用管理后台 #

首页-日常数据统计 · HomeStatisticsController

基本信息

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

调用链路 & 涉及数据表

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

ControllerHomeStatisticsController#statHomeDailyData

ServiceStatisticsService#statHomeDailyData （StatisticsServiceImpl）

MapperStatisticsMapper#statHomeDailyData

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardDataStatRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	否	可选(@MvcOptional)	—	卡种id
datePair	Date[]	否	可选(@MvcOptional)	—	日期区间

响应参数

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

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

data 结构　HomeDailyDataStatResponse　（object）

字段	类型	表 / 列	说明
salesAmount	BigDecimal	—	旅游卡营收（万元）
salesNum	Integer	—	售卡数
activeNum	Integer	—	激活数
checkNum	Integer	—	入园人次

示例

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

POST /statistics/statHomeDailyData

{
  "body": {
    "cardModelId": 1,
    "datePair": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "salesAmount": 0,
    "salesNum": 0,
    "activeNum": 0,
    "checkNum": 0
  }
}

处理逻辑

逻辑摘要调用 statHomeDailyData（statisticsService.statHomeDailyData）

前端调用方

dscp-html-manage statHomeDailyData exact

POST /statistics/statHomeMemberPortrait 在用管理后台 #

首页-持卡人画像统计 · HomeStatisticsController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_bind

ControllerHomeStatisticsController#statHomeMemberPortrait

ServiceStatisticsService#statHomeMemberPortrait （StatisticsServiceImpl）

MapperCardBindMapper#queryList ⇒ 表 card_bind

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardModelIdNullableRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	否	可选(@MvcOptional)	`card_bind`.`card_model_id`	卡种id

响应参数

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

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

data 结构　HomeMemberPortraitStatResponse　（object）

字段	类型	表 / 列	说明
genderDistribution	List<BizNumRateStatResponse>	—	性别分dmh
genderDistribution[].label	String	—	标签
genderDistribution[].count	Long	—	计数
genderDistribution[].rate	Double	—	比率
genderDistribution[].code	String	—
genderDistribution[].type	Integer	—
ageDistribution	List<BizNumRateStatResponse>	—	年龄分布
ageDistribution[].label	String	—	标签
ageDistribution[].count	Long	—	计数
ageDistribution[].rate	Double	—	比率
ageDistribution[].code	String	—
ageDistribution[].type	Integer	—
cityDistributions	List<BizNumRateStatResponse>	—	城市分布
cityDistributions[].label	String	—	标签
cityDistributions[].count	Long	—	计数
cityDistributions[].rate	Double	—	比率
cityDistributions[].code	String	—
cityDistributions[].type	Integer	—

示例

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

POST /statistics/statHomeMemberPortrait

{
  "body": {
    "cardModelId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "genderDistribution": [
      {
        "label": "",
        "count": 0,
        "rate": 0,
        "code": "",
        "type": 0
      }
    ],
    "ageDistribution": [
      {
        "label": "",
        "count": 0,
        "rate": 0,
        "code": "",
        "type": 0
      }
    ],
    "cityDistributions": [
      {
        "label": "",
        "count": 0,
        "rate": 0,
        "code": "",
        "type": 0
      }
    ]
  }
}

处理逻辑

逻辑摘要调用 statHomeMemberPortrait（statisticsService.statHomeMemberPortrait）

前端调用方

dscp-html-manage statHomeMemberPortrait exact

POST /statistics/statHomeSalesAmount 在用开放/回调 #

首页-总销售额统计 · HomeStatisticsController

基本信息

控制器	com.jxxx.dscp.api.controller.statistics.HomeStatisticsController#statHomeSalesAmount
所属模块	统计 `statistics`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

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

ControllerHomeStatisticsController#statHomeSalesAmount

ServiceStatisticsService#statHomeSalesAmountDay （StatisticsServiceImpl）

MapperStatisticsMapper#statHomeSalesAmount

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

StatisticsService.statHomeSalesAmountMonthStatisticsService.statHomeSalesAmountYear

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HomeSalesAmountStatRequest

字段	类型	必填	取值/校验	表 / 列	说明
periodType	PeriodType	否	1日2月3年	—	统计类型，1日统计2月统计3年统计
datePair	Date[]	否	可选(@MvcOptional)	—	日期区间

响应参数

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

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

data 结构　List<HomeSalesAmountStatResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
time	String	—	时间
cardSalesAmount	BigDecimal	—	旅游卡销售额（元）
goodsSalesAmount	BigDecimal	—	其它商品销售额（元）

示例

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

POST /statistics/statHomeSalesAmount

{
  "body": {
    "periodType": "1",
    "datePair": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "time": "2026-01-01 12:00:00",
      "cardSalesAmount": 0,
      "goodsSalesAmount": 0
    }
  ]
}

处理逻辑

逻辑摘要调用 statHomeSalesAmountDay（statisticsService.statHomeSalesAmountDay）；调用 statHomeSalesAmountMonth（statisticsService.statHomeSalesAmountMonth）；调用 statHomeSalesAmountYear（statisticsService.statHomeSalesAmountYear）

前端调用方

dscp-html-manage statHomeSalesAmount exact

POST /statistics/statHomeSceneryCheckAvgNum 在用管理后台 #

首页-景区人均入园次数 · HomeStatisticsController

基本信息

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

调用链路 & 涉及数据表

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

ControllerHomeStatisticsController#statHomeSceneryCheckAvgNum

ServiceStatisticsService#statHomeSceneryCheckAvgNum （StatisticsServiceImpl）

MapperStatisticsMapper#queryHomeSceneryCheckAvgNumPage

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardDataStatPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardModelId	Long	否	可选(@MvcOptional)	—	卡种id
datePair	Date[]	否	可选(@MvcOptional)	—	日期区间

响应参数

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

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

data 结构　PageInfo<HomeCardCheckAvgNumResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
seqNo	Integer	—	序号
sceneryName	String	—	景区名称
avgCheckNum	BigDecimal	—	人均入园人次

示例

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

POST /statistics/statHomeSceneryCheckAvgNum

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardModelId": 1,
    "datePair": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "seqNo": 0,
        "sceneryName": "",
        "avgCheckNum": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 statHomeSceneryCheckAvgNum（statisticsService.statHomeSceneryCheckAvgNum）

前端调用方

dscp-html-manage statHomeSceneryCheckAvgNum exact

POST /statistics/statHomeSceneryCheckNumRank 在用管理后台 #

首页-景区入园人次排行 · HomeStatisticsController

基本信息

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

调用链路 & 涉及数据表

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

ControllerHomeStatisticsController#statHomeSceneryCheckNumRank

ServiceStatisticsService#statHomeSceneryCheckNumRank （StatisticsServiceImpl）

MapperStatisticsMapper#queryHomeSceneryCheckNumRankPage

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardDataStatPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardModelId	Long	否	可选(@MvcOptional)	—	卡种id
datePair	Date[]	否	可选(@MvcOptional)	—	日期区间

响应参数

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

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

data 结构　PageInfo<HomeCardCheckNumRankResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
seqNo	Integer	—	序号
sceneryName	String	—	景区名称
checkNum	Integer	—	入园人次

示例

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

POST /statistics/statHomeSceneryCheckNumRank

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardModelId": 1,
    "datePair": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "seqNo": 0,
        "sceneryName": "",
        "checkNum": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 statHomeSceneryCheckNumRank（statisticsService.statHomeSceneryCheckNumRank）

前端调用方

dscp-html-manage statHomeSceneryCheckNumRank exact

GET /statistics/statHomeTest 未使用管理后台 #

（无摘要） · HomeStatisticsController

基本信息

控制器	com.jxxx.dscp.api.controller.statistics.HomeStatisticsController#statHomeTest
所属模块	统计 `statistics`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	GET

调用链路 & 涉及数据表

涉及数据表card_bind

ControllerHomeStatisticsController#statHomeTest

ServiceStatisticsService#statHomeTest （StatisticsServiceImpl）

MapperCardBindMapper#queryList ⇒ 表 card_bind

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/statistics/statHomeTest
uat	https://dscp-uat.hn12301.net/manage-api/statistics/statHomeTest
pro	https://dscp-uat.hn12301.net/manage-api/statistics/statHomeTest	（仓库 .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 结构　HomeMemberPortraitStatResponse　（object）

字段	类型	表 / 列	说明
genderDistribution	List<BizNumRateStatResponse>	—	性别分dmh
genderDistribution[].label	String	—	标签
genderDistribution[].count	Long	—	计数
genderDistribution[].rate	Double	—	比率
genderDistribution[].code	String	—
genderDistribution[].type	Integer	—
ageDistribution	List<BizNumRateStatResponse>	—	年龄分布
ageDistribution[].label	String	—	标签
ageDistribution[].count	Long	—	计数
ageDistribution[].rate	Double	—	比率
ageDistribution[].code	String	—
ageDistribution[].type	Integer	—
cityDistributions	List<BizNumRateStatResponse>	—	城市分布
cityDistributions[].label	String	—	标签
cityDistributions[].count	Long	—	计数
cityDistributions[].rate	Double	—	比率
cityDistributions[].code	String	—
cityDistributions[].type	Integer	—

示例

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

GET /statistics/statHomeTest

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "genderDistribution": [
      {
        "label": "",
        "count": 0,
        "rate": 0,
        "code": "",
        "type": 0
      }
    ],
    "ageDistribution": [
      {
        "label": "",
        "count": 0,
        "rate": 0,
        "code": "",
        "type": 0
      }
    ],
    "cityDistributions": [
      {
        "label": "",
        "count": 0,
        "rate": 0,
        "code": "",
        "type": 0
      }
    ]
  }
}

处理逻辑

逻辑摘要调用 statHomeTest（statisticsService.statHomeTest）

前端调用方

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