zkxw/mobile-oa-h5/README.md

移动 OA 与市场 H5

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

开发与构建

从本目录执行：

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。改 base 或路由时同时检查 ../mobile-h5/ 的 WebView URL 与 Nginx。

检查

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

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

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