Story 3: Trace Water Flow Problem

Coming Soon

This feature is planned for a future release.

As a maintenance crew member I want to trace pipes backward from a dry trough So that I can identify the failure point

User Journey

Screenshots

Trace view showing upstream path with status indicators

Wireframes

Step 1: Element detail with Trace button

┌─────────────────────────┐
│  ← East Pasture Trough  │
├─────────────────────────┤
│  [📷]      Status: Fair │
│  Type: Trough           │
├─────────────────────────┤
│  Connections            │
│  ├─ → Main Tank (pipe)  │
│  └─ ← Pump Station      │
├─────────────────────────┤
│  [Trace Upstream ↗]     │
├─────────────────────────┤
│  Inspections            │
│  └─ Jan 18: Fair ⚠      │
└─────────────────────────┘

Step 2: Upstream trace view

┌─────────────────────────┐
│  ← Trace Upstream       │
├─────────────────────────┤
│                         │
│  ┌───────────────────┐  │
│  │ ⬡ East Trough     │  │
│  │   Starting point  │  │
│  └───────────────────┘  │
│           │             │
│           ▼             │
│  ┌───────────────────┐  │
│  │ ▢ Main Tank    ⚠  │  │
│  │   Fair condition  │  │
│  └───────────────────┘  │
│           │             │
│           ▼             │
│  ┌───────────────────┐  │
│  │ ⚙ Pump Station ✗  │  │
│  │   Poor condition  │  │
│  └───────────────────┘  │
│           │             │
│           ▼             │
│  ┌───────────────────┐  │
│  │ ● North Well   ✓  │  │
│  │   Good condition  │  │
│  └───────────────────┘  │
│                         │
├─────────────────────────┤
│  ⚠ Problem Identified   │
│  ┌───────────────────┐  │
│  │ ⚙ Pump Station    │  │
│  │   Requires attn   │  │
│  │          [View]   │  │
│  └───────────────────┘  │
└─────────────────────────┘

Steps

1. Open element detail - Navigate to the element with the problem (e.g., dry trough)
2. Tap Trace Upstream - System follows pipe connections backward
3. Review element chain - Each element shows its condition from latest inspection
4. Identify failure - First element with "Poor" status is highlighted
5. Tap View - Navigate directly to problem element
6. Check inspections - Review photos and notes to understand the issue

How Tracing Works

The trace algorithm uses Breadth-First Search (BFS) to traverse the pipe network:

1. Starts from the selected element
2. Follows incoming pipes only (upstream direction)
3. Respects pipe flow direction settings
4. Shows each element's status from its latest inspection
5. Identifies the first element with "Poor" condition as the problem

Status Indicators

Status	Color	Meaning
✓ Good	Green	Upstream source is healthy
⚠ Fair	Orange	May need attention
✗ Poor	Red	Problem identified
— Unknown	Gray	No inspection recorded

Happy Path

Report of dry trough → open trough detail → tap "Trace Upstream" → see chain: Trough ← Tank ← Pump ← Well → pump shows red "Poor" status → tap "View" → see pump inspection photos showing broken belt → dispatch repair with right parts.

Implementation Status

🔜 Planned for M7: Tracing & Diagnostics - BFS-based upstream tracing with problem identification. UI wireframes and algorithm are designed; implementation pending M6 completion.

Related Features

• Map Visualization — View element locations and plan routes
• Systems Organization — Organize elements by water system
• Element Management — View element details and inspection history