注释优化、格式优化

刘帅

2026-09-29 b55cd9aad0835a96a790e61f9f89edc2fae1be9f

 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);