feat: add the custom dashboard guide

Signed-off-by: Nicolas Crocfer <[email protected]>

Author: ncrocfer

docs/guides/custom_dashboards.md

@@ -0,0 +1,62 @@
+# Custom Dashboards
+
+Custom dashboards allow users to create a personalized homepage populated with dynamic widgets.
+
+Widgets can be freely positioned, resized, and configured.
+
+## Why Use Custom Dashboards?
+
+Custom dashboards allow CISOs and security analysts to build a monitoring environment perfectly tailored to their needs.
+
+By combining dynamic widgets, you can:
+
+- **Prioritize** vulnerabilities that matter most to your organization, such as CVEs with a high CVSS score or impacting critical assets.
+- **Track** the progress of vulnerability management workflows using custom tags (e.g., `to-check`, `in-progress`, `validated`).
+- **Monitor** project-specific risks by isolating CVEs related to a given customer, department, or application.
+- **Centralize** key information (latest CVE activity, project status, reports) into a single, always up-to-date workspace.
+
+This approach improves visibility, collaboration, and reaction speed, making it easier to focus on what truly matters in your vulnerability management process.
+
+![Custom Dashboards](../images/guides/custom_dashboards/draggable-widgets.png){.center style="width:100%"}
+
+## Available Widgets
+
+- **CVEs Activity**: Displays the most recent CVE changes across all projects.
+- **CVEs by Project**: Displays CVEs associated with a selected project.
+- **CVEs by View**: Displays CVEs associated with a selected saved view.
+- **Last Reports**: Displays the latest CVE reports generated for your projects.
+- **Projects**: Displays the list of all projects within your organization.
+- **Tags**: Shows the list of tags you created to categorize CVEs.
+- **Views**: Lists your private views and your organization's public views.
+
+![New Widget](../images/guides/custom_dashboards/new-widget.png){.center style="width:100%"}
+
+## Create a Dashboard
+
+Each user can create their own dashboard layout:
+
+- Go to your organization's dashboard page.
+- Click on the **+** button:
+
+![Add Save Buttons](../images/guides/custom_dashboards/add-save-buttons.png){.center style="width:60%"}
+
+- Select a widget type and configure it:
+
+![Configure Widget](../images/guides/custom_dashboards/configure-widget.png){.center style="width:100%"}
+
+- Position and resize the widget as needed.
+- Save your layout once your dashboard is configured.
+
+## Using Views in Dashboard
+
+You can create [Views](views.md) based on **advanced queries** to filter CVEs based on specific criteria (CVSS scores, vendors, products, tags, etc.).
+
+Example query:
+
+```
+userTags:tocheck AND cvss31>=9 AND vendor:apache
+```
+
+This view can then be added as a widget to your dashboard with the **CVEs by View** widget.
+
+![Configure Widget](../images/guides/custom_dashboards/cves-by-view-widget.png){.center style="width:100%"}

docs/guides/views.md

@@ -26,3 +26,11 @@ Save it, and your query is now available for quick access using the **Load** but
 ![Load Query](../images/guides/views/load-query.png){.center style="width:100%"}
 
 All your saved Views can be managed from the **Views section**. Simply click on a View to apply its query instantly or edit/delete it when needed.
+
+## Using Views in Dashboard
+
+Once you have created and saved a view, you can integrate it directly into your custom dashboard using the **CVEs by View** widget:
+
+![CVEs by view Widget](../images/guides/views/cves-by-view-widget.png){.center style="width:80%"}
+
+This allows you to monitor the CVEs matching your saved query without having to manually re-run searches.

docs/images/guides/custom_dashboards/add-save-buttons.png

@@ -28,6 +28,7 @@ nav:
       - Notifications: 'notifications.md'
   - Guides:
       - Advanced Search: 'guides/advanced_search.md'
+      - Custom Dashboards: 'guides/custom_dashboards.md'
       - Views: 'guides/views.md'
       - Social Authentication: 'guides/social_auth.md'
       - Migrate OpenCVE v1 data: 'guides/migrate_opencve_v1.md'