All Docs
FeaturesDepositClearUpdated March 12, 2026

Analytics Dashboard: Proactive Insight Banners

Analytics Dashboard: Proactive Insight Banners

Available from: v0.1.232

The analytics dashboard now detects and surfaces actionable anomalies automatically, rendering them as contextual InsightBanners above the KPI card row. You no longer need to manually compare periods or spot trends in raw numbers — the system flags what needs your attention and links you directly to the relevant action.

Overview

KPI cards on the analytics dashboard show aggregate metrics for the selected period:

  • Total Releases
  • Total Deducted
  • Avg Deduction
  • Dispute Rate
  • Resolution Rate
  • Avg Time-to-Resolve

While a delta % badge on each card indicates direction of change, it cannot distinguish a stable-but-high value from a sudden spike. InsightBanners solve this by computing three specific anomaly signals server-side and presenting each as a plain-language callout with a direct action link.

Insight Types

1. Resolution Time Spike

Trigger: avgResolutionDays for the current period has increased by more than 50% compared to the prior period.

Example banner:

⚠️ Avg time-to-resolve jumped +150% vs last period — 3 tenancies have been in-progress for 30+ days.

What to do: Follow the action link to view the long-running tenancies and identify blockers (missing evidence, unresponsive parties, etc.).

2. Dispute Rate Trending Upward

Trigger: The monthly disputedCount has increased for 3 or more consecutive months.

Example banner:

📈 Dispute rate trending upward 3 months in a row — consider reviewing deduction evidence quality.

What to do: Follow the action link to the evidence audit view to assess whether deduction justifications are meeting evidential standards under the Renters' Rights Act.

3. Top-Performing Agent Benchmark

Trigger: Always shown when agent-level resolution data is available for the period.

Example banner:

🏆 Your fastest resolution this month was Agent X at 8 days — benchmark for the team.

What to do: Follow the action link to Agent X's case breakdown to identify practices that can be shared across your team.

How It Works

InsightBanners are server-computed. When the analytics dashboard loads, the analytics router evaluates the three signals against the existing analytics query data and returns an insights array in the response payload. No additional data sources or queries are needed.

The InsightBanner component renders above the KPI cards. If no signals are triggered, the banner area is hidden and the dashboard appears as before.

Page layout (with active insights)

┌─────────────────────────────────────────────────┐
│  ⚠️  InsightBanner: Resolution time spike        │
│  📈  InsightBanner: Dispute rate trending up     │
├─────────────────────────────────────────────────┤
│  [ KPI Cards row ]                              │
│  Total Releases | Deducted | Avg Deduction ...  │
└─────────────────────────────────────────────────┘

Relationship to the Existing High-Dispute-Rate Banner

A separate banner triggered at dispute rate ≥ 20% already existed before this release. InsightBanners are additive — they coexist with the existing threshold banner and cover anomaly patterns (trend direction, period-over-period spikes, benchmarks) that a single threshold cannot capture.

Notes

  • All three signals are computed over the currently selected period and its immediately prior equivalent period.
  • The top-agent benchmark insight is informational only; it does not trigger a warning state.
  • InsightBanners do not replace KPI cards or the delta % badges — they layer contextual interpretation on top of the existing metrics.