mp：完成的公众号的管理界面

2025-10-31 02:28:03 +08:00 · 2023-01-07 18:31:04 +08:00
parent 71beeabe9c
commit 39b2afd506
17 changed files with 294 additions and 206 deletions
--- a/yudao-module-mp/yudao-module-mp-api/src/main/java/cn/iocoder/yudao/module/mp/enums/ErrorCodeConstants.java
+++ b/yudao-module-mp/yudao-module-mp-api/src/main/java/cn/iocoder/yudao/module/mp/enums/ErrorCodeConstants.java
@ -9,9 +9,12 @@ import cn.iocoder.yudao.framework.common.exception.ErrorCode;
 */
 public interface ErrorCodeConstants {

-    // ========== 用户相关  1004001000============
-    ErrorCode WX_ACCOUNT_NOT_EXISTS = new ErrorCode(1006001000, "公众号账户不存在");
-    ErrorCode WX_ACCOUNT_FANS_NOT_EXISTS = new ErrorCode(1006001001, "粉丝账号不存在");
+    // ========== 公众号账号 1006000000============
+    ErrorCode ACCOUNT_NOT_EXISTS = new ErrorCode(1006000000, "公众号账号不存在");
+    ErrorCode ACCOUNT_GENERATE_QR_CODE_FAIL = new ErrorCode(1006000001, "生成公众号二维码失败，原因：{}");
+    ErrorCode ACCOUNT_CLEAR_QUOTA_FAIL = new ErrorCode(1006000001, "清空公众号的 API 配额失败，原因：{}");
+
+    // TODO 要处理下
    ErrorCode COMMON_NOT_EXISTS = new ErrorCode(1006001002, "用户不存在");

 }
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/controller/admin/account/MpAccountController.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/controller/admin/account/MpAccountController.java
@ -2,7 +2,10 @@ package cn.iocoder.yudao.module.mp.controller.admin.account;

 import cn.iocoder.yudao.framework.common.pojo.CommonResult;
 import cn.iocoder.yudao.framework.common.pojo.PageResult;
-import cn.iocoder.yudao.module.mp.controller.admin.account.vo.*;
+import cn.iocoder.yudao.module.mp.controller.admin.account.vo.MpAccountCreateReqVO;
+import cn.iocoder.yudao.module.mp.controller.admin.account.vo.MpAccountPageReqVO;
+import cn.iocoder.yudao.module.mp.controller.admin.account.vo.MpAccountRespVO;
+import cn.iocoder.yudao.module.mp.controller.admin.account.vo.MpAccountUpdateReqVO;
 import cn.iocoder.yudao.module.mp.convert.account.MpAccountConvert;
 import cn.iocoder.yudao.module.mp.dal.dataobject.account.MpAccountDO;
 import cn.iocoder.yudao.module.mp.service.account.MpAccountService;
@ -18,54 +21,72 @@ import javax.validation.Valid;

 import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;

-@Api(tags = "管理后台 - 公众号账户")
+@Api(tags = "管理后台 - 公众号账号")
@RestController
@RequestMapping("/mp/account")
@Validated
 public class MpAccountController {

    @Resource
-    private MpAccountService wxAccountService;
+    private MpAccountService mpAccountService;

    @PostMapping("/create")
-    @ApiOperation("创建公众号账户")
+    @ApiOperation("创建公众号账号")
    @PreAuthorize("@ss.hasPermission('mp:account:create')")
    public CommonResult<Long> createWxAccount(@Valid @RequestBody MpAccountCreateReqVO createReqVO) {
-        return success(wxAccountService.createAccount(createReqVO));
+        return success(mpAccountService.createAccount(createReqVO));
    }

    @PutMapping("/update")
-    @ApiOperation("更新公众号账户")
+    @ApiOperation("更新公众号账号")
    @PreAuthorize("@ss.hasPermission('mp:account:update')")
    public CommonResult<Boolean> updateWxAccount(@Valid @RequestBody MpAccountUpdateReqVO updateReqVO) {
-        wxAccountService.updateAccount(updateReqVO);
+        mpAccountService.updateAccount(updateReqVO);
        return success(true);
    }

    @DeleteMapping("/delete")
-    @ApiOperation("删除公众号账户")
+    @ApiOperation("删除公众号账号")
    @ApiImplicitParam(name = "id", value = "编号", required = true, dataTypeClass = Long.class)
    @PreAuthorize("@ss.hasPermission('mp:account:delete')")
    public CommonResult<Boolean> deleteWxAccount(@RequestParam("id") Long id) {
-        wxAccountService.deleteAccount(id);
+        mpAccountService.deleteAccount(id);
        return success(true);
    }

    @GetMapping("/get")
-    @ApiOperation("获得公众号账户")
+    @ApiOperation("获得公众号账号")
    @ApiImplicitParam(name = "id", value = "编号", required = true, example = "1024", dataTypeClass = Long.class)
    @PreAuthorize("@ss.hasPermission('mp:account:query')")
    public CommonResult<MpAccountRespVO> getWxAccount(@RequestParam("id") Long id) {
-        MpAccountDO wxAccount = wxAccountService.getAccount(id);
+        MpAccountDO wxAccount = mpAccountService.getAccount(id);
        return success(MpAccountConvert.INSTANCE.convert(wxAccount));
    }

    @GetMapping("/page")
-    @ApiOperation("获得公众号账户分页")
+    @ApiOperation("获得公众号账号分页")
    @PreAuthorize("@ss.hasPermission('mp:account:query')")
    public CommonResult<PageResult<MpAccountRespVO>> getWxAccountPage(@Valid MpAccountPageReqVO pageVO) {
-        PageResult<MpAccountDO> pageResult = wxAccountService.getAccountPage(pageVO);
+        PageResult<MpAccountDO> pageResult = mpAccountService.getAccountPage(pageVO);
        return success(MpAccountConvert.INSTANCE.convertPage(pageResult));
    }

+    @PutMapping("/generate-qr-code")
+    @ApiOperation("生成公众号二维码")
+    @ApiImplicitParam(name = "id", value = "编号", required = true, dataTypeClass = Long.class)
+    @PreAuthorize("@ss.hasPermission('mp:account:qr-code')")
+    public CommonResult<Boolean> generateAccountQrCode(@RequestParam("id") Long id) {
+        mpAccountService.generateAccountQrCode(id);
+        return success(true);
+    }
+
+    @PutMapping("/clear-quota")
+    @ApiOperation("清空公众号 API 配额")
+    @ApiImplicitParam(name = "id", value = "编号", required = true, dataTypeClass = Long.class)
+    @PreAuthorize("@ss.hasPermission('mp:account:clear-quota')")
+    public CommonResult<Boolean> clearAccountQuota(@RequestParam("id") Long id) {
+        mpAccountService.clearAccountQuota(id);
+        return success(true);
+    }
+
 }
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/controller/admin/account/vo/MpAccountBaseVO.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/controller/admin/account/vo/MpAccountBaseVO.java
@ -3,10 +3,10 @@ package cn.iocoder.yudao.module.mp.controller.admin.account.vo;
 import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;

-import javax.validation.constraints.NotNull;
+import javax.validation.constraints.NotEmpty;

 /**
- * 公众号账户 Base VO，提供给添加、修改、详细的子 VO 使用
+ * 公众号账号 Base VO，提供给添加、修改、详细的子 VO 使用
 * 如果子 VO 存在差异的字段，请不要添加到这里，影响 Swagger 文档生成
 *
 * @author fengdan
@ -14,29 +14,30 @@ import javax.validation.constraints.NotNull;
@Data
 public class MpAccountBaseVO {

-    @ApiModelProperty(value = "公众号名称", required = true)
-    @NotNull(message = "公众号名称不能为空")
+    @ApiModelProperty(value = "公众号名称", required = true, example = "芋道源码")
+    @NotEmpty(message = "公众号名称不能为空")
    private String name;

-    @ApiModelProperty(value = "公众号账户", required = true)
-    @NotNull(message = "公众号账户不能为空")
+    @ApiModelProperty(value = "公众号微信号", required = true, example = "yudaoyuanma")
+    @NotEmpty(message = "公众号微信号不能为空")
    private String account;

    @ApiModelProperty(value = "公众号 appId", required = true, example = "wx5b23ba7a5589ecbb")
-    @NotNull(message = "公众号 appId 不能为空")
+    @NotEmpty(message = "公众号 appId 不能为空")
    private String appId;

-    @ApiModelProperty(value = "公众号密钥", required = true)
-    @NotNull(message = "公众号密钥不能为空")
+    @ApiModelProperty(value = "公众号密钥", required = true, example = "3a7b3b20c537e52e74afd395eb85f61f")
+    @NotEmpty(message = "公众号密钥不能为空")
    private String appSecret;

-    @ApiModelProperty(value = "公众号 token", required = true)
+    @ApiModelProperty(value = "公众号 token", required = true, example = "kangdayuzhen")
+    @NotEmpty(message = "公众号 token 不能为空")
    private String token;

-    @ApiModelProperty(value = "加密密钥")
+    @ApiModelProperty(value = "加密密钥", example = "gjN+Ksei")
    private String aesKey;

-    @ApiModelProperty(value = "备注")
+    @ApiModelProperty(value = "备注", example = "请关注芋道源码，学习技术")
    private String remark;

 }
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/controller/admin/account/vo/MpAccountCreateReqVO.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/controller/admin/account/vo/MpAccountCreateReqVO.java
@ -5,7 +5,7 @@ import lombok.Data;
 import lombok.EqualsAndHashCode;
 import lombok.ToString;

-@ApiModel("管理后台 - 公众号账户创建 Request VO")
+@ApiModel("管理后台 - 公众号账号创建 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/controller/admin/account/vo/MpAccountPageReqVO.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/controller/admin/account/vo/MpAccountPageReqVO.java
@ -4,7 +4,7 @@ import lombok.*;
 import io.swagger.annotations.*;
 import cn.iocoder.yudao.framework.common.pojo.PageParam;

-@ApiModel("管理后台 - 公众号账户分页 Request VO")
+@ApiModel("管理后台 - 公众号账号分页 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
@ -13,7 +13,7 @@ public class MpAccountPageReqVO extends PageParam {
    @ApiModelProperty(value = "公众号名称", notes = "模糊匹配")
    private String name;

-    @ApiModelProperty(value = "公众号账户", notes = "模糊匹配")
+    @ApiModelProperty(value = "公众号账号", notes = "模糊匹配")
    private String account;

    @ApiModelProperty(value = "公众号 appid", notes = "模糊匹配")
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/controller/admin/account/vo/MpAccountRespVO.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/controller/admin/account/vo/MpAccountRespVO.java
@ -8,25 +8,19 @@ import lombok.ToString;

 import java.util.Date;

-/**
- * @author fengdan
- */
-@ApiModel("管理后台 - 公众号账户 Response VO")
+@ApiModel("管理后台 - 公众号账号 Response VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
 public class MpAccountRespVO extends MpAccountBaseVO {

-    @ApiModelProperty(value = "编号", required = true)
+    @ApiModelProperty(value = "编号", required = true, example = "1024")
    private Long id;

-    @ApiModelProperty(value = "二维码图片URL")
+    @ApiModelProperty(value = "二维码图片URL", example = "https://www.iocoder.cn/1024.png")
    private String qrCodeUrl;

    @ApiModelProperty(value = "创建时间", required = true)
    private Date createTime;

-    @ApiModelProperty(value = "公众号密钥", required = true)
-    private String appSecret;
-
 }
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/controller/admin/account/vo/MpAccountUpdateReqVO.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/controller/admin/account/vo/MpAccountUpdateReqVO.java
@ -7,7 +7,7 @@ import javax.validation.constraints.*;
 /**
 * @author fengdan
 */
-@ApiModel("管理后台 - 公众号账户更新 Request VO")
+@ApiModel("管理后台 - 公众号账号更新 Request VO")
@Data
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true)
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/dal/dataobject/account/MpAccountDO.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/dal/dataobject/account/MpAccountDO.java
@ -1,18 +1,13 @@
 package cn.iocoder.yudao.module.mp.dal.dataobject.account;

-import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
 import cn.iocoder.yudao.framework.tenant.core.db.TenantBaseDO;
 import com.baomidou.mybatisplus.annotation.KeySequence;
 import com.baomidou.mybatisplus.annotation.TableId;
 import com.baomidou.mybatisplus.annotation.TableName;
-import com.binarywang.spring.starter.wxjava.mp.properties.WxMpProperties;
 import lombok.*;
-import me.chanjar.weixin.common.redis.RedisTemplateWxRedisOps;
-import me.chanjar.weixin.mp.config.WxMpConfigStorage;
-import me.chanjar.weixin.mp.config.impl.WxMpRedisConfigImpl;

 /**
- * 公众号账户 DO
+ * 公众号账号 DO
 *
 * @author 芋道源码
 */
@ -36,7 +31,7 @@ public class MpAccountDO extends TenantBaseDO {
     */
    private String name;
    /**
-     * 公众号账户
+     * 公众号账号
     */
    private String account;
    /**
@ -52,7 +47,7 @@ public class MpAccountDO extends TenantBaseDO {
     */
    private String token;
    /**
-     * 加密密钥
+     * 消息加解密密钥
     */
    private String aesKey;
    /**
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/dal/mysql/account/MpAccountMapper.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/dal/mysql/account/MpAccountMapper.java
@ -6,9 +6,6 @@ import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
 import cn.iocoder.yudao.module.mp.controller.admin.account.vo.MpAccountPageReqVO;
 import cn.iocoder.yudao.module.mp.dal.dataobject.account.MpAccountDO;
 import org.apache.ibatis.annotations.Mapper;
-import org.apache.ibatis.annotations.Select;
-
-import java.time.LocalDateTime;

@Mapper
 public interface MpAccountMapper extends BaseMapperX<MpAccountDO> {
@ -21,7 +18,8 @@ public interface MpAccountMapper extends BaseMapperX<MpAccountDO> {
                .orderByDesc(MpAccountDO::getId));
    }

-    @Select("SELECT COUNT(*) FROM mp_account WHERE update_time > #{maxUpdateTime}")
-    Long selectCountByUpdateTimeGt(LocalDateTime maxUpdateTime);
+    default MpAccountDO selectByAppId(String appId) {
+        return selectOne(MpAccountDO::getAppId, appId);
+    }

 }
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/mq/consumer/MpAccountRefreshConsumer.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/mq/consumer/MpAccountRefreshConsumer.java
@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.mp.mq.consumer;
+
+import cn.iocoder.yudao.framework.mq.core.pubsub.AbstractChannelMessageListener;
+import cn.iocoder.yudao.module.mp.mq.message.MpAccountRefreshMessage;
+import cn.iocoder.yudao.module.mp.service.account.MpAccountService;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+import javax.annotation.Resource;
+
+/**
+ * 针对 {@link MpAccountRefreshMessage} 的消费者
+ *
+ * @author 芋道源码
+ */
+@Component
+@Slf4j
+public class MpAccountRefreshConsumer extends AbstractChannelMessageListener<MpAccountRefreshMessage> {
+
+    @Resource
+    private MpAccountService mpAccountService;
+
+    @Override
+    public void onMessage(MpAccountRefreshMessage message) {
+        log.info("[onMessage][收到 Account 刷新消息]");
+        mpAccountService.initLocalCache();
+    }
+
+}
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/mq/consumer/MpConfigRefreshConsumer.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/mq/consumer/MpConfigRefreshConsumer.java
@ -1,29 +0,0 @@
-package cn.iocoder.yudao.module.mp.mq.consumer;
-
-import cn.iocoder.yudao.framework.mq.core.pubsub.AbstractChannelMessageListener;
-import cn.iocoder.yudao.module.mp.mq.message.MpConfigRefreshMessage;
-import cn.iocoder.yudao.module.mp.service.account.MpAccountService;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.stereotype.Component;
-
-import javax.annotation.Resource;
-
-/**
- * 针对 {@link MpConfigRefreshMessage} 的消费者
- *
- * @author lyz
- */
-@Component
-@Slf4j
-public class MpConfigRefreshConsumer extends AbstractChannelMessageListener<MpConfigRefreshMessage> {
-
-    @Resource
-    private MpAccountService wxAccountService;
-
-    @Override
-    public void onMessage(MpConfigRefreshMessage message) {
-        log.info("[onMessage][收到 MpConfig 刷新消息]");
-        wxAccountService.initLocalCache();
-    }
-
-}
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/mq/message/MpAccountRefreshMessage.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/mq/message/MpAccountRefreshMessage.java
@ -5,15 +5,17 @@ import lombok.Data;
 import lombok.EqualsAndHashCode;

 /**
- * 微信配置数据刷新 Message
+ * 公众号账号刷新 Message
+ *
+ * @author 芋道源码
 */
@Data
@EqualsAndHashCode(callSuper = true)
-public class MpConfigRefreshMessage extends AbstractChannelMessage {
+public class MpAccountRefreshMessage extends AbstractChannelMessage {

    @Override
    public String getChannel() {
-        return "mp.config-data.refresh";
+        return "mp.account.refresh";
    }

 }
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/mq/producer/MpAccountProducer.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/mq/producer/MpAccountProducer.java
@ -1,25 +1,27 @@
 package cn.iocoder.yudao.module.mp.mq.producer;

 import cn.iocoder.yudao.framework.mq.core.RedisMQTemplate;
-import cn.iocoder.yudao.module.mp.mq.message.MpConfigRefreshMessage;
+import cn.iocoder.yudao.module.mp.mq.message.MpAccountRefreshMessage;
 import org.springframework.stereotype.Component;

 import javax.annotation.Resource;

 /**
- * 微信配置数据相关消息的 Producer
+ * 公众号账号 Producer
+ *
+ * @author 芋道源码
 */
@Component
-public class MpConfigProducer {
+public class MpAccountProducer {

    @Resource
    private RedisMQTemplate redisMQTemplate;

    /**
-     * 发送 {@link MpConfigRefreshMessage} 消息
+     * 发送 {@link MpAccountRefreshMessage} 消息
     */
-    public void sendDictDataRefreshMessage() {
-        MpConfigRefreshMessage message = new MpConfigRefreshMessage();
+    public void sendAccountRefreshMessage() {
+        MpAccountRefreshMessage message = new MpAccountRefreshMessage();
        redisMQTemplate.send(message);
    }

--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/service/account/MpAccountService.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/service/account/MpAccountService.java
@ -5,12 +5,11 @@ import cn.iocoder.yudao.module.mp.controller.admin.account.vo.MpAccountCreateReq
 import cn.iocoder.yudao.module.mp.controller.admin.account.vo.MpAccountPageReqVO;
 import cn.iocoder.yudao.module.mp.controller.admin.account.vo.MpAccountUpdateReqVO;
 import cn.iocoder.yudao.module.mp.dal.dataobject.account.MpAccountDO;
-import com.baomidou.mybatisplus.core.toolkit.support.SFunction;

 import javax.validation.Valid;

 /**
- * 公众号账户 Service 接口
+ * 公众号账号 Service 接口
 *
 * @author 芋道源码
 */
@ -22,7 +21,7 @@ public interface MpAccountService {
    void initLocalCache();

    /**
-     * 创建公众号账户
+     * 创建公众号账号
     *
     * @param createReqVO 创建信息
     * @return 编号
@ -30,51 +29,57 @@ public interface MpAccountService {
    Long createAccount(@Valid MpAccountCreateReqVO createReqVO);

    /**
-     * 更新公众号账户
+     * 更新公众号账号
     *
     * @param updateReqVO 更新信息
     */
    void updateAccount(@Valid MpAccountUpdateReqVO updateReqVO);

    /**
-     * 删除公众号账户
+     * 删除公众号账号
     *
     * @param id 编号
     */
    void deleteAccount(Long id);

    /**
-     * 获得公众号账户
+     * 获得公众号账号
     *
     * @param id 编号
-     * @return 公众号账户
+     * @return 公众号账号
     */
    MpAccountDO getAccount(Long id);

    /**
-     * 从缓存中，获得公众号账户
+     * 从缓存中，获得公众号账号
     *
     * @param appId 微信公众号 appId
-     * @return 公众号账户
+     * @return 公众号账号
     */
    MpAccountDO getAccountFromCache(String appId);

    /**
-     * 获得公众号账户分页
+     * 获得公众号账号分页
     *
     * @param pageReqVO 分页查询
-     * @return 公众号账户分页
+     * @return 公众号账号分页
     */
    PageResult<MpAccountDO> getAccountPage(MpAccountPageReqVO pageReqVO);

-    // TODO 芋艿：去除这样的方法
    /**
-     * 查询账户
+     * 生成公众号账号的二维码
     *
-     * @param field
-     * @param val
-     * @return
+     * @param id 编号
     */
-    MpAccountDO findBy(SFunction<MpAccountDO, ?> field, Object val);
+    void generateAccountQrCode(Long id);
+
+    /**
+     * 清空公众号账号的 API 配额
+     *
+     * 参考文档：<a href="https://developers.weixin.qq.com/doc/offiaccount/Message_Management/API_Call_Limits.html">接口调用频次限制说明</a>
+     *
+     * @param id 编号
+     */
+    void clearAccountQuota(Long id);

 }
--- a/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/service/account/MpAccountServiceImpl.java
+++ b/yudao-module-mp/yudao-module-mp-biz/src/main/java/cn/iocoder/yudao/module/mp/service/account/MpAccountServiceImpl.java
@ -1,5 +1,6 @@
 package cn.iocoder.yudao.module.mp.service.account;

+import cn.hutool.core.util.ObjUtil;
 import cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil;
 import cn.iocoder.yudao.framework.common.pojo.PageResult;
 import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
@ -12,24 +13,27 @@ import cn.iocoder.yudao.module.mp.dal.dataobject.account.MpAccountDO;
 import cn.iocoder.yudao.module.mp.dal.mysql.account.MpAccountMapper;
 import cn.iocoder.yudao.module.mp.enums.ErrorCodeConstants;
 import cn.iocoder.yudao.module.mp.framework.mp.core.MpServiceFactory;
-import cn.iocoder.yudao.module.mp.mq.producer.MpConfigProducer;
-import com.baomidou.mybatisplus.core.toolkit.support.SFunction;
+import cn.iocoder.yudao.module.mp.mq.producer.MpAccountProducer;
+import com.google.common.annotations.VisibleForTesting;
 import lombok.Getter;
 import lombok.extern.slf4j.Slf4j;
+import me.chanjar.weixin.common.error.WxErrorException;
+import me.chanjar.weixin.mp.api.WxMpService;
+import me.chanjar.weixin.mp.bean.result.WxMpQrCodeTicket;
 import org.springframework.context.annotation.Lazy;
-import org.springframework.scheduling.annotation.Scheduled;
 import org.springframework.stereotype.Service;
 import org.springframework.validation.annotation.Validated;

 import javax.annotation.PostConstruct;
 import javax.annotation.Resource;
-import java.time.LocalDateTime;
 import java.util.List;
 import java.util.Map;

+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.system.enums.ErrorCodeConstants.USER_USERNAME_EXISTS;

 /**
- * 公众号账户 Service 实现类
+ * 公众号账号 Service 实现类
 *
 * @author fengdan
 */
@ -38,12 +42,6 @@ import java.util.Map;
@Validated
 public class MpAccountServiceImpl implements MpAccountService {

-    /**
-     * 定时执行 {@link #schedulePeriodicRefresh()} 的周期
-     * 因为已经通过 Redis Pub/Sub 机制，所以频率不需要高
-     */
-    private static final long SCHEDULER_PERIOD = 5 * 60 * 1000L;
-
    /**
     * 账号缓存
     * key：账号编号 {@link MpAccountDO#getAppId()}
@ -52,11 +50,6 @@ public class MpAccountServiceImpl implements MpAccountService {
     */
    @Getter
    private volatile Map<String, MpAccountDO> accountCache;
-    /**
-     * 缓存菜单的最大更新时间，用于后续的增量轮询，判断是否有更新
-     */
-    @Getter
-    private volatile LocalDateTime maxUpdateTime;

    @Resource
    private MpAccountMapper mpAccountMapper;
@ -66,89 +59,85 @@ public class MpAccountServiceImpl implements MpAccountService {
    private MpServiceFactory mpServiceFactory;

    @Resource
-    private MpConfigProducer mpConfigDataProducer;
+    private MpAccountProducer mpAccountProducer;

    @Override
    @PostConstruct
    public void initLocalCache() {
-        initLocalCacheIfUpdate(null);
-    }
-
-    @Scheduled(fixedDelay = SCHEDULER_PERIOD, initialDelay = SCHEDULER_PERIOD)
-    public void schedulePeriodicRefresh() {
-        initLocalCacheIfUpdate(this.maxUpdateTime);
-    }
-
-    /**
-     * 刷新本地缓存
-     *
-     * @param maxUpdateTime 最大更新时间
-     *                      1. 如果 maxUpdateTime 为 null，则“强制”刷新缓存
-     *                      2. 如果 maxUpdateTime 不为 null，判断自 maxUpdateTime 是否有数据发生变化，有的情况下才刷新缓存
-     */
-    private void initLocalCacheIfUpdate(LocalDateTime maxUpdateTime) {
        // 注意：忽略自动多租户，因为要全局初始化缓存
        TenantUtils.executeIgnore(() -> {
-            // 第一步：基于 maxUpdateTime 判断缓存是否刷新。
-            // 如果没有增量的数据变化，则不进行本地缓存的刷新
-            if (maxUpdateTime != null
-                    && mpAccountMapper.selectCountByUpdateTimeGt(maxUpdateTime) == 0) {
-                log.info("[initLocalCacheIfUpdate][数据未发生变化({})，本地缓存不刷新]", maxUpdateTime);
-                return;
-            }
+            // 第一步：查询数据
            List<MpAccountDO> accounts = mpAccountMapper.selectList();
            log.info("[initLocalCacheIfUpdate][缓存公众号账号，数量为:{}]", accounts.size());

            // 第二步：构建缓存。创建或更新支付 Client
            mpServiceFactory.init(accounts);
            accountCache = CollectionUtils.convertMap(accounts, MpAccountDO::getAppId);
-
-            // 第三步：设置最新的 maxUpdateTime，用于下次的增量判断。
-            this.maxUpdateTime = CollectionUtils.getMaxValue(accounts, MpAccountDO::getUpdateTime);
        });
    }

    @Override
    public Long createAccount(MpAccountCreateReqVO createReqVO) {
-        // TODO 芋艿：校验唯一性
-        // 插入
-        MpAccountDO wxAccount = MpAccountConvert.INSTANCE.convert(createReqVO);
-        mpAccountMapper.insert(wxAccount);
+        // 校验 appId 唯一
+        validateAppIdUnique(null, createReqVO.getAppId());

-        // TODO 芋艿：刷新的方式
-        mpConfigDataProducer.sendDictDataRefreshMessage();
-        // 返回
-        return wxAccount.getId();
+        // 插入
+        MpAccountDO account = MpAccountConvert.INSTANCE.convert(createReqVO);
+        mpAccountMapper.insert(account);
+
+        // 发送刷新消息
+        mpAccountProducer.sendAccountRefreshMessage();
+        return account.getId();
    }

    @Override
    public void updateAccount(MpAccountUpdateReqVO updateReqVO) {
-        // TODO 芋艿：校验唯一性
        // 校验存在
-        validateWxAccountExists(updateReqVO.getId());
+        validateAccountExists(updateReqVO.getId());
+        // 校验 appId 唯一
+        validateAppIdUnique(updateReqVO.getId(), updateReqVO.getAppId());
+
        // 更新
        MpAccountDO updateObj = MpAccountConvert.INSTANCE.convert(updateReqVO);
        mpAccountMapper.updateById(updateObj);

-        // TODO 芋艿：刷新的方式
-        mpConfigDataProducer.sendDictDataRefreshMessage();
+        // 发送刷新消息
+        mpAccountProducer.sendAccountRefreshMessage();
    }

    @Override
    public void deleteAccount(Long id) {
        // 校验存在
-        validateWxAccountExists(id);
+        validateAccountExists(id);
        // 删除
        mpAccountMapper.deleteById(id);

-        // TODO 芋艿：刷新的方式
-        mpConfigDataProducer.sendDictDataRefreshMessage();
+        // 发送刷新消息
+        mpAccountProducer.sendAccountRefreshMessage();
    }

-    private void validateWxAccountExists(Long id) {
-        if (mpAccountMapper.selectById(id) == null) {
-            throw ServiceExceptionUtil.exception(ErrorCodeConstants.WX_ACCOUNT_NOT_EXISTS);
+    private MpAccountDO validateAccountExists(Long id) {
+        MpAccountDO account = mpAccountMapper.selectById(id);
+        if (account == null) {
+            throw ServiceExceptionUtil.exception(ErrorCodeConstants.ACCOUNT_NOT_EXISTS);
        }
+        return account;
+    }
+
+    @VisibleForTesting
+    public void validateAppIdUnique(Long id, String appId) {
+        // 多个租户，appId 是不能重复，否则公众号回调会无法识别
+        TenantUtils.executeIgnore(() -> {
+            MpAccountDO account = mpAccountMapper.selectByAppId(appId);
+            if (account == null) {
+                return;
+            }
+            // 存在 account 记录的情况下
+            if (id == null // 新增时，说明重复
+                    || ObjUtil.notEqual(id, account.getId())) { // 更新时，如果 id 不一致，说明重复
+                throw exception(USER_USERNAME_EXISTS);
+            }
+        });
    }

    @Override
@ -167,8 +156,36 @@ public class MpAccountServiceImpl implements MpAccountService {
    }

    @Override
-    public MpAccountDO findBy(SFunction<MpAccountDO, ?> field, Object val) {
-        return mpAccountMapper.selectOne(field, val);
+    public void generateAccountQrCode(Long id) {
+        // 校验存在
+        MpAccountDO account = validateAccountExists(id);
+
+        // 生成二维码
+        WxMpService mpService = mpServiceFactory.getRequiredMpService(account.getAppId());
+        String qrCodeUrl;
+        try {
+            WxMpQrCodeTicket qrCodeTicket = mpService.getQrcodeService().qrCodeCreateLastTicket("default");
+            qrCodeUrl = mpService.getQrcodeService().qrCodePictureUrl(qrCodeTicket.getTicket());
+        } catch (WxErrorException e) {
+            throw exception(ErrorCodeConstants.ACCOUNT_GENERATE_QR_CODE_FAIL, e.getError().getErrorMsg());
+        }
+
+        // 保存二维码
+        mpAccountMapper.updateById(new MpAccountDO().setId(id).setQrCodeUrl(qrCodeUrl));
+    }
+
+    @Override
+    public void clearAccountQuota(Long id) {
+        // 校验存在
+        MpAccountDO account = validateAccountExists(id);
+
+        // 生成二维码
+        WxMpService mpService = mpServiceFactory.getRequiredMpService(account.getAppId());
+        try {
+            mpService.clearQuota(account.getAppId());
+        } catch (WxErrorException e) {
+            throw exception(ErrorCodeConstants.ACCOUNT_CLEAR_QUOTA_FAIL, e.getError().getErrorMsg());
+        }
    }

 }
--- a/yudao-ui-admin/src/api/mp/account.js
+++ b/yudao-ui-admin/src/api/mp/account.js
@ -1,6 +1,6 @@
 import request from '@/utils/request'

-// 创建公众号账户
+// 创建公众号账号
 export function createAccount(data) {
  return request({
    url: '/mp/account/create',
@ -9,7 +9,7 @@ export function createAccount(data) {
  })
 }

-// 更新公众号账户
+// 更新公众号账号
 export function updateAccount(data) {
  return request({
    url: '/mp/account/update',
@ -18,7 +18,7 @@ export function updateAccount(data) {
  })
 }

-// 删除公众号账户
+// 删除公众号账号
 export function deleteAccount(id) {
  return request({
    url: '/mp/account/delete?id=' + id,
@ -26,7 +26,7 @@ export function deleteAccount(id) {
  })
 }

-// 获得公众号账户
+// 获得公众号账号
 export function getAccount(id) {
  return request({
    url: '/mp/account/get?id=' + id,
@ -34,7 +34,7 @@ export function getAccount(id) {
  })
 }

-// 获得公众号账户分页
+// 获得公众号账号分页
 export function getAccountPage(query) {
  return request({
    url: '/mp/account/page',
@ -43,12 +43,18 @@ export function getAccountPage(query) {
  })
 }

-// 导出公众号账户 Excel
-export function exportAccountExcel(query) {
+// 生成公众号二维码
+export function generateAccountQrCode(id) {
  return request({
-    url: '/mp/account/export-excel',
-    method: 'get',
-    params: query,
-    responseType: 'blob'
+    url: '/mp/account/generate-qr-code?id=' + id,
+    method: 'put'
+  })
+}
+
+// 清空公众号 API 配额
+export function clearAccountQuota(id) {
+  return request({
+    url: '/mp/account/clear-quota?id=' + id,
+    method: 'put'
  })
 }
--- a/yudao-ui-admin/src/views/mp/account/index.vue
+++ b/yudao-ui-admin/src/views/mp/account/index.vue
@ -28,16 +28,25 @@
      <el-table-column label="名称" align="center" prop="name"/>
      <el-table-column label="微信号" align="center" prop="account" width="180"/>
      <el-table-column label="appId" align="center" prop="appId" width="180"/>
-      <el-table-column label="appSecret" align="center" prop="appSecret" width="180"/>
-      <el-table-column label="Token" align="center" prop="token"/>
-      <el-table-column label="密钥" align="center" prop="aesKey"/>
-      <el-table-column label="二维码" align="center" prop="qrCodeUrl"/>
-      <el-table-column label="备注" align="center" prop="remark"/>
-      <el-table-column label="创建时间" align="center" prop="createTime" width="180">
-        <template slot-scope="scope">
-          <span>{{ parseTime(scope.row.createTime) }}</span>
+<!--      <el-table-column label="appSecret" align="center" prop="appSecret" width="180"/>-->
+<!--      <el-table-column label="token" align="center" prop="token"/>-->
+<!--      <el-table-column label="消息加解密密钥" align="center" prop="aesKey"/>-->
+      <el-table-column label="服务器地址(URL)" align="center" prop="appId" width="360">
+        <template v-slot="scope">
+          {{  'http://服务端地址/mp/open/' + scope.row.appId }}
        </template>
      </el-table-column>
+      <el-table-column label="二维码" align="center" prop="qrCodeUrl">
+        <template v-slot="scope">
+          <img v-if="scope.row.qrCodeUrl" :src="scope.row.qrCodeUrl" alt="二维码" style="height: 100px;" />
+        </template>
+      </el-table-column>
+      <el-table-column label="备注" align="center" prop="remark"/>
+<!--      <el-table-column label="创建时间" align="center" prop="createTime" width="180">-->
+<!--        <template slot-scope="scope">-->
+<!--          <span>{{ parseTime(scope.row.createTime) }}</span>-->
+<!--        </template>-->
+<!--      </el-table-column>-->
      <el-table-column label="操作" align="center" class-name="small-padding fixed-width">
        <template slot-scope="scope">
          <el-button size="mini" type="text" icon="el-icon-edit" @click="handleUpdate(scope.row)"
@ -46,6 +55,12 @@
          <el-button size="mini" type="text" icon="el-icon-delete" @click="handleDelete(scope.row)"
                     v-hasPermi="['mp:account:delete']">删除
          </el-button>
+          <el-button size="mini" type="text" icon="el-icon-refresh" @click="handleGenerateQrCode(scope.row)"
+                     v-hasPermi="['mp:account:qr-code']">生成二维码
+          </el-button>
+          <el-button size="mini" type="text" icon="el-icon-share" @click="handleCleanQuota(scope.row)"
+                     v-hasPermi="['mp:account:clear-quota']">清空 API 配额
+          </el-button>
        </template>
      </el-table-column>
    </el-table>
@ -55,13 +70,13 @@

    <!-- 对话框(添加 / 修改) -->
    <el-dialog :title="title" :visible.sync="open" width="500px" append-to-body>
-      <el-form ref="form" :model="form" :rules="rules" label-width="100px">
+      <el-form ref="form" :model="form" :rules="rules" label-width="120px">
        <el-form-item label="名称" prop="name">
          <el-input v-model="form.name" placeholder="请输入名称"/>
        </el-form-item>
        <el-form-item label="微信号" prop="account">
         <span slot="label">
-           <el-tooltip content="在微信公众平台（mp.weixin.qq.com）的菜单【设置】-【公众号设置】-【帐号详情】中能找到原始ID" placement="top">
+           <el-tooltip content="在微信公众平台（mp.weixin.qq.com）的菜单 [设置与开发 - 公众号设置 - 账号详情] 中能找到「微信号」" placement="top">
              <i class="el-icon-question" />
           </el-tooltip>
           微信号
@ -70,30 +85,30 @@
        </el-form-item>
        <el-form-item label="appId" prop="appId">
          <span slot="label">
-            <el-tooltip content="在微信公众平台（mp.weixin.qq.com）的菜单【开发】-【基本配置】中能找到 appId" placement="top">
+            <el-tooltip content="在微信公众平台（mp.weixin.qq.com）的菜单 [设置与开发 - 公众号设置 - 基本设置] 中能找到「开发者ID(AppID)」" placement="top">
              <i class="el-icon-question" />
            </el-tooltip>
            appId
          </span>
          <el-input v-model="form.appId" placeholder="请输入公众号 appId"/>
        </el-form-item>
-        <el-form-item label="密钥" prop="appSecret">
+        <el-form-item label="appSecret" prop="appSecret">
          <span slot="label">
-            <el-tooltip content="在微信公众平台（mp.weixin.qq.com）的菜单【开发】-【基本配置】中能找到密钥" placement="top">
+            <el-tooltip content="在微信公众平台（mp.weixin.qq.com）的菜单 [设置与开发 - 公众号设置 - 基本设置] 中能找到「开发者密码(AppSecret)」" placement="top">
              <i class="el-icon-question" />
            </el-tooltip>
-            密钥
+            appSecret
          </span>
          <el-input v-model="form.appSecret" placeholder="请输入公众号 appSecret"/>
        </el-form-item>
        <el-form-item label="token" prop="token">
          <el-input v-model="form.token" placeholder="请输入公众号token"/>
        </el-form-item>
-        <el-form-item label="加密密钥" prop="aesKey">
-          <el-input v-model="form.aesKey" placeholder="请输入加密密钥"/>
+        <el-form-item label="消息加解密密钥" prop="aesKey">
+          <el-input v-model="form.aesKey" placeholder="请输入消息加解密密钥"/>
        </el-form-item>
        <el-form-item label="备注" prop="remark">
-          <el-input v-model="form.remark" placeholder="请输入备注"/>
+          <el-input type="textarea" v-model="form.remark" placeholder="请输入备注"/>
        </el-form-item>
      </el-form>
      <div slot="footer" class="dialog-footer">
@ -105,7 +120,15 @@
 </template>

 <script>
-import { createAccount, deleteAccount, getAccount, getAccountPage, updateAccount} from '@/api/mp/account'
+import {
+  clearAccountQuota,
+  createAccount,
+  deleteAccount,
+  generateAccountQrCode,
+  getAccount,
+  getAccountPage,
+  updateAccount
+} from '@/api/mp/account'

 export default {
  name: 'mpAccount',
@ -120,7 +143,7 @@ export default {
      showSearch: true,
      // 总条数
      total: 0,
-      // 公众号账户列表
+      // 公众号账号列表
      list: [],
      // 弹出层标题
      title: '',
@ -139,7 +162,7 @@ export default {
      // 表单校验
      rules: {
        name: [{required: true, message: '名称不能为空', trigger: 'blur'}],
-        account: [{required: true, message: '公众号账户不能为空', trigger: 'blur'}],
+        account: [{required: true, message: '公众号账号不能为空', trigger: 'blur'}],
        appId: [{required: true, message: '公众号 appId 不能为空', trigger: 'blur'}],
        appSecret: [{required: true, message: '公众号密钥不能为空', trigger: 'blur'}],
        token: [{required: true, message: '公众号 token 不能为空', trigger: 'blur'}],
@ -199,7 +222,7 @@ export default {
    handleAdd() {
      this.reset()
      this.open = true
-      this.title = '添加公众号账户'
+      this.title = '添加公众号账号'
    },
    /** 修改按钮操作 */
    handleUpdate(row) {
@ -208,7 +231,7 @@ export default {
      getAccount(id).then(response => {
        this.form = response.data
        this.open = true
-        this.title = '修改公众号账户'
+        this.title = '修改公众号账号'
        this.disabled = true
      })
    },
@ -238,7 +261,7 @@ export default {
    /** 删除按钮操作 */
    handleDelete(row) {
      const id = row.id
-      this.$modal.confirm('是否确认删除公众号账户编号为"' + row.name + '"的数据项?').then(function () {
+      this.$modal.confirm('是否确认删除公众号账号编号为"' + row.name + '"的数据项?').then(function () {
        return deleteAccount(id)
      }).then(() => {
        this.getList()
@ -246,6 +269,27 @@ export default {
      }).catch(() => {
      })
    },
+    /** 生成二维码的按钮操作 */
+    handleGenerateQrCode(row) {
+      const id = row.id
+      this.$modal.confirm('是否确认生成公众号账号编号为"' + row.name + '"的二维码?').then(function () {
+        return generateAccountQrCode(id)
+      }).then(() => {
+        this.getList()
+        this.$modal.msgSuccess('生成二维码成功')
+      }).catch(() => {
+      })
+    },
+    /** 清空二维码 API 配额的按钮操作 */
+    handleCleanQuota(row) {
+      const id = row.id
+      this.$modal.confirm('是否清空生成公众号账号编号为"' + row.name + '"的 API 配额?').then(function () {
+        return clearAccountQuota(id)
+      }).then(() => {
+        this.$modal.msgSuccess('清空 API 配额成功')
+      }).catch(() => {
+      })
+    },
  }
 }
 </script>