Spatial diagnostics UX: confidence, conflicts, and remediation cues

[DarinShapiro]

Summary

Build the 'Explainable AI' layer for spatial diagnostics, surfacing why placements were made and how to fix issues.

Why

Spatial inference can be counter-intuitive; operators need to know when metrics conflict with the physical model.

Scope

• Placement Logic Display: Tooltips or sidebars explaining why a node is placed in a specific spot (e.g., 'Strong LQI to Router A').
• Conflict Highlighting: Mark nodes where RF evidence (RSSI) contradicts the floorplan anchor.
• Remediation Suggestions: Suggest adding a router in a 'weak corridor' or moving a node away from a high-loss barrier.
• Uncertainty Visualization: Visual cues for low-confidence placements (e.g., blurred or dashed icons).

Acceptance Criteria

• UI surfaces conflicts between 'expected' and 'observed' signal strength based on location.
• Actionable remediation tips appear in the diagnostic panel.
• Confidence levels are clearly communicated to the user.

[DarinShapiro]

Requirement: Ground diagnostic insights in spatial and radio evidence. Explanation should correlate link degradation with physical barriers (e.g., walls) and recommend strategic router placement (e.g., adding a router between a weak endpoint and the OTBR) to optimize routing paths for nearby devices.