From 4564be24fd7ceebdc8ca673d9e2115de65344c04 Mon Sep 17 00:00:00 2001
From: Ayan Sinha Mahapatra <ayansmahapatra@gmail.com>
Date: Mon, 21 Jul 2025 15:27:38 +0530
Subject: [PATCH] Fix license detections page error and improve UI

Reference: https://github.com/aboutcode-org/scancode.io/issues/1750
Signed-off-by: Ayan Sinha Mahapatra <ayansmahapatra@gmail.com>
---
 scanpipe/filters.py                           |  4 ++
 scanpipe/models.py                            |  1 -
 .../scanpipe/license_detection_list.html      | 16 ++++----
 .../panels/license_clarity_panel.html         |  2 +-
 .../panels/license_detections_summary.html    | 38 ++++++++++++++-----
 .../panels/resource_status_summary.html       |  2 +-
 .../scanpipe/panels/scan_summary_panel.html   |  4 +-
 scanpipe/views.py                             | 19 +++++++---
 8 files changed, 58 insertions(+), 28 deletions(-)

diff --git a/scanpipe/filters.py b/scanpipe/filters.py
index e8d5846eec..1a063d730d 100644
--- a/scanpipe/filters.py
+++ b/scanpipe/filters.py
@@ -840,6 +840,8 @@ class LicenseFilterSet(FilterSetUtilsMixin, django_filters.FilterSet):
         "compliance_alert",
         "license_expression",
         "license_expression_spdx",
+        "is_license_clue",
+        "needs_review",
     ]
 
     search = DiscoveredLicenseSearchFilter(
@@ -853,6 +855,8 @@ class LicenseFilterSet(FilterSetUtilsMixin, django_filters.FilterSet):
             "license_expression",
             "license_expression_spdx",
             "compliance_alert",
+            "is_license_clue",
+            "needs_review",
         ],
     )
     license_expression = django_filters.AllValuesFilter()
diff --git a/scanpipe/models.py b/scanpipe/models.py
index ac28627808..dd3f353c7f 100644
--- a/scanpipe/models.py
+++ b/scanpipe/models.py
@@ -2537,7 +2537,6 @@ class Meta:
     """
 
     license_expression_field = None
-    license_expression_spdx_field = None
 
     class Compliance(models.TextChoices):
         OK = "ok"
diff --git a/scanpipe/templates/scanpipe/license_detection_list.html b/scanpipe/templates/scanpipe/license_detection_list.html
index 6ea52f5196..364e8c98e8 100644
--- a/scanpipe/templates/scanpipe/license_detection_list.html
+++ b/scanpipe/templates/scanpipe/license_detection_list.html
@@ -26,12 +26,12 @@
               <a href="{% url 'license_detail' project.slug license_detection.identifier %}">{{ license_detection.identifier }}</a>
               {% if license_detection.needs_review %}
                 <a href="{% url 'license_detail' project.slug license_detection.identifier %}#detection">
-                  <i class="fa-solid fa-magnifying-glass fa-sm has-text-danger" title="License Detection Issues"></i>
+                  <i class="fa-solid fa-magnifying-glass fa-sm has-text-danger" title="License detection issue: needs review"></i>
                 </a>
               {% endif %}
               {% if license_detection.has_compliance_alert %}
                 <a href="{% url 'license_detail' project.slug license_detection.identifier %}#detection">
-                  <i class="fa-solid fa-scale-balanced fa-sm has-text-danger" title="License Compliance Alerts"></i>
+                  <i class="fa-solid fa-scale-balanced fa-sm has-text-danger" title="License Compliance Alert"></i>
                 </a>
               {% endif %}
             </td>
@@ -50,13 +50,13 @@
             <td>
               {{ license_detection.needs_review }}
             </td>
-            {% if display_compliance_alert %}
-              <td>
-                <a href="?compliance_alert={{ license_detection.compliance_alert }}" class="is-black-link">
-                  {{ license_detection.compliance_alert }}
-                </a>
-              </td>
+            <td>
+              {% if display_compliance_alert %}
+              <a href="?compliance_alert={{ license_detection.compliance_alert }}" class="is-black-link">
+                {{ license_detection.compliance_alert }}
+              </a>
               {% endif %}
+            </td>
           </tr>
         {% empty %}
           <tr>
diff --git a/scanpipe/templates/scanpipe/panels/license_clarity_panel.html b/scanpipe/templates/scanpipe/panels/license_clarity_panel.html
index 457b5b7ceb..78927ba526 100644
--- a/scanpipe/templates/scanpipe/panels/license_clarity_panel.html
+++ b/scanpipe/templates/scanpipe/panels/license_clarity_panel.html
@@ -1,4 +1,4 @@
-<article id="license-clarity-panel" class="panel is-dark">
+<article id="license-clarity-panel" class="panel is-info">
   <div class="panel-heading is-flex is-justify-content-space-between">
     License clarity
     {% include "scanpipe/dropdowns/help_dropdown_tooltip.html" with content="License clarity is a set of metrics that indicate how clearly, comprehensively and accurately a software project has defined and communicated the licensing that applies to the software." only %}
diff --git a/scanpipe/templates/scanpipe/panels/license_detections_summary.html b/scanpipe/templates/scanpipe/panels/license_detections_summary.html
index d31b5e41ab..3e41b6ae81 100644
--- a/scanpipe/templates/scanpipe/panels/license_detections_summary.html
+++ b/scanpipe/templates/scanpipe/panels/license_detections_summary.html
@@ -1,16 +1,32 @@
 {% load humanize %}
 {% if license_detection_summary %}
-  <div class="column is-half">
+<div class="column is-half">
+<article id="license-detection-summary-panel" class="panel is-info">
+  <div class="panel-heading is-flex is-justify-content-space-between">
+    Unique license detections
+    {% include "scanpipe/dropdowns/help_dropdown_tooltip.html" with content="All unique license detections in the codebase identified by matched license text and other license match characteristics. Also contains other license clues." only %}
+  </div>
+  <div class="panel is-info">
     <nav class="panel is-info">
-      <p class="panel-heading py-2 is-size-6">
-        Unique license detections
-      </p>
       {% for license_expression, count in license_detection_summary.items %}
-        <a class="panel-block is-align-items-flex-start break-word  is-flex is-align-items-center" href="{{ project_licenses_url }}?license_expression={{ license_expression|default:'_EMPTY_' }}" target="_blank">
+        <a class="panel-block is-align-items-flex-start break-word is-flex is-align-items-center" href="{{ project_licenses_url }}?license_expression={{ license_expression|default:'_EMPTY_' }}" target="_blank">
           {{ license_expression|default:'<i>No licenses</i>' }}
           <span class="tag is-rounded ml-1">{{ count|intcomma }}</span>
+          {% if license_expression in issue_count_by_expression %}
+            <span class="has-text-danger is-size-6 ml-2 is-flex is-flex-direction-row" title="License detection issue: needs review">
+              <span class="ml-1"><i class="fa-solid fa-magnifying-glass"></i></span>
+              {% for expression, count in issue_count_by_expression.items %}
+                {% if license_expression is expression %}
+                  <span class="ml-1">{{ count|intcomma }}</span>
+                {% endif %}
+              {% endfor %}
+            </span>
+          {% endif %}
           {% if license_expression in expressions_with_compliance_alert %}
-            &nbsp; <span class="fa-solid fa-scale-balanced has-text-danger" title="License Compliance Alerts"></span>
+            <span class="has-text-danger is-size-6 is-flex is-flex-direction-row" title="License Compliance Alert">
+              <span class="ml-1"><i class="fa-solid fa-scale-balanced"></i></span>
+              <span class="ml-1">{{ count|intcomma }}</span>
+            </span>
           {% endif %}
         </a>
       {% endfor %}
@@ -19,13 +35,13 @@
         See all license detections
         <span class="tag is-rounded ml-1">{{ total_counts.all|intcomma }}</span>
         {% if total_counts.needs_review %}
-        <span class="has-text-danger is-size-6 ml-2">
+        <span class="has-text-danger is-size-6 ml-2" title="License detection issue: needs review">
           <i class="fa-solid fa-magnifying-glass"></i>
           {{ total_counts.needs_review|intcomma }}
         </span>
         {% endif %}
         {% if total_counts.with_compliance_error %}
-        <span class="has-text-danger is-size-6 ml-2">
+        <span class="has-text-danger is-size-6 ml-2" title="License Compliance Alert">
           <i class="fa-solid fa-scale-balanced fa-sm"></i>
           {{ total_counts.with_compliance_error|intcomma }}
         </span>
@@ -37,13 +53,13 @@
         See all license clues
         <span class="tag is-rounded ml-1">{{ clue_counts.all|intcomma }}</span>
         {% if clue_counts.needs_review %}
-        <span class="has-text-danger is-size-6 ml-2">
+        <span class="has-text-danger is-size-6 ml-2" title="License detection issue: needs review">
           <i class="fa-solid fa-magnifying-glass"></i>
           {{ clue_counts.needs_review|intcomma }}
         </span>
         {% endif %}
         {% if clue_counts.with_compliance_error %}
-        <span class="has-text-danger is-size-6 ml-2">
+        <span class="has-text-danger is-size-6 ml-2" title="License Compliance Alert">
           <i class="fa-solid fa-scale-balanced fa-sm"></i>
           {{ clue_counts.with_compliance_error|intcomma }}
         </span>
@@ -52,4 +68,6 @@
       {% endif %}
     </nav>
   </div>
+</article>
+</div>
 {% endif %}
\ No newline at end of file
diff --git a/scanpipe/templates/scanpipe/panels/resource_status_summary.html b/scanpipe/templates/scanpipe/panels/resource_status_summary.html
index 9040e16ca7..4330d97f95 100644
--- a/scanpipe/templates/scanpipe/panels/resource_status_summary.html
+++ b/scanpipe/templates/scanpipe/panels/resource_status_summary.html
@@ -1,7 +1,7 @@
 {% load humanize %}
 {% if resource_status_summary %}
   <div class="column is-half">
-    <nav class="panel is-dark">
+    <nav class="panel is-info">
       <p class="panel-heading">
         Resources status
       </p>
diff --git a/scanpipe/templates/scanpipe/panels/scan_summary_panel.html b/scanpipe/templates/scanpipe/panels/scan_summary_panel.html
index 0d69764b22..1def8b4be5 100644
--- a/scanpipe/templates/scanpipe/panels/scan_summary_panel.html
+++ b/scanpipe/templates/scanpipe/panels/scan_summary_panel.html
@@ -1,6 +1,6 @@
 {% load intcomma from humanize %}
-<article id="scan-summary-panel" class="panel is-dark">
-  <div class="panel-heading is-flex is-justify-content-space-between">
+<article id="scan-summary-panel" class="panel is-info">
+  <div class="panel-heading py-2 is-size-6 is-flex is-justify-content-space-between">
     Scan summary
     {% include "scanpipe/dropdowns/help_dropdown_tooltip.html" with content="A top-level summary of the collected scanned data such as licenses, holders, and languages." only %}
   </div>
diff --git a/scanpipe/views.py b/scanpipe/views.py
index 150fd0e13f..5d938d7c30 100644
--- a/scanpipe/views.py
+++ b/scanpipe/views.py
@@ -1129,14 +1129,19 @@ def get_license_detection_summary(project, limit=10):
 
         # Also get count for detections with
         expressions_with_compliance_alert = []
+        issue_count_by_expression = {}
         for license_expression in top_licenses.keys():
+            detections_for_expression = proper_license_detections.filter(
+                license_expression=license_expression
+            )
             has_compliance_alert = (
-                proper_license_detections.filter(license_expression=license_expression)
-                .has_compliance_alert()
-                .exists()
+                detections_for_expression.has_compliance_alert().exists()
             )
+            issue_count = detections_for_expression.needs_review().count()
             if has_compliance_alert:
                 expressions_with_compliance_alert.append(license_expression)
+            if issue_count > 0:
+                issue_count_by_expression[license_expression] = issue_count
 
         total_counts = {
             "with_compliance_error": (
@@ -1160,6 +1165,7 @@ def get_license_detection_summary(project, limit=10):
         return (
             top_licenses,
             expressions_with_compliance_alert,
+            issue_count_by_expression,
             total_counts,
             license_clues,
             clue_counts,
@@ -1167,11 +1173,12 @@ def get_license_detection_summary(project, limit=10):
 
     def get_context_data(self, **kwargs):
         context = super().get_context_data(**kwargs)
-        summary, expressions, counts, clues, clue_counts = (
+        summary, expressions, issues, counts, clues, clue_counts = (
             self.get_license_detection_summary(project=self.object)
         )
         context["license_detection_summary"] = summary
         context["expressions_with_compliance_alert"] = expressions
+        context["issue_count_by_expression"] = issues
         context["total_counts"] = counts
         context["license_clues"] = clues
         context["clue_counts"] = clue_counts
@@ -1896,7 +1903,9 @@ def get_queryset(self):
 
     def get_context_data(self, **kwargs):
         context = super().get_context_data(**kwargs)
-        context["display_compliance_alert"] = self.get_project().policies_enabled
+        context["display_compliance_alert"] = (
+            self.get_project().license_policies_enabled
+        )
         return context