feat(wxcp): 通知支持图片/视频/Markdown/多图文模板与成员预览

liu

6 天以前 47dd1ecaf0aafa66b9c39fff9c91abc1c611b02c

 yudao-module-wxcp/src/main/java/cn/iocoder/yudao/module/wxcp/controller/admin/notice/vo/WxCpNoticeSaveReqVO.java

@@ -2,10 +2,14 @@

import cn.iocoder.yudao.framework.common.validation.InEnum;
import cn.iocoder.yudao.module.wxcp.enums.activity.WxCpPushScopeEnum;
import cn.iocoder.yudao.module.wxcp.enums.notice.WxCpNoticeTypeEnum;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.Valid;
import jakarta.validation.constraints.NotEmpty;
import jakarta.validation.constraints.Size;
import lombok.Data;

import java.util.List;

@Schema(description = "管理后台 - 企业微信通知 创建/修改 Request VO")
@Data
@@ -19,10 +23,55 @@
    @Size(max = 128, message = "通知标题长度不能超过 128 个字符")
    private String title;

    @Schema(description = "通知正文", requiredMode = Schema.RequiredMode.REQUIRED)
    @NotEmpty(message = "通知正文不能为空")
    @Schema(description = "通知正文；纯文本通知必填，其它类型作为补充说明")
    @Size(max = 10000, message = "通知正文长度不能超过 10000 个字符")
    private String content;

    @Schema(description = "通知模板类型：1纯文本 2图文卡片(填报/链接) 3文件通知 4图文消息 5图片通知 6视频通知 7Markdown 8多图文消息",
            example = "1")
    @InEnum(WxCpNoticeTypeEnum.class)
    private Integer noticeType;

    @Schema(description = "摘要（图文卡片/图文消息使用）", example = "请于本周五前完成填报")
    @Size(max = 512, message = "摘要长度不能超过 512 个字符")
    private String summary;

    @Schema(description = "跳转链接（填报、查看详情等）", example = "https://example.com/form/1")
    @Size(max = 1024, message = "跳转链接长度不能超过 1024 个字符")
    private String linkUrl;

    @Schema(description = "链接按钮文案", example = "去填报")
    @Size(max = 32, message = "按钮文案长度不能超过 32 个字符")
    private String linkBtnText;

    @Schema(description = "图文消息封面图地址", example = "https://example.com/cover.png")
    @Size(max = 1024, message = "封面图地址长度不能超过 1024 个字符")
    private String coverUrl;

    @Schema(description = "文件通知的附件 Blob ID（旧版单附件字段，建议改用 fileBlobIds）", example = "1024")
    private Long fileBlobId;

    @Schema(description = "文件通知的附件文件名（旧版单附件字段）", example = "关于开展XX工作的通知.pdf")
    @Size(max = 255, message = "文件名长度不能超过 255 个字符")
    private String fileName;

    @Schema(description = "图片通知的图片 Blob ID 列表（最多 9 张）；null = 不改动，[] = 清空", example = "[1024,1025]")
    @Size(max = 9, message = "图片最多上传 9 张")
    private List<Long> imageBlobIds;

    @Schema(description = "附件通知的附件 Blob ID 列表（最多 5 个）；null = 不改动，[] = 清空", example = "[1024,1025]")
    @Size(max = 5, message = "附件最多上传 5 个")
    private List<Long> fileBlobIds;

    @Schema(description = "视频通知的视频 Blob ID 列表（最多 1 个）；null = 不改动，[] = 清空", example = "[1024]")
    @Size(max = 1, message = "视频最多上传 1 个")
    private List<Long> videoBlobIds;

    @Schema(description = "多图文消息的图文列表；null = 不改动，[] = 清空", example = "[]")
    @Valid
    @Size(max = 8, message = "多图文消息最多 8 篇")
    private List<WxCpNoticeArticleSaveReqVO> articleList;

    @Schema(description = "推送范围（选填，不传默认全员）；推送时仍可在推送弹窗里重新选择", example = "0")
    @InEnum(WxCpPushScopeEnum.class)
    private Integer pushScope;