基于企业微信API的微应用前端与后端架构设计

1. 引言

微应用前端负责给员工点:查订单、提审批、看客户。后端负责鉴权、任务、出站。把发送写进按钮点击函数里,页面一卡、人连点,就是多条通知。架构要把「界面操作」和「投递」切开。

2. 三层不要焊死

text 复制代码
前端(工作台 / 管理页)
  → 后端业务 API(鉴权、校验、写任务)
    → 发送进程(号在线才出站)
      → 员工会话
回调入口 → 入队 → 业务消费 → 回写工作台

前端不持有发送凭证。凭证在发送进程。员工在前端看到的「已发送」,以任务状态为准,不要以按钮返回为准。

QiWe API 放在发送进程和回调入口,不要嵌进浏览器。

3. 前端

工作台可以是你们自己的管理端,不必先上官方 JS-SDK。需要的是:当前员工、当前客户绑定、任务列表、失败原因(存活 / 对象 / 投递)。不要在前端拼会话 ID 当隐藏域长期保存后还拿去发。

后端怎么调发送,以 API文档 为准。

4. 后端

python 复制代码
def create_notify(user, customer_no, text, db):
    bind = db.get_bind(user.device, customer_no)
    if not bind:
        return {"ok": False, "reason": "unbound"}
    key = f"ui:{user.id}:{customer_no}:{hash(text)}"
    if db.try_insert(key):
        db.enqueue(user.device, bind["peer"], text)
    return {"ok": True}

出站交给 QiWe API。回调入口只入队。前端轮询任务状态,不轮询聊天窗口。

测试和生产不能共用任务表。前端环境标识必须传到任务行上。

频率、回调和附件分模块做,不要挤进页面按钮。

5. 验收

连点三次按钮只有一条出站;关闭页面后任务仍会发;号掉线时前端看到的是存活失败,不是「接口 500 自己猜」。

6. 总结

微应用架构的合格线:前端无凭证、后端有任务、发送有进程、回调有队列。企业微信API是出站层,不是页面组件。

相关推荐
feixing_fx15 小时前
第一个 JS 程序:在浏览器控制台和 Node 中分别运行
开发语言·前端·javascript·前端框架·ecmascript
feixing_fx16 小时前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
JavaGuide18 小时前
Cloudflare 开源的这套神级安全审计 Skill 太好用了!
前端·后端
孟健20 小时前
用 unslop 拯救 AI 生成网页的塑料感,7 分钟重构落地实测
前端·人工智能·ai编程
feixing_fx20 小时前
JavaScript 是什么:从浏览器脚本到通用编程语言
开发语言·前端·javascript·前端框架·ecmascript
丘山望岳20 小时前
【开发工具】 cluade code常用快捷键
前端
小巫编程室20 小时前
我造了一个 Java 能力包:让 AI 直接调用你的业务代码
java·前端·后端
小y的笔记20 小时前
JavaScript URL 状态同步
前端·javascript
十有八七20 小时前
手搓 Agent(五):学会翻书——RAG,先查资料再回答
前端·人工智能·后端
Swot20 小时前
产品 RAG 知识库与 AI 顾问 设计与实现
前端·后端