From 4e8cadb13ebd6f01b8cf6d5cc89757cf8e960792 Mon Sep 17 00:00:00 2001
From: 刘帅 <rr.iii@qq.com>
Date: 星期三, 30 九月 2026 12:22:24 +0800
Subject: [PATCH] 门店管理修改
---
cloud-server-management/src/main/java/com/dsh/guns/modular/system/controller/code/AppGuideManagementController.java | 64 +++++++++++++++++++++++++++++++
1 files changed, 63 insertions(+), 1 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 d874b00..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,17 +39,32 @@
@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() {
@@ -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);
--
Gitblit v1.7.1