django-cfg 1.2.6__py3-none-any.whl → 1.2.8__py3-none-any.whl

django_cfg/modules/django_unfold/callbacks/system.py

@@ -0,0 +1,180 @@
+"""
+System health and metrics callbacks.
+"""
+
+import logging
+import shutil
+from typing import List, Dict, Any
+
+from django.utils import timezone
+from django.db import connection
+from django.core.cache import cache
+
+from ..models.dashboard import SystemHealthItem
+
+logger = logging.getLogger(__name__)
+
+
+class SystemCallbacks:
+    """System health and metrics callbacks."""
+    
+    def get_system_health(self) -> List[SystemHealthItem]:
+        """Get system health status as Pydantic models."""
+        health_items = []
+
+        # Database health
+        try:
+            with connection.cursor() as cursor:
+                cursor.execute("SELECT 1")
+                health_items.append(
+                    SystemHealthItem(
+                        component="database",
+                        status="healthy",
+                        description="Connection successful",
+                        last_check=timezone.now().strftime("%H:%M:%S"),
+                        health_percentage=95,
+                    )
+                )
+        except Exception as e:
+            health_items.append(
+                SystemHealthItem(
+                    component="database",
+                    status="error",
+                    description=f"Connection failed: {str(e)[:50]}",
+                    last_check=timezone.now().strftime("%H:%M:%S"),
+                    health_percentage=0,
+                )
+            )
+
+        # Cache health
+        try:
+            cache.set("health_check", "ok", 10)
+            if cache.get("health_check") == "ok":
+                health_items.append(
+                    SystemHealthItem(
+                        component="cache",
+                        status="healthy",
+                        description="Cache operational",
+                        last_check=timezone.now().strftime("%H:%M:%S"),
+                        health_percentage=90,
+                    )
+                )
+            else:
+                health_items.append(
+                    SystemHealthItem(
+                        component="cache",
+                        status="warning",
+                        description="Cache not responding",
+                        last_check=timezone.now().strftime("%H:%M:%S"),
+                        health_percentage=50,
+                    )
+                )
+        except Exception:
+            health_items.append(
+                SystemHealthItem(
+                    component="cache",
+                    status="unknown",
+                    description="Cache not configured",
+                    last_check=timezone.now().strftime("%H:%M:%S"),
+                    health_percentage=0,
+                )
+            )
+
+        # Storage health
+        try:
+            total, used, free = shutil.disk_usage("/")
+            usage_percentage = (used / total) * 100
+            free_percentage = 100 - usage_percentage
+
+            if free_percentage > 20:
+                status = "healthy"
+                desc = f"Disk space: {free_percentage:.1f}% free"
+            elif free_percentage > 10:
+                status = "warning"
+                desc = f"Low disk space: {free_percentage:.1f}% free"
+            else:
+                status = "error"
+                desc = f"Critical disk space: {free_percentage:.1f}% free"
+
+            health_items.append(
+                SystemHealthItem(
+                    component="storage",
+                    status=status,
+                    description=desc,
+                    last_check=timezone.now().strftime("%H:%M:%S"),
+                    health_percentage=int(free_percentage),
+                )
+            )
+        except Exception as e:
+            health_items.append(
+                SystemHealthItem(
+                    component="storage",
+                    status="error",
+                    description="Storage check failed",
+                    last_check=timezone.now().strftime("%H:%M:%S"),
+                    health_percentage=0,
+                )
+            )
+
+        # API health
+        health_items.append(
+            SystemHealthItem(
+                component="api",
+                status="healthy",
+                description="API server running",
+                last_check=timezone.now().strftime("%H:%M:%S"),
+                health_percentage=100,
+            )
+        )
+
+        return health_items
+
+    def get_system_metrics(self) -> Dict[str, Any]:
+        """Get system metrics for dashboard."""
+        metrics = {}
+
+        # Database metrics
+        try:
+            with connection.cursor() as cursor:
+                cursor.execute("SELECT 1")
+                metrics["database"] = {
+                    "status": "healthy",
+                    "type": "PostgreSQL",
+                    "health_percentage": 95,
+                    "description": "Connection successful",
+                }
+        except Exception as e:
+            metrics["database"] = {
+                "status": "error",
+                "type": "PostgreSQL",
+                "health_percentage": 0,
+                "description": f"Connection failed: {str(e)}",
+            }
+
+        # Cache metrics
+        try:
+            cache.set("health_check", "ok", 10)
+            cache_result = cache.get("health_check")
+            if cache_result == "ok":
+                metrics["cache"] = {
+                    "status": "healthy",
+                    "type": "Memory Cache",
+                    "health_percentage": 90,
+                    "description": "Cache working properly",
+                }
+            else:
+                metrics["cache"] = {
+                    "status": "warning",
+                    "type": "Memory Cache",
+                    "health_percentage": 50,
+                    "description": "Cache response delayed",
+                }
+        except Exception as e:
+            metrics["cache"] = {
+                "status": "error",
+                "type": "Memory Cache",
+                "health_percentage": 0,
+                "description": f"Cache error: {str(e)}",
+            }
+
+        return metrics

django_cfg/modules/django_unfold/callbacks/users.py

@@ -0,0 +1,65 @@
+"""
+Users data callbacks.
+"""
+
+import logging
+from typing import List, Dict, Any
+
+from django.contrib.auth import get_user_model
+
+from .base import get_user_admin_urls
+
+logger = logging.getLogger(__name__)
+
+
+class UsersCallbacks:
+    """Users data callbacks."""
+    
+    def _get_user_model(self):
+        """Get the user model safely."""
+        return get_user_model()
+    
+    def get_recent_users(self) -> List[Dict[str, Any]]:
+        """Get recent users data for template."""
+        try:
+            # Avoid database access during app initialization
+            from django.apps import apps
+            if not apps.ready:
+                return []
+                
+            User = self._get_user_model()
+            recent_users = User.objects.select_related().order_by("-date_joined")[:10]
+
+            # Get admin URLs for user model
+            user_admin_urls = get_user_admin_urls()
+
+            return [
+                {
+                    "id": user.id,
+                    "username": user.username,
+                    "email": user.email or "No email",
+                    "date_joined": (
+                        user.date_joined.strftime("%Y-%m-%d")
+                        if user.date_joined
+                        else "Unknown"
+                    ),
+                    "is_active": user.is_active,
+                    "is_staff": user.is_staff,
+                    "is_superuser": user.is_superuser,
+                    "last_login": user.last_login,
+                    "admin_urls": {
+                        "change": (
+                            user_admin_urls["change"].format(id=user.id)
+                            if user.id
+                            else None
+                        ),
+                        "view": (
+                            user_admin_urls["view"].format(id=user.id) if user.id else None
+                        ),
+                    },
+                }
+                for user in recent_users
+            ]
+        except Exception as e:
+            logger.error(f"Error getting recent users: {e}")
+            return []

django_cfg/modules/django_unfold/models/config.py

@@ -467,21 +467,28 @@ class UnfoldConfig(BaseModel):
         if self.tab_configurations:
             unfold_settings["TABS"] = self.tab_configurations
         
-        # Command interface
+        # Command interface - Enhanced for better UX
         unfold_settings["COMMAND"] = {
             "search_models": True,
             "show_history": True,
+            "search_callback": None,  # Can be customized per project
         }
 
-        # Inject universal CSS variables (includes object-tools flex)
+        # Inject universal CSS variables and custom styles
         if "STYLES" not in unfold_settings:
             unfold_settings["STYLES"] = []
         
         # Add our CSS as inline data URI
         try:
-            from ..tailwind import get_css_variables
+            from ..tailwind import get_css_variables, get_modal_fix_css
             import base64
+            
+            # Base CSS variables
             css_content = get_css_variables()
+            
+            # Add modal scroll fix CSS
+            css_content += get_modal_fix_css()
+            
             css_b64 = base64.b64encode(css_content.encode('utf-8')).decode('utf-8')
             data_uri = f"data:text/css;base64,{css_b64}"
             unfold_settings["STYLES"].append(lambda request: data_uri)

django_cfg/modules/django_unfold/tailwind.py

@@ -198,6 +198,74 @@ def get_css_variables() -> str:
 """
 
 
+def get_modal_fix_css() -> str:
+    """
+    Get CSS fixes for modal scroll issues and other UI improvements.
+    
+    Returns:
+        str: CSS fixes as string
+    """
+    return """
+/* Modal scroll fixes and UI improvements */
+
+/* Ensure proper modal scroll behavior */
+.modal-scrollable {
+    max-height: calc(80vh - 8rem);
+    overflow-y: auto;
+}
+
+/* Command modal specific fixes */
+#commandModal .overflow-y-auto {
+    scrollbar-width: thin;
+    scrollbar-color: rgb(156, 163, 175) transparent;
+}
+
+#commandModal .overflow-y-auto::-webkit-scrollbar {
+    width: 8px;
+}
+
+#commandModal .overflow-y-auto::-webkit-scrollbar-track {
+    background: transparent;
+}
+
+#commandModal .overflow-y-auto::-webkit-scrollbar-thumb {
+    background-color: rgb(156, 163, 175);
+    border-radius: 4px;
+}
+
+#commandModal .overflow-y-auto::-webkit-scrollbar-thumb:hover {
+    background-color: rgb(107, 114, 128);
+}
+
+/* Dark theme scrollbar */
+.dark #commandModal .overflow-y-auto {
+    scrollbar-color: rgb(75, 85, 99) transparent;
+}
+
+.dark #commandModal .overflow-y-auto::-webkit-scrollbar-thumb {
+    background-color: rgb(75, 85, 99);
+}
+
+.dark #commandModal .overflow-y-auto::-webkit-scrollbar-thumb:hover {
+    background-color: rgb(107, 114, 128);
+}
+
+/* Improved focus states */
+.focus-visible\\:outline-primary-600:focus-visible {
+    outline: 2px solid rgb(37, 99, 235);
+    outline-offset: 2px;
+}
+
+/* Better button transitions */
+.transition-colors {
+    transition-property: color, background-color, border-color;
+    transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+    transition-duration: 150ms;
+}
+
+"""
+
+
 def get_unfold_colors() -> Dict[str, Any]:
     """
     Get color configuration for Unfold settings.

django_cfg/templates/admin/components/action_grid.html

@@ -0,0 +1,49 @@
+{% load unfold %}
+
+<!-- Action Grid Component -->
+<div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-{{ cols|default:'3' }} xl:grid-cols-{{ xl_cols|default:'4' }} gap-4">
+    {% for action in actions %}
+        <a href="{{ action.link }}" 
+           class="group flex items-center p-4 bg-white dark:bg-base-900 rounded-lg border border-base-200 dark:border-base-700 hover:border-primary-600 dark:hover:border-primary-500 hover:shadow-md transition-all duration-200 focus:outline-none focus:ring-2 focus:ring-primary-500 focus:ring-offset-2">
+            
+            <!-- Icon -->
+            <div class="flex-shrink-0 mr-4">
+                <div class="p-2 rounded-lg transition-colors duration-200
+                    {% if action.color == 'primary' %}bg-primary-100 dark:bg-primary-900/20 group-hover:bg-primary-200 dark:group-hover:bg-primary-800/30
+                    {% elif action.color == 'success' %}bg-green-100 dark:bg-green-900/20 group-hover:bg-green-200 dark:group-hover:bg-green-800/30
+                    {% elif action.color == 'warning' %}bg-amber-100 dark:bg-amber-900/20 group-hover:bg-amber-200 dark:group-hover:bg-amber-800/30
+                    {% elif action.color == 'danger' %}bg-red-100 dark:bg-red-900/20 group-hover:bg-red-200 dark:group-hover:bg-red-800/30
+                    {% else %}bg-base-100 dark:bg-base-800 group-hover:bg-base-200 dark:group-hover:bg-base-700{% endif %}">
+                    
+                    <span class="material-icons text-lg
+                        {% if action.color == 'primary' %}text-primary-600 dark:text-primary-400
+                        {% elif action.color == 'success' %}text-green-600 dark:text-green-400
+                        {% elif action.color == 'warning' %}text-amber-600 dark:text-amber-400
+                        {% elif action.color == 'danger' %}text-red-600 dark:text-red-400
+                        {% else %}text-font-subtle-light dark:text-font-subtle-dark{% endif %}">
+                        {{ action.icon }}
+                    </span>
+                </div>
+            </div>
+            
+            <!-- Content -->
+            <div class="flex-1 min-w-0">
+                <h3 class="text-sm font-medium text-font-default-light dark:text-font-default-dark group-hover:text-primary-600 dark:group-hover:text-primary-500 transition-colors duration-200">
+                    {{ action.title }}
+                </h3>
+                {% if action.description %}
+                    <p class="text-xs text-font-subtle-light dark:text-font-subtle-dark mt-1 line-clamp-2">
+                        {{ action.description }}
+                    </p>
+                {% endif %}
+            </div>
+            
+            <!-- Arrow -->
+            <div class="flex-shrink-0 ml-2">
+                <span class="material-icons text-base-400 dark:text-base-500 group-hover:text-primary-600 dark:group-hover:text-primary-500 transition-colors duration-200">
+                    arrow_forward
+                </span>
+            </div>
+        </a>
+    {% endfor %}
+</div>

django_cfg/templates/admin/components/card.html

@@ -0,0 +1,50 @@
+{% load unfold %}
+
+<!-- Enhanced Card Component following Unfold patterns -->
+<div class="bg-white dark:bg-base-900 rounded-lg border border-base-200 dark:border-base-700 shadow-xs overflow-hidden {% if hover %}hover:shadow-md hover:border-base-300 dark:hover:border-base-600 transition-all duration-200{% endif %}{% if class %} {{ class }}{% endif %}">
+    
+    <!-- Card Header -->
+    {% if title or header_actions %}
+    <div class="p-6 border-b border-base-200 dark:border-base-700 {% if header_bg %}{{ header_bg }}{% else %}bg-base-50 dark:bg-base-800{% endif %}">
+        <div class="flex items-center justify-between">
+            {% if title %}
+            <div class="flex items-center space-x-3">
+                {% if icon %}
+                <div class="flex items-center justify-center w-8 h-8 bg-{{ icon_color|default:'primary' }}-100 dark:bg-{{ icon_color|default:'primary' }}-900/20 rounded-lg">
+                    <span class="material-icons text-{{ icon_color|default:'primary' }}-600 dark:text-{{ icon_color|default:'primary' }}-400 text-lg">{{ icon }}</span>
+                </div>
+                {% endif %}
+                <div>
+                    <h3 class="text-lg font-semibold text-font-important-light dark:text-font-important-dark">
+                        {{ title }}
+                    </h3>
+                    {% if subtitle %}
+                    <p class="text-sm text-font-subtle-light dark:text-font-subtle-dark mt-1">
+                        {{ subtitle }}
+                    </p>
+                    {% endif %}
+                </div>
+            </div>
+            {% endif %}
+            
+            {% if header_actions %}
+            <div class="flex items-center space-x-2">
+                {{ header_actions }}
+            </div>
+            {% endif %}
+        </div>
+    </div>
+    {% endif %}
+    
+    <!-- Card Body -->
+    <div class="p-6{% if compact %} p-4{% endif %}">
+        {{ content }}
+    </div>
+    
+    <!-- Card Footer -->
+    {% if footer %}
+    <div class="px-6 py-4 border-t border-base-200 dark:border-base-700 bg-base-50 dark:bg-base-800">
+        {{ footer }}
+    </div>
+    {% endif %}
+</div>

django_cfg/templates/admin/components/data_table.html

@@ -0,0 +1,67 @@
+{% load unfold %}
+
+<!-- Data Table Component -->
+<div class="bg-white dark:bg-base-900 rounded-lg border border-base-200 dark:border-base-700 overflow-hidden shadow-xs">
+    
+    <!-- Table Header -->
+    {% if title or actions %}
+    <div class="px-6 py-4 border-b border-base-200 dark:border-base-700 bg-base-50 dark:bg-base-800">
+        <div class="flex items-center justify-between">
+            {% if title %}
+            <div class="flex items-center">
+                {% if icon %}
+                <span class="material-icons text-primary-600 mr-2">{{ icon }}</span>
+                {% endif %}
+                <h3 class="text-lg font-semibold text-font-important-light dark:text-font-important-dark">{{ title }}</h3>
+            </div>
+            {% endif %}
+            
+            {% if actions %}
+            <div class="flex items-center space-x-2">
+                {{ actions }}
+            </div>
+            {% endif %}
+        </div>
+    </div>
+    {% endif %}
+    
+    <!-- Table Content -->
+    <div class="overflow-x-auto">
+        <table class="w-full">
+            {% if headers %}
+            <thead class="bg-base-50 dark:bg-base-800">
+                <tr>
+                    {% for header in headers %}
+                    <th class="px-6 py-3 text-left text-xs font-medium text-font-subtle-light dark:text-font-subtle-dark uppercase tracking-wider">
+                        {{ header }}
+                    </th>
+                    {% endfor %}
+                </tr>
+            </thead>
+            {% endif %}
+            
+            <tbody class="bg-white dark:bg-base-900 divide-y divide-base-200 dark:divide-base-700">
+                {% if rows %}
+                    {% for row in rows %}
+                    <tr class="hover:bg-base-100 dark:hover:bg-base-800 transition-colors duration-150">
+                        {% for cell in row %}
+                        <td class="px-6 py-4 whitespace-nowrap">
+                            {{ cell }}
+                        </td>
+                        {% endfor %}
+                    </tr>
+                    {% endfor %}
+                {% else %}
+                    <tr>
+                        <td colspan="{{ headers|length|default:'5' }}" class="px-6 py-8 text-center">
+                            <div class="flex flex-col items-center">
+                                <span class="material-icons text-4xl text-base-400 dark:text-base-500 mb-2">{{ empty_icon|default:'inbox' }}</span>
+                                <p class="text-font-subtle-light dark:text-font-subtle-dark">{{ empty_message|default:'No data available' }}</p>
+                            </div>
+                        </td>
+                    </tr>
+                {% endif %}
+            </tbody>
+        </table>
+    </div>
+</div>

django_cfg/templates/admin/components/metric_card.html

@@ -0,0 +1,39 @@
+{% load unfold %}
+
+<!-- Metric Card Component -->
+<div class="bg-white dark:bg-base-900 rounded-lg p-5 border border-base-200 dark:border-base-700 hover:shadow-md transition-shadow duration-200">
+    <div class="flex items-center justify-between">
+        <div class="flex items-center space-x-3">
+            <div class="flex-shrink-0">
+                <span class="material-icons 
+                    {% if status == 'healthy' or status == 'success' %}text-green-600 dark:text-green-400
+                    {% elif status == 'warning' %}text-amber-600 dark:text-amber-400
+                    {% elif status == 'error' or status == 'failed' %}text-red-600 dark:text-red-400
+                    {% elif status == 'info' %}text-blue-600 dark:text-blue-400
+                    {% else %}text-primary-600 dark:text-primary-400{% endif %}">
+                    {{ icon }}
+                </span>
+            </div>
+            <div>
+                <div class="text-sm font-medium text-font-default-light dark:text-font-default-dark">
+                    {{ title }}
+                </div>
+                {% if description %}
+                <div class="text-xs text-font-subtle-light dark:text-font-subtle-dark mt-1">
+                    {{ description }}
+                </div>
+                {% endif %}
+            </div>
+        </div>
+        
+        <div class="flex-shrink-0">
+            {% include 'admin/components/status_badge.html' with status=status text=status_text %}
+        </div>
+    </div>
+    
+    {% if progress %}
+    <div class="mt-4">
+        {% include 'admin/components/progress_bar.html' with value=progress title=progress_title description=progress_description %}
+    </div>
+    {% endif %}
+</div>

django_cfg/templates/admin/components/modal.html

@@ -0,0 +1,58 @@
+{% load unfold %}
+
+<!-- Reusable Modal Component based on Unfold patterns -->
+<div id="{{ modal_id|default:'modal' }}" class="fixed inset-0 bg-black/80 backdrop-blur-sm hidden z-50">
+    <div class="flex items-center justify-center min-h-screen p-4">
+        <div class="bg-white dark:bg-base-900 rounded-lg shadow-2xl max-w-{{ max_width|default:'4xl' }} w-full max-h-[80vh] flex flex-col border border-base-200 dark:border-base-700">
+            
+            <!-- Modal Header -->
+            {% if title or closable %}
+            <div class="flex items-center justify-between p-4 border-b border-base-200 dark:border-base-700 bg-base-50 dark:bg-base-800">
+                {% if title %}
+                <div class="flex items-center space-x-3">
+                    {% if icon %}
+                    <div class="flex items-center justify-center w-10 h-10 bg-primary-100 dark:bg-primary-900/20 rounded-lg">
+                        <span class="material-icons text-primary-600 dark:text-primary-400">{{ icon }}</span>
+                    </div>
+                    {% endif %}
+                    <div>
+                        <h3 class="text-lg font-semibold text-font-important-light dark:text-font-important-dark">
+                            {{ title }}
+                        </h3>
+                        {% if subtitle %}
+                        <p class="text-sm text-font-subtle-light dark:text-font-subtle-dark">
+                            {{ subtitle }}
+                        </p>
+                        {% endif %}
+                    </div>
+                </div>
+                {% endif %}
+                
+                {% if closable %}
+                <button onclick="{{ close_function|default:'closeModal()' }}" class="p-2 text-font-subtle-light dark:text-font-subtle-dark hover:text-font-default-light dark:hover:text-font-default-dark hover:bg-base-100 dark:hover:bg-base-700 rounded-lg transition-colors">
+                    <span class="material-icons">close</span>
+                </button>
+                {% endif %}
+            </div>
+            {% endif %}
+            
+            <!-- Modal Body -->
+            <div class="flex-1 overflow-hidden p-4">
+                {% if scrollable %}
+                <div class="bg-base-100 dark:bg-base-800 rounded-lg border border-base-200 dark:border-base-700 h-full overflow-y-auto p-4">
+                    {{ content }}
+                </div>
+                {% else %}
+                {{ content }}
+                {% endif %}
+            </div>
+            
+            <!-- Modal Footer -->
+            {% if footer %}
+            <div class="flex items-center justify-between p-4 border-t border-base-200 dark:border-base-700 bg-base-50 dark:bg-base-800">
+                {{ footer }}
+            </div>
+            {% endif %}
+        </div>
+    </div>
+</div>

django_cfg/templates/admin/components/progress_bar.html

@@ -0,0 +1,25 @@
+{% load unfold %}
+
+<!-- Progress Bar Component -->
+<div class="w-full">
+    {% if title %}
+    <div class="flex items-center justify-between mb-2">
+        <span class="text-sm font-medium text-font-default-light dark:text-font-default-dark">{{ title }}</span>
+        <span class="text-sm text-font-subtle-light dark:text-font-subtle-dark">{{ value }}%</span>
+    </div>
+    {% endif %}
+    
+    <div class="w-full bg-base-200 dark:bg-base-700 rounded-full h-2">
+        <div class="h-2 rounded-full transition-all duration-300
+            {% if value >= 80 %}bg-green-500
+            {% elif value >= 60 %}bg-amber-500
+            {% elif value >= 40 %}bg-orange-500
+            {% else %}bg-red-500{% endif %}"
+            style="width: {{ value|default:0 }}%">
+        </div>
+    </div>
+    
+    {% if description %}
+    <p class="text-xs text-font-subtle-light dark:text-font-subtle-dark mt-1">{{ description }}</p>
+    {% endif %}
+</div>

django_cfg/templates/admin/components/section_header.html

@@ -0,0 +1,26 @@
+{% load unfold %}
+
+<!-- Section Header Component -->
+<div class="flex items-center mb-6">
+    {% if icon %}
+    <div class="flex items-center justify-center w-8 h-8 bg-{{ icon_color|default:'primary' }}-100 dark:bg-{{ icon_color|default:'primary' }}-900/20 rounded-lg mr-3">
+        <span class="material-icons text-{{ icon_color|default:'primary' }}-600 dark:text-{{ icon_color|default:'primary' }}-400 text-lg">{{ icon }}</span>
+    </div>
+    {% endif %}
+    
+    <h2 class="text-xl font-semibold text-font-important-light dark:text-font-important-dark">
+        {{ title }}
+    </h2>
+    
+    {% if badge %}
+    <span class="ml-auto text-xs text-font-subtle-light dark:text-font-subtle-dark bg-base-100 dark:bg-base-800 px-2 py-1 rounded-full">
+        {{ badge }}
+    </span>
+    {% endif %}
+    
+    {% if actions %}
+    <div class="ml-auto flex items-center space-x-2">
+        {{ actions }}
+    </div>
+    {% endif %}
+</div>