From 9eeb62c02a7b3c7b95c20678b6a9c74e7f12f943 Mon Sep 17 00:00:00 2001
From: MrShi <1878285526@qq.com>
Date: 星期三, 01 七月 2026 18:15:10 +0800
Subject: [PATCH] Merge branch '3.0.1' of http://139.186.142.91:10010/r/productDev/parkBike into 3.0.1
---
server/接口变更说明.txt | 85 ++++++++++++++++++++++++++++++++++++++++++
1 files changed, 85 insertions(+), 0 deletions(-)
diff --git "a/server/\346\216\245\345\217\243\345\217\230\346\233\264\350\257\264\346\230\216.txt" "b/server/\346\216\245\345\217\243\345\217\230\346\233\264\350\257\264\346\230\216.txt"
new file mode 100644
index 0000000..27a2dfe
--- /dev/null
+++ "b/server/\346\216\245\345\217\243\345\217\230\346\233\264\350\257\264\346\230\216.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 鏌ヨ鎶栭煶鍟嗘埛涓嬮棬搴桰D鍒楄〃(鏃犲叆鍙�,杩斿洖 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鏌ヨ(鍚玈KU)
+ 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 鑱旇皟娴嬭瘯:鏌ヨ鎶栭煶鍟嗘埛涓嬮棬搴桰D鍒楄〃(杩斿洖 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銆丠omeResponse 涓烘棦鏈夋枃浠惰淇敼)銆�
+- 鐩稿叧鏁版嵁搴撳彉鏇磋 db/changeSql.sql(鎶栭煶鍟嗗搧/鏍搁攢璁板綍/鎿嶄綔鏃ュ織/杞ㄨ抗琛� +
+ DOUYIN_CONFIG / DOUYIN_EXCHANGE_TIPS 瀛楀吀椤�)銆�
+============================================================
--
Gitblit v1.9.3