Working with issues

Once an issue exists, the work is keeping it accurate and moving it along. The panel on the right has three views: Details for the selected issue, Conversation for its discussion, and All issues for the whole register.

The Details view

Selecting a pin, or opening an issue from the list, shows the full record:

• The photo, with the current status shown on it. Click it to view it at full size, including the original upload rather than the reduced copy.
• Name, Nearest Address, Issue type, Status, Recorded on site and Description, all editable if your role allows it.
• Ownership — who logged the issue, who is responsible for it now, and any offer waiting to be answered.
• Location, which can be expanded for the coordinates read from the photo in WGS84 and NZTM, the ground elevation where available, and Street View.

Edits are not saved as you type. Change what you need and use Save issue; the button stays inactive until something has actually changed, and an Unsaved changes note appears while a change is still pending. Changes to the name appear on the map label immediately so you can see what you are affecting.

If your role cannot edit issues, the fields are shown but locked, and a note at the top of the panel says so rather than letting you type into something that will be refused when you save.

Every saved change is recorded in the audit trail with your user and a timestamp.

Statuses

The distinction between Resolved and Closed is worth keeping. Resolved is the contractor's or field team's view that the job is done; Closed is the acknowledgement that it has been checked and accepted. Collapsing the two loses the inspection step, which is usually the one people later ask about.

When you change a status, add a note saying why. A status that changes with no explanation is the most common source of confusion on a shared register.

Changing the issue type

Issue types can be corrected at any time. Recategorising is normal — plenty of issues are recorded as Unclassified in the field and sorted out later, and some turn out to be a different category once someone has looked properly. The list of types is on the Creating an issue page.

The conversation

The Conversation view is the issue's history and its discussion in one place. It starts with the photo upload and grows as people post. Each message shows when it was added, who added it and which organisation they are from. Status changes and other recorded activity appear in the same stream, so the record reads in order.

To start a thread, write in the box at the bottom and post it. Replies sit under the message they answer, so two separate matters on one issue stay separate. Type @ to mention someone — they get a notification. A thread can be marked resolved once it is settled, which keeps it in the record without leaving it looking open.

Messages can be up to 8,000 characters, so there is room to be specific. You can edit or remove your own messages; an edited message is marked as edited and a removed one leaves a placeholder, because the surrounding replies still have to make sense.

Nothing is silently overwritten. If you need to correct something you wrote earlier, replying to correct it is usually better than editing — that way the record shows both what was thought at the time and what was established later.

Good messages tend to answer one of these:

• What did you find when you looked?
• What did you do, and when?
• What is blocking the next step, and who is it waiting on?

Ownership

Every issue has the person who logged it, which never changes, and an owner, who is the person responsible for resolving it now.

Ownership moves by offer, not by assignment. Assign to… offers the issue to someone with a short message; nothing changes until they accept. They can accept or decline, and whoever made the offer can withdraw it. An unanswered offer expires. All of it is kept under Ownership history, so who was responsible at any point stays answerable later.

Offers, replies and mentions all raise a notification, shown on the bell in the header. Selecting one takes you straight to the issue it is about.

The All issues list

The All issues view lists every issue in the project, with a count in the tab label. For each issue it shows a thumbnail, the status, the issue type, the nearest address, the date recorded on site, who logged it, the current owner, and when it was last active.

The list can be narrowed:

• The search box filters on name, address, issue type, status and person.
• The status chips filter by status, and each carries a count and the same colour the pin uses on the map. Choose more than one to combine them.
• The type and sort menus filter by issue type and reorder by recent activity, newest first, or name.

Two actions are available on each entry:

• Go to on map moves the map to the issue without changing what the panel is showing — useful for checking where something is while you work through the list.
• Open opens the full issue record.

Searching for an address

The address search in the header takes a street address, suggests matches as you type, and moves the map to the address you choose, marking the point. Use it when somebody reports a problem by address rather than by issue number: search the address, then look at what pins are already nearby before creating a duplicate.

The search finds addresses. It does not search issue names or descriptions — for that, use the search in the timeline view.