feat(statistics): usual weekday baseline matches opening hours; configurable sample rules #105

New issue

Closed

opened 2026-09-25 17:29:05 +00:00 by gabogg · 0 comments

gabogg commented

2026-09-25 17:29:05 +00:00

Owner

Step 3 of the pre-deck work agreed on 2026-09-25. Decisions are settled. Changes a route the deck will call, so it lands before the deck.

Decisions

The Usual Weekday Baseline only uses source days whose opening hours (open and close time for that business day, after holiday/exception overrides) match the target day's. Applies to the shared list of dates, so the hourly and daypart baselines stay consistent. A Closed Day is never a sample (step 1).
Replace the fixed numbers with config keys (no magic numbers): max samples (default 4), lookback weeks (default 8), minimum samples (default 2).
Rename the query value baseline=same_weekday_4w to baseline=usual_weekday on all four routes (admin + presenter). No compatibility alias needed: no client uses it yet.
Glossary wording (CONTEXT.md, reconciled with #80):

Usual Weekday Baseline: The mean of up to the configured number of earlier instances of the same weekday, from the configured lookback before a closed business day, used as the "usual" reference for that day. A day counts only if it has counted flow, is not a holiday or Closed Day, has no ingestion gap, is trusted in its current audit, and had the same opening hours. With fewer than the configured minimum there is no baseline. Avoid: average day, normal day.
Dwell weighting and the volume-daypart rule stay in the API docs, not the glossary.

🤖 Generated with Claude Code

Step 3 of the pre-deck work agreed on 2026-09-25. Decisions are settled. Changes a route the deck will call, so it lands before the deck. ## Decisions - The Usual Weekday Baseline only uses source days whose opening hours (open and close time for that business day, after holiday/exception overrides) match the target day's. Applies to the shared list of dates, so the hourly and daypart baselines stay consistent. A Closed Day is never a sample (step 1). - Replace the fixed numbers with config keys (no magic numbers): max samples (default 4), lookback weeks (default 8), minimum samples (default 2). - Rename the query value `baseline=same_weekday_4w` to `baseline=usual_weekday` on all four routes (admin + presenter). No compatibility alias needed: no client uses it yet. - Glossary wording (CONTEXT.md, reconciled with #80): > **Usual Weekday Baseline**: The mean of up to the configured number of earlier instances of the same weekday, from the configured lookback before a closed business day, used as the "usual" reference for that day. A day counts only if it has counted flow, is not a holiday or Closed Day, has no ingestion gap, is trusted in its current audit, and had the same opening hours. With fewer than the configured minimum there is no baseline. _Avoid_: average day, normal day. - Dwell weighting and the volume-daypart rule stay in the API docs, not the glossary. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

gabogg added the

ready-for-agent

label

2026-09-25 17:29:05 +00:00

gabogg referenced this issue

2026-09-25 17:29:11 +00:00

follow-up(statistics): P3 cleanups from #90 review (usual-weekday baselines) #97

gabogg referenced this issue

2026-09-25 18:16:35 +00:00

feat(schedule): each business day remembers the schedule it was measured under #113

gabogg referenced this issue

2026-09-25 19:19:30 +00:00