Minecart · Visit Schedule
Three approaches each for the template-builder (manager web) and rep daily-list (mobile), one approach for the account-detail cadence block. Use this page to navigate, react, and pick directions.
Drafted 2026-05-19 · For review, not production fidelity
Foundation concept note: visit-schedule-concept
last_qualifying_visit_at and the scored pool.RepUnavailability with provenance.Pool = accounts due or approaching breach AND not already scheduled in any future EntityList within the planning horizon (default 7 days). When an agent or rep adds an account to a future list, it drops out of the pool. When a list closes without a substantive visit, the account re-enters the pool with a carryover boost.
This changes the mental model from "today's list" to "planning horizon with multiple lists." The mobile UI should make the planned week visible, not just today.
urgency = days_since_visit / max_gap_days; multiply by priority and tightness. Normalizes weekly vs monthly cleanly. Continuous score, harder to explain ad-hoc.
Recommended: ship the normalized-urgency math (B), render the tier labels (A) on the surface. Defensible engine, scannable UI.
Trusting breach severity alone fails when a planned account isn't yet overdue. So:
substantive activity auto-carries to tomorrow's draft list.attempted_no_contact gets half boost; cancelled_by_customer gets none.EntityListMember: rescheduled_from FK, so we can render "carryover from Monday" and decay correctly.Three mental models for defining cadence.
Approach A
Twelve months across the top. Drag/click segments onto months. Visual, marina-friendly.
Approach B
Table of (start, end, max gap, preferred gap) rows. Add rows. Textual, contract-friendly.
Approach C
Pick from cards ("Year-round Weekly", "Marine Seasonal", "Quarterly Touch"), then customize.
Three mental models for the rep's day-and-week. All show the planning horizon, not just today.
Approach A
Single ranked list, tier labels, badge per account. Algorithm-first. Familiar todo-list shape.
Approach B
Map plus regional groupings, list nested beneath. Spatial-first. Built for drivers.
Approach C
AM block / lunch / PM block / overflow. Calendar-shaped. Mirrors how reps actually structure a day.
One approach for now. Visible to both reps and managers on the account.