feat: 新增系统管理/公告管理（列表、查看详情、新增、修改、删除、导出）

continew-admin-webapi/src/main/java/top/charles7c/cnadmin/webapi/controller/system/AnnouncementController.java

@@ -0,0 +1,82 @@
+/*
+ * Copyright (c) 2022-present Charles7c Authors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package top.charles7c.cnadmin.webapi.controller.system;
+
+import static top.charles7c.cnadmin.common.annotation.CrudRequestMapping.Api;
+
+import java.time.LocalDateTime;
+
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+
+import top.charles7c.cnadmin.common.annotation.CrudRequestMapping;
+import top.charles7c.cnadmin.common.base.BaseController;
+import top.charles7c.cnadmin.common.base.ValidateGroup;
+import top.charles7c.cnadmin.common.model.vo.R;
+import top.charles7c.cnadmin.common.util.validate.ValidationUtils;
+import top.charles7c.cnadmin.system.model.query.AnnouncementQuery;
+import top.charles7c.cnadmin.system.model.request.AnnouncementRequest;
+import top.charles7c.cnadmin.system.model.vo.AnnouncementDetailVO;
+import top.charles7c.cnadmin.system.model.vo.AnnouncementVO;
+import top.charles7c.cnadmin.system.service.AnnouncementService;
+
+/**
+ * 公告管理 API
+ *
+ * @author Charles7c
+ * @since 2023/8/20 10:55
+ */
+@Tag(name = "公告管理 API")
+@RestController
+@CrudRequestMapping(value = "/system/announcement",
+    api = {Api.PAGE, Api.GET, Api.ADD, Api.UPDATE, Api.DELETE, Api.EXPORT})
+public class AnnouncementController extends
+    BaseController<AnnouncementService, AnnouncementVO, AnnouncementDetailVO, AnnouncementQuery, AnnouncementRequest> {
+
+    @Override
+    @SaCheckPermission("system:announcement:add")
+    public R<Long> add(@Validated(ValidateGroup.Crud.Add.class) @RequestBody AnnouncementRequest request) {
+        this.checkTime(request);
+        return super.add(request);
+    }
+
+    @Override
+    @SaCheckPermission("system:announcement:update")
+    public R update(@Validated(ValidateGroup.Crud.Update.class) @RequestBody AnnouncementRequest request,
+        @PathVariable Long id) {
+        this.checkTime(request);
+        return super.update(request, id);
+    }
+
+    /**
+     * 检查时间
+     *
+     * @param request
+     *            创建或修改信息
+     */
+    private void checkTime(AnnouncementRequest request) {
+        LocalDateTime effectiveTime = request.getEffectiveTime();
+        LocalDateTime terminateTime = request.getTerminateTime();
+        if (null != effectiveTime && null != terminateTime) {
+            ValidationUtils.throwIf(terminateTime.isBefore(effectiveTime), "终止时间必须晚于生效时间");
+        }
+    }
+}

continew-admin-webapi/src/main/resources/db/changelog/v1.1.0/continew-admin_table.sql

@@ -30,4 +30,21 @@ CREATE TABLE IF NOT EXISTS `gen_field_config` (
     `query_type` tinyint(1) UNSIGNED DEFAULT NULL COMMENT '查询方式',
     `create_time` datetime NOT NULL COMMENT '创建时间',
     INDEX `idx_table_name`(`table_name`) USING BTREE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='字段配置表';
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='字段配置表';
+
+CREATE TABLE IF NOT EXISTS `sys_announcement` (
+    `id` bigint(20) UNSIGNED AUTO_INCREMENT COMMENT 'ID',
+    `title` varchar(255) NOT NULL COMMENT '标题',
+    `content` mediumtext NOT NULL COMMENT '内容',
+    `type` tinyint(1) UNSIGNED DEFAULT 1 COMMENT '类型（1：活动，2：消息，3：通知）',
+    `effective_time` datetime DEFAULT NULL COMMENT '生效时间',
+    `terminate_time` datetime DEFAULT NULL COMMENT '终止时间',
+    `sort` int(11) UNSIGNED DEFAULT 999 COMMENT '排序',
+    `create_user` bigint(20) UNSIGNED NOT NULL COMMENT '创建人',
+    `create_time` datetime NOT NULL COMMENT '创建时间',
+    `update_user` bigint(20) UNSIGNED DEFAULT NULL COMMENT '修改人',
+    `update_time` datetime DEFAULT NULL COMMENT '修改时间',
+    PRIMARY KEY (`id`) USING BTREE,
+    INDEX `idx_create_user`(`create_user`) USING BTREE,
+    INDEX `idx_update_user`(`update_user`) USING BTREE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='公告表';