主题
公众号管理 PRD
文档信息
| 项目 | 内容 |
|---|---|
| 文档编号 | PRD-10-01 |
| 文档名称 | 公众号管理 |
| 产品名称 | PMForge 项目管理平台 |
| 所属模块 | 微信公众号(pmforge-module-mp) |
| 文档版本 | v2.2 |
| 最后更新 | 2026-11-18 |
| 文档状态 | 已更新 |
| 实施状态 | 预留(已编译,未接入运行时) |
| 优先级 | P1 |
1. 功能概述
1.1 功能定位
公众号管理是平台面向「微信生态运营」的底座模块:把公众号账号、菜单、素材、图文草稿与发布、自动回复、粉丝消息、模板消息、粉丝与标签、运营数据集中到一个后台,让运营同学不必在微信公众平台与业务系统之间来回切换。
它解决的是**「内容和粉丝在哪、发过什么、谁在跟进」三件事无法沉淀**的问题:微信公众平台只提供操作界面,不提供与企业内部账号、权限、审计、文件存储的打通;本模块把这层打通,并保留与微信开放接口的完整对应关系。
1.2 目标用户与核心诉求
| 角色 | 核心诉求 | 典型动作 |
|---|---|---|
| 公众号管理员 | 账号接入安全、菜单可控、异常可查 | 新增账号、配置菜单、清空配额重试 |
| 内容运营 | 写稿—预览—发布一条链路 | 建草稿、传素材、提交发布、看发布记录 |
| 客服/社群运营 | 及时回复、按标签触达 | 查粉丝消息、发模板消息、给粉丝打标签 |
| 数据分析 | 粉丝涨跌、消息触达效果 | 看粉丝增减、累计、消息概况、接口调用量 |
| 系统管理员 | 权限与审计 | 分配 mp:* 权限点、查操作日志与 API 日志 |
1.3 业务价值
- 账号集中:一套后台管理多个公众号,避免多人共用微信后台账号。
- 内容留痕:草稿、发布、素材都在库中,可按账号/时间检索与复用。
- 触达闭环:粉丝—标签—模板消息串起来,运营动作可复盘。
- 可观测:微信接口失败原因透传为业务错误码,配额与调用量可见。
1.4 功能范围
本期包含
- 公众号账号接入、二维码、API 配额重置;
- 自定义菜单配置与同步;
- 素材(临时/永久/图文内图片)上传、查询、删除;
- 图文草稿增删改查与发布、发布记录查询与删除;
- 关注回复、消息类型回复、关键词回复;
- 粉丝消息查询与主动发送;
- 模板消息同步、查询、删除、发送;
- 粉丝列表/详情/更新/同步,标签增删改查与同步、粉丝打标签;
- 运营数据:粉丝增减、粉丝累计、消息发送概况、接口调用概况;
- 微信服务器回调入口(GET 校验 + POST 事件接收)。
本期不包含
- 小程序、企业微信、视频号;
- 微信支付、卡券、广告投放;
- 图文内容的富文本编辑器实现(由前端提供,本模块只存结构化字段);
- 多租户下的公众号「共享池」策略(当前按租户隔离账号)。
2. 用户场景
2.1 用户角色
- 公众号管理员:负责账号接入与菜单,权限
mp:account:*、mp:menu:*。 - 内容运营:负责素材、草稿、发布,权限
mp:material:*、mp:draft:*、mp:free-publish:*。 - 客服运营:负责会话与触达,权限
mp:message:*、mp:message-template:*、mp:user:*、mp:tag:*。 - 数据分析:只读统计,权限
mp:statistics:query。
2.2 核心使用场景
| 编号 | 场景 | 触发 | 期望结果 |
|---|---|---|---|
| S-01 | 新公众号接入 | 运营拿到 appId/appSecret | 账号创建成功,能生成二维码、能拉取粉丝 |
| S-02 | 菜单改版 | 市场活动需要三个一级菜单 | 保存后微信侧菜单生效,粉丝端可见 |
| S-03 | 活动图文发布 | 内容同学写好稿 | 草稿保存 → 提交发布 → 发布记录可查 |
| S-04 | 关键词自动回复 | 用户回复「报价」 | 命中关键词规则,返回配置的图文/文本 |
| S-05 | 订单提醒触达 | 业务系统触发 | 模板消息按 openid 发送成功,失败原因可查 |
| S-06 | 粉丝分层 | 运营按来源打标签 | 标签同步到微信,粉丝可按标签筛选 |
| S-07 | 周报复盘 | 每周一看数据 | 粉丝增减、累计、消息概况可导出/截图 |
2.3 用户故事与验收标准
| 编号 | 用户故事 | 优先级 | 验收标准 |
|---|---|---|---|
| US-01 | 作为公众号管理员,我希望接入一个公众号账号,以便统一管理 | P0 | ① 必填:名称、appId、appSecret;② appId 全局唯一;③ appSecret 加密存储,接口不回显明文;④ 接入后能成功获取 access_token;⑤ 失败时返回微信原始错误原因 |
| US-02 | 作为管理员,我希望看到账号列表并生成二维码 | P0 | ① 分页支持名称/appId 模糊搜索;② 精简列表供下拉选择;③ 生成二维码返回图片地址;④ 生成失败提示原因 |
| US-03 | 作为管理员,我希望清空账号的 API 配额 | P1 | ① 仅测试/运维用途;② 清空后配额计数归零;③ 失败返回原因 |
| US-04 | 作为管理员,我希望配置自定义菜单 | P0 | ① 一级最多 3 个、二级最多 5 个;② 支持跳转网页、小程序、图文素材、点击事件;③ 保存即同步微信;④ 同步失败保留本地配置并提示 |
| US-05 | 作为内容运营,我希望上传素材 | P0 | ① 支持临时素材与永久素材;② 支持图文消息内图片上传;③ 返回 mediaId 与 url;④ 单文件大小与格式按微信限制校验 |
| US-06 | 作为内容运营,我希望管理图文草稿 | P0 | ① 草稿含多篇图文(标题、作者、摘要、正文、封面、原文链接);② 支持新建/更新/删除/分页;③ 正文长度按微信限制校验;④ 草稿与账号绑定,跨账号不可见 |
| US-07 | 作为内容运营,我希望把草稿发布出去 | P0 | ① 提交发布需选择草稿;② 发布结果异步,需可轮询/查列表;③ 发布记录可删除;④ 失败返回微信错误码 |
| US-08 | 作为客服运营,我希望配置自动回复 | P0 | ① 关注回复每个账号唯一;② 按消息类型回复每种类型唯一;③ 关键词回复同一关键字唯一;④ 支持全匹配/半匹配 |
| US-09 | 作为客服运营,我希望查看并回复粉丝消息 | P1 | ① 按账号/粉丝/时间分页;② 支持发送文本、图片、图文、音乐等类型;③ 发送失败返回原因 |
| US-10 | 作为客服运营,我希望用模板消息触达 | P1 | ① 可从微信同步模板;② 可查询/删除本地模板;③ 发送时传 openid + 参数;④ 失败原因透传 |
| US-11 | 作为运营,我希望管理粉丝与标签 | P1 | ① 粉丝列表按昵称/标签筛选;② 支持从微信同步粉丝;③ 标签增删改查并同步;④ 支持给粉丝批量打标签 |
| US-12 | 作为数据分析,我希望看运营数据 | P2 | ① 粉丝增减按日期区间;② 粉丝累计;③ 消息发送概况;④ 接口调用概况;⑤ 数据来自微信接口,缓存 5 分钟 |
| US-13 | 作为系统管理员,我希望接收微信事件回调 | P0 | ① GET 校验签名通过才返回 echostr;② 支持明文/密文/兼容模式;③ 关注/取关/消息/菜单点击事件落库;④ 异常不阻塞返回 |
3. 功能需求
3.1 账号管理
| 功能 | 说明 | 权限点 | 接口 |
|---|---|---|---|
| 创建账号 | 名称、appId、appSecret、token、aesKey 接入 | mp:account:create | POST /admin-api/mp/account/create |
| 更新账号 | 名称、密钥轮换 | mp:account:update | PUT /admin-api/mp/account/update |
| 删除账号 | 逻辑删除,关联数据保留 | mp:account:delete | DELETE /admin-api/mp/account/delete |
| 账号详情 | 不返回 appSecret 明文 | mp:account:query | GET /admin-api/mp/account/get |
| 账号分页 | 名称/appId 搜索 | mp:account:query | GET /admin-api/mp/account/page |
| 精简列表 | 下拉选择 | mp:account:query | GET /admin-api/mp/account/list-all-simple |
| 生成二维码 | 返回带参数二维码图片 | mp:account:qr-code | PUT /admin-api/mp/account/generate-qr-code |
| 清空配额 | 重置当日调用计数 | mp:account:clear-quota | PUT /admin-api/mp/account/clear-quota |
规则:appId 唯一;appSecret 使用平台加密器存储;删除前校验是否仍有关联草稿/菜单(存在则提示先清理)。
3.2 菜单管理
| 功能 | 说明 | 权限点 | 接口 |
|---|---|---|---|
| 保存菜单 | 全量覆盖式保存,保存后同步微信 | mp:menu:save | POST /admin-api/mp/menu/save |
| 删除菜单 | 删除微信侧菜单 | mp:menu:delete | DELETE /admin-api/mp/menu/delete |
| 菜单列表 | 返回树形结构 | mp:menu:query | GET /admin-api/mp/menu/list |
规则:一级 3 个、二级 5 个;叶子节点才允许配置动作;动作类型包含跳转网页、小程序、图文素材、点击推事件;保存失败时本地记录保留,供修正后重试。
3.3 素材管理
| 功能 | 说明 | 权限点 | 接口 |
|---|---|---|---|
| 上传临时素材 | 有效期 3 天 | mp:material:upload-temporary | POST /admin-api/mp/material/upload-temporary |
| 上传永久素材 | 图文/图片/语音/视频 | mp:material:upload-permanent | POST /admin-api/mp/material/upload-permanent |
| 上传图文内图片 | 不占用永久素材配额 | mp:material:upload-news-image | POST /admin-api/mp/material/upload-news-image |
| 删除永久素材 | 按 mediaId 删除 | mp:material:delete | DELETE /admin-api/mp/material/delete-permanent |
| 素材分页 | 按类型/永久性筛选 | mp:material:query | GET /admin-api/mp/material/page |
3.4 草稿与发布
| 功能 | 说明 | 权限点 | 接口 |
|---|---|---|---|
| 草稿分页 | 按账号、标题筛选 | mp:draft:query | GET /admin-api/mp/draft/page |
| 新建草稿 | 多篇图文,封面用永久素材 mediaId | mp:draft:create | POST /admin-api/mp/draft/create |
| 更新草稿 | 全量替换图文列表 | mp:draft:update | PUT /admin-api/mp/draft/update |
| 删除草稿 | 同步删除微信草稿 | mp:draft:delete | DELETE /admin-api/mp/draft/delete |
| 发布草稿 | 提交后由微信异步处理 | mp:free-publish:submit | POST /admin-api/mp/free-publish/submit |
| 发布记录 | 查询已发布图文 | mp:free-publish:query | GET /admin-api/mp/free-publish/page |
| 删除发布 | 删除已发布记录 | mp:free-publish:delete | DELETE /admin-api/mp/free-publish/delete |
3.5 自动回复
| 功能 | 说明 | 权限点 | 接口 |
|---|---|---|---|
| 自动回复分页 | 按类型/关键字筛选 | mp:auto-reply:query | GET /admin-api/mp/auto-reply/page |
| 自动回复详情 | — | mp:auto-reply:query | GET /admin-api/mp/auto-reply/get |
| 新建 | 关注/消息/关键词三类 | mp:auto-reply:create | POST /admin-api/mp/auto-reply/create |
| 更新 | 修改回复内容与匹配方式 | mp:auto-reply:update | PUT /admin-api/mp/auto-reply/update |
| 删除 | — | mp:auto-reply:delete | DELETE /admin-api/mp/auto-reply/delete |
唯一性规则:关注每个账号 1 条;消息类型每个账号每种类型 1 条;关键词每个账号每个关键字 1 条(重复返回「已存在该关键字的回复」)。
3.6 消息与模板消息
| 功能 | 说明 | 权限点 | 接口 |
|---|---|---|---|
| 消息分页 | 按粉丝/账号/时间 | mp:message:query | GET /admin-api/mp/message/page |
| 发送消息 | 文本/图片/图文/音乐 | mp:message:send | POST /admin-api/mp/message/send |
| 模板同步 | 从微信拉取模板列表 | mp:message-template:sync | POST /admin-api/mp/message-template/sync |
| 模板列表 | — | mp:message-template:query | GET /admin-api/mp/message-template/list |
| 模板详情 | — | mp:message-template:query | GET /admin-api/mp/message-template/get |
| 删除模板 | — | mp:message-template:delete | DELETE /admin-api/mp/message-template/delete |
| 发送模板消息 | openid + data | mp:message-template:send | POST /admin-api/mp/message-template/send |
3.7 粉丝与标签
| 功能 | 说明 | 权限点 | 接口 |
|---|---|---|---|
| 粉丝分页 | 昵称/标签/关注状态筛选 | mp:user:query | GET /admin-api/mp/user/page |
| 粉丝详情 | — | mp:user:query | GET /admin-api/mp/user/get |
| 更新粉丝 | 备注、标签 | mp:user:update | PUT /admin-api/mp/user/update |
| 同步粉丝 | 从微信全量/增量同步 | mp:user:sync | POST /admin-api/mp/user/sync |
| 标签分页 | — | mp:tag:query | GET /admin-api/mp/tag/page |
| 标签详情 | — | mp:tag:query | GET /admin-api/mp/tag/get |
| 标签精简列表 | 下拉选择 | mp:account:query | GET /admin-api/mp/tag/list-all-simple |
| 创建标签 | 同步到微信 | mp:tag:create | POST /admin-api/mp/tag/create |
| 更新标签 | — | mp:tag:update | PUT /admin-api/mp/tag/update |
| 删除标签 | 粉丝上的该标签同步移除 | mp:tag:delete | DELETE /admin-api/mp/tag/delete |
| 同步标签 | 拉取微信标签 | mp:tag:sync | POST /admin-api/mp/tag/sync |
3.8 数据统计
| 功能 | 说明 | 权限点 | 接口 |
|---|---|---|---|
| 粉丝增减 | 按日期区间,最多 30 天 | mp:statistics:query | GET /admin-api/mp/statistics/user-summary |
| 粉丝累计 | 按日期区间 | mp:statistics:query | GET /admin-api/mp/statistics/user-cumulate |
| 消息发送概况 | 按日期区间 | mp:statistics:query | GET /admin-api/mp/statistics/upstream-message |
| 接口调用概况 | 按日期区间 | mp:statistics:query | GET /admin-api/mp/statistics/interface-summary |
3.9 开放回调
| 功能 | 说明 | 权限点 | 接口 |
|---|---|---|---|
| 回调校验(GET) | 校验 signature/timestamp/nonce,返回 echostr | 公开(签名校验) | GET /admin-api/mp/open/{appId} |
| 事件接收(POST) | 关注/取关/文本/图片/菜单点击等事件 | 公开(签名校验) | POST /admin-api/mp/open/{appId} |
规则:回调必须校验签名;支持明文、密文、兼容三种模式;处理异常要吞掉并返回 success,避免微信重试风暴;事件消息落 mp_message 表供后台查询。
4. 非功能需求
4.1 性能要求
- 后台列表接口 P95 < 500ms(单账号 10 万粉丝以内)。
- 微信接口调用单独超时(连接 3s、读取 5s),失败快速返回,不阻塞页面。
- 粉丝同步按分页批量写入,单次 1 万粉丝不超过 60s。
4.2 安全要求
- appSecret 使用平台
encryptor加密存储,接口与日志均不回显明文。 - access_token 集中缓存于 Redis(key 按 appId 隔离),过期前 5 分钟刷新,避免并发刷新击穿。
- 所有写操作记录操作日志(
@LogRecord),所有接口调用记录 API 日志(@ApiAccessLog)。 - 回调入口校验签名,并限制请求体大小。
4.3 兼容性要求
- 支持 MySQL / PostgreSQL / Oracle / SQL Server / 达梦 / Kingbase / openGauss / HighGo 八套脚本。
- 微信接口版本以公众平台当前稳定版为准,字段新增按「忽略未知字段」处理。
4.4 可用性要求
- 微信侧限流/配额耗尽时返回明确错误码与原因,页面提示「稍后重试或清空配额」。
- 单账号故障不影响其它账号;同步类操作可重试且幂等。
5. 数据设计
5.1 数据表概览
| 表名 | 说明 | 关键字段 |
|---|---|---|
mp_account | 公众号账号 | app_id、app_secret、token、aes_key |
mp_menu | 自定义菜单 | account_id、parent_id、type、menu_key |
mp_material | 素材 | account_id、media_id、type、permanent |
mp_draft 关联的图文存储于 mp_material/草稿结构 | 草稿图文 | 标题、作者、摘要、封面 media_id |
mp_auto_reply | 自动回复 | account_id、type、request_keyword、request_match |
mp_message | 粉丝消息与事件 | account_id、openid、type、send_from、event |
mp_message_template | 模板消息 | account_id、template_id、title、content |
mp_user | 粉丝 | app_id、openid、tag_ids、subscribe_status |
mp_tag | 标签 | account_id、tag_id、name |
说明:草稿与发布记录由微信侧持有
media_id,本地保存结构化字段(标题/作者/摘要/正文/封面/原文链接),发布时以media_id与微信交互。
5.2 关键约束
mp_account.app_id唯一;mp_user(app_id, openid)唯一;mp_tag(account_id, tag_id)唯一。mp_auto_reply按type做业务唯一(关注 1 条、每消息类型 1 条、每关键字 1 条),由服务层校验。- 所有表带
tenant_id(租户隔离)、creator/create_time/updater/update_time、deleted逻辑删除。
5.3 缓存设计
| 缓存 | Key | TTL | 说明 |
|---|---|---|---|
| access_token | mp:access_token:{appId} | 7000s | 提前 5 分钟刷新 |
| API 配额 | mp:quota:{appId}:{date} | 当日 | 调用前自增,超限拒绝 |
| 统计结果 | mp:statistics:{appId}:{type}:{range} | 300s | 降低微信调用次数 |
6. 跨模块联动
| 关联模块 | 联动点 | 说明 |
|---|---|---|
| system | 用户、租户、字典、权限、操作日志 | 权限点 mp:* 归属菜单;操作日志记录关键动作 |
| infra | 文件存储、API 日志、定时任务 | 素材与封面存文件服务;回调与页面调用记 API 日志;粉丝/模板同步可由定时任务触发 |
| im/通知 | 运营提醒 | 发布失败、配额告警可走站内信(规划) |
7. 附录
7.1 权限标识汇总
mp:account:{create,update,delete,query,qr-code,clear-quota}、mp:menu:{save,delete,query}、mp:material:{upload-temporary,upload-permanent,upload-news-image,delete,query}、mp:draft:{create,update,delete,query}、mp:free-publish:{submit,query,delete}、mp:auto-reply:{create,update,delete,query}、mp:message:{query,send}、mp:message-template:{sync,query,delete,send}、mp:user:{query,update,sync}、mp:tag:{create,update,delete,query,sync}、mp:statistics:query。
7.2 接口汇总
见文末「代码对齐(自动生成)」章节的接口对照表与 docs/code/api/mp.md。
7.3 错误码定义
| 错误码 | 说明 |
|---|---|
1_006_000_000 | 公众号账号不存在 |
1_006_000_001 | 生成公众号二维码失败,原因:{} |
1_006_000_002 | 清空公众号的 API 配额失败,原因:{} |
1_006_001_000 | 获取粉丝增减数据失败,原因:{} |
1_006_001_001 | 获得粉丝累计数据失败,原因:{} |
1_006_001_002 | 获得消息发送概况数据失败,原因:{} |
1_006_001_003 | 获得接口分析数据失败,原因:{} |
1_006_002_000 | 标签不存在 |
1_006_002_001 | 创建标签失败,原因:{} |
1_006_003_000 | 粉丝不存在 |
1_006_003_001 | 更新粉丝标签失败,原因:{} |
1_006_004_000 | 素材不存在 |
1_006_004_001 | 上传素材失败,原因:{} |
1_006_005_000 | 发送消息失败,原因:{} |
1_006_006_001 | 提交发布失败,原因:{} |
1_006_007_001 | 创建草稿失败,原因:{} |
1_006_008_000 | 创建菜单失败,原因:{} |
1_006_009_000 | 自动回复不存在 |
1_006_009_001 | 操作失败,原因:已存在关注时的回复 |
1_006_009_003 | 操作失败,原因:已存在该关键字的回复 |
1_006_010_000 | 模版消息不存在 |
1_006_010_003 | 同步模版消息失败,原因:{} |
1_006_010_004 | 发送模版消息失败,原因:{} |
7.4 名词解释
| 名词 | 说明 |
|---|---|
| appId / appSecret | 公众号唯一标识与密钥 |
| access_token | 调用微信接口的凭证,7200s 有效 |
| mediaId | 微信素材标识,临时素材 3 天有效 |
| openid | 粉丝在单个公众号内的唯一标识 |
| unionId | 同一微信开放平台账号下的跨应用唯一标识 |
| 模板消息 | 微信服务号下发通知的模板能力 |
代码对齐(自动生成)
本节由
tools/docs/prd-align.mjs从源码与 SQL 解析生成,请勿手工编辑;重跑npm run prd:align会整体替换。
1. 模块规模
| 控制器 | 接口 | 权限点 | 数据表 |
|---|---|---|---|
| 12 | 51 | 40 | 8 |
2. 控制器清单
| 控制器 | 基础路径 | 接口数 | 权限点数 | 代码位置 |
|---|---|---|---|---|
| MpAccountController | /mp/account | 8 | 6 | modules/mp/src/main/java/com/pmforge/module/mp/controller/admin/account/MpAccountController.java |
| MpAutoReplyController | /mp/auto-reply | 5 | 4 | modules/mp/src/main/java/com/pmforge/module/mp/controller/admin/message/MpAutoReplyController.java |
| MpDraftController | /mp/draft | 4 | 4 | modules/mp/src/main/java/com/pmforge/module/mp/controller/admin/news/MpDraftController.java |
| MpFreePublishController | /mp/free-publish | 3 | 3 | modules/mp/src/main/java/com/pmforge/module/mp/controller/admin/news/MpFreePublishController.java |
| MpMaterialController | /mp/material | 5 | 5 | modules/mp/src/main/java/com/pmforge/module/mp/controller/admin/material/MpMaterialController.java |
| MpMenuController | /mp/menu | 3 | 3 | modules/mp/src/main/java/com/pmforge/module/mp/controller/admin/menu/MpMenuController.java |
| MpMessageController | /mp/message | 2 | 2 | modules/mp/src/main/java/com/pmforge/module/mp/controller/admin/message/MpMessageController.java |
| MpMessageTemplateController | /mp/message-template | 5 | 4 | modules/mp/src/main/java/com/pmforge/module/mp/controller/admin/message/MpMessageTemplateController.java |
| MpOpenController | /mp/open | 2 | 0 | modules/mp/src/main/java/com/pmforge/module/mp/controller/admin/open/MpOpenController.java |
| MpStatisticsController | /mp/statistics | 4 | 1 | modules/mp/src/main/java/com/pmforge/module/mp/controller/admin/statistics/MpStatisticsController.java |
| MpTagController | /mp/tag | 7 | 6 | modules/mp/src/main/java/com/pmforge/module/mp/controller/admin/tag/MpTagController.java |
| MpUserController | /mp/user | 4 | 3 | modules/mp/src/main/java/com/pmforge/module/mp/controller/admin/user/MpUserController.java |
3. 接口对照
本文引用 51 个接口,代码中存在 51 个(命中率 100%)。
| 本文接口 | 代码中 | 对应真实接口 |
|---|---|---|
/mp/account/create | ✅ | |
/mp/account/update | ✅ | |
/mp/account/delete | ✅ | |
/mp/account/get | ✅ | |
/mp/account/page | ✅ | |
/mp/account/list-all-simple | ✅ | |
/mp/account/generate-qr-code | ✅ | |
/mp/account/clear-quota | ✅ | |
/mp/menu/save | ✅ | |
/mp/menu/delete | ✅ | |
/mp/menu/list | ✅ | |
/mp/material/upload-temporary | ✅ | |
/mp/material/upload-permanent | ✅ | |
/mp/material/upload-news-image | ✅ | |
/mp/material/delete-permanent | ✅ | |
/mp/material/page | ✅ | |
/mp/draft/page | ✅ | |
/mp/draft/create | ✅ | |
/mp/draft/update | ✅ | |
/mp/draft/delete | ✅ | |
/mp/free-publish/submit | ✅ | |
/mp/free-publish/page | ✅ | |
/mp/free-publish/delete | ✅ | |
/mp/auto-reply/page | ✅ | |
/mp/auto-reply/get | ✅ | |
/mp/auto-reply/create | ✅ | |
/mp/auto-reply/update | ✅ | |
/mp/auto-reply/delete | ✅ | |
/mp/message/page | ✅ | |
/mp/message/send | ✅ | |
/mp/message-template/sync | ✅ | |
/mp/message-template/list | ✅ | |
/mp/message-template/get | ✅ | |
/mp/message-template/delete | ✅ | |
/mp/message-template/send | ✅ | |
/mp/user/page | ✅ | |
/mp/user/get | ✅ | |
/mp/user/update | ✅ | |
/mp/user/sync | ✅ | |
/mp/tag/page | ✅ | |
/mp/tag/get | ✅ | |
/mp/tag/list-all-simple | ✅ | |
/mp/tag/create | ✅ | |
/mp/tag/update | ✅ | |
/mp/tag/delete | ✅ | |
/mp/tag/sync | ✅ | |
/mp/statistics/user-summary | ✅ | |
/mp/statistics/user-cumulate | ✅ | |
/mp/statistics/upstream-message | ✅ | |
/mp/statistics/interface-summary | ✅ | |
/mp/open/{id} | ✅ |
4. 数据表
| 表名 | 说明 |
|---|---|
mp_account | MpAccountDO |
mp_auto_reply | MpAutoReplyDO |
mp_material | MpMaterialDO |
mp_menu | MpMenuDO |
mp_message | Article |
mp_message_template | MpMessageTemplateDO |
mp_tag | MpTagDO |
mp_user | MpUserDO |
5. 说明
- 模块码:
mp(微信公众号);PRD 编号:10-01。 - 「接口对照」只统计本文用反引号显式写出的
/admin-api/...路径;未写接口的章节不代表没有实现。 - 代码位置为相对仓库根的路径,行号可在功能卡或
docs/code/api/中查到。
文档变更记录
| 版本 | 日期 | 变更说明 | 作者 |
|---|---|---|---|
| v2.2 | 2026-11-18 | 补齐公众号模块 PRD:13 条用户故事、9 组功能需求、8 张表、42 个权限点、52 个接口,按代码现状撰写 | 产品 |