Daily Pace Color Scale Alignment
This page compares the color ranges in the app today with a proposed daily-session scale where purple means effectively at the current adjusted target, not merely near it in absolute percentage points.
Current Color Ranges
Current logic uses actual - expected in absolute percentage points. A small special case now keeps displayed-zero values green.
| Color | Signal | Current rule | Example when target is 4.5% |
|---|---|---|---|
| Gray | Unknown | Missing or invalid actual/expected. | No observed session data. |
| Green | Reserve available | actual < 0.05% or more than 6 points under target. | 0.03%/4.5% or below -1.5%, practically only displayed-zero for this target. |
| Purple | On pace | Within -6 to +6 percentage points. | 0.1%/4.5% through 10.5%/4.5%. |
| Orange | Too fast | More than 6 and up to 12 points over target. | 10.6%/4.5% through 16.5%/4.5%. |
| Red | Way too fast | More than 12 points over target, or limit hit. | Above 16.5%/4.5%. |
Alignment issue: for small daily-session targets, the absolute six-point purple band is too wide. With a 4.5% target, using 10.5% still appears purple even though it is 233% of target.
Target Rebalancing Model
The Daily row should model real provider reset windows clipped to the local day. The daily target comes from remaining weekly quota divided by days remaining, then each slice receives a time-weighted share of that target.
| Step | Calculation | Implication |
|---|---|---|
| Daily target | Weekly remaining 67.5% divided by 3 days remaining = 22.5% for today. | The daily plan follows the weekly reset window, not a fixed local preference. |
| Provider session slices | Provider windows are clipped to local day: 00:00-04:00, 04:00-09:00, 09:00-14:00, 14:00-19:00, 19:00-24:00. | First and last slices can be partial-day portions of cross-midnight provider sessions. |
| Initial targets | Targets are time-weighted by overlap: 3.8%, 4.7%, 4.7%, 4.7%, 4.7% for a 24-hour day. | Targets are equal only when slice durations are equal. |
| Observed underuse | If 00:00-04:00 is observed at 1.0%, remaining target becomes 21.5% and later slices rebalance by remaining overlap. | Only observed actuals create catch-up pressure. |
| Unobserved past | If morning slices have no evidence, they stay gray as No data and do not subtract 0% from the day. | A fresh install in the afternoon does not inflate current or future targets. |
| Budget used | If observed usage exactly consumes today's adjustable allocation, future target-only slices show Budget used. | The slice remains gray until actual usage is observed. |
| Overdrawn budget | If observed usage exceeds today's allocation, the raw remaining pace budget can cross zero and become negative, e.g. Overdrawn 0.9%. | Negative slice budgets are visible and represent weekly allowance pulled forward from future daily pace. |
Evaluation: colors should be calculated against each observed slice's assigned target. Past observed slice targets stay fixed; current and future targets rebalance only from observed actual usage. Past unobserved, future target-only, and future overdrawn-budget-only slices are gray and do not affect aggregate Daily row color. Gray can therefore mean missing/unobserved data, future target-only, or future overdrawn-budget-only.
Overdrawn Pace Budget Examples
| Slice | Display | Tooltip contract | Color |
|---|---|---|---|
| Future positive budget | Target 3.4% | Target-only future session. | Gray |
| Future zero budget | Budget used | Today's allocation is fully used. | Gray |
| Future negative budget | Overdrawn 0.9% | Today's allocation has been pulled forward from the remaining weekly budget. | Gray |
| Observed negative-budget slice | 4.2%/Overdrawn 0.9% | 4.2% used; today's pace budget is already overdrawn by 0.9%. This usage is pulled from the remaining weekly budget and lowers future daily pace. | Red |
Proposed Daily-Session Scale
Use actual as a ratio of the adjusted target for daily session segments. This version treats the colors as a progress spectrum: unavailable, started but far behind, catching up, at pace, over pace, badly over, and hard limit hit.
| Color | Meaning | Proposed rule | Example when target is 4.5% |
|---|---|---|---|
| Gray | Unknown | Missing or invalid actual/expected. | No observed session data. |
| Yellow | Started, far behind pace | Observed usage, but below 50% of target. | Above 0% through 2.2%/4.5%. |
| Green | Catching up, still behind | 50% to below 100% of target. | 2.3%/4.5% through 4.4%/4.5%. |
| Purple | Essentially at pace | 100% to 105% of target. | 4.5%/4.5% through 4.7%/4.5%. |
| Orange | Over pace | More than 105% and up to 125% of target. | 4.8%/4.5% through 5.6%/4.5%. |
| Red | Badly over target | More than 125% of target. | Above 5.6%/4.5%. |
| Checkered | Limit hit | Hard cap reached: session, daily if supported later, or weekly. | 100% session/weekly limit, independent of pace ratio. |
Evaluation
What Works
This scale matches the mental model of moving through the current adjusted target. Yellow and green are no longer both just "under"; yellow means barely started, green means useful progress with headroom.
Key Tradeoff
Yellow becomes neutral-warning instead of bad. Copy and tooltips should say "far behind pace" rather than "bad" so it does not imply quota waste.
Implementation Shape
Daily session segments should use ratio thresholds against rebalanced targets. Session and weekly hard limits should still use checkered/limit-hit semantics when a provider bucket reaches 100%.
Simulated Provider Rows
Unavailable/future
Started, far behind
Catching up
At pace
Over pace
Badly over
Limit hit
Current scale, realistic provider day
Session limit
Current provider window
14:00-19:00; 32% of the session bucket used.32%
Daily pace
Daily target 22.5%; observed morning underuse rebalanced later timed slices.
00-04 1.0/3.8
3.2%/5.4%
5.4%/5.4%
6.4%/5.4%
19-24 6.5
5%
Proposed scale, same provider day
Session limit
Session row can keep existing broader session-level pace logic.
32%
Daily pace
Daily slices use ratio to adjusted targets; future target-only slices remain gray.
00-04 1.0/3.8
3.2%/5.4%
5.4%/5.4%
6.4%/5.4%
19-24 6.5
5%
Observed Underuse Progression
Each Daily row is a separate snapshot after a real provider session slice. Completed observed slices use the proposed ratio color scale; future slices stay gray target-only, with displayed targets rebalanced only from observed actuals.
After 00:00-04:00
Used 1.0%; remaining target is 21.5% across 20 remaining local hours.
Daily pace
The partial first slice is observed far behind; later slices are target-only.
00-04 1.0/3.8
04-09 5.4
09-14 5.4
14-19 5.4
19-24 5.4
22%
After 04:00-09:00
Used 4.2%; remaining target is 18.3% across 15 remaining local hours.
Daily pace
The second observed slice is behind but catching up; later targets rise.
00-04 1.0/3.8
04-09 3.2/5.4
09-14 6.1
14-19 6.1
19-24 6.1
59%
After 09:00-14:00
Used 9.6%; remaining target is 12.9% across 10 remaining local hours.
Daily pace
The midday slice lands below its rebalanced target; future targets rise again.
00-04 1.0/3.8
04-09 3.2/5.4
09-14 5.4/6.1
14-19 6.5
19-24 6.5
89%
After 14:00-19:00
Used 16.0%; remaining target is 6.5% for the final local slice.
Daily pace
The current-afternoon slice nearly reaches its adjusted target; final slice remains target-only.
00-04 1.0/3.8
04-09 3.2/5.4
09-14 5.4/6.1
14-19 6.4/6.5
19-24 6.5
99%
After 19:00-24:00
Used 22.5%; daily target is fully allocated across observed slices.
Daily pace
All slices are observed; no future target-only segments remain.
00-04 1.0/3.8
04-09 3.2/5.4
09-14 5.4/6.1
14-19 6.4/6.5
19-24 6.5/6.5
100%
Fresh Install And Overuse Progressions
The first snapshot shows a fresh install during the current provider session. Earlier timed slices are gray No data before Pitwall started and do not rebalance. The later snapshots show observed overuse, where only observed actuals shrink future targets.
Fresh install at 14:30
Morning slices are unobserved; current and future targets keep their time-weighted plan.
Daily pace
No observed actual usage yet; missing morning evidence is not treated as zero.
00-04 No data
04-09 No data
09-14 No data
14-19 target 4.7
19-24 target 4.7
?
After 00:00-04:00 observed on target
Used 3.8%; remaining target is 18.7% across 20 remaining local hours.
Daily pace
Observed first slice hits its partial-day target; future targets stay near plan.
00-04 3.8/3.8
04-09 4.7
09-14 4.7
14-19 4.7
19-24 4.7
100%
After 04:00-09:00 over pace
Used 8.8%; remaining target is 13.7% across 15 remaining local hours.
Daily pace
The observed second slice exceeds target; later targets shrink by remaining overlap.
00-04 3.8/3.8
04-09 5.0/4.7
09-14 4.6
14-19 4.6
19-24 4.6
106%
After 09:00-14:00 badly over
Used 14.8%; remaining target is 7.7% across 10 remaining local hours.
Daily pace
Observed midday overuse tightens the current and final target-only slices.
00-04 3.8/3.8
04-09 5.0/4.7
09-14 6.0/4.6
14-19 3.9
19-24 3.9
129%
After 14:00-19:00 still over
Used 19.0%; remaining target is 3.5% for
19:00-24:00.Daily pace
The current slice is observed over pace; only the future target changes.
00-04 3.8/3.8
04-09 5.0/4.7
09-14 6.0/4.6
14-19 4.2/3.9
19-24 3.5
108%
Concrete Daily-Session Examples
| Displayed segment | Ratio to target | Today | Proposed |
|---|---|---|---|
00:00-04:00 No data / 3.8% | Unavailable | Gray | Gray; missing or unobserved, not zero usage |
04:00-09:00 0% / 4.7% | 0% | Green after the displayed-zero fix | Yellow only when observed zero is confirmed |
09:00-14:00 target 4.7% | Future target-only | Gray | Gray; target-only future slice |
0.8%/4.5% | 18% | Purple | Yellow |
3.2%/5.4% | 59% | Purple under current absolute band | Green |
5.4%/5.4% | 100% | Purple | Purple |
6.4%/5.4% | 119% | Purple | Orange |
6.9%/5.4% | 128% | Purple | Red |
10.5%/5.4% | 194% | Purple under current absolute band | Red |
100% session limit | Hard cap | Limit hit color path | Checkered limit-hit state |