feat(admin): django admin tweaks

cl/assets/templates/admin/docket_change_form.html

@@ -0,0 +1,19 @@
+{% extends "admin/change_form.html" %}
+
+{% block object-tools-items %}
+  {% if docket_entries_url %}
+    <li>
+      <a class="historylink" href="{{ docket_entries_url }}">
+        View Docket Entries
+      </a>
+    </li>
+  {% endif %}
+  {% if docket_alerts_url %}
+    <li>
+      <a class="historylink" href="{{ docket_alerts_url }}">
+        View Docket Alerts
+      </a>
+    </li>
+  {% endif %}
+  {{ block.super }}
+{% endblock object-tools-items %}

cl/assets/templates/admin/user_change_form.html

@@ -0,0 +1,19 @@
+{% extends "admin/change_form.html" %}
+
+{% block object-tools-items %}
+  {% if proxy_events_url %}
+    <li>
+      <a class="historylink" href="{{ proxy_events_url }}">
+        View UserProxy Events
+      </a>
+    </li>
+  {% endif %}
+  {% if profile_events_url %}
+    <li>
+      <a class="historylink" href="{{ profile_events_url }}">
+        View UserProfile Events
+      </a>
+    </li>
+  {% endif %}
+  {{ block.super }}
+{% endblock object-tools-items %}

cl/recap/admin.py

@@ -21,8 +21,10 @@ class ProcessingQueueAdmin(CursorPaginatorAdmin):
         "pacer_case_id",
         "document_number",
         "attachment_number",
+        "date_created",
     )
-    list_filter = ("status",)
+    list_filter = ("status", "date_created")
+    search_help_text = "Search ProcessingQueues by pacer_case_id or court__pk."
     search_fields = (
         "pacer_case_id",
         "court__pk",
@@ -41,15 +43,8 @@ class ProcessingQueueAdmin(CursorPaginatorAdmin):
 
 @admin.register(PacerFetchQueue)
 class PacerFetchQueueAdmin(CursorPaginatorAdmin):
-    list_display = (
-        "__str__",
-        "court",
-        "request_type",
-    )
-    list_filter = (
-        "status",
-        "request_type",
-    )
+    list_display = ("__str__", "court", "request_type", "date_created")
+    list_filter = ("status", "request_type", "date_created")
     readonly_fields = (
         "date_created",
         "date_modified",
@@ -94,14 +89,15 @@ def reprocess_failed_epq(modeladmin, request, queryset):
 
 @admin.register(EmailProcessingQueue)
 class EmailProcessingQueueAdmin(CursorPaginatorAdmin):
-    list_display = (
-        "__str__",
-        "status",
-    )
-    list_filter = ("status",)
+    list_display = ("__str__", "status", "date_created")
+    list_filter = ("status", "date_created")
     actions = [reprocess_failed_epq]
     raw_id_fields = ["uploader", "court"]
     exclude = ["recap_documents", "filepath"]
+    readonly_fields = (
+        "date_created",
+        "date_modified",
+    )
 
 
 admin.site.register(FjcIntegratedDatabase)

cl/search/admin.py

@@ -4,8 +4,10 @@
 from django.http import HttpRequest
 
 from cl.alerts.admin import DocketAlertInline
+from cl.alerts.models import DocketAlert
 from cl.lib.cloud_front import invalidate_cloudfront
 from cl.lib.models import THUMBNAIL_STATUSES
+from cl.lib.string_utils import trunc
 from cl.recap.management.commands.delete_document_from_ia import delete_from_ia
 from cl.search.models import (
     BankruptcyInformation,
@@ -88,7 +90,14 @@ class OpinionClusterAdmin(CursorPaginatorAdmin):
 
 @admin.register(Court)
 class CourtAdmin(admin.ModelAdmin):
-    list_display = ("full_name", "short_name", "position", "in_use", "pk")
+    list_display = (
+        "full_name",
+        "short_name",
+        "position",
+        "in_use",
+        "pk",
+        "jurisdiction",
+    )
     list_filter = (
         "jurisdiction",
         "in_use",
@@ -215,17 +224,36 @@ class RECAPDocumentInline(admin.StackedInline):
 @admin.register(DocketEntry)
 class DocketEntryAdmin(CursorPaginatorAdmin):
     inlines = (RECAPDocumentInline,)
+    search_help_text = (
+        "Search DocketEntries by Docket ID or RECAP sequence number."
+    )
+    search_fields = (
+        "docket__id",
+        "recap_sequence_number",
+    )
+    list_display = (
+        "get_pk",
+        "get_trunc_description",
+        "date_filed",
+        "time_filed",
+        "entry_number",
+        "recap_sequence_number",
+        "pacer_sequence_number",
+    )
     raw_id_fields = ("docket", "tags")
     readonly_fields = (
         "date_created",
         "date_modified",
     )
+    list_filter = ("date_filed", "date_created", "date_modified")
 
+    @admin.display(description="Docket entry")
+    def get_pk(self, obj):
+        return obj.pk
 
-class DocketEntryInline(admin.TabularInline):
-    model = DocketEntry
-    extra = 1
-    raw_id_fields = ("tags",)
+    @admin.display(description="Description")
+    def get_trunc_description(self, obj):
+        return trunc(obj.description, 35, ellipsis="...")
 
 
 @admin.register(OriginatingCourtInformation)
@@ -238,17 +266,26 @@ class OriginatingCourtInformationAdmin(admin.ModelAdmin):
 
 @admin.register(Docket)
 class DocketAdmin(CursorPaginatorAdmin):
+    change_form_template = "admin/docket_change_form.html"
     prepopulated_fields = {"slug": ["case_name"]}
-    inlines = (
-        DocketEntryInline,
-        BankruptcyInformationInline,
-        DocketAlertInline,
+    list_display = (
+        "__str__",
+        "pacer_case_id",
+        "docket_number",
+        "pacer_case_id",
     )
+    search_help_text = "Search dockets by PK, PACER case ID, or Docket number."
+    search_fields = ("pk", "pacer_case_id", "docket_number")
+    inlines = (BankruptcyInformationInline,)
     readonly_fields = (
         "date_created",
         "date_modified",
         "view_count",
     )
+    autocomplete_fields = (
+        "court",
+        "appeal_from",
+    )
     raw_id_fields = (
         "panel",
         "tags",
@@ -259,6 +296,29 @@ class DocketAdmin(CursorPaginatorAdmin):
         "parent_docket",
     )
 
+    def change_view(self, request, object_id, form_url="", extra_context=None):
+        """Add links to pre-filtered related admin pages."""
+        extra_context = extra_context or {}
+        docket = self.get_object(request, object_id)
+
+        if docket and hasattr(docket, "docket_entries"):
+            docket_entries_url = (
+                f"/admin/{DocketEntry._meta.app_label}/"
+                f"{DocketEntry._meta.model_name}/?docket={object_id}"
+            )
+            extra_context["docket_entries_url"] = docket_entries_url
+
+        if docket and hasattr(docket, "alerts"):
+            docket_alerts_url = (
+                f"/admin/{DocketAlert._meta.app_label}/"
+                f"{DocketAlert._meta.model_name}/?docket={object_id}"
+            )
+            extra_context["docket_alerts_url"] = docket_alerts_url
+
+        return super().change_view(
+            request, object_id, form_url, extra_context=extra_context
+        )
+
 
 @admin.register(OpinionsCited)
 class OpinionsCitedAdmin(CursorPaginatorAdmin):

cl/users/admin.py

@@ -1,4 +1,6 @@
+from django.apps import apps
 from django.contrib import admin
+from django.contrib.auth.forms import UserChangeForm
 from django.contrib.auth.models import Permission, User
 from rest_framework.authtoken.models import Token
 
@@ -19,30 +21,42 @@
     UserProfile,
 )
 
+UserProxyEvent = apps.get_model("users", "UserProxyEvent")
+UserProfileEvent = apps.get_model("users", "UserProfileEvent")
 
-def get_email_confirmed(obj):
-    return obj.profile.email_confirmed
-
-
-get_email_confirmed.short_description = "Email Confirmed?"
 
+class TokenInline(admin.StackedInline):
+    model = Token
 
-def get_stub_account(obj):
-    return obj.profile.stub_account
 
+class UserProfileInline(admin.StackedInline):
+    model = UserProfile
 
-get_stub_account.short_description = "Stub Account?"
 
+class CustomUserChangeForm(UserChangeForm):
+    class Meta(UserChangeForm.Meta):
+        model = User
+        fields = "__all__"
 
-class TokenInline(admin.StackedInline):
-    model = Token
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        # Ensure user_permissions field uses an optimized queryset
+        if "user_permissions" in self.fields:
+            self.fields["user_permissions"].queryset = (
+                Permission.objects.select_related("content_type").order_by(
+                    "content_type__app_label", "codename"
+                )
+            )
 
 
-class UserProfileInline(admin.StackedInline):
-    model = UserProfile
+# Replace the normal User admin with our better one.
+admin.site.unregister(User)
 
 
+@admin.register(User)
 class UserAdmin(admin.ModelAdmin, AdminTweaksMixin):
+    form = CustomUserChangeForm  # optimize queryset for user_permissions field
+    change_form_template = "admin/user_change_form.html"
     inlines = (
         UserProfileInline,
         DonationInline,
@@ -57,8 +71,16 @@ class UserAdmin(admin.ModelAdmin, AdminTweaksMixin):
     )
     list_display = (
         "username",
-        get_email_confirmed,
-        get_stub_account,
+        "get_email_confirmed",
+        "get_stub_account",
+    )
+    list_filter = (
+        "is_superuser",
+        "profile__email_confirmed",
+        "profile__stub_account",
+    )
+    search_help_text = (
+        "Search Users by username, first name, last name, or email."
     )
     search_fields = (
         "username",
@@ -67,6 +89,36 @@ class UserAdmin(admin.ModelAdmin, AdminTweaksMixin):
         "email",
     )
 
+    def change_view(self, request, object_id, form_url="", extra_context=None):
+        """Add links to related event admin pages filtered by user/profile."""
+        extra_context = extra_context or {}
+        user = self.get_object(request, object_id)
+        proxy_events_url = (
+            f"/admin/{UserProxyEvent._meta.app_label}/"
+            f"{UserProxyEvent._meta.model_name}/?pgh_obj={object_id}"
+        )
+        extra_context["proxy_events_url"] = proxy_events_url
+
+        if user and hasattr(user, "profile"):
+            profile_id = user.profile.pk
+            profile_events_url = (
+                f"/admin/{UserProfileEvent._meta.app_label}/"
+                f"{UserProfileEvent._meta.model_name}/?pgh_obj={profile_id}"
+            )
+            extra_context["profile_events_url"] = profile_events_url
+
+        return super().change_view(
+            request, object_id, form_url, extra_context=extra_context
+        )
+
+    @admin.display(description="Email Confirmed?")
+    def get_email_confirmed(self, obj):
+        return obj.profile.email_confirmed
+
+    @admin.display(description="Stub Account?")
+    def get_stub_account(self, obj):
+        return obj.profile.stub_account
+
 
 @admin.register(EmailFlag)
 class EmailFlagAdmin(admin.ModelAdmin):
@@ -117,8 +169,57 @@ class FailedEmailAdmin(admin.ModelAdmin):
     raw_id_fields = ("stored_email",)
 
 
-# Replace the normal User admin with our better one.
-admin.site.unregister(User)
-admin.site.register(User, UserAdmin)
+class BaseUserEventAdmin(admin.ModelAdmin):
+    ordering = ("-pgh_created_at",)
+    # Define common attributes to be extended:
+    common_list_display = ("get_pgh_created", "get_pgh_label")
+    common_list_filters = ("pgh_created_at",)
+    common_search_fields = ("pgh_obj",)
+    # Default to common attributes:
+    list_display = common_list_display
+    list_filter = common_list_filters
+    search_fields = common_search_fields
+
+    @admin.display(ordering="pgh_created_at", description="Event triggered")
+    def get_pgh_created(self, obj):
+        return obj.pgh_created_at
+
+    @admin.display(ordering="pgh_label", description="Event label")
+    def get_pgh_label(self, obj):
+        return obj.pgh_label
+
+
+@admin.register(UserProxyEvent)
+class UserProxyEventAdmin(BaseUserEventAdmin):
+    search_help_text = "Search UserProxyEvents by pgh_obj, email, or username."
+    search_fields = BaseUserEventAdmin.common_search_fields + (
+        "email",
+        "username",
+    )
+    list_display = BaseUserEventAdmin.list_display + (
+        "email",
+        "username",
+    )
+    readonly_fields = [
+        field.name for field in UserProxyEvent._meta.get_fields()
+    ]
+
+
+@admin.register(UserProfileEvent)
+class UserProfileEventAdmin(BaseUserEventAdmin):
+    search_help_text = "Search UserProxyEvents by pgh_obj or username."
+    search_fields = BaseUserEventAdmin.common_search_fields + (
+        "user__username",
+    )
+    list_display = BaseUserEventAdmin.common_list_display + (
+        "user",
+        "email_confirmed",
+    )
+    list_filter = BaseUserEventAdmin.common_list_filters + ("email_confirmed",)
+    readonly_fields = [
+        field.name for field in UserProfileEvent._meta.get_fields()
+    ]
+
+
 admin.site.register(BarMembership)
 admin.site.register(Permission)