概念

面板里的 ? 助手说「看概念」，落到这些标题之一。每个标题是 UI 上的一个词，不是架构章节。

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

/o/… 上的活 ETA 只在订单在途、有司机位置、有 B 点时存在。

套餐上限

每个套餐有车辆、司机和成员天花板。碰到天花板后，新行存不上，直到你改套餐或腾出名额。那不是字段校验错误 — 那是公司的权益。

面板消息会说你撞上了哪块天花板。

跟踪链接

/o/… 地址（订单短码）在订单还在系统里时有效。生产环境在公司主机：id.delieta.pl/o/…，或 — Pro 上 — CNAME 之后的自定义主机。送达后作为完成打开，不是 404。

别人公司的主机配上你的码什么也不显示。delieta.pl/o/… 上的旧链接仍可用。

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

司机 GPS

司机电话用 drv_… 钥匙发送位置。第一个信号之前，车队显示「等待 GPS」。第一次 ping 是里程碑。

钥匙留在电话上。轮换作废旧地址。不要把 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

权益

权益是套餐允许公司拥有的：天花板（车辆、司机、成员）和旗标（实时跟踪、分析、白标就绪）。缺少权益不会渲染关掉的按钮 — 功能不在。

实时跟踪在 Starter、Growth 和 Pro。分析更高。自定义域名记为 Pro 就绪，不是集成里一张能用的卡片。

套餐上限旁的助手指向上限。

行程

行程（英 run）是司机当前路线：此刻运送的有序停靠。司机卡片上显示「当前行程」。空行程表示人在班上但什么都没派 — 和缺少 GPS 不同。

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