Incidents

The Incidents page is a single register for anything that went wrong: security incidents, health and safety (HSE) incidents, quality incidents, and environmental incidents. Each incident gets an automatic number, a severity, and a lifecycle from first report through investigation and containment to closure. Serious incidents can be escalated into a CAPA with one click.

Before you start

Report an incident

  1. Open Incidents in the side nav and click Report Incident.
  2. Fill in the dialog:
    • Title (required): what happened, in one line.
    • Description: what happened, who was involved, and the impact.
    • Category: Security, HSE, Quality, Environmental, or Other. Defaults to Other. Security incidents map to ISO 27001 A.5.24 to A.5.28; HSE incidents map to ISO 45001.
    • Severity: Minor, Moderate, Major, or Critical. Defaults to Moderate.
    • Occurred on: the date the incident happened.
    • Detected on: the date it was noticed. These can differ, for example a security breach found weeks later.
    • Location: site, area, or system.
    • Reported by: the name of the person who reported it.
    • Immediate action taken: the containment or first response already done.
  3. If you pick the HSE category, four extra fields appear:
    • Injury type: for example laceration or sprain.
    • Body part: for example left hand.
    • Lost time (days): whole number of work days lost.
    • Recordable incident: check this if the incident counts as recordable under your reporting rules.
  4. Click Report incident. The incident is saved with status Reported and gets an automatic number in the form INC-0001, INC-0002, and so on, sequential per organization.

Read the register

Move an incident through its lifecycle

The lifecycle is: Reported > Investigating > Actions in progress > Closed. Each row shows one forward button for the next step:

  1. On a Reported incident, click Investigate. Status becomes Investigating.
  2. On an Investigating incident, click Actions. Status becomes Actions in progress, and CompStack stamps the containment time on the record.
  3. On an incident with Actions in progress, click Close. Status becomes Closed, and CompStack stamps the closure time.

The containment and closure timestamps together give you the incident timeline: reported, contained, closed. They are stamped once and are not overwritten if you pass through a status again.

Edit an incident

  1. Click the pencil (edit) button on the row.
  2. The same dialog opens with one extra field that only appears when editing: Root cause, the underlying cause found during the investigation.
  3. Change any field and click Save. Switching the category away from HSE clears the injury fields.

Raise a CAPA from an incident

  1. Move the incident past Reported first. The Raise CAPA button appears once the incident is Investigating or later and has no CAPA linked yet.
  2. Click Raise CAPA. CompStack creates a CAPA titled "Incident INC-XXXX: ", copies the incident details and immediate action into the CAPA description, and links it back to the incident.</li> <li>The row now shows a CAPA tag with the CAPA number, and the Raise CAPA button disappears. Manage the corrective action itself from the <a href="20-capa.html">CAPA</a> board.</li> </ol> <h2>Try it</h2> <ul> <li><input disabled="" type="checkbox"> Click Report Incident, enter only a title, and save. Expected: a new row with number INC-0001 (or the next number), status Reported, severity Moderate, category Other.</li> <li><input disabled="" type="checkbox"> Report a second incident with category HSE. Expected: the Injury type, Body part, Lost time (days), and Recordable incident fields appear in the dialog.</li> <li><input disabled="" type="checkbox"> Set Lost time to 3 and save. Expected: the row shows a red "3 lost days" tag.</li> <li><input disabled="" type="checkbox"> Check Recordable incident and save. Expected: the row shows a Recordable tag and the HSE recordable stat increases by one.</li> <li><input disabled="" type="checkbox"> Click Investigate on a Reported incident. Expected: status tag changes to Investigating and a toast confirms the change.</li> <li><input disabled="" type="checkbox"> Click Actions, then Close. Expected: status walks through Actions in progress to Closed, and the Open stat drops by one.</li> <li><input disabled="" type="checkbox"> On an Investigating incident, click Raise CAPA. Expected: a toast names the new CAPA, and the row shows a cyan CAPA tag. The Raise CAPA button is gone.</li> <li><input disabled="" type="checkbox"> Filter Status to Closed. Expected: only closed incidents show, but the stats bar totals do not change.</li> </ul> <h2>If something goes wrong</h2> <ul> <li><strong>Incidents is missing from the side nav</strong>: the Incidents module is turned off. An admin can enable it in Settings > Modules under Health, safety & environment. Visiting <code>/incidents</code> while it is off redirects you to the dashboard.</li> <li><strong>"No incidents reported" empty state</strong>: nothing has been logged yet. Click Report Incident to add the first one.</li> <li><strong>"No incidents match the filters"</strong>: your Status, Category, or Severity filter is excluding everything. Set the filters back to All to see the full register.</li> <li><strong>Raise CAPA is not visible</strong>: the button only appears when the incident is past Reported and has no CAPA linked yet. Click Investigate first, or check for an existing CAPA tag on the row.</li> <li><strong>Injury fields are missing</strong>: they only show when the Category is HSE. Other categories do not carry injury data.</li> <li><strong>Lost time will not accept text</strong>: the field accepts digits only. Enter a whole number of days.</li> <li><strong>Permission errors when saving</strong>: you need a member role in the organization. Ask an admin to check your membership in Settings > Members.</li> </ul> <a class="back-to-app" href="https://app.compstack.io/">← Back to CompStack</a> </main> </div> </body> </html>