From 08c181231519361f1b7a533d1c7d8b00b776e787 Mon Sep 17 00:00:00 2001
From: liujie <1793218484@qq.com>
Date: 星期五, 09 十月 2026 11:11:00 +0800
Subject: [PATCH] update
---
cloud-server-management/src/main/java/com/dsh/guns/modular/system/controller/code/AppGuideManagementController.java | 68 ++++++++++++++++++++++++++++++++-
1 files changed, 65 insertions(+), 3 deletions(-)
diff --git a/cloud-server-management/src/main/java/com/dsh/guns/modular/system/controller/code/AppGuideManagementController.java b/cloud-server-management/src/main/java/com/dsh/guns/modular/system/controller/code/AppGuideManagementController.java
index d0e950e..2a1046e 100644
--- a/cloud-server-management/src/main/java/com/dsh/guns/modular/system/controller/code/AppGuideManagementController.java
+++ b/cloud-server-management/src/main/java/com/dsh/guns/modular/system/controller/code/AppGuideManagementController.java
@@ -39,23 +39,38 @@
@Autowired
private ITSiteService siteService;
+ /**
+ * 打开 APP 下载引导管理页面。
+ *
+ * @return APP 下载引导管理页面路径
+ */
@GetMapping("")
public String index() {
return "/system/appGuide/appGuide.html";
}
+ /**
+ * 查询可用于生成订场二维码的场地列表。
+ *
+ * @return 按 ID 倒序排列的场地列表
+ */
@ResponseBody
@GetMapping("/sites")
public List<TSite> queryAvailableSites() {
return siteService.list(new QueryWrapper<TSite>().orderByDesc("id"));
}
+ /**
+ * 查询 APP 下载引导页面所需的配置、宣传图和订场二维码数据。
+ *
+ * @return 下载引导页面的聚合数据
+ */
@ResponseBody
@GetMapping("/data")
public Map<String, Object> data() {
Map<String, Object> r = new HashMap<>();
r.put("config", appGuideConfigMapper.selectOne(new QueryWrapper<AppGuideConfig>().orderByDesc("id").last("limit 1")));
- r.put("banners", appGuideBannerMapper.selectList(new QueryWrapper<AppGuideBanner>().orderByAsc("sort").orderByDesc("id")));
+ r.put("banners", appGuideBannerMapper.selectList(new QueryWrapper<AppGuideBanner>().orderByDesc("sort").orderByDesc("id")));
List<QrLink> links = qrLinkMapper.selectList(new QueryWrapper<QrLink>().eq("type", "SITE_BOOKING").orderByDesc("id"));
List<Map<String, Object>> linkData = new ArrayList<>();
for (QrLink link : links) {
@@ -69,6 +84,12 @@
return r;
}
+ /**
+ * 保存 APP 下载引导配置。
+ *
+ * @param config 下载引导配置
+ * @return 保存结果
+ */
@ResponseBody
@PostMapping("/config")
public Map<String, Object> saveConfig(AppGuideConfig config) {
@@ -80,6 +101,12 @@
return ok();
}
+ /**
+ * 保存 APP 下载引导宣传图。
+ *
+ * @param banner 宣传图配置
+ * @return 保存结果
+ */
@ResponseBody
@PostMapping("/banner")
public Map<String, Object> saveBanner(AppGuideBanner banner) {
@@ -89,6 +116,12 @@
return ok();
}
+ /**
+ * 删除 APP 下载引导宣传图。
+ *
+ * @param id 宣传图 ID
+ * @return 删除结果
+ */
@ResponseBody
@PostMapping("/banner/delete")
public Map<String, Object> deleteBanner(Long id) {
@@ -96,6 +129,16 @@
return ok();
}
+ /**
+ * 为指定场地创建订场二维码。
+ *
+ * @param storeId 门店 ID
+ * @param siteId 场地 ID
+ * @param name 二维码名称
+ * @param channel 投放渠道
+ * @param pageName 引导页面名称
+ * @return 创建结果及二维码引导链接
+ */
@ResponseBody
@PostMapping("/siteQr")
public Map<String, Object> createSiteQr(Integer storeId, Integer siteId, String name, String channel, String pageName) {
@@ -118,6 +161,13 @@
return r;
}
+ /**
+ * 修改场地订场二维码的启用状态。
+ *
+ * @param id 二维码 ID
+ * @param enabled 启用状态（0：停用；1：启用）
+ * @return 修改结果
+ */
@ResponseBody
@PostMapping("/siteQr/status")
public Map<String, Object> changeStatus(Long id, Integer enabled) {
@@ -128,7 +178,12 @@
return ok();
}
- /** 逻辑删除场地订场二维码。 */
+ /**
+ * 逻辑删除场地订场二维码。
+ *
+ * @param id 二维码 ID
+ * @return 删除结果
+ */
@ResponseBody
@PostMapping("/siteQr/delete")
public Map<String, Object> deleteSiteQr(Long id) {
@@ -136,6 +191,13 @@
return ok();
}
+ /**
+ * 生成并输出场地订场二维码图片。
+ *
+ * @param id 二维码 ID
+ * @param response HTTP 响应
+ * @throws IOException 图片输出失败时抛出
+ */
@GetMapping("/siteQr/{id}.png")
public void qrImage(@PathVariable Long id, HttpServletResponse response) throws IOException {
QrLink link = qrLinkMapper.selectById(id);
@@ -149,7 +211,7 @@
}
private String guideUrl(QrLink link) {
- return "https://www.weparklife.com/appdown?code=" + link.getShortCode();
+ return "https://package.daowepark.com/appdown?code=" + link.getShortCode();
}
private String nextCode() {
--
Gitblit v1.7.1