@zfs-boe-inspector/adapter-vue3

@zfs-boe-inspector/adapter-vue3

ZFS BOE Runtime Adapter，用于从真实 BOE 页面采集最终模板、字段值、区域/字段配置和可用的差旅运行时数据。统一入口会根据宿主 Vue 和 BOE 结构自动选择高版本或低版本基础模式；低版本缺失的增强能力会标记为未采集，不影响业务页面。

安装

npm install @zfs-boe-inspector/adapter-vue3

BOE 宿主版本范围为 3.x、4.x，包括 4.2.0-4、4.1.2-100、3.3.0-beta.1 等项目后缀版本。宿主项目需自行安装 @zfs/boe；Adapter 不声明该包的 npm peer 约束，以避免预发布后缀导致安装冲突。/zfs-boe 入口在注册采集前校验宿主主版本，其他版本或无法识别的版本会提示并跳过采集；具体采集能力仍取决于宿主结构和所选入口。

Options API / Mixin

import { createBillTemplateInspectorMixin } from '@zfs-boe-inspector/adapter-vue3/zfs-boe';

export default {
  mixins: [createBillTemplateInspectorMixin()],
};

Composition API / setup

import { useBillTemplateInspector } from '@zfs-boe-inspector/adapter-vue3/zfs-boe';

export default {
  setup() {
    useBillTemplateInspector();
  },
};

两种方式都支持可选的 projectCode 等元数据覆盖，并自动管理注册和注销生命周期。关联申请三段对比可选传入 getApplySnapshot(component)；未传入时仍保留模板映射和当前值诊断，回调异常只生成采集 warning。

Vue2.6/2.7 项目使用同一个 Mixin 导入，无需安装 Composition API 插件。低版本默认提供最终模板、原始数据、字段值和可定位字段；运行态字段扫描、过程记录和无法确认请求历史的差旅规则会按能力降级。Vue3 原有 Mixin、Composable、动态配置和过程记录行为保持不变。

同一导入路径会由宿主构建器选择入口：支持 exports 的构建器进入 Vue3 高版本入口，webpack 4 的物理子路径进入 Vue2 基础入口；业务代码不需要手动选择版本。

需要提供过程记录业务条件时，可传入只读同步 getTraceConditions({ eventId, method, args, component, instanceId })，返回带 definition.key、可选 ruleId/label/expression 和 result 的条件数组。第一个条件作为主分组条件；不要在回调中调用被观察方法或执行异步操作。回调异常、重入或超过约 20 ms 会自动降级，不影响 BOE 原方法。

差旅组件自动发现

通用 Mixin 或 Composable 会从 billTemplate 向上定位标准差旅宿主，自动注册 Travel Collector。标准项目不需要逐个修改差旅 wrapper。

组件结构经过定制时，可以显式指定差旅宿主：

createBillTemplateInspectorMixin({
  resolveTravelComponent: (billTemplate) => billTemplate.$parent,
});

传入 autoTravelCollector: false 可关闭自动发现。旧项目已有的差旅 Mixin 或 Composable 继续兼容：

import { createTravelInspectorMixin } from '@zfs-boe-inspector/adapter-vue3/zfs-boe';

export default {
  mixins: [createTravelInspectorMixin()],
};

import { useTravelInspector } from '@zfs-boe-inspector/adapter-vue3/zfs-boe';

export default {
  setup() {
    useTravelInspector();
  },
};

底层 attachTravelInspector 需要先调用 installBoeInspector 安装 Runtime，普通 BOE local wrapper 不建议直接调用。

License

Proprietary software. See LICENSE.

多人差旅采集

MULTI_TRAVEL_BOE 通过一个 Collector 按人员引用采集，快照使用 travel.mode: 'multi' 和 travel.persons 保存独立的身份、数据和采集状态。 面板切换人员使用当前快照，不重新请求宿主；增删人员、变更岗位后需要刷新快照。 新扩展兼容原有单人快照；多人能力需要同时更新 adapter 和扩展，不支持旧扩展读取新多人快照。

BOE 3.x / Vue2 基础入口沿用候选缓存语义，只采集可确认人员归属的原始明细和已有标准， 不读取未经核验的行程 computed、不补发请求、不推断请求历史或最终超标结论。 缺失、读取失败、身份冲突和预算截断会标记为不完整，相关规则跳过。 公共费用与外部人员不会被推断为个人费用；本次不支持多人多行程类型的卡片适配。

多人分支的所有人员共享 20,000 节点、20 层深度、集合 1,000 项和累计 1 Mi 字符预算， 并在遍历边界检查 16 ms 软预算；不能中断单个同步 getter，也不是整个单据快照的总预算。 travel.diagnostics 记录采集耗时、序列化计数及字段读取耗时，便于真实项目校准。 超过预算不会后台补采；面板、规则和 AI 保留不完整证据。单人分支的默认预算不变。

验收需分别覆盖 Vue2 / Vue3、1 / 10 / 50 人、100 / 1,000 条明细及超预算数据， 记录采集、规则、人员切换耗时与输出体积，并对照原有单人结果。 源码中的单元用例不能替代低版本真实项目和浏览器性能验收。