============================================================
|
接口变更说明(相对当前已提交代码)
|
日期: 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 绑定/解绑本地套餐
|
|
|
============================================================
|
|
【接口端 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 字典项)。
|
============================================================
|
