# 移动 OA 与市场 H5

Vue 3 + Vant + Vite，提供 OA 发起、审批详情、打印，以及市场的协议、预签约、缴费、催缴、运费页面。由 uni-app 移动端通过 WebView 打开，也可经授权的 H5 链接访问。

## 开发与构建

从本目录执行：

```bash
npm ci
npm run build
```

开发服务由用户执行 `npm run dev`，`vite.config.js` 默认端口 5178；API 代理到本地后端。首次配置参考 `.env.example`，不覆盖已有 `.env.*`。测试环境构建使用 `npm run build -- --mode test`。

## 入口与部署

- `src/main.js`、`src/router.js`：应用与 History 路由。
- `src/oa/`：审批运行、表单组件和打印；`src/market/`：市场模块、表单契约及业务交互。
- `src/api/`、`src/utils/`：接口、Token、附件、跨端交互；`src/styles/`：移动样式。
- 基础路径固定为 `/oa-h5/`，部署需保持 History 回退和静态资源路径。

Docker 将 `dist/` 放入 Web 镜像的 `/oa-h5/`，配置见 [Dockerfile](../deploy/docker/web-admin/Dockerfile)。改 base 或路由时同时检查 `../mobile-h5/` 的 WebView URL 与 Nginx。

## 检查

相关逻辑测试使用 Node 内置测试运行器，例如：

```bash
node --test src/market/attachment-upload-state.test.js
```

按改动选择用例；UI、路由或打包变更还需构建与页面检查。跨端附件、返回和打印行为需实际 WebView 核验。规则见 [AGENTS](AGENTS.md)。