@fleetbase/fleetops-data

中文文档
0.2.3发布于 2026/10/14AGPL-3.0-or-later近 30 天下载 4369

Fleetbase Fleet-Ops based models, serializers, transforms, adapters, GeoJson utilities and the shared resource identity descriptors.

原始使用文档
文档目录6 节
  1. Compatibility
  2. Installation
  3. Usage
  4. Shared resource descriptors
  5. Contributing
  6. License

@fleetbase/fleetops-data

codecov

[Short description of the addon.]

Compatibility

  • Ember.js v4.8 or above
  • Ember CLI v4.8 or above
  • Node.js v18 or above

Installation

ember install @fleetbase/fleetops-data

Usage

Install the addon and the Fleet-Ops models, adapters, serializers and transforms are available to the host application and to every engine that lists it as a dependency.

Shared resource descriptors

The addon also ships the resource identity descriptors for the resources every extension can see through its models: driver, vehicle, customer, contact, place, order, vendor and fleet, along with the thin <Key::Pill>, <Key::Summary>, <Cell::KeyIdentity> and <SelectOption::Key> wrappers that name the resource type for the generic components in @fleetbase/ember-ui.

An instance initializer registers the descriptors with the resource-registry service whenever the host or an engine boots, filling in only the keys nobody has registered yet. That means a Storefront or Ledger table can render a driver as an identity cell before the Fleet-Ops engine has loaded:

{
    id: 'driver-assigned',
    cellComponent: 'table/cell/identity',
    resourceType: 'driver',
    resourcePath: 'driver_assigned',
}

Opening a resource loads the Fleet-Ops engine on demand and hands the record to its action service, so the engine bundle is only fetched when someone clicks. When Fleet-Ops itself boots it replaces these descriptors with its own, which open the same panels directly.

The helpers behind the descriptors and the styled placeholder images are exported from @fleetbase/fleetops-data/utils/resource-descriptors and @fleetbase/fleetops-data/utils/placeholder-images for other packages that build descriptors. @fleetbase/fleetops-data/utils/identity-stub builds a stand-in record for a relation a row only knows by name (driver_name, pickupName), so an identity cell can render it and load the real record on demand.

Contributing

See the Contributing guide for details.

License

This project is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later).

版本与发布记录

@fleetbase/fleetops-data 共发布 54 个版本,首次发布于 2023/05/17;过去 12 个月发布了 23 个版本。

版本发布日期距今
0.2.3latest2026/10/141 个月前
0.2.22026/09/221 个月前
0.2.12026/09/161 个月前
0.2.02026/09/092 个月前
0.1.402026/06/194 个月前
0.1.392026/06/184 个月前

关于 @fleetbase/fleetops-data 的常见问题

@fleetbase/fleetops-data 是什么?

Fleetbase Fleet-Ops based models, serializers, transforms, adapters, GeoJson utilities and the shared resource identity descriptors.

如何安装 @fleetbase/fleetops-data?

在项目目录运行 npm install @fleetbase/fleetops-data,或使用 pnpm add / yarn add / bun add。

@fleetbase/fleetops-data 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/fleetbase__fleetops-data 是否存在。

@fleetbase/fleetops-data 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@fleetbase/fleetops-data 可以商用吗?

@fleetbase/fleetops-data 使用 AGPL-3.0-or-later 许可。最严格的 Copyleft:除分发外,通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括,不构成法律意见,请以许可原文为准。

@fleetbase/fleetops-data 的下载量有多少?

根据 npm 官方下载统计,@fleetbase/fleetops-data 在 2026/10/15 – 2026/11/13 这 30 天内被下载 4,369 次,日均约 146 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@fleetbase/fleetops-data 还在维护吗?

最新版本 0.2.3 发布于 2026/10/14(1 个月前);至今共发布 54 个版本,其中过去 12 个月发布了 23 个;首次发布于 2023/05/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。