更新记录

0.1.1（2026-03-26） 下载此版本

0.11

0.1.0（2026-03-26） 下载此版本

0.1.0

平台兼容性

uni-app(3.8.10)

licence-plugin 作业票业务插件

基于 uni-app 打造的作业票业务插件，沉淀列表、预览、表单与 service 能力，通过 initLicencePlugin 与宿主解耦网络、鉴权、电子围栏、签字等外部能力，可复用到多个项目。

目录结构

uni_modules/licence-plugin/
├── package.json           # 插件元数据、依赖声明
├── README.md              # 使用说明（当前文件）
├── components/            # vForm、业务组件、按钮、弹窗
├── config/                # 默认 apiMap 等配置
├── pages/                 # licence-list / basic-info / preview 等页面
├── runtime/               # context、初始化及注入入口
├── services/              # licence、person、certificate 等 service 封装
└── utils/                 # 加密、上传、工具函数

功能范围

• 作业票列表（筛选、分页、按钮操作、更多弹窗）
• 作业票预览、基础信息等页面插槽
• initLicencePlugin 运行时上下文及 getLicencePluginContext 调用链
• service 抽象（生成编号、保存、提交、签批、气体检测、关联作业票等）
• vForm 容器、区块、字段、字段选择器、数据字典、加密上传等组件

安装方式

1. 将 uni_modules/licence-plugin 拷贝/拉取到宿主 uni_modules/ 目录，或从插件市场导入。
2. 在宿主根目录执行：

   npm install uview-ui js-base64 jsrsasign --save

   （js-base64、jsrsasign 也随插件 package.json 声明，宿主若已全局安装可复用；uview-ui 属于前置 UI 依赖，需宿主自己安装并注册）

3. 确保 HBuilderX / CLI 版本 ≥ 3.7.0，并已开启 easycom 自动解析与 transpileDependencies: ['uview-ui']。

前置依赖

宿主接入步骤

1. 注册 uView

// main.js
import uView from 'uview-ui'
Vue.use(uView)
uni.$u && (uni.$u.config.unit = 'rpx')

在 uni.scss 引入 @import 'uview-ui/theme.scss';，在 App.vue 引入 @import 'uview-ui/index.scss';，保持与宿主其他页面一致。

2. 配置 easycom & 编译

在 pages.json 增加：

"easycom": {
  "^u-(.*)": "uview-ui/components/u-$1/u-$1.vue"
}

并在 vue.config.js 中加入 transpileDependencies: ['uview-ui']，确保 uView 组件在 H5/小程序端被正确构建。

3. 初始化 licence-plugin 上下文

// main.js
import { initLicencePlugin } from '@/uni_modules/licence-plugin/runtime/context'
import request from '@/common/request'

initLicencePlugin({
  request,
  getToken: () => uni.getStorageSync('token'),
  getUserInfo: () => store.state.user,
  apiMap: {
    generateLicenceNo: '/api/operaSafe/licence/generateNo',
    saveLicence: '/api/operaSafe/licence/save'
  },
  fenceService: {
    getFenceInfo: (no) => request({ url: `/api/operaSafe/licence/getFenceInfo/${no}` }),
    checkFence: (payload) => request({ url: '/api/operaSafe/licence/checkFence', method: 'POST', data: payload })
  },
  signService: {
    openSignDialog: () => Promise.resolve(true),
    submitSign: (payload) => request({ url: '/api/sign/submit', method: 'POST', data: payload })
  },
  personService: {
    list: (params) => request({ url: '/api/person/list', method: 'GET', params })
  },
  certificateService: {
    list: (params) => request({ url: '/api/certificate/list', method: 'GET', params })
  },
  showToast: uni.showToast,
  showModal: (opts) => new Promise(resolve => uni.showModal({ ...opts, success: res => resolve(res.confirm) })),
  navigator: { navigateTo: uni.navigateTo, redirectTo: uni.redirectTo }
})

4. 注册页面

在宿主 pages.json 添加：

{
  "path": "uni_modules/licence-plugin/pages/licence-list/index",
  "style": { "navigationBarTitleText": "作业票列表" }
},
{
  "path": "uni_modules/licence-plugin/pages/licence-preview/index",
  "style": { "navigationBarTitleText": "作业票预览" }
},
{
  "path": "uni_modules/licence-plugin/pages/basic-info/index",
  "style": { "navigationBarTitleText": "作业票基础信息" }
}

其他子页面（如作业票详情、人员调整等）可按需注册或由宿主路由跳转。

5. 业务入口

在菜单或任意页面调起：

uni.navigateTo({ url: '/uni_modules/licence-plugin/pages/licence-list/index' })

业务侧可直接复用 services/ 暴露的方法，例如：

import { fetchLicenceList } from '@/uni_modules/licence-plugin/services/licenceService'
const list = await fetchLicenceList({ pageNum: 1, pageSize: 10 })

前置依赖/注入清单

限制 & 注意事项

1. utils/utils/upload.js 暂依赖宿主的 Vue.prototype.baseUrl 以及 uni.getStorageSync('ty_yxxh_token')，在发布前请根据宿主实现抽象或在 README 中告知替换方式。
2. 加密模块引用 @/utils/encrypts.js，默认读宿主 alias，如需完全独立可改为插件内路径或通过 context 注入。
3. 目前仅提供 App/H5 适配，如需小程序版本请在宿主自行验证。
4. 组件使用 uView UI，宿主需保持 uView 与 uView 主题变量配置一致，否则存在样式差异。
5. 插件默认语义化接口路径写死在 config/apiMap.js，生产接入时务必覆盖为真实地址。

如需更多方案背景，可参考仓库根目录 docs/licence-plugin-plan.md。