Module 2 · Entitlement
Entitlement & Overspend Controls
Role-aware entitlement display. The same district's entitlement renders three different ways depending on who is looking at it. The 10% buffer in the distributor view is what production episode ticket #303613 was about — distributor displays were inadvertently showing the buffered cap as if it were additional district spend capacity.
About the 10% buffer
The board-approved 10% buffer is the operational concept that drives the difference between district and distributor views.
- District perspective
- Sees the unbuffered entitlement number — the actual dollar value of USDA Foods the district is authorized to spend.
- Distributor perspective
- Sees the hard cap, which is the unbuffered entitlement plus a 10% buffer. The buffer exists so distributors can accept rounding, late corrections, and per-truck variance without rejecting valid district orders. It is not additional spend capacity for the district.
- Why this needed to be role-aware
- Early production builds displayed the buffered hard cap to both districts and distributors. Districts read the buffered figure as additional ordering room, ordered against it, and triggered overspend reconciliation cycles. Ticket #303613 corrected the display logic so each role only sees what it should act on.
Entitlement adjustments · Admin only
Admin can record one-off adjustments to a district's entitlement — carry-overs from the prior school year, late USDA allocation corrections, or board overrides. Adjustments apply to baseline before role-specific display.