Report Sections
| Section | Title | Content |
|---|
| 1 | Report Header | Title, project name, report date |
| 2 | Pre-Mitigation Risk Distribution Matrix | 5x5 matrix of initial risk levels |
| 3 | Post-Mitigation Risk Distribution Matrix | 5x5 matrix of residual risk levels |
Pre-Mitigation Risk Distribution Matrix
The pre-mitigation matrix plots combined probability (P) against harm severity (S) for the initial risk assessment before any risk controls are applied.
Input fields:
| Field | Source |
|---|
preHazardProbability | P1 — probability of hazardous situation (1-5) |
preHarmProbability | P2 — probability of harm occurring (1-5) |
Harm severity | Resolved from linked harm work item (1-5) |
P1 x P2 Bucket Mapping
Combined probability is calculated by multiplying P1 and P2, then mapping to 5 buckets:
| P1 x P2 Product | Probability Bucket |
|---|
| 1-3 | 1 (Very Low) |
| 4-8 | 2 (Low) |
| 9-15 | 3 (Medium) |
| 16-20 | 4 (High) |
| 21-25 | 5 (Very High) |
Risk Level Classification
Each cell in the matrix is classified using a decision matrix:
Color coding:
| Color | Classification | Meaning |
|---|
| Green (#4CAF50) | Acceptable | Risk is within acceptable limits |
| Orange (#FF9800) | Investigation | Risk requires investigation per ISO 14971 |
| Red (#F44336) | Unacceptable | Risk must be reduced before release |
Post-Mitigation Risk Distribution Matrix
The post-mitigation matrix uses the same 5x5 structure with residual risk fields:
| Field | Source |
|---|
postHazardProbability | P1 — post-control hazard probability (1-5) |
postHarmProbability | P2 — post-control harm probability (1-5) |
Harm severity | Same linked harm severity (unchanged by controls) |
The post-mitigation matrix is hidden when all risk records lack post-mitigation data (postPending == totalCount). This prevents showing an empty matrix when controls have not yet been evaluated.
Residual Risk Summary
After the post-mitigation matrix, the report displays:
- Counts of acceptable, investigation, and unacceptable residual risks
- Conditional alert boxes based on the residual risk profile:
| Alert Type | Condition | Message |
|---|
| Danger box | Unacceptable risks remain | References ISO 14971 Clause 7.4 for benefit-risk analysis |
| Warning box | Investigation risks remain | Risk requires further evaluation |
| Success box | All risks acceptable | All risks within acceptable limits |
Harm Severity Resolution
Severity is resolved for each risk record by traversing linked work items:
- Get linked work items via
linkedWorkItems().direct()
- Find the first linked item of type
harm
- Extract its
severity enum value (1-5 scale)
Interactive Features
Matrix cells include hover effects:
- Opacity change on hover for visual feedback
- Box-shadow for interactive feel
- HTML title attributes showing P value, severity ID, and item count as tooltips
Technical Details
| Property | Value |
|---|
| Page location | .polarion/pages/spaces/_default/Hara Risk Matrix Report/page.xml |
| Template type | Velocity script |
| Sidebar shortcut | wiki/Hara Risk Matrix Report |
| CSS scope | .risk-matrix-report-container |
| Print support | page-break-inside:avoid on sections |
| Risk thresholds | Hardcoded in Velocity logic (not configurable) |
Related Pages