# @fleetbase/fleetops-engine 中文文档

规范地址：https://npmcn.com/package/%40fleetbase/fleetops-engine/

版本：0\.6\.75
npm 元数据更新时间：2026-10-27T09:35:42.244Z
中文译文更新时间：2026-11-14T22:13:03.373Z
软件包许可：AGPL-3\.0-or-later

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fleetbase/fleetops-engine
原文对照：https://npmcn.com/package/%40fleetbase/fleetops-engine/?lang=original
项目主页：https://github.com/fleetbase/fleetops#readme
源码仓库：https://github.com/fleetbase/fleetops

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：45.2 MB，4441 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>= 18
- 运行依赖：31 个
- peer 依赖：ember-engines ^0\.9\.0
- 首次发布：2023-05-17T09:42:47.536Z
- 最新版本发布：2026-10-27T09:35:41.789Z
- 近 30 天下载量：6405（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：172（近 12 个月 50 个）

## 中文简介

舰队基地运输管理扩展

## 安装

```sh
npm install @fleetbase/fleetops-engine
```

也可以使用：`pnpm add @fleetbase/fleetops-engine`、`yarn add @fleetbase/fleetops-engine`、`bun add @fleetbase/fleetops-engine`

## README

![Fleetbase](https://flb-assets.s3.ap-southeast-1.amazonaws.com/static/fleetbase-logo-svg.svg)

开源机队,调度,运输管理,为舰队基地开展实时后勤业务.

 [![Repository](https://img.shields.io/badge/repo-fleetbase%2Ffleetops-111827?style=flat-square)](https://github.com/fleetbase/fleetops)[![License: AGPL-3.0-or-later](https://img.shields.io/badge/license-AGPL--3.0--or--later-blue?style=flat-square) ](https://github.com/fleetbase/fleetops/blob/master/LICENSE.md)[![Coverage](https://codecov.io/gh/fleetbase/fleetops/branch/main/graph/badge.svg) ](https://codecov.io/gh/fleetbase/fleetops)[![NPM package](https://img.shields.io/badge/npm-%40fleetbase%2Ffleetops--engine-CB3837?style=flat-square) ](https://www.npmjs.com/package/@fleetbase/fleetops-engine)[![Packagist package](https://img.shields.io/badge/packagist-fleetbase%2Ffleetops--api-F28D1A?style=flat-square) ](https://packagist.org/packages/fleetbase/fleetops-api)[![Fleet-Ops documentation](https://img.shields.io/badge/docs-fleet--ops-0EA5E9?style=flat-square) ](https://www.fleetbase.io/docs/fleet-ops)![Node >= 18](https://img.shields.io/badge/node-%3E%3D18-339933?style=flat-square) ![PHP ^8.0](https://img.shields.io/badge/php-%5E8.0-777BB4?style=flat-square)

![Fleet-Ops multi-waypoint order with live map, route, driver assignment, and order details](https://www.fleetbase.io/images/screenshots/fleet-ops/fleet-ops-multi-waypoint-order.webp)

## 什么是舰队 -Ops?

Fleet-Ops是美国海军陆战队的核心后勤及舰队管理延伸 [舰队基地](https://www.fleetbase.io/) 平台。 它为各行动小组提供调度控制台,以管理订单、司机、车辆、车队、服务区、实况地图、路线执行、分析、维护和连接的远程数据.

分舰队-Ops舰艇作为两套:

| 软件包 | 目的 |
| --- | --- |
| `@fleetbase/fleetops-engine` | Ember Engine/Add 上授权舰队-Ops控制台UI. |
| `fleetbase/fleetops-api` | Laravel/PHP软件包,提供Fleet-Ops API,模型,工作,事件和集成. |

舰队-Ops包含有舰队基地"云"和自备舰队基地设施. 关于产品概念、工作流程和设置指南,从 [舰队-Ops文档](https://www.fleetbase.io/docs/fleet-ops)。 。 。 .

## 特征

### 业务

-   创建,导入,调度,发送,启动,取消,并完成交付订单.
-   管理多行点路线,有效载荷,实体,标签,订购元数据,注释,注释,文件和证明.
-   与ETA,路由覆盖,驱动平分,活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活.
-   配置自定义命令类型,活性流,实体字段,证明要求,以及服务率规则.
-   运行管弦工作流程,用于订单分配,驾驶员分配,车辆容量,以及路由排序.
-   计划与调度器,机队调度,服务报价,路线,出货单并列车.

### 现场地图

-   查看现场司机、车辆、主动订单、路线、地点、服务区、区和地峡.
-   使用Fleet-Ops地图控制和抽屉面板过滤并检查操作层.
-   通过Fleetbase地图设置支持基于Leaflet和Google的地图体验.
-   捕捉位置,回放移动,跟踪车辆和司机,以及地表地缘事件.

### 车队管理

-   管理司机、车辆、车队、地点、联系人、客户、供应商和综合供应商.
-   向车队、供应商和订单分派司机和车辆.
-   跟踪司机时刻表,可用情况,职位,主动轮班,服务时间状况.
-   履带车辆状况,装置,站位,设备,时刻表,工作订单,维修历史.
-   管理问题、燃料报告、进出口、散装行动和定制资源领域.

### 维修

-   确定预防性维护时间表和日历信息.
-   管理工作订单、维护记录、细列物品、设备、零件和保修.
-   发送工作订单,触发时间表运行,暂停并恢复时间表,并审查维护历史.

### 连通性

-   连接远程数据提供者、设备、传感器、事件和跟踪数据.
-   发现并链接到远程matics设备,测试提供者证书,并接收远程matics webhoks.
-   使用Fleet-Ops跟踪提供者进行计算,OSRM,和Google Routes支持的路由智能.

### 分析与盘子

-   使用 Fleet-Ops KPI 部件获取收益, 平均订单值, 距离, 主动订单, 在线驱动器, 以及开出的问题 .
-   审查业务脉冲、活机队、收入趋势、订单量、按时交货、最高驾驶员、燃料效率、问题、维修和地缘侵犯情况的分析.
-   创建并查看来自"舰队-Ops分析"工作空间的报告.

### 设置和扩展

-   配置导航应用程序上载、 路由、 跟踪、 地图提供者、 通知、 调度、 付款、 管弦乐器设置、 自定义字段和相机 .
-   (原始内容存档于2018-03-21) (英语). Expose Fleet - Ops 订单跟踪 舰队基地登录地表.
-   通过已注册组件和虚拟细节标签,将Fleet-Ops实体整合到其他Fleet Base扩展.

## 建筑

Fleet-Ops遵循了Fleet Base扩展架构:用于控制台接口的Ember引擎和用于API和后端能力的Laravel包.

```text
fleetops/
+-- addon/              # Ember Engine source: routes, controllers, components, services, templates
+-- app/                # Ember app re-exports and integration points
+-- assets/             # Frontend assets bundled with the engine
+-- translations/       # Fleet-Ops locale files
+-- server/
|   +-- config/         # Fleet-Ops API configuration
|   +-- migrations/     # Database migrations
|   +-- resources/      # Backend views and resources
|   +-- seeders/        # Seed data
|   +-- src/            # Controllers, models, jobs, events, support services, providers
|   +-- tests/          # Backend test suite
+-- tests/              # Ember test suite
+-- package.json        # Frontend package metadata and scripts
+-- composer.json       # Backend package metadata and scripts
```

核心前端依赖包括: Ember Octane, Ember Engines, Fleetbase Ember Core, Fleetbase UI, Fleet-Ops Data, Leaflet, Leaflet Draw, Turf, JointJS, 和花纹连接. 核心后端能力由Laravel,Fleetbase Core API,Fleet-Ops模型/控制器,管弦乐引擎,跟踪提供者,分析器,通知,工作,以及远程数据集成提供.

## 开始

舰队-Ops 预先安装了舰队基地"云"和标准的自备舰队基地设施. 如果你正在建立舰队基地平台, 请使用舰队基地的文件:

-   [舰队-Ops文档](https://www.fleetbase.io/docs/fleet-ops)
-   [舰队基地文件](https://www.fleetbase.io/docs)
-   [舰队基地控制台](https://console.fleetbase.io/)

在从源头开发Fleet-Ops时,同时安装前端和后端依赖性:

```bash
pnpm install
composer install
```

### 将舰队-Ops连入舰队基地

在从Fleetbase monorepo工作时,使用Fleetbase包链接器将这个本地包连接到运行中的Console和API应用程序. 从舰队基地寄存器根:

```bash
flb-package-linker enable fleetops
flb-package-linker install fleetops
```

这将本地的 Fleet-Ops Ember 引擎和 Laravel 软件包连接起来, 因此 Console 和 API 使用您的源检出而不是发布软件包 。 见 [舰队基地开发设置指南](https://www.fleetbase.io/docs/platform/quickstart/development-setup) 用于完整包链接的工作流程,多克设置,Octane重装笔记,以及前端热重装选项.

### 链接车队- Ops 数据

机队- Ops 也取决于共享 `@fleetbase/fleetops-data` 软件包。 该软件包包含Fleet-Ops Ember Data模型,适配器,和序列器,可以被其他Fleet基地模块再用,这些模块需要读取或写入Fleet-Ops资源而无需重复数据层定义.

如果您正在更改共享的 Fleet-Ops 数据模型或从另一个扩展名中消耗这些模型, 请链接 `fleetops-data` 通过根控制台工作空间 :

```bash
flb-package-linker enable-shared fleetops-data
flb-package-linker install
```

对于更广泛的Fleet-Ops前端工作,您也可以链接Fleetbase使用的共同共享的Ember包:

```bash
flb-package-linker enable fleetops --shared ember-core ember-ui fleetops-data
flb-package-linker install fleetops
```

## 发展

以开发模式启动 Ember 引擎 :

```bash
pnpm start
```

构建生产前端捆绑 :

```bash
pnpm build
```

运行前端林入 :

```bash
pnpm lint
```

运行后端林入 :

```bash
composer test:lint
```

## 测试

运行 Ember/ QUnit 测试套件 :

```bash
pnpm test:ember
```

运行完整的前端检查套件 :

```bash
pnpm test
```

运行后端测试套件 :

```bash
composer test
```

单独运行后端检查 :

```bash
composer test:lint
composer test:types
composer test:unit
```

## 文档

-   [舰队操作文件](https://www.fleetbase.io/docs/fleet-ops)
-   [舰队快速启动](https://www.fleetbase.io/docs/fleet-ops/getting-started/quickstart)
-   [舰队-Ops核心概念](https://www.fleetbase.io/docs/fleet-ops/getting-started/core-concepts)
-   [导航应用程序设置](https://www.fleetbase.io/docs/fleet-ops/getting-started/navigator-app-setup)
-   [舰队基地文件](https://www.fleetbase.io/docs)

## 捐款

欢迎捐款。 请阅读 [捐款额](https://npmcn.com/package/%40fleetbase/fleetops-engine/CONTRIBUTING.md) 在打开拉出请求之前.

有用的工程文件 :

-   [软件包.json](https://npmcn.com/package/%40fleetbase/fleetops-engine/package.json) 前端脚本和软件包元数据.
-   [编曲.json](https://npmcn.com/package/%40fleetbase/fleetops-engine/composer.json) 用于后端脚本和软件包元数据.
-   [扩展名.json](https://npmcn.com/package/%40fleetbase/fleetops-engine/extension.json) 用于Fleetbase扩展元数据.

## 许可证

Fleet-Ops 是一个开源软件,根据 [GNU 阿费罗通用公共许可证 v3.0 或以后](https://npmcn.com/package/%40fleetbase/fleetops-engine/LICENSE.md)。 。 。 .

## 常见问题

### @fleetbase/fleetops-engine 是什么？

舰队基地运输管理扩展

### 如何安装 @fleetbase/fleetops-engine？

在项目目录运行 npm install @fleetbase/fleetops-engine，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：ember-engines（^0\.9\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fleetbase/fleetops-engine 支持 TypeScript 吗？

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

### @fleetbase/fleetops-engine 需要什么版本的 Node\.js？

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

### @fleetbase/fleetops-engine 可以商用吗？

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

### @fleetbase/fleetops-engine 的下载量有多少？

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

### @fleetbase/fleetops-engine 还在维护吗？

最新版本 0\.6\.75 发布于 2026/10/27（19 天前）；至今共发布 172 个版本，其中过去 12 个月发布了 50 个；首次发布于 2023/05/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。