Skip to content

docs(pro): report and chart on PAIN ratings - #16985

Merged
blakeaowens merged 2 commits into
devfrom
docs/pain-rating-reports-dashboards
Nov 18, 2026
Merged

blakeaowens merged 2 commits into
devfrom
docs/pain-rating-reports-dashboards

Conversation

@blakeaowens

@blakeaowens blakeaowens commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Description

Documents reporting on FedRAMP Potential Agency Impact (PAIN) ratings in DefectDojo Pro:

  • Report Builder: a Finding table or detail block can show the Potential Agency Impact (PAIN) field (printed N1 to N5; an unrated finding shows - in PDF and HTML, an empty cell in CSV and Excel, null in JSON) and PAIN Evaluated, and order by either. Descending by PAIN lists N5 first; unrated findings come last in both directions.
  • Dashboards: a Graph or Top-N Leaderboard on findings can group by PAIN Rating: the Graph draws N5 to N1, then Unrated, and a bar drills to the findings list filtered to that rating; the Top-N ranks the ratings by count.

Pages changed: federal_compliance/pain_ratings.md (new "Reporting on ratings" section) and metrics_reports/dashboards/PRO__custom_dashboards.md (the PAIN Rating dimension and its order).

This ships with the matching DefectDojo Pro change, so it should merge together with it.

Test results

Docs only: English .md files, no code. Links point at existing pages (/federal_compliance/pain_ratings/).

Documentation

This PR is the documentation.

Checklist

  • Make sure to rebase your PR against the very latest dev.
  • Submit all PRs, features and bug fixes alike, against the dev branch.
  • Give a meaningful name to your PR, as it may end up being used in the release notes.
  • Your code is Ruff compliant (see ruff.toml).
  • Your code is python 3.13 compliant.
  • If this is a new feature and not a bug fix, you've included the proper documentation in the docs at https://github.com/DefectDojo/django-DefectDojo/tree/dev/docs as part of this PR.
  • Model changes must include the necessary migrations in the dojo/db_migrations folder.

🤖 Generated with Claude Code

https://claude.ai/code/session_0143hYTEtVYzmMRXsP4dRsHe

Report Builder finding blocks can show the Potential Agency Impact (PAIN)
rating as a column (N1 to N5, blank when unrated) and PAIN Evaluated, and sort
by either; Dashboards can group a Graph or Top-N Leaderboard by PAIN Rating.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0143hYTEtVYzmMRXsP4dRsHe
@blakeaowens blakeaowens added this to the 3.5.300 milestone Nov 18, 2026
@github-actions github-actions Bot added the docs label Nov 18, 2026
…s ratings

An unrated finding prints `-` in PDF and HTML, an empty cell in CSV and Excel,
and null in JSON. The Graph lists ratings N5 first; the Top-N Leaderboard ranks
them by count.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0143hYTEtVYzmMRXsP4dRsHe
@blakeaowens
blakeaowens added this pull request to the merge queue Nov 18, 2026
Merged via the queue into dev with commit 8529a3c Nov 18, 2026
32 checks passed
@blakeaowens
blakeaowens deleted the docs/pain-rating-reports-dashboards branch November 18, 2026 07:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants