工作台概览
近 7 天工单趋势新增 / 解决（单）
在办工单分类占比
SLA 风险关注超时与临近超时
今日待办
工单处理
点击行查看详情，支持筛选 / 搜索 / SLA 排序工单号标题 / 分类优先级状态提交人受理人创建时间SLA
报修登记
代员工登记报修（电话 / 现场受理）资产台账
员工终端与服务器，点击行查看资产卡片与关联工单常用处置手册
工单详情会按分类自动推荐 2–3 条运维巡检待办
完成全部检查项后点击「完成并生成下一期」，自动滚动周期运维统计
单人工程师视角 · 数据基于本地演示工单企业微信接入说明
把「员工报修页」接入企业微信，实现一键报修与消息通知ℹ
本页为接入方案说明。当前单文件版是纯前端离线演示（数据存 localStorage，无后端），企微相关的 OAuth、JS-SDK、消息推送均需后端配合，无法在 file:// 离线文件中直接运行。
一、接入后的效果
- 员工在企业微信工作台点「IT 报修」，免登录（自动带身份）进入极简报修页；
- 支持拍照、录音上传（JS-SDK 或标准 H5 能力）；
- 新工单 / 即将超时 / 已解决，通过群机器人或应用消息推送给工程师与报修人；
- 本工作台的工单看板、SLA、统计逻辑不变，数据源从 localStorage 换成后端接口。
二、接入步骤
1
创建自建应用
企业微信管理后台 → 应用管理 → 自建 → 创建应用，记录 corpid、agentid、secret；配置应用主页指向报修页 URL。
2
配置可信域名
应用详情 → 网页授权及 JS-SDK 可信域名：需 ICP 备案 + HTTPS 的域名，并按提示放置域名校验文件。员工报修页（本文件中的 mobile 表单）部署到该域名下。
3
网页授权获取员工身份
报修页入口跳转 OAuth 链接，后端用 code 换取 userid，作为报修人身份，无需手填姓名：
https://open.weixin.qq.com/connect/oauth2/authorize ?appid=CORPID &redirect_uri=https%3A%2F%2Fit.example.com%2Frepair &response_type=code&scope=snsapi_base &agentid=AGENTID#wechat_redirect
4
拍照 / 录音能力
两种方式任选：① 引入企业微信 JS-SDK，用 wx.chooseImage / wx.startRecord（体验最稳）；② 直接用标准 H5 的 getUserMedia + MediaRecorder（与本演示页一致，需 HTTPS）。
wx.config({ corpid:'CORPID', agentid:'AGENTID', timestamp, nonceStr, signature });
wx.chooseImage({ count:2, sizeType:['compressed'], success:r=> upload(r.localIds) });5
提交工单到后端
把本页「提交报修」的逻辑从写 localStorage 改为调用后端接口；后端生成 INC 单号、计算 SLA、入库。
POST /api/tickets
{ "title":"打印机无法打印", "category":"硬件", "reporterUserId":"zhangsan",
"photos":[file1,file2], "audio":blob }6
消息通知（群机器人 Webhook）
新建群 → 添加群机器人，拿到 webhook key；后端在新工单 / SLA 临期 / 解决时推送：
curl 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=KEY' \
-H 'Content-Type: application/json' \
-d '{"msgtype":"text","text":{"content":"【新工单】INC-2026-0136 [P1] 生产线扫码枪全部离线（生产车间）"}}'应用消息推单人到个人，使用「发送应用消息」接口（touser=userid，agentid 同上）。
7
安全与上线
- corpid / secret / webhook key 只能存后端，绝不能放进前端页面；
- 报修附件建议直传对象存储，后端只存 URL，避免接口报文过大；
- SLA 超时扫描用后端定时任务（如每 5 分钟），命中后推 webhook + 应用消息。
⚠
离线演示边界：双击 file:// 打开本文件时，企微 OAuth / JS-SDK 均不可用（无域名、无后端）；「员工报修」页仍可演示拍照（getUserMedia）与录音（MediaRecorder），其可用性受浏览器与授权影响，详见交付说明。