Merge branch '3.0.1' of http://139.186.142.91:10010/r/productDev/parkBike i...

MrShi

6 天以前 9eeb62c02a7b3c7b95c20678b6a9c74e7f12f943

 server/½Ó¿Ú±ä¸ü˵Ã÷.txt

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,85 @@
============================================================
接口变更说明(相对当前已提交代码)
日期: 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     æŸ¥è¯¢æŠ–音商户下门店ID列表(无入参,返回 List<String>)
  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 å­—典项)。
============================================================