概念

每个标题解释面板上的一个词。面板里的 ? 按钮会带你到其中一个标题。

ETA 时间窗

顾客看见的是分钟区间，不是单独一分钟。GPS 越确定、交通越慢，窗口越窄。跟踪页上只显示一个数字，会让人误以为时间很精确，一旦这一分钟变动，顾客就会不安。

API 报价（POST /api/v1/quotes）以 minMinutes 和 maxMinutes 给出同样的东西，guaranteed: false。只展示一个数字的合作方改变了时间窗的含义，不只是外观。

flowchart TD
  q["下单前的 API 报价"] --> sum["准备 + 装载 + 行驶 + 余量"]
  sum --> win["分钟窗，guaranteed false"]
  live["在途订单"] --> need{"GPS 位置和 B 点"}
  need -->|"缺一样"| none["没有 ETA，页面仍活着"]
  need -->|"都有"| route{"Google 路线"}
  route -->|"有钥匙和响应"| road["路上时间"]
  route -->|"没有或出错"| hav["直线"]
  road --> shown["顾客看见窗口，不是一分钟"]
  hav --> shown

只有在订单在途、我们知道司机位置和 B 点时，/o/… 上才有实时 ETA。缺少其中一项，页面仍然可用，只是没有时间窗。

没有车队就根本没有时间窗：跟踪页只显示状态。见跟踪链接。

套餐上限

每个套餐对车辆、司机和成员都有上限。到达上限后，你无法添加新记录，直到更换套餐或腾出名额。这不是表单错误，而是公司的权益。

面板消息会告诉你到达了哪个上限。套餐旁的 ? 按钮指向这里，不是价目表。

跟踪链接

/o/… 地址（订单短码）在订单还在系统里时有效。地址在公司主机上：id.delieta.pl/o/…，或 — Pro 套餐 — CNAME 之后的自定义主机。送达后页面显示已完成，不是 404 错误。知道链接的人能看到这一单配送，但页面不显示顾客的姓名、电话和地址。

链接有两种形态。有车队时显示地图、司机和 ETA 时间窗。没有车队 — 或到店自取、没有人配送时 — 只显示状态：订单步骤和公司名称。司机位置和目的地址根本不会出现在页面上，所以没有可泄露的东西。见跟踪页。

另一家公司的地址加上你的代码什么也不显示。delieta.pl/o/… 上的旧链接仍可用。

这 不是 司机令牌。你从订单卡片复制链接。面板里怎么做：如何发送跟踪链接。合作方在 201 里以 trackingUrl 拿到同一 URL。DNS：跟踪域名。

司机 GPS

司机手机用 drv_… 密钥发送位置。第一个信号之前，车队显示「等待 GPS」。第一个信号是重要的一步，不是技术细节。

密钥留在手机上。更换密钥会使旧地址失效。不要把 drv_… 发给顾客 — 顾客收到的是跟踪链接。

跟踪令牌

跟踪令牌就是司机手机上的同一个 drv_… 密钥。代码和连接手机的屏幕使用这个名字。它不是订单标识，打不开 /o/…，也不能当面板密码。

这是两个不同的令牌：drv_… 标识司机，/o/{shortId} 标识一单配送。混淆它们，会把司机的位置暴露给只应看到一单配送的人。

flowchart LR
  drv["司机电话上的 drv_ 钥匙"] --> gps["司机位置和任务"]
  page["/o/ 页加短码"] --> glance["一单，没有姓名和电话"]
  drv -.->|"打不开"| glance
  page -.->|"不驾驶"| gps

警报紧急程度

颜色表示有多急。它不表示警报是否已读或已解决。

• 紧急（红）：正在发生。
• 风险（琥珀）：马上就晚 — 到达会错过承诺的 ETA 时间窗。
• 运营（灰）：这一班内要处理的事 — 闲置的司机、电量低、没有分配司机的队列。

确认、稍后提醒、解决是三个不同的操作。已读的灰色警报仍属于运营，直到有人关闭它。

租户

租户是一家公司：披萨店、花店、服务。人的账户和公司不是一回事。

数据按公司隔离，不按角色隔离。A 公司的成员看不到 B 公司的数据。公司内部每个被邀请的人都有完整运营权限；角色是标签。

Partner API 不在 body 里接收公司名称。dlt_live_… 密钥本身就代表公司。

flowchart LR
  session["面板：已登录会话"] --> doorA["公司门"]
  key["合作方：Bearer dlt_live"] --> doorB["公司门"]
  doorA --> co["公司 A"]
  doorB --> co
  co -.-> miss["这次调用里不存在公司 B"]
  pub["可发布钥匙"] -->|"只有 catalog:read"| menu["GET /menu"]
  role["成员角色"] -.->|"标签，不是闸门"| co

模块

模块是公司拥有或不拥有的一组屏幕和功能：商店、车队、预订、餐饮外送、翻译、在线支付。商店和车队是路径，其余是需要商店的附加功能。

模块只在三个条件同时成立时启用：订阅包含它，设置 → 模块里的所有者开关已开，它所需的模块也在运行。关闭的模块从菜单消失，数据保留。完整说明：模块与订阅。

flowchart LR
  plan["订阅包含该模块"] --> on{"三者同时成立"}
  sw["所有者开关已开"] --> on
  need["所需模块在运行"] --> on
  on -->|"是"| shown["模块出现在菜单和仪表盘"]
  on -->|"否"| hidden["从菜单消失，数据保留"]

权益

权益是套餐允许公司拥有的一切：上限（车辆、司机、成员）和功能（实时跟踪、分析、白标就绪，以及商店功能：下单、预订和餐饮外送）。没有权益时，你看不到停用的按钮，因为这项功能根本不存在。权益只是模块三个条件中的第一个。

实时跟踪在 Starter、Growth 和 Pro。分析在更高的套餐里。自定义域名在 Pro 套餐可用：你在设置 → 开发者的域名卡片里配置，分步说明见跟踪域名。集成里的其他卡片介绍密钥和门店地址。

套餐上限旁的 ? 按钮指向上限；“权益”含义更广，也包括功能，不只是上限。当前上限和价格：设置 → 订阅。

行程

行程（英 run）是司机当前路线：他此刻要跑的各个停靠点，按顺序排列。司机卡片上显示为「当前行程」。空行程表示司机在班上但没有分配任何任务 — 和缺少 GPS 不同。

行程不是订单。公开跟踪链接永远属于一张订单，不是整段行程。