============================================================
接口变更说明(相对当前已提交代码)
日期: 2026-06-26   版本: v3.0.1   作者: rk
依据: git 工作区相对 master 已提交代码的实际差异
============================================================


【管理端 platform】(Shiro 鉴权)
------------------------------------------------------------
新增接口:
一、抖音核销配置(加在既有 SystemDictDataController,/system/dictData)
  1. POST /system/dictData/getDouyinConfigDTO
     查询抖音核销配置(四项字典值)。无入参。
  2. POST /system/dictData/updateDouyinAppConfigDTO
     更新抖音应用配置(client_key/client_secret/account_id)。
     入参(body):clientKey / clientSecret / accountId
  3. POST /system/dictData/updateDouyinPoiIdDTO
     更新核销门店ID(单门店)。
     入参(query):poiId

二、抖音券核销(新文件 DouyinVerifyController,/business/douyinVerify)
  4. POST /business/douyinVerify/page        核销记录分页(对外)
  5. POST /business/douyinVerify/poiList     查询抖音商户下门店列表(无入参,返回 List<DouyinShopPoiVO>:poiId + poiName 门店名称成对)
  6. POST /business/douyinVerify/cancel      撤销核销(管理端,不受1小时限制)

三、抖音商品(新文件 DouyinProductController,/business/douyinProduct)
  7. POST /business/douyinProduct/sync       从抖音同步商品(全量)
  8. POST /business/douyinProduct/page       分页查询
  9. GET  /business/douyinProduct/{id}       根据ID查询(含SKU)
  10. POST /business/douyinProduct/bindDiscount  绑定/解绑本地套餐

四、数据报表(新文件 ReportController,/business/report)
     鉴权:无 @RequiresPermissions,仅 Shiro 登录校验,登录后台即可访问。
     Service 复用 services 模块 ReportService(与 web 端 /web/report 同源)。
  11. GET /business/report/incomeStat30       近30天收益统计(按日柱状图+累计+环比/同比)
  12. GET /business/report/bikeUsageStat      车辆使用情况(自行车/电动车 × 使用中/空闲;禁用车辆排除)
  13. GET /business/report/packageSourceStat  套餐销售来源(本月/本年 × 抖音兑换/小程序购买)
  14. GET /business/report/dashboard          综合看板(本月/昨日/今日收益+订单数+车辆总数+客户数)

     各接口出参字段:
     · incomeStat30       → IncomeStatVO(dailyList/totalIncome/环比/同比),固定近30天,无入参
     · bikeUsageStat      → BikeUsageStatVO:bikeIdle/bikeInUse/eleBikeIdle/eleBikeInUse
     · packageSourceStat  → PackageSourceStatVO:month{douyinCount,miniCount} + year{douyinCount,miniCount}
     · dashboard          → DashboardVO:monthIncome/yesterdayIncome/todayIncome(元)
                                   + monthOrderCount/yesterdayOrderCount/todayOrderCount
                                   + totalBikeCount + totalMemberCount/yesterdayNewMember/todayNewMember


============================================================

【接口端 web】(JWT 鉴权)
------------------------------------------------------------
新增接口:
一、抖音(新文件 DouyinApi,/web/douyin)
  1. GET  /web/douyin/testQuery     联调测试:从抖音全量同步商品入库
  2. GET  /web/douyin/testPoiList   联调测试:查询抖音商户下门店ID列表(返回 List<String>)
  3. POST /web/douyin/scanVerify    扫码一步核销(验券准备+核销合并)。@LoginRequired + @PreventRepeat
     入参(body):qrContent(扫码内容)/ code(券码明文)二选一 + poiId(门店ID,选填)
  4. POST /web/douyin/page          核销记录分页。@LoginRequired
  5. GET  /web/douyin/{id}          核销记录详情。@LoginRequired

二、数据报表(新文件 ReportController,/web/report,从管理端迁回)
     鉴权:JWT + 管理员校验(需登录且 user.sysuser 非空,否则 NOT_ALLOWED)
  6. GET  /web/report/overview             概览统计
  7. POST /web/report/bikeIncome           收入车型分析
  8. POST /web/report/incomeStat           收入统计
  9. GET  /web/report/operationCenter      运营中心数据
  10. POST /web/report/operationOrderPage  运营中心订单查询(分页)
  11. GET /web/report/orderRides           订单骑行记录+轨迹


变化接口:
1. GET /web/home/home   返回值新增字段
   HomeResponse 新增:douyinExchangeTips(抖音券兑换说明,String)
   入参无变化,仅返回体增加一个字段(值来自字典 DOUYIN_EXCHANGE_TIPS)。


============================================================
说明:
- 上述清单基于 git 工作区实际差异(DouyinApi / ReportController /
  DouyinVerifyController / DouyinProductController 均为新增文件,
  在已提交代码中不存在;SystemDictDataController、HomeResponse 为既有文件被修改)。
- 相关数据库变更见 db/changeSql.sql(抖音商品/核销记录/操作日志/轨迹表 +
  DOUYIN_CONFIG / DOUYIN_EXCHANGE_TIPS 字典项)。
============================================================