zlwu
b220298f89
为减少仓库噪声和重复规则，整理当前开发入口并移除已废弃资料。 - 精简根 AGENTS，补充四个应用规则与 README，统一规范入口 - 归整部署文件、SOP 原稿和参考资源，修正迁移后的脚本路径 - 取消虚拟环境、工具状态、业务导出及备份的跟踪，本机所需原件保留 - 移除停用的 graphify 配置、脚本与产物 - 删除历史业务文档、执行计划、OpenSpec 业务变更和移动 UI 原型 - 清理失效引用，历史细胞产品导入改为必须显式指定 --file 验证：git diff --cached --check、OpenSpec 严格校验、导入参数隔离检查 3/3 通过； 迁移文件完整性和现行链接已核对。未执行部署、业务数据导入或服务启停。
34 lines
1.4 KiB
Markdown
34 lines
1.4 KiB
Markdown
# 移动 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)。
|