Appearance
用户指南 14 · uni-jeeflow-app 移动审批端
jeeflow 工作流系列的开源移动端（uni-app x，
.uvue/.uts，无 npm 依赖树）。 对接 mldong 八栈 jeeflow 集成后端的统一 API 契约（/sys/**登录态 +/wf/{action}工作流门面）， 与后端语言无关——Java / Go / Python / Node / PHP / Rust / C# 实现同一套契约即可接入。源码：github.com/mldong/uni-jeeflow-app · Web 端流程中心见 13 · jeeflow-ui。
1. 功能总览
| 模块 | 说明 |
|---|---|
| 登录 | 账号密码；开发态可在登录页切换接口地址（默认演示站） |
| 工作台 | 待办/消息角标；快捷发起（processDesign/listByType 分组九宫格）；待办/已办/我发起/抄送四指标 |
| 审批中心 | 待办 / 已办 / 抄送 |
| 发起 | 动态表单：自定义组件（如 LeaveWfForm）或 SchemaWfForm（__schema__ → getByTableName） |
| 任务/实例 | 同意/拒绝、撤回、审批记录时间线、钉钉风格流程图（mldong-flow-designer-dingtalk） |
| 统计 | 引擎 stats 三 action 真数据：指标卡、趋势（7天/30天/12月）、状态分布、流程 Top 10、积压节点/积压人 |
| 消息 | 列表 / 详情 / 已读 / tab 角标 |
| 我的 | 委托代理 CRUD、退出登录 |
2. 下载体验（免编译）
- Android 体验包：蒲公英 · jeeflow审批（打开链接扫码或直接安装）
- 默认连开源演示站
https://jeeflow-pro.mldong.com/api，演示账号admin/123456 - 装完即用，不需要自己部署后端；想连自己的后端见下节
3. 从源码运行
前置：安装 HBuilderX（含 uni-app x 插件）、Android 模拟器或真机 + adb。
- clone 本仓，HBuilderX 打开工程
- 制作自定义调试基座（包名
com.mldong.jeeflow，签名证书自备；证书文件不要提交进仓库） - 不要用 standard 公共基座——standard 装的是
io.dcloud.uniappx，应用图标/名称永远是 HBuilder 默认，改 manifest 无效 - 真机运行必须带
--playground custom（与.hbuilderx/launch.json一致）：
bash
adb connect 127.0.0.1:5555
adb -s 127.0.0.1:5555 reverse tcp:8001 tcp:8001 # HX sync 通道
adb -s 127.0.0.1:5555 reverse tcp:8000 tcp:8000 # 本机后端按需
cli launch app-android \
--project <本仓绝对路径> \
--deviceId 127.0.0.1:5555 \
--playground custom- 连接自建后端：登录页「切换接口地址」手输
http://<局域网IP>:<端口>（开发态开放；正式包锁定演示站）
4. 表单分发（对齐 vben5-wf）
与 Web 端同一套流程定义，只是表现层不同：
instanceUrl = jsonObject.instanceUrl
├─ 已注册自定义（如 LeaveWfForm）→ 本地命名 FormSchema
├─ SchemaWfForm
│ ├─ 有 __schema__ → 按列渲染
│ └─ 否则 getByTableName(processDefine.name)
└─ 未注册 → 明确失败（不按 defineName 偷换表单）5. 技术要点
- 契约：全 POST+JSON，
Authorization: Bearer <token>，响应{code,msg,data}成功code===0；分页{rows,recordCount,…}；雪花 id 全程字符串。接口明细见 规范 06 · 统一门面 - refreshToken 静默续命：access 失效（99990403）不踢登录，单飞
POST /sys/refreshToken换新(token, refreshToken)对后重放原请求（用户无感）；refresh 也失效（99990410）才回登录页 - 流程图：webview 加载
mldong-flow-designer-dingtalkviewer，highLight回显已走/当前节点高亮 - 统计：
stats/overview指标卡、stats/trend趋势（start/end 必填，12 月按月粒度）、stats/group分布/Top10/积压
6. 相关页面
- 13 · jeeflow-ui 流程中心 — Web 端开源接入
- 规范 06 · 统一门面完整接口文档 — 40+ action 参数/返回/JSON 示例
- 10 · mldong 框架集成 jeeflow — 后端八栈参考实现