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

liu

2 天以前 47dd1ecaf0aafa66b9c39fff9c91abc1c611b02c

 yudao-module-wxcp/src/main/java/cn/iocoder/yudao/module/wxcp/service/notice/WxCpNoticeService.java

@@ -1,12 +1,16 @@
package cn.iocoder.yudao.module.wxcp.service.notice;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.system.controller.admin.storage.vo.SystemStorageBlobRespVO;
import cn.iocoder.yudao.module.wxcp.controller.admin.notice.vo.WxCpNoticePageReqVO;
import cn.iocoder.yudao.module.wxcp.controller.admin.notice.vo.WxCpNoticeSaveReqVO;
import cn.iocoder.yudao.module.wxcp.controller.admin.vo.WxCpPushReqVO;
import cn.iocoder.yudao.module.wxcp.controller.admin.vo.WxCpPushResultVO;
import cn.iocoder.yudao.module.wxcp.dal.dataobject.notice.WxCpNoticeArticleDO;
import cn.iocoder.yudao.module.wxcp.dal.dataobject.notice.WxCpNoticeDO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * 企业微信通知 Service 接口
@@ -54,6 +58,46 @@
    PageResult<WxCpNoticeDO> getNoticePage(@Valid WxCpNoticePageReqVO pageReqVO);

    /**
     * 获得图片通知的图片列表
     *
     * @param noticeId 通知编号
     * @return 图片列表（含预览地址）
     */
    List<SystemStorageBlobRespVO> getNoticeImageAttachments(Long noticeId);

    /**
     * 获得附件通知的附件列表
     *
     * @param noticeId 通知编号
     * @return 附件列表（含预览/下载地址）
     */
    List<SystemStorageBlobRespVO> getNoticeFileAttachments(Long noticeId);

    /**
     * 获得视频通知的视频列表
     *
     * @param noticeId 通知编号
     * @return 视频列表（含预览地址）
     */
    List<SystemStorageBlobRespVO> getNoticeVideoAttachments(Long noticeId);

    /**
     * 获得多图文消息的图文列表
     *
     * @param noticeId 通知编号
     * @return 图文列表
     */
    List<WxCpNoticeArticleDO> getNoticeArticles(Long noticeId);

    /**
     * 获得多图文条目的封面附件
     *
     * @param articleId 图文条目编号
     * @return 封面附件列表（最多 1 张）
     */
    List<SystemStorageBlobRespVO> getNoticeArticleCoverAttachments(Long articleId);

    /**
     * 发布通知（草稿 -&gt; 已发布）
     *
     * @param id 通知编号
@@ -75,4 +119,12 @@
     */
    WxCpPushResultVO pushNotice(@Valid WxCpPushReqVO pushReqVO);

    /**
     * 拼装通知预览页地址，成员在企业微信内打开后可查看图片与附件
     *
     * @param id 通知编号
     * @return 预览页地址；未配置外网地址前缀时返回 null
     */
    String buildPreviewUrl(Long id);

}