H5 移动端与 App 服务
Forge Admin 提供独立的移动端 H5，基于 uni-app 3 + Vue 3，一套代码可发布到 H5 网页、微信小程序、支付宝小程序等多端。业务表单、审批待办、消息通知在移动端与 PC 端体验一致。
H5 的接口由 App 服务（forge-app-server） 提供，流程相关接口转发到独立流程服务。
App 服务定位
| 服务 | 模块 | 端口 | 职责 |
|---|---|---|---|
| App 服务 | forge-app-server | 8583 | 移动端业务接口，聚合各插件能力对外提供 |
| 流程服务 | forge-flow | 8081 | 待办、审批等流程接口 |
| 主后台服务 | forge-admin-server | 8580 | PC 管理端接口 |
H5 的请求前缀为 /dev-api：普通接口代理到 App 服务（8583），/dev-api/api/flow 相关接口转发到流程服务（8081）。
工程结构
text
forge-h5-ui/src/
├── pages/ # 页面（index 工作台 / message 消息 / mine 我的 / login 登录 / demo）
├── api/ # 接口定义
├── store/modules/ # Pinia 状态
├── composables/ # 组合式 API
├── utils/ # http、storage、crypto 等工具
├── components/ # 组件
├── config/ # 应用配置
├── directives/ # 指令
└── static/ # 静态资源（图片 / 图标）环境变量
| 变量 | 说明 |
|---|---|
VITE_HTTP_PORT | 开发端口，默认 3001 |
VITE_REQUEST_PREFIX | 请求前缀，默认 /dev-api |
VITE_HTTP_PROXY_TARGET | App 服务地址，默认 http://127.0.0.1:8583/ |
VITE_FLOW_PROXY_TARGET | 流程服务地址，默认 http://127.0.0.1:8081/ |
VITE_USER_CLIENT | 客户端标识，默认 h5 |
VITE_APP_ID | 应用标识，默认 forge_h5 |
启动与构建
bash
cd forge-h5-ui
pnpm install
pnpm dev:h5 # 开发模式，默认 http://localhost:3001
pnpm build:h5 # 生产构建企业微信工作台免登
H5 的企业微信工作台免登已改为后端连接配置驱动：在 sys_social_config.sso_workbench_enabled 与 connection_code（企业协同连接配置中维护）中控制，前端无需再配置。配置方式见企业协同。