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 (the home screen), look for the trouble spot markers. Each marker carries the category shape and the type's short code.
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).

📷 Screenshot: Maps tab with several trouble spot markers; one tapped to reveal its detail card.

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 on the Work Orders 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 shows:

• 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 as a smaller line underneath.
• Who reported it, the distance from your current position (for example, "120m away" or "1.4km away"), and the report date.
• Any photos and notes attached to the spot.

📷 Screenshot: Trouble spot detail card showing type and row, vineyard/block, reporter, distance, and a "Hold to complete" 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 Edit.
2. Add a note, tap Add photo to attach a photo, or both.
3. Tap Save.
4. Then Hold to complete as below.

📷 Screenshot: Edit trouble spot sheet with the note field and Add photo button.

Edit isn't available for spots that haven't synced yet. A spot reported on mobile that's still uploading shows a Saved locally badge, and the Edit button is hidden until it has synced. You can still complete it once it's synced.

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.

While the hold finishes and the change saves, the button shows a Completing… spinner. On success you'll see a green Trouble spot marked as complete confirmation, and the spot's card closes. The app records the completion time and your name as the person who completed it.

📷 Screenshot: Detail card with the "Hold to complete" button.

📷 Screenshot: Button mid-hold showing the "Completing…" state.

📷 Screenshot: Green "Trouble spot marked as complete" confirmation.

Where completed spots go

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

• Block view: when you open a block's trouble spots, switch the segmented control from Pending to History to see completed spots, with time-range chips (for example, today / this week) to narrow the list.
• Maps view: completed spots are hidden on the field map by default. Turn on Show completed in the map's filter sheet to bring them back onto the map.

📷 Screenshot: Block trouble spots view with the Pending / History segmented control set to History.

Completing in the portal

If you'd rather clear spots in bulk from a computer, use the portal. Open Trouble Spots (the /trouble-spots page). Pending spots are listed in the Pending Trouble Spots grid.

1. Tick the checkbox on each pending row you want to clear.
2. Click Approve Selected.
3. Confirm at the prompt: "Mark selected trouble spots as complete? This cannot be undone."
4. The portal reports Completed N trouble spot(s). and the rows move into the Completed Trouble Spots grid.

📷 Screenshot: Portal Pending Trouble Spots grid with several rows selected and the "Approve Selected" button.

Clicking a row (rather than its checkbox) opens the spot's details — vineyard, block, row, reporter, photos, and notes — without completing it.

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. In the Pending Trouble Spots grid, click the delete control on the spot's row.
2. Confirm at the Delete trouble spot prompt: "Are you sure you want to delete this trouble spot? This action cannot be undone."
3. Click Delete. The portal confirms with Deleted.

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.

Completing spots from a work order

If someone has grouped a batch of spots into a work order — for example, "all today's powdery mildew in Block 4" — you'll see that work order on the Work Orders tab. Opening it and tapping a spot takes you to the field map in a focus session: the work order's spots are emphasised and everything else is dimmed. The completion flow for each individual spot is the same as above (walk up, resolve, Hold to complete), and the work order's progress updates as you go. See Working a work order for the full field-side flow.