移动 H5 开发约束

适用 mobile-oa-h5/，与根规则同时生效。命令见 README。

工程边界

Vue 3、Vant、Vite、form-create；既有代码为 JavaScript。使用 npm 与 package-lock.json。
工程承载 OA 表单、审批详情和市场模块，不仅是 OA；入口 src/main.js，路由 src/router.js，市场子路由 src/market/routes.js。
vite.config.js 的 base 为 /oa-h5/，使用 History 路由。修改必须同时核对 Nginx、Docker 与 uni-app WebView URL，不能只改前端路径。
宿主在 ../mobile-h5/；Token、消息事件、关闭/返回、下载和平台差异需两端配套维护。
复用 src/utils/ 的请求与附件工具、src/market/ 的模块契约及表单逻辑、src/oa/ 的审批运行组件，不能为同类模块复制另一套请求和权限逻辑。

UI 与契约

移动端与 Web 管理端分别遵循各自规范，不照搬 Element Plus、Web 自动导入规则或主色。
移动端规范品牌绿为 #0a9f6d；src/styles/tokens.css 当前为 #22c55e，与 uni-app Token 对齐但与规范存在差异。涉及改色须先核对设计依据，本轮清理不改变色板。
保持 Vant 移动布局、安全区、44×44px 点击目标、附件与表单的既有交互；新增模式先明确移动规范，不使用 Web 弹窗规则替代。
字段、金额、状态、租户和数据权限与后端保持一致；隐藏控件不能替代后端鉴权。
样本编码及子行 ID 的稳定性遵循根规则，修改协议保存时核对跨端字段映射。

验证与交付

运行受影响的 src/**/*.test.js，涉及 UI/路由/构建时执行 npm run build；单元测试不能替代 WebView 真机验收。
Docker 会将此工程与 Web 管理端一起打包，通过 /oa-h5/ 提供访问；dist/ 为构建产物，不提交。
前端环境变量会进入客户端包，不放真实服务端密钥；测试不覆盖本地生产配置。