Completing trouble spots

Platform: Mobile and portal

Completing a trouble spot is how you tell Archer (and the rest of your team) that the issue has been dealt with. In the field you'll usually do this on mobile; back in the office you can clear out spots in bulk from the portal.

The typical mobile workflow is:

1. Open the mobile app on the Maps tab.
2. Find the spot on the map and tap its marker.
3. Walk or drive to it and deal with the issue.
4. Hold to complete on the spot's detail card.

Completing can't be undone. That's why mobile uses a press-and-hold gesture and the portal asks you to confirm — both guard against marking a spot done by accident.

Before you start

• You're signed in to the mobile app and in the right management group.
• You have the tools/materials you need to actually resolve the spots you're working on.
• GPS is healthy so you can navigate accurately.

Finding spots to work on

The map is the main way to find spots in the field:

1. On the Maps tab, look for the trouble spot markers. Each marker carries the category shape and the type's short code. Zoomed out, nearby spots collapse into numbered cluster circles — zoom in and they separate again.
2. Tap a marker to open its detail card.
3. Use the row and distance shown on the card to walk to the exact spot (see Navigating to a spot below).

If there are a lot of spots and you only want to work one issue at a time, group similar work into a work order from the portal first, then work it from the Work tab — see Completing spots from a work order.

Navigating to a spot

Tapping a marker opens its detail card at the bottom of the map. The card opens folded, showing just what you need to act:

• The type and row as the two big facts at the top — in a tight-rowed vineyard the row is often the fastest way to find a spot, since GPS can be ambiguous between adjacent rows.
• The vineyard › block and the distance from your current position on one line underneath (for example, "Willowbank East › A · 120m away", or "1.4km away").
• The completion control — Hold to complete, or the step buttons for a spot with a resolution process.
• A summary line at the bottom — "2 photos · 1 note", "2 done · 1 to come", or just More.

Tap the summary line to unfold the card. That reveals who reported it and when, any photos and notes, the full step checklist, and the Edit button.

Use the row and distance to walk to the spot.

Leaving a note or photo first

If you want to record what you found before clearing a spot — for example, what you treated, or that it turned out to be a false alarm — add it before completing:

1. On the detail card, tap the summary line to unfold it, then tap Edit.
2. Add a note, tap Add photo to attach a photo, or both.
3. Tap Save. The app confirms with "Trouble spot updated: note saved" (or "moved to row 14, note saved" if you changed the row).
4. Then Hold to complete as below.

Spots that haven't synced yet can't be edited or completed. A spot reported on mobile that's still uploading shows a Saved locally badge; both Edit and Hold to complete appear once it has synced. (Very old spots imported from before the current system also have no Edit.)

Marking complete on mobile

Once you've dealt with the issue, press and hold the Hold to complete button on the detail card. Holding (rather than a single tap) is deliberate — completion can't be undone, so the hold guards against accidental completion.

As you hold, a fill sweeps across the button; after half a second it fires and the button changes to a disabled Completing… with a spinner while the change saves. On success the card simply closes — the marker stays on the map only if you have Show completed turned on. The app records the completion time and your name as the person who completed it. Completing from the card needs signal. If it fails (for example no signal at that moment), the button re-arms and a red Could not mark trouble spot complete. message appears so you can retry when you're back in signal.

Spots with a resolution process

If a spot's type carries a resolution process, its detail card shows the process steps instead of a single Hold to complete. Folded, the card shows only the steps you can do now; unfold it for the full Resolution steps checklist:

• Done steps are ticked and struck through, with the first name of who did them.
• Available steps (all prerequisites done) are green hold-to-confirm buttons labelled with the step's name — the same press-and-hold idiom as completing a whole spot.
• Blocked steps show a lock and "needs …" naming the step they're waiting on.

When the work order carries per-step people assignments, a step assigned to someone else renders as an outlined button with an "assigned to …" hint — but assignment never blocks anyone from doing a step. Completing the last step resolves the spot. Step ticks are kept if you're offline and sync automatically when connectivity returns.

Did a step by mistake? A done step has an Undo button when it's yours (or you supervise the job) and nothing later depends on it; the app asks "Undo "Drive new post"?" before it reverts. The portal can untick steps as well.

Where completed spots go

A completed spot drops off the pending view. You can still find it again:

• On the mobile map: completed spots are hidden by default. Open the Layers sheet (the Layers button in the map title bar), tap the Trouble spots row, and turn on Show completed. Completed spots then draw exactly like pending ones — same shape, colour and short code — so check the card if you're not sure.
• In the portal: the Spots lens on the Maps page has its own Show completed switch.

Completing in the portal

If you'd rather clear spots in bulk from a computer, use the portal's Maps page and switch to the Spots lens (the old Trouble Spots page now lands here). The side panel lists the pending spots for the vineyard in view.

1. Tap Select all at the top of the list (or tick the spots you want), then Mark complete.
2. Confirm at the prompt — Mark N trouble spots complete? — and the portal completes them and takes them off the pending list.

Clicking a spot in the list (rather than ticking it) opens its side card — vineyard, block, row, reporter, notes — without completing it, and the card has its own Mark complete action (or the step checklist, for process spots). See Viewing trouble spots.

Deleting a spot (portal)

Deleting is different from completing: it removes the spot entirely rather than recording it as resolved. Use it for spots that were reported in error.

1. On the Spots lens, open the spot's side card.
2. Click Delete (Managers and Admins only) and confirm at the Delete trouble spot? prompt.

Tips

• Use row numbers, not just GPS, to locate spots. In a tight-rowed vineyard, GPS alone can put you one row off. Trust the row number the card shows you.
• If the spot is gone or was a false alarm, it's still better to complete it than to leave it pending. Add a note via Edit explaining what you found, then Hold to complete.
• In a Spot Search session the card hides step checklists and Edit — searching is finding, not fixing. Leave the search to resolve a spot.

Completing spots from a work order

If someone has grouped a batch of spots into one job — for example, "all the broken posts in Block 4" — that's a Spot Fix work order, and you'll see it on the Work tab (the bottom navigation is List · Maps · Work). Tapping the work order's card starts (or resumes) the work session and takes you straight to the map, with the order's spots emphasised and everything else dimmed; the ⓘ button on the card opens the details without starting work.

In the session, the pull-up sheet's row grid gets you to each spot, and each one is completed on its own detail card exactly as above — Hold to complete, or its step checklist for process spots — and the work order completes itself when the last spot is resolved. See Working a work order for the full field-side flow.