Story 6: Adjust Pipe Route (Photo-Based)

Coming Soon

This feature is planned for a future release.

As a ranch technician I want to refine a pipe route by walking it and taking geolocated photos So that the map accurately reflects where pipes actually run underground

User Journey

Wireframes

Step 1: Select pipe and enter edit mode

┌─────────────────────────┐
│  Waterworks        [+]  │
├─────────────────────────┤
│                         │
│    ● Well               │
│    │                    │
│    │ ← tap pipe         │
│    │                    │
│    ▢ Tank               │
│                         │
├─────────────────────────┤
│  Pipe: Well → Tank      │
│  [Edit Route] [Details] │
└─────────────────────────┘

Step 2: Route edit mode - take photos along path

┌─────────────────────────┐
│  Edit Route      [Done] │
├─────────────────────────┤
│                         │
│    ● Well               │
│    ┃                    │
│    ┃ ← walk this path   │
│    ┃                    │
│    ▢ Tank               │
│                         │
├─────────────────────────┤
│  Walk pipe route and    │
│  take photos at bends   │
│       [ 📷 Add Point ]  │
└─────────────────────────┘

Step 3: Photo auto-places on pipe (GPS-based)

┌─────────────────────────┐
│  Edit Route      [Done] │
├─────────────────────────┤
│                         │
│    ● Well               │
│    ┃                    │
│    ◉ ← new point (photo)│
│    ┃   [drag to adjust] │
│    ┃                    │
│    ▢ Tank               │
│                         │
├─────────────────────────┤
│  📷 Point added at bend │
│  Drag to fine-tune      │
│       [ 📷 Add Point ]  │
└─────────────────────────┘

Step 4: Multiple points define accurate route

┌─────────────────────────┐
│  Edit Route      [Done] │
├─────────────────────────┤
│                         │
│    ● Well               │
│    ┃                    │
│    ◉ photo (bend)       │
│     ╲                   │
│      ◯ waypoint (no pic)│
│       ╲                 │
│        ◉ photo (marker) │
│         ┃               │
│    ▢ Tank               │
│                         │
├─────────────────────────┤
│  3 points • 2 with 📷   │
│  [+ Waypoint] [📷 Photo]│
└─────────────────────────┘

Step 5: Route saved with accurate path

┌─────────────────────────┐
│  Waterworks        [+]  │
├─────────────────────────┤
│                         │
│    ● Well               │
│     ╲                   │
│      ◉ bend             │
│       ╲                 │
│        ◯                │
│         ╲               │
│          ◉ marker       │
│           │             │
│    ▢ Tank               │
├─────────────────────────┤
│  ✓ Route updated        │
│  ● Online               │
└─────────────────────────┘

Steps

1. Tap existing pipe - Select the pipe to refine
2. Tap Edit Route - Enter route editing mode
3. Walk the pipe path - Physically walk where the pipe runs
4. Take photos at key points - Bends, buried markers, access points
5. Photos auto-place via GPS - Point appears on pipe near your location
6. Drag to fine-tune - Adjust precise position if GPS is off
7. Add waypoints - Tap pipe to add non-photo points for route shape
8. Save - Route updates with accurate path

Photo Points vs Waypoints

Type	Has Photo	Purpose	Icon
Photo Point	Yes	Document bend/marker/access	◉ filled
Waypoint	No	Define route shape only	◯ hollow

Both types can be dragged to adjust position. Photo points also store images for future reference (buried pipe markers, above-ground indicators).

Happy Path

Technician selects pipe → walks along buried route → takes photo at each bend → points auto-place from GPS → taps Done → pipe now shows actual underground path. Zero manual coordinate entry.

Implementation Status

🔜 Planned for M3: Pipes & Connections - This story will be implemented alongside Draw Pipe.

Related Features

• Map Visualization — View accurate pipe routes on the map
• Camera-First Capture — How GPS location is captured from photos
• Draw Pipe — Initial pipe connection workflow