docs: DefectDojo Pro Customizable Dashboards (dashboard_v2) (#15111)

* docs: add DefectDojo Pro Customizable Dashboards (dashboard_v2)

Document the new Pro customizable dashboards (layouts + widget catalog,
beta behind the dashboard_v2 feature flag): concepts + UI walkthrough,
the /api/v2/dashboards/ REST API with a full lifecycle script, and a
paste-in LLM prompt. Rework the dashboards index for OSS-vs-Pro, point
the OSS Main Dashboard page's Pro section at the new docs, remove the
obsolete custom-tiles page, and repoint inbound links to it.

Authored by T. Walker - DefectDojo

* docs: refine Pro dashboards nav, beta enablement language, and section ordering

Authored by T. Walker - DefectDojo

* docs: dark-mode dashboard screenshots, hero image, focus boxes, and LLM prompt copy button

Authored by T. Walker - DefectDojo

* docs: point Metrics & Reports nav at OSS Main Dashboard page

The top-nav Metrics & Reports link targeted the dashboards section
index (_index.md) — a chapter landing rendered without the left side
menu. Restore it to the introduction_dashboard leaf page so the nav
lands on a page with the full sidebar and version selector, consistent
with every other top-nav item.

Authored by T. Walker - DefectDojo

Author: skywalke34

docs/assets/images/pro_dashboard_v2_add_widget.png

@@ -21,7 +21,7 @@ You can use SLAs as a way to represent your organizations remediation policies.
 * You can sort or filter Finding tables by SLA days.
 * SLA violations can be configured to trigger [Notifications](/admin/notifications/about_notifications/) to DefectDojo users assigned to the related Product.
 * In **DefectDojo Pro**, SLA performance is also tracked on the [Executive Insights and Remediation](/metrics_reports/pro_metrics/pro__overview/) Metrics Dashboards.
-* SLA compliance can also be used to create custom [Dashboard Tiles](/metrics_reports/dashboards/about_custom_dashboard_tiles/#sla-violation-tile) in **DefectDojo Pro**.
+* SLA compliance can also be surfaced on a custom [dashboard](/metrics_reports/dashboards/custom-dashboards/) in **DefectDojo Pro** — for example with an SLA Burndown or a filtered Count widget.
 
 ### Mitigated Within SLA status
 

docs/assets/images/pro_dashboard_v2_default.png

@@ -218,7 +218,7 @@ You can use SLAs as a way to represent your organizations remediation policies.
 * You can sort or filter Finding tables by SLA days.
 * SLA violations can be configured to trigger [Notifications](/admin/notifications/about_notifications/) to DefectDojo users assigned to the related Product.
 * In **DefectDojo Pro**, SLA performance is also tracked on the [Executive Insights and Remediation](/metrics_reports/pro_metrics/pro__overview/) Metrics Dashboards.
-* SLA compliance can also be used to create custom [Dashboard Tiles](/metrics_reports/dashboards/about_custom_dashboard_tiles/#sla-violation-tile) in **DefectDojo Pro**.
+* SLA compliance can also be surfaced on a custom [dashboard](/metrics_reports/dashboards/custom-dashboards/) in **DefectDojo Pro** — for example with an SLA Burndown or a filtered Count widget.
 
 ### Mitigated Within SLA status
 

docs/assets/images/pro_dashboard_v2_edit_grid.png

@@ -2,6 +2,7 @@
 title: "DefectDojo Main Dashboard"
 description: "Working with the front page of DefectDojo"
 weight: 1
+audience: opensource
 aliases:
   - /en/customize_dojo/dashboards/Introduction_dashboard
   - /en/customize_dojo/dashboards/pro_dashboards
@@ -15,7 +16,7 @@ The Dashboard is likely the first page you'll see when you open DefectDojo. It s
 </div>
 <div class="version-pro">
 
-![image](images/Introduction_to_Dashboard_Features.png)
+> **💡 DefectDojo Pro:** In DefectDojo Pro, the home page is a fully **customizable dashboard** — you build it from widgets and arrange them yourself, rather than using the fixed layout described below. See **[Customizable Dashboards](../custom-dashboards/)** for the concepts and a UI walkthrough. The rest of this page describes the open-source Main Dashboard.
 
 </div>
 
@@ -55,92 +56,3 @@ Superusers can toggle which charts appear on the dashboard. Navigate to the gear
 Select **Reset Dashboard Configuration** from the same menu to restore defaults.
 
 </div>
-<div class="version-pro">
-
-## Dashboard Components
-
-* **Customizable Dashboard Tiles**, which you can use to visualize the metrics which are relevant to you.
-* **Pre\-built Dashboard Charts**, which visualize your team’s overall performance.
-
-Each team member shares a single dashboard, but the results of the dashboard are restricted by their role and Product Membership. Team members will only see calculated stats for the Products, Engagements, Findings or other objects that they have access to. For more information, see our guides on [User Permissions and Roles](/admin/user_management/about_perms_and_roles).
-
-### Dashboard Tiles
-
-Tiles are designed to provide relevant information and speed up navigation within DefectDojo.
-
-![image](images/Introduction_to_Dashboard_Features_2.png)
-
-Tiles can:
-
-* Act as shortcuts for particular sets of Findings, Products, or other objects
-* Visualize metrics related to your Product
-* Provide alerts on particular activity, track SLA Violations, failing imports or new Critical Findings
-
-Tiles are pinned to the top section of your **🏠 Home** page.
-
-To learn how to add and use dashboard tiles, see our [guide](/metrics_reports/dashboards/about_custom_dashboard_tiles).
-
-### Dashboard Charts
-
-Located beneath Dashboard Tiles, DefectDojo has five pre\-built charts:
-
-* **Historical Finding Severity** pie\-chart
-* **Reported Finding Severity** histogram, by month
-* **Unassigned Answered Engagement Questionnaires** table
-* **Top 10 Graded Products** table
-* **Bottom 10 Graded Products** table
-
-These charts can be added or removed from the dashboard via **Dashboard Configuration**.
-
-#### Historical Finding Severity
-
-This chart organizes all Findings created in DefectDojo by Severity, so that you can see the overall distribution of vulnerability levels in your environment.
-
-![image](images/Introduction_to_Dashboard_Features_3.png)
-
-#### Reported Finding Severity
-
-This chart allows you to monitor the volume and severity distribution of incoming Findings per month.
-
-![image](images/Introduction_to_Dashboard_Features_4.png)
-
-#### Unassigned Answered Engagement Questionnaires
-
-If you have completed Engagement Questionnaires for review, those will be listed in this table.
-
-![image](images/Introduction_to_Dashboard_Features_5.png)
-
-#### Top 10 / Bottom 10 Graded Products
-
-This section summarizes the Graded performance of each Product in your instance, counting the Highest and Lowest scoring Products.
-
-![image](images/Introduction_to_Dashboard_Features_6.png)
-
-Finding Counts of each severity are calculated by the tile, but note that Product Grade is only assigned based on Active Findings, so there may be Inactive Findings counted in this table which do not contribute to the Grade.
-
-To understand how grades are calculated, see our guide to **[Product Health Grading](/asset_modelling/pro_hierarchy/product_health_grade/)**.
-
-## Dashboard Configuration
-
-Superusers can choose which Metrics Charts are displayed on the Dashboard. To do this, select the **Edit Dashboard Configuration** option from the top\-right hand gear menu.
-
-![image](images/How-To_Edit_Dashboard_Configuration.png)
-This will open the **Dashboard Configuration Settings** window.
-
-### Configuration Settings
-
-![image](images/How-To_Edit_Dashboard_Configuration_2.png)
-
-* **Display Graphs** determines whether or not the **Historical Finding Severity** and **Reported Finding Severity** charts are visible.
-* **Display Surveys determines whether or not the Unassigned Answered Engagement Questionnaires table is visible.**
-* **Display Data Tables determines whether or not the Top 10 / Bottom 10 Graded Products tables are visible.**
-
-### Reset Dashboard Configuration
-
-If you would like to reset your Dashboard to a default state, you can do so by selecting **Reset Dashboard Configuration** from the top\-right hand gear menu.
-
-![image](images/How-To_Edit_Dashboard_Configuration_3.png)
-
-**Note that this will remove any Custom Dashboard Tiles which have been added to your instance.**
-
-</div>