Tutorial: Raising and Resolving Issues

Open the Pasco Cloud web app and click Issues in the sidebar. You will see the issues list — if this is your first issue, the list will be empty.

Click the Create Issue button to open the creation modal.

Fill in the following fields:

• Title — enter "Cracked concrete in basement level 2" (or any descriptive title for your test issue).
• Category — select Structural from the dropdown.
• Priority — select High.
• Project — choose your project from the dropdown.
• Assignee — select a team member who will be responsible for the fix.
• Due date — set a date one week from now.

In the Location section of the creation modal:

• Location description — type "Basement level 2, column B3, south face".
• GPS location — click the map picker and drop a pin at the approximate location. On mobile, you can tap Current Location to use your device's GPS coordinates.

The GPS location will appear on the issue's map view and on the detail page as an inline map.

In the Attachments section:

1. Click the upload area and select your defect photo (or drag and drop it).
2. Once uploaded, click the Annotate button on the image thumbnail.
3. The annotation editor opens. Draw a red arrow pointing to the crack.
4. Add a text label that reads "50mm structural crack — requires assessment".
5. Save the annotation.

You now have both the original photo and the annotated version attached to the issue.

Review your issue details and click Create.

The issue is created with Raised status. Your assigned team member receives a notification alerting them to the new issue.

When the assignee logs in, they see a notification about the new issue. Clicking the notification takes them directly to the issue detail page, where they can see:

• The issue title, description, and priority.
• The annotated photo showing exactly where the crack is.
• The location card with an inline map showing the GPS pin.
• The due date.

The assignee can now visit the site, locate the exact spot using the GPS pin and location description, and assess the defect.

The assignee clicks the Open status action button to indicate they are now actively working on the issue. The status changes from Raised to Open.

This status change is recorded in the audit trail, and the creator and close-out manager are notified.

After completing the repair work, the assignee adds a comment documenting what was done:

1. Scroll to the Comments section on the issue detail page.
2. Type a comment: "Crack repaired with epoxy injection. Structural engineer has inspected and approved the repair method."
3. Attach a photo of the completed repair using the comment attachment button.
4. Click Post.

The comment with the repair photo now appears in the issue timeline.

The assignee clicks the Resolve status action button. The status changes from Open to Resolved.

The close-out manager (you, the creator) receives a notification that the issue has been resolved and is ready for verification.

Open the issue detail page. You can see:

• The assignee's comment with the repair photo.
• The audit trail showing every status change with timestamps.
• The original defect photo for comparison.

If the fix is satisfactory, click the Close status action button. The issue status changes to Closed, and the issue is complete.

If the fix is not adequate, click Reopen to send the issue back to Open status. Add a comment explaining what still needs to be done.

Scroll through the issue detail page to see the complete audit trail:

1. Issue created — with your name and timestamp.
2. Status changed to Open — by the assignee, with timestamp.
3. Comment posted — the assignee's resolution note with repair photo.
4. Status changed to Resolved — by the assignee.
5. Status changed to Closed — by you (the close-out manager).

This creates a complete, timestamped record of the issue from identification through to verified resolution.

1. Open a report in the builder that uses a template with flag logic configured (for example, a Pass/Fail inspection checklist).
2. Select Fail on an inspection item.
3. If the template has "Raise Issue" enabled on that field, you will see a Raise Issue button appear.
4. Click it to open a quick issue creation modal. The title is pre-filled from the field label (for example, "Roof framing alignment — Fail").
5. Set the priority, assignee, and any other details, then create the issue.

The issue is now linked to the report — you can navigate from the issue to the source report, and from the report to the linked issue. This creates a direct chain of evidence from the inspection to the corrective action.