微信运营架构与账号模型

模块关系

微信运营后台由以下部分组成：

后台 UI 经网关使用 /weixin/** 访问微信后台服务。控制器内部路径不带 /weixin，例如控制器 /wxmalivemember/page 的前端地址为 /weixin/wxmalivemember/page。

微信账号主模型

所有公众号和小程序都复用 wx_app：

Pro 微信账号表不保存支付商户密钥或支付证书。支付配置由独立的 joolun-pay 模块管理。

页面账号下拉只返回 AppID 和名称等非敏感字段。服务端不能只相信前端传入的 AppID，必须同时校验 tenant_id 和 app_type。

接入模式

手动接入

适合少量公众号或小程序：

1. 在微信公众平台取得 AppID、AppSecret、Token 和 EncodingAESKey。
2. 在后台对应的公众号或小程序账号管理中新增账号。
3. 将后台提供的消息地址配置到微信公众平台。
4. 执行凭据检测，确认 access token 和回调配置有效。

手动接入账号依赖自身 AppSecret 获取 access token。

第三方平台授权接入

适合批量代运营：

1. 配置 wx.component。
2. 在第三方平台授权账号页面生成授权地址。
3. 公众号或小程序管理员扫码完成授权。
4. 微信回调写入或更新同一条 wx_app，并标记 is_component=1。
5. 后续 access token、发布、域名等能力通过第三方平台授权链路执行。

重新授权不会先删除原账号和用户关系。授权账号管理提供同步、令牌刷新和微信侧全量对账。

微信服务选择

• 公众号能力通过微信公众平台接口调用。
• 小程序能力通过微信小程序接口调用。
• 第三方平台能力通过微信开放平台接口调用。
• 直连账号和第三方平台授权账号由配置层选择相应服务，业务页面不要求运营人员区分 SDK 调用方式。

租户与平台边界

• 公众号和小程序业务页面只允许管理当前租户账号。
• 平台级第三方平台配置、代码模板库和平台域名默认属于系统平台管理员能力。
• 授权账号本身仍有租户归属，不能因为由同一个第三方平台托管而跨租户读取。
• ROLE_ADMIN 只是角色类型，仍必须结合租户和父菜单授权判断。

状态来源

判断问题时先确认该页面的数据来源，避免把微信尚未返回的数据误认为数据库同步失败。