术语表

本平台及本指南中使用的 Aptli 专属术语快速参考。

数据与记录

版本化模型

记录在变更永久生效前，需经历 草稿 → 差异 → 提交 的循环。 版本化记录支持离线编辑、撤销/重做、冲突检测以及完整的版本历史记录。在 Aptli 中，地图要素（点、线段、多边形、图层、示意图）和任务均采用版本化模型。

对比：实时模型

实时模型

记录会立即保存到服务器，无需中间存储步骤。所有用户都能即时看到更改。工作单、报告、验证、交易和站点均采用实时模型。

对比：版本化模型

草稿

对版本化记录所做的本地修改集合，尚未提交至服务器。草稿存储在浏览器中，即使在无网络连接的情况下刷新页面也能保留。每个版本，用户可拥有一个活跃的草稿。 草稿可在上线前上传至服务器供管理员审核。

提交

将草稿中的更改永久应用到实时数据集的操作。提交会在版本历史中创建一个新的不可变条目。只有拥有 allowCommits 管理员权限的用户才能进行提交。

版本冲突

当两名用户在各自的离线草稿中编辑了同一要素时，就会发生版本冲突。Aptli 会在提交时通过比较每个草稿所基于的版本与当前在线版本来检测冲突。存在冲突的提交会被标记为待管理员审核，在冲突解决之前无法应用——不会发生无提示的覆盖操作。

库存

资源

对材料、耗材、设备类型或劳动力类别的定义。资源定义其计量单位和提货政策，是 任务 所消耗的对象。 针对资源执行的工作将作为活动单独归档。示例：500 米光纤电缆、混凝土锚栓、安装团队工时。

活动

对施工团队所执行的工作类型的定义——如光纤熔接、拉缆、挖掘、检查。 活动是 资源 在工作层面的对应概念：一个独立的登记表，拥有自己的计量单位（§193），由 工作单 中的活动行引用，既可从目录中选择，也可临时输入。 可选——工作单无需指定具体名称。示例：熔接、光缆牵引（米）、定向钻进（米）。在“管理”→“活动”下进行管理（activitiesCreate / activitiesUpdate / activitiesDelete）。

库存项目

特定资源在特定地点的当前余额。库存项目仅通过交易更新——绝不能直接编辑。一种资源可同时在多个地点拥有库存项目。

站点

存放库存的物理或逻辑位置。站点包括仓库、堆场、现场仓库、个别员工的“个人站点”以及车辆。每位用户均可拥有一个个人站点，该站点可通过扫描二维码接收库存。

交易

记录每次库存流动的不可变账目条目。交易无法编辑或删除——更正始终通过创建新的调整交易来完成。交易类型：

领料码

在分配工作单时生成的、具有时效性且防篡改的二维码。 现场工作人员在仓库扫描提货码，以授权并领取分配给他们的物料。提货码中编码了授权的资源数量、所属的工作任务以及有效期。只有被分配的工人——或拥有 canFacilitatePickups 权限的用户——才能扫描该码。

转移码

一种防篡改的二维码，用于授权不同站点之间的点对点库存转移。与提货码不同，转移码不与工作单绑定。可针对任何站点间的物料流动生成转移码，由接收方扫描以执行转移并自动记录交易。

暂存资源

一种临时“中转”标识，用于接收包含资源目录中尚不存在的物品的货物。现场工作人员将货物接收至暂存资源中，以免阻碍工作进度；待相关资源定义后，办公室工作人员再将其重新归类到正确的资源中。 此举可避免出现“因系统中不存在该资源而无法接收”的僵局。

领取政策

资源 上的一项单一控制级设置，用于管理在每个流程（任务领取、自助借阅、转移）中谁可以发放或领取该资源。有三种取值：

受协助领取

提货策略 设置为 受协助 的资源的行为。工作人员无法自行发放该资源；而是由仓库人员（拥有 canFacilitatePickups 权限者）在工作人员在场的情况下，代其完成提货。 交易记录中会包含双方信息以及所使用的扫描方法。

工作履约

任务

具有地理位置的计划工作单元，可选配资源需求。任务具有版本控制——其生命周期与地图要素类似，经历草稿 → 提交的流程。 一项工作可以位于一个点（如检查井）、一条线段（如道路段）、一个多边形（如分区）上，也可以不指定位置，用于办公室工作。 任务隶属于项目，并通过工作单来执行；已完成的工作记录在工作单的活动行中。

工作单

将一个任务分配给团队，包含截止日期、可选的活动行（待执行的工作）以及可选的物料领取代码。工作单实时跟踪状态（待处理 → 进行中 → 已完成）。也称为分配。

任务

在 Aptli 系统中与 工作单 可互换使用。部分用户界面仍将该概念标记为“任务”，但底层记录及其管理权限均命名为 工作单（workOrdersCreate、workOrdersUpdate、workOrdersDelete）。二者指代同一事物。

报告

现场工作人员对已完成工作的记录。报告包含已完成的工作内容、GPS 位置、实际消耗的资源以及照片。报告可针对正式任务提交，也可针对计划外维护临时提交。提交报告会触发自动库存扣减，并通知主管。

审核

主管对已提交报告进行的质量保证审查。审核会记录结果（通过/未通过/需修改/附注批准）及任何发现的问题。未通过或需修改的审核结果将报告退回给工作人员；已批准的审核可触发付款发放计算。

项目

一组具有共同截止日期和团队分配的关联工单。项目提供涵盖所有工单和报告的高层级进度视图。

安全与访问

管理员权限

采用许可式授予机制，控制用户可以执行的操作。 Aptli 提供细粒度的管理权限，涵盖系统中的所有创建、读取、更新和删除操作。示例：workOrdersCreate、reportsDelete、allowCommits、canFacilitatePickups、auditView。管理权限具有累加性——没有权限的用户只能查看自己的任务分配。

角色限制

限制性的字段级过滤器，用于控制用户无法查看哪些数据。 角色限制在服务器端强制执行：未经授权的数据绝不会发送至客户端，而不仅仅是隐藏在用户界面中。例如：对 assignedTo = currentUser 的限制，可使承包商仅能查看自己的工作单。角色限制与管理权限作为两个独立层级运行。

访问请求

当用户通过登录页面自助注册时，系统会创建一个待处理账户。访问请求将保存在 管理 → 访问请求 中，直至管理员批准或拒绝。批准后，该账户将成为普通用户；拒绝后，请求将被软删除。

单个活跃会话

Aptli 的会话模型允许每个账户在任何时间、所有设备上仅保持一个活跃登录会话。在新设备上登录将终止之前的会话；被取代的设备会显示一次通知，并返回登录页面。同一浏览器配置文件中的两个标签页共享一个会话，不会相互取代。

硬锁定

一种阻止通过任何方式登录的账户状态。在多次登录失败后自动触发（默认：连续 10 次失败），或由管理员手动设置。仅拥有 usersUpdate 权限的管理员才能解除该状态。

维护模式

一种由管理员切换的模式，该模式会阻止非管理员的写入操作，并向所有用户显示一条横幅通知。该模式适用于迁移或批处理任务运行期间的短暂时段，以避免用户写入操作与运维工作发生冲突。管理员仍保留完全访问权限。

审计日志

记录部署环境中所有重要操作的只追加式日志——包括登录、记录创建与编辑、文件上传、状态转换以及管理员权限授予。 可在详情页的嵌入式时间轴中按记录查看，也可在 管理 → 审计历史 中全局查看（需要 auditView 权限）。可导出为 CSV 文件供外部审查（需要 auditExport 权限）。

归档（软删除）

标记为已删除但物理上仍保留的记录。归档记录在常规列表和查询中被隐藏；拥有 viewDeleted 权限的用户可显示这些记录，并在需要时恢复。Aptli 极少进行硬删除——归档可保留审计和操作历史。

地图与 GIS

图层

一组命名好的地图要素集合，它们共享相同的几何类型（点、线段或多边形）和视觉样式（图标、颜色、线宽）。图层定义了要素的本质——例如，“电话杆”图层或“管道路线”图层。图层具有版本控制。

示意图

一种关系图，用于建模地图要素或抽象对象之间的连接。示意图使用图形编辑器（节点和有向边）来表示网络拓扑、电缆路径、管道填充率，或任何其他仅凭地理地图难以表达的关系。示意图具有版本控制。

绘图暂存区

这是一个临时编辑区域，用于在将几何图形提交为永久地图要素之前进行绘制和精修。绘图暂存区允许在复杂编辑操作（如自由绘图、对齐、多要素操作）正式生效前进行审查。

现场记录

Aptli 导航界面中地图界面的名称——地理要素在此处存储、绘制、编辑和追踪。（地图工具从其工具栏以 窗口 形式打开。）

窗口

从地图工具栏打开的浮动、可拖动面板。每个窗口对应一个工具：选定要素、搜索、数据传输和图层管理器始终显示；项目、 图层关系 和 构建器 则在相关功能获得授权后才会显示。为适应多显示器工作环境，窗口可弹出至独立的浏览器窗口中。

执行视图

一种地图叠加层，根据派生工作状态重新着色现有要素，从而使区域状态一目了然。 可同时激活多个透镜。透镜包括 进度、我的工作单、需要验证、失败、已验证、需要修订、附注后已批准 和 未分配。通过 图层管理器 → 叠加层 启用。

关联透镜

作为 执行透镜 的补充，该功能会突出显示附带特定类型记录的要素：有任务、有示意图、有现场信息。

全局搜索

这是一个覆盖整个应用的命令面板，可在任何页面通过 Cmd/Ctrl-K 打开。它可在整个应用中搜索您的记录，并跳转至搜索结果。这与地图上的 搜索 窗口不同，后者用于查找要素并飞跃至相应位置。

设备端操作

“读取源”开关（原“离线模式”），可使列表页面和地图从本地设备副本而非实时服务器加载数据，从而让您在断网时仍能继续工作。 该功能与 自动保存到设备（本地写入频率）和 版本管理器 配合使用。请参阅 版本管理。

自动化与监控

钩子

一个已签名的出站目标，用于订阅您选择的事件：提供一个 URL 和一个签名密钥，每个匹配的事件都会通过 POST 请求发送到该地址。这是最简单的出站集成方式。请参阅 自动化与监控。

事件触发器

遵循 触发器 → 条件 → 操作 模型的自动化规则——当事件触发且满足条件时，将执行一项或多项操作（通知、创建工单、调用 webhook、写入 Postgres 等）。

数据导入连接器

一种将传感器/设备的读数导入 Aptli 的外部数据源——可采用拉取（Aptli 按计划轮询供应商 API）或推送（发送方使用数据采集 API 密钥向连接器端点发送 POST 请求）方式。

监测站

传感器用于上报数据的地图要素。读数到达后，该要素的记录将显示每个指标的最新值以及 7 天的 微型图表。

告警

当受监控的读数超过阈值（带有滞后机制，以避免频繁触发）或数据源停止发送数据（死传感器检测）时触发的记录。 告警会经历 活跃 → 已确认 → 已解决 的状态流转，通知接收方，若未及时确认，可升级至第二级。

结果

在项目中，这是一张将受监控指标序列与已完成工作里程碑进行对比的图表——读数与可能对其产生影响的工作并列显示（仅为提供背景相关性，并非因果关系声明）。可发布为只读且可撤销的共享链接。

连接配额

自动化功能的商业计量机制：每个 数据采集连接器、API 密钥和可重用的 钩子 都会从共享池中消耗一个 单位（内部事件触发规则不计入配额）。 Automations 本身包含在每个套餐中。

公共受理（服务门户）

提交

当公众成员通过公共服务门户提交请求时生成的记录——无需登录。包含一个公开的参考编号、可选的几何数据以及附件。工作人员会对其进行分流处理，并可将其转换为工单、报告或地图要素。

参考编号

提交者收到的简短、可分享的代码。该代码不包含任何内部标识符，是跟踪或回复提交的持久方式——同时，在提交者的设备上，也可通过该代码列出其所有提交记录（“我的提交”）。

转发以供跟进

将提交内容作为纯粹的单向交接传递给外部系统，附带一个仅限使用一次且会过期的回调链接，以便外部系统将结果回传一次。不会更改提交的状态；显示为 已转发 → 等待回复 → 已回复（或已过期/已撤销）。

回复即执行

通过电子邮件或短信发送工作单，收件人可通过回复该消息提交完成报告——无需登录。回复链接为一次性使用且会过期。

协作与可持续性

多人协作会话

基于6位代码的实时协同编辑会话（协同设计插件）：两人或多人可共同编辑同一张地图或记录，光标位置可见，主持人将协商一致的结果提交至主分支。 参见 多人协作。

委托资产 / 排放概况

“碳”插件功能（位于地图要素的记录上）可附加一个排放概况——将该要素与其以某种速率消耗的资源相关联——从而根据标准排放因子追踪其温室气体足迹。参见 碳。

速率负载指示器

一个小型应用内仪表，显示您距离请求速率限制还有多远——接近限制时显示琥珀色，达到上限时显示红色；当应用有意控制请求速率时，会显示“正在追赶…”状态。该功能仅供参考，旨在高负载情况下保障应用响应性。