Managing Issues

Once you understand what issues are, you need to know how to work with them day to day — creating new issues, tracking their progress, updating details, and using filters to find what you need. This page covers the practical side of issue management in Pasco Cloud.

Creating an Issue

To create a new issue:

1. Navigate to Issues in the sidebar.
2. Click Create Issue to open the creation modal.
3. Fill in the required fields:
   • Title — a clear, concise description of the problem (up to 300 characters).
   • Category — select from the ten available categories (safety, quality, environmental, etc.).
   • Priority — choose low, medium, high, or critical. Defaults to medium.
4. Optionally fill in:
   • Description — a longer explanation with context (up to 5,000 characters).
   • Project — the project this issue relates to.
   • Organisation — the organisation context.
   • Assignee — the person responsible for resolving the issue.
   • Close-out manager — the person who will verify the fix. Defaults to you (the creator) if left blank.
   • Due date — when the issue should be resolved by.
   • Location description — a text description of where the issue is (for example, "Level 3, north-east stairwell").
   • GPS location — set a precise location using the map picker, or tap "Current Location" on mobile.
5. Configure sharing — choose which groups or users can see this issue, or mark it as public.
6. Click Create to save the issue.

The new issue is created with Raised status. If you assigned someone, they receive a notification.

Issue Detail Page

Click any issue in the list to open its detail page. The detail page shows:

• Status badge with the current status and colour coding.
• Priority and category badges.
• Assignee and close-out manager with avatar and name.
• Project and organisation context (if set).
• Due date with overdue highlighting.
• Location card — if the issue has a GPS location, an inline map shows the pin. The location description appears alongside it.
• Linked report — if the issue was created from a flagged report response, a link to the source report and the specific field is shown.
• Attachments — photos and files attached to the issue.
• Comments — the discussion thread with the audit trail.
• Sharing — the groups and users who have access.

Status Transitions

The issue lifecycle follows a defined path. Each transition has specific rules about who can perform it:

⚠️ Watch out!

Only the close-out manager can close an issue. This is by design — the close-out manager verifies that the resolution meets the required standard before signing off. If the fix is not adequate, the close-out manager can send the issue back to open status.

To change an issue's status, open the issue detail page and click the status action button. The available transitions depend on the current status and your role.

Editing an Issue

You can update most fields on an existing issue:

• Title and description — click to edit inline or use the edit modal.
• Priority and category — change as the situation evolves. Escalating priority is common as deadlines approach.
• Assignee — reassign to a different person if responsibilities change.
• Close-out manager — project admins can reassign the close-out manager if needed.
• Due date — extend or bring forward as required.
• Location — update the GPS pin or location description.

Every edit is recorded in the audit trail, so there is a complete history of what changed and who changed it.

Filtering and Searching

The issues list page provides powerful filtering to help you find specific issues:

• Status — filter by one or more statuses (raised, open, resolved, closed). The API supports comma-separated status queries, so the dashboard can show "raised,open" issues together.
• Priority — filter by priority level.
• Category — filter by issue category.
• Assignee — find all issues assigned to a specific person.
• Project — filter by project.
• Date range — filter by creation date or due date.
• Search — free-text search across issue titles.

Combine multiple filters to narrow down your results. For example, "show me all critical safety issues assigned to me that are still open."

💡 Tip

Use priority levels consistently. Agree on definitions as a team — for example, "critical" means work must stop until the issue is resolved, "high" means it must be resolved this week. Consistent priorities make filtering meaningful.

Map View

Toggle between list and map view using the view switcher at the top of the Issues page. The map view shows all issues that have a GPS location as pins on an interactive map.

Pin Colours

Pins are coloured by priority:

• Red — critical
• Orange — high
• Amber — medium
• Green — low

Clusters

When many issues are close together, the map groups them into clusters showing a count. Zoom in to see individual pins. Click a pin to see the issue title and a link to the detail page.

GPS Location

You can set a GPS location when creating or editing an issue:

• Web — use the map picker to drop a pin at the correct location.
• Mobile — tap "Current Location" to use your device's GPS, or use the map picker to set a different location.

The location is shown on the issue detail page as an inline map with the pin.

Notifications

Pasco Cloud sends notifications for key issue events:

• Issue created — the assignee is notified when a new issue is assigned to them.
• Issue assigned — the new assignee is notified when an issue is reassigned.
• Status changed — the creator, assignee, and close-out manager are all notified when the status changes. Notifications are de-duplicated, so you only receive one notification even if you hold multiple roles.
• Issue shared — you are notified when an issue is shared with you or your group.

Comment notifications are in-app only (no email) to avoid notification fatigue from active discussion threads.

What's Next?

• Want to understand comments and the audit trail? See Comments & Audit Trail.
• Need to attach photos? Learn about Attachments.
• First time? Follow the Tutorial: Raising and Resolving Issues.
• Looking for task management? See the Tasks Overview.