Capacity & Occupancy
Capacity tells Yard Spot how many assets a location can hold, so the gate can warn an operator before they send a truck to a full row.
Occupancy is assignment-based: it counts the assets currently assigned to a location, not GPS positions inside a boundary. An asset parked in a row but assigned elsewhere does not count towards that row. This keeps the number consistent with what the gate actually decided.
Where Capacity Comes From
| Location kind | Capacity |
|---|---|
| Point | Defaults to 1 — a single parking spot. |
| Shape | Whatever you set on the geoshape. A shape with no capacity is not capacity-tracked. |
Set capacity on shapes in the Location Editor. A shape with no capacity value is not an error; it simply never triggers a full warning.
What the Operator Sees
At check-in, if the assigned location has reached its capacity, the check-in is soft-blocked.
The operator is told the location is full and must acknowledge to continue. Proceeding is recorded
as a capacity_override exception on the visit.
Soft-blocking rather than hard-blocking is deliberate. The operator standing at the gate can see the yard; the capacity number is a model of it. When the two disagree, the person with eyes on the row should win — but the disagreement gets recorded so you can find out why.
A steady stream of capacity overrides on one location usually means its configured capacity is wrong, not that operators are misbehaving.
Reading Occupancy
Each capacity-bearing location reports its name, capacity, current occupancy, and whether it is full. This is what drives the full warnings at the gate, and it answers "where can I actually put this?" without walking the yard.
Locations with no capacity configured are absent from the occupancy view — there is nothing meaningful to report for them.
Getting Capacity Right
- Start with the rows that fill up. Capacity on a location that is never near full adds configuration burden and warns nobody.
- Count what fits, not what is painted. If a row is marked for twelve but realistically holds ten with a reefer at the end, ten is the more useful number.
- Points are already capacity 1. You do not need to configure individual spots; that is the default.
- Revisit after a month. Override frequency per location is the honest signal about whether a capacity figure matches the yard.