术语表

Aptli 专有术语快速参考，涵盖平台全站及本指南中使用的词汇。

数据与记录

版本化模型

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

对比：实时模型

实时模型

无需中间步骤、直接保存至服务器的记录。变更立即对所有用户可见。工单、报告、验证、事务和站点均采用实时模型。

对比：版本化模型

草稿

对版本化记录所做的、尚未提交至服务器的本地变更集合。草稿存储在浏览器（IndexedDB）中，无需网络即可在页面刷新后保留。每个版本每位用户只能有一个活跃草稿。草稿可上传至服务器供管理员审核后再发布。

提交（Commit）

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

版本冲突

两位用户分别在各自的离线草稿中编辑了同一要素时发生。Aptli 在提交时通过比较每个草稿的基础版本与当前正式版本来检测冲突。存在冲突的提交将被标记供管理员审核，在解决前无法应用——不会发生静默覆盖。

库存

资源

对材料、耗材、设备类型或劳动力类别的定义。资源定义计量单位、可选的单位换算，以及领取该资源是否需要协助人员。示例：500 m 光纤电缆、混凝土锚栓、安装团队工时。

库存项目

特定站点中特定资源的当前余量。库存项目仅通过事务更新，从不直接编辑。一种资源可同时在多个站点持有库存项目。

站点

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

事务

记录每次库存移动的不可变台账条目。事务无法编辑或删除——更正操作始终通过创建新的调整事务进行。事务类型：

领料码

分配工单时签发的限时 JWT 签名二维码。现场工人在仓库扫描领料码以授权并领取分配的材料。领料码中编码了授权的资源数量、所属分配及到期时间。只有被指定的工人——或拥有 canFacilitatePickups 权限的用户——才能扫描。

调拨码

授权站点间点对点库存调拨的 JWT 签名二维码。与领料码不同，调拨码不与工单绑定。可为任意站点间移动生成，由接收方扫描以执行调拨并自动记录事务。

工作履行

任务

具有定义资源需求、带地理空间定位的计划工作单元。任务是版本化的——与地图要素一样经历草稿 → 提交流程。任务可定位在某个点（检查井）、线（路段）、多边形（小区），或保持无定位以处理办公室工作。任务归属于项目，通过工单完成。

工单

将一项或多项任务分配给团队，附带截止日期和可选的材料领料码。工单实时跟踪状态（待处理 → 进行中 → 已完成）。也称为分配。

报告

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

验证

主管对已提交报告的质量审查。验证记录结果（通过 / 未通过 / 需要修改 / 已批准）及相关发现。未通过或需要修改的验证将报告退回给工人；已批准的验证可触发付款释放计算。

项目

共享截止日期和团队分配的相关任务集合。项目提供所有任务和报告的高层次进度视图。

安全与访问

管理员权限

控制用户可以执行哪些操作的授权。Aptli 拥有 40 余项细粒度管理员权限，涵盖系统中的每项创建、读取、更新和删除操作。示例：workOrdersCreate、reportsDelete、allowCommits、canFacilitatePickups、canRunAiQueries。管理员权限是累加的——没有任何权限的用户只能读取自己的分配。

角色限制

控制用户不能看到哪些数据的字段级限制过滤器。角色限制在服务器端执行：未经授权的数据从不发送至客户端，而不只是在界面中隐藏。示例：assignedTo = currentUser 限制会将承包商限定为只能查看自己的工单。角色限制与管理员权限作为两个独立层运作。

地图与 GIS

图层

共享同一几何类型（点、线或多边形）和视觉样式（图标、颜色、线宽）的命名地图要素集合。图层定义要素是什么——例如"电话杆"图层或"管道路由"图层。图层是版本化的。

示意图

对地图要素或抽象对象之间连接关系进行建模的关系图。示意图使用图形编辑器（节点和有向边）来表示网络拓扑、电缆路径、管道填充或其他难以单独在地理地图上表达的关系。示意图是版本化的。

绘图暂存区

在将几何图形提交到永久地图要素之前进行绘制和精细调整的临时编辑区域。绘图暂存区允许进行复杂编辑——徒手绘制、捕捉、多要素操作——并在发布前进行审查。