feat: 新增APP启动页功能，完善多项业务优化

zjk

2026-09-24 4c4b36e7337385ff15ff66a0ad487cdffaf9c86b

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
package com.tcm.training.admin.system.service;
 
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.tcm.training.admin.system.dto.SystemSettingsSaveRequest;
import com.tcm.training.admin.system.entity.SystemSettings;
import com.tcm.training.admin.system.mapper.SystemSettingsMapper;
import com.tcm.training.admin.system.vo.SystemSettingsVO;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
 
@Service
public class SystemSettingsAppService {
 
    private final SystemSettingsMapper systemSettingsMapper;
 
    public SystemSettingsAppService(SystemSettingsMapper systemSettingsMapper) {
        this.systemSettingsMapper = systemSettingsMapper;
    }
 
    public SystemSettingsVO current() {
        SystemSettings config = systemSettingsMapper.selectOne(new LambdaQueryWrapper<SystemSettings>()
                .eq(SystemSettings::getDeleted, 0)
                .orderByDesc(SystemSettings::getId)
                .last("limit 1"));
        return toVO(config);
    }
 
    @Transactional
    public SystemSettingsVO saveCurrent(SystemSettingsSaveRequest request) {
        // 开启时必须提供图片；服务层校验同时覆盖非 HTTP 调用。
        if (Boolean.TRUE.equals(request.getStartupPageEnabled())
                && (request.getStartupPageImageUrl() == null || request.getStartupPageImageUrl().trim().isEmpty())) {
            throw new IllegalArgumentException("开启启动页后，请上传启动页图片");
        }
        SystemSettings config = systemSettingsMapper.selectOne(new LambdaQueryWrapper<SystemSettings>()
                .eq(SystemSettings::getDeleted, 0)
                .orderByDesc(SystemSettings::getId)
                .last("limit 1"));
        if (config == null) {
            config = new SystemSettings();
            fillConfig(config, request);
            systemSettingsMapper.insert(config);
        } else {
            fillConfig(config, request);
            systemSettingsMapper.updateById(config);
        }
        return toVO(config);
    }
 
    private void fillConfig(SystemSettings config, SystemSettingsSaveRequest request) {
        config.setServicePhone(request.getServicePhone().trim());
        config.setServiceOnlineTime(request.getServiceOnlineTime().trim());
        config.setBackupCycleDays(request.getBackupCycleDays());
        config.setMemberExpireRemindDays(request.getMemberExpireRemindDays());
        config.setStartupPageEnabled(Boolean.TRUE.equals(request.getStartupPageEnabled()));
        // 空串也会写入，避免 updateById 忽略 null 导致删除图片后仍保留旧值。
        config.setStartupPageImageUrl(request.getStartupPageImageUrl() == null
                ? "" : request.getStartupPageImageUrl().trim());
    }
 
    private SystemSettingsVO toVO(SystemSettings config) {
        if (config == null) {
            return null;
        }
        SystemSettingsVO vo = new SystemSettingsVO();
        vo.setId(config.getId());
        vo.setServicePhone(config.getServicePhone());
        vo.setServiceOnlineTime(config.getServiceOnlineTime());
        vo.setBackupCycleDays(config.getBackupCycleDays());
        vo.setMemberExpireRemindDays(config.getMemberExpireRemindDays());
        vo.setStartupPageEnabled(Boolean.TRUE.equals(config.getStartupPageEnabled()));
        vo.setStartupPageImageUrl(config.getStartupPageImageUrl());
        return vo;
    }
}