django-cfg 1.1.81__py3-none-any.whl → 1.2.0__py3-none-any.whl

django_cfg/modules/django_unfold/dashboard.py

@@ -0,0 +1,278 @@
+"""
+Dashboard Manager for Django CFG Unfold
+
+Manages dashboard configuration, widgets, and navigation
+based on the working configuration from the old version.
+"""
+
+from typing import List, Dict, Any, Optional
+from django.templatetags.static import static
+from django.urls import reverse_lazy
+from ..base import BaseCfgModule
+from .icons import Icons
+from .models.navigation import NavigationSection, NavigationItem
+from .models.dashboard import StatCard, StatsCardsWidget
+
+
+class DashboardManager(BaseCfgModule):
+    """
+    Dashboard configuration manager for Unfold.
+    
+    Based on the working configuration from @old/api__old/api/dashboard/unfold_config.py
+    """
+    
+    def __init__(self):
+        """Initialize dashboard manager."""
+        super().__init__()
+        self.config = self.get_config()
+    
+    def _get_default_dropdown_items(self) -> List[Dict[str, Any]]:
+        """Get default dropdown menu items for Unfold admin (lazy import to avoid circular imports)."""
+        from django_cfg.config import get_default_dropdown_items
+        dropdown_items = get_default_dropdown_items()
+        
+        # Convert SiteDropdownItem objects to dictionaries for Unfold
+        return [item.to_dict() for item in dropdown_items]
+    
+    
+    def get_navigation_config(self) -> List[Dict[str, Any]]:
+        """Get complete default navigation configuration for Unfold sidebar."""
+        navigation_sections = [
+            NavigationSection(
+                title="Dashboard",
+                separator=True,
+                collapsible=True,
+                items=[
+                    NavigationItem(title="Overview", icon=Icons.DASHBOARD, link="/admin/"),
+                    NavigationItem(title="Settings", icon=Icons.SETTINGS, link="/admin/constance/config/"),
+                    NavigationItem(title="Health Check", icon=Icons.HEALTH_AND_SAFETY, link="/cfg/health/"),
+                ]
+            ),
+        ]
+        
+        # Add Accounts section if enabled
+        if self.is_accounts_enabled():
+            navigation_sections.append(NavigationSection(
+                title="Users & Access",
+                separator=True,
+                collapsible=True,
+                items=[
+                    NavigationItem(title="Users", icon=Icons.PEOPLE, link="/admin/django_cfg_accounts/customuser/"),
+                    NavigationItem(title="User Groups", icon=Icons.GROUP, link="/admin/auth/group/"),
+                    NavigationItem(title="Registration Sources", icon=Icons.LINK, link="/admin/django_cfg_accounts/registrationsource/"),
+                    NavigationItem(title="User Registration Sources", icon=Icons.PERSON, link="/admin/django_cfg_accounts/userregistrationsource/"),
+                ]
+            ))
+        
+        # Add Support section if enabled
+        if self.is_support_enabled():
+            navigation_sections.append(NavigationSection(
+                title="Support",
+                separator=True,
+                collapsible=True,
+                items=[
+                    NavigationItem(title="Tickets", icon=Icons.SUPPORT_AGENT, link="/admin/django_cfg_support/ticket/"),
+                    NavigationItem(title="Messages", icon=Icons.CHAT, link="/admin/django_cfg_support/message/"),
+                ]
+            ))
+        
+        # Add Newsletter section if enabled
+        if self.is_newsletter_enabled():
+            navigation_sections.append(NavigationSection(
+                title="Newsletter",
+                separator=True,
+                collapsible=True,
+                items=[
+                    NavigationItem(title="Newsletters", icon=Icons.EMAIL, link="/admin/django_cfg_newsletter/newsletter/"),
+                    NavigationItem(title="Subscriptions", icon=Icons.PERSON_ADD, link="/admin/django_cfg_newsletter/newslettersubscription/"),
+                    NavigationItem(title="Campaigns", icon=Icons.CAMPAIGN, link="/admin/django_cfg_newsletter/newslettercampaign/"),
+                    NavigationItem(title="Email Logs", icon=Icons.MAIL_OUTLINE, link="/admin/django_cfg_newsletter/emaillog/"),
+                ]
+            ))
+        
+        # Add Leads section if enabled
+        if self.is_leads_enabled():
+            navigation_sections.append(NavigationSection(
+                title="Leads",
+                separator=True,
+                collapsible=True,
+                items=[
+                    NavigationItem(title="Leads", icon=Icons.CONTACT_PAGE, link="/admin/django_cfg_leads/lead/"),
+                ]
+            ))
+        
+        # Add Agents section if enabled
+        if self.is_agents_enabled():
+            navigation_sections.append(NavigationSection(
+                title="AI Agents",
+                separator=True,
+                collapsible=True,
+                items=[
+                    NavigationItem(title="Agent Definitions", icon=Icons.SMART_TOY, link="/admin/django_cfg_agents/agentdefinition/"),
+                    NavigationItem(title="Agent Templates", icon=Icons.DESCRIPTION, link="/admin/django_cfg_agents/agenttemplate/"),
+                    NavigationItem(title="Agent Executions", icon=Icons.PLAY_ARROW, link="/admin/django_cfg_agents/agentexecution/"),
+                    NavigationItem(title="Workflow Executions", icon=Icons.AUTORENEW, link="/admin/django_cfg_agents/workflowexecution/"),
+                    NavigationItem(title="Tool Executions", icon=Icons.BUILD, link="/admin/django_cfg_agents/toolexecution/"),
+                    NavigationItem(title="Toolset Configurations", icon=Icons.SETTINGS, link="/admin/django_cfg_agents/toolsetconfiguration/"),
+                ]
+            ))
+        
+        # Add Knowledge Base section if enabled
+        if self.is_knowbase_enabled():
+            navigation_sections.append(NavigationSection(
+                title="Knowledge Base",
+                separator=True,
+                collapsible=True,
+                items=[
+                    NavigationItem(title="Document Categories", icon=Icons.FOLDER, link="/admin/django_cfg_knowbase/documentcategory/"),
+                    NavigationItem(title="Documents", icon=Icons.DESCRIPTION, link="/admin/django_cfg_knowbase/document/"),
+                    NavigationItem(title="Document Chunks", icon=Icons.TEXT_SNIPPET, link="/admin/django_cfg_knowbase/documentchunk/"),
+                    NavigationItem(title="External Data", icon=Icons.CLOUD_SYNC, link="/admin/django_cfg_knowbase/externaldata/"),
+                    NavigationItem(title="External Data Chunks", icon=Icons.AUTO_AWESOME_MOTION, link="/admin/django_cfg_knowbase/externaldatachunk/"),
+                    NavigationItem(title="Chat Sessions", icon=Icons.CHAT, link="/admin/django_cfg_knowbase/chatsession/"),
+                    NavigationItem(title="Chat Messages", icon=Icons.MESSAGE, link="/admin/django_cfg_knowbase/chatmessage/"),
+                ]
+            ))
+        
+        # Add Tasks section if knowbase or agents are enabled
+        if self.is_tasks_enabled():
+            navigation_sections.append(NavigationSection(
+                title="Background Tasks",
+                separator=True,
+                collapsible=True,
+                items=[
+                    NavigationItem(title="Task Queue", icon=Icons.QUEUE, link="/admin/django_dramatiq/task/"),
+                    NavigationItem(title="Task Dashboard", icon=Icons.SETTINGS_APPLICATIONS, link="/cfg/tasks/dashboard/"),
+                ]
+            ))
+        
+        # Convert all NavigationSection objects to dictionaries
+        return [section.to_dict() for section in navigation_sections]
+    
+    
+    def get_unfold_config(self) -> Dict[str, Any]:
+        """Get complete Unfold configuration based on working old version."""
+        return {
+            # Site branding and appearance
+            "SITE_TITLE": "Admin",
+            "SITE_HEADER": "Admin",
+            "SITE_SUBHEADER": "",
+            "SITE_URL": "/",
+            "SITE_SYMBOL": "dashboard",
+            
+            # UI visibility controls
+            "SHOW_HISTORY": True,
+            "SHOW_VIEW_ON_SITE": True,
+            "SHOW_BACK_BUTTON": False,
+            
+            # Dashboard callback
+            "DASHBOARD_CALLBACK": "api.dashboard.callbacks.main_dashboard_callback",
+            
+            # Theme configuration
+            "THEME": None,  # Auto-detect or force "dark"/"light"
+            
+            # Login page customization
+            "LOGIN": {
+                "redirect_after": lambda request: "/admin/",
+            },
+            
+            # Design system
+            "BORDER_RADIUS": "8px",
+            "COLORS": {
+                "base": {
+                    "50": "249, 250, 251",
+                    "100": "243, 244, 246",
+                    "200": "229, 231, 235",
+                    "300": "209, 213, 219",
+                    "400": "156, 163, 175",
+                    "500": "107, 114, 128",
+                    "600": "75, 85, 99",
+                    "700": "55, 65, 81",
+                    "800": "31, 41, 55",
+                    "900": "17, 24, 39",
+                    "950": "3, 7, 18",
+                },
+                "primary": {
+                    "50": "239, 246, 255",
+                    "100": "219, 234, 254",
+                    "200": "191, 219, 254",
+                    "300": "147, 197, 253",
+                    "400": "96, 165, 250",
+                    "500": "59, 130, 246",
+                    "600": "37, 99, 235",
+                    "700": "29, 78, 216",
+                    "800": "30, 64, 175",
+                    "900": "30, 58, 138",
+                    "950": "23, 37, 84",
+                },
+                "font": {
+                    "subtle-light": "var(--color-base-500)",
+                    "subtle-dark": "var(--color-base-400)",
+                    "default-light": "var(--color-base-600)",
+                    "default-dark": "var(--color-base-300)",
+                    "important-light": "var(--color-base-900)",
+                    "important-dark": "var(--color-base-100)",
+                },
+            },
+            
+            # Sidebar navigation - KEY STRUCTURE!
+            "SIDEBAR": {
+                "show_search": True,
+                "command_search": True,
+                "show_all_applications": True,
+                "navigation": self.get_navigation_config(),
+            },
+            
+            # Site dropdown menu - handled by config.py to allow extending
+            # "SITE_DROPDOWN": self._get_default_dropdown_items(),
+            
+            # Command interface
+            "COMMAND": {
+                "search_models": True,
+                "show_history": True,
+            },
+            
+            # Multi-language support - DISABLED
+            "SHOW_LANGUAGES": False,
+        }
+    
+    def get_widgets_config(self) -> List[Dict[str, Any]]:
+        """Get dashboard widgets configuration using Pydantic models."""
+        # Create system overview widget with StatCard models
+        system_overview_widget = StatsCardsWidget(
+            title="System Overview",
+            cards=[
+                StatCard(
+                    title="CPU Usage",
+                    value="{{ cpu_percent }}%",
+                    icon=Icons.MEMORY,
+                    color="blue",
+                ),
+                StatCard(
+                    title="Memory Usage",
+                    value="{{ memory_percent }}%",
+                    icon=Icons.STORAGE,
+                    color="green",
+                ),
+                StatCard(
+                    title="Disk Usage",
+                    value="{{ disk_percent }}%",
+                    icon=Icons.FOLDER,
+                    color="orange",
+                ),
+            ]
+        )
+        
+        # Convert to dictionaries for Unfold
+        return [system_overview_widget.to_dict()]
+
+
+# Lazy initialization to avoid circular imports
+_dashboard_manager = None
+
+def get_dashboard_manager() -> DashboardManager:
+    """Get the global dashboard manager instance."""
+    global _dashboard_manager
+    if _dashboard_manager is None:
+        _dashboard_manager = DashboardManager()
+    return _dashboard_manager

django_cfg/modules/django_unfold/icons/README.md

@@ -0,0 +1,145 @@
+# Material Icons for Django CFG Unfold
+
+This module provides Material Design Icons integration for Django CFG Unfold admin interface.
+
+## 📊 Statistics
+
+- **Total Icons**: 2234
+- **Categories**: 24
+- **Auto-generated**: Yes (via `generate_icons.py`)
+
+## 🚀 Usage
+
+### Basic Usage
+
+```python
+from django_cfg.modules.django_unfold.icons import Icons
+
+# Use in navigation configuration
+navigation_item = {
+    "title": "Dashboard",
+    "icon": Icons.DASHBOARD,  # IDE autocompletion!
+    "link": "/admin/",
+}
+```
+
+### Category-based Selection
+
+```python
+from django_cfg.modules.django_unfold.icons import IconCategories
+
+# Get all navigation-related icons
+nav_icons = IconCategories.NAVIGATION
+
+# Get all user-related icons  
+user_icons = IconCategories.USERS
+```
+
+### Validation
+
+```python
+from django_cfg.modules.django_unfold.icons import validate_icon_constant
+
+# Validate icon exists
+is_valid = validate_icon_constant(Icons.DASHBOARD)  # True
+is_valid = validate_icon_constant("nonexistent")    # False
+```
+
+## 🔄 Updating Icons
+
+To update to the latest Material Icons:
+
+```bash
+cd /path/to/django-cfg/src/django_cfg/modules/django_unfold/icons/
+python generate_icons.py
+```
+
+This will:
+1. Download the latest Material Icons from Google
+2. Generate new `constants.py` with all icons
+3. Categorize icons for easy discovery
+4. Provide IDE-friendly autocompletion
+
+## 📂 File Structure
+
+```
+icons/
+├── __init__.py              # Main exports
+├── constants.py             # 🤖 Auto-generated icon constants
+├── icons.py                 # MaterialIcons class & validation
+├── icon_validator.py        # Navigation validation utilities
+├── generate_icons.py        # 🔄 Icon generator script
+├── example_usage.py         # Usage examples
+└── README.md               # This file
+```
+
+## 🎯 Available Categories
+
+- **Navigation** (124 icons): add_home, add_home_work, add_home_work, add_to_home_screen, app_settings_alt, ... (+119 more)
+- **Users** (54 icons): account_balance, account_balance_wallet, account_box, account_circle, account_tree, ... (+49 more)
+- **Documents** (70 icons): article, attach_file, audio_file, contact_page, create_new_folder, ... (+65 more)
+- **Communication** (174 icons): 3p, add_call, add_comment, add_ic_call, add_ic_call, ... (+169 more)
+- **Ai_Automation** (39 icons): auto_awesome, auto_awesome_mosaic, auto_awesome_motion, auto_delete, auto_fix_high, ... (+34 more)
+- **Actions** (124 icons): add, add_a_photo, add_alarm, add_alert, add_box, ... (+119 more)
+- **Status** (36 icons): check, check_box, check_box_outline_blank, check_circle, check_circle_outline, ... (+31 more)
+- **Media** (82 icons): assistant_photo, audiotrack, bluetooth_audio, broken_image, camera, ... (+77 more)
+- **Settings** (26 icons): admin_panel_settings, app_settings_alt, build, build_circle, construction, ... (+21 more)
+- **Commerce** (18 icons): attach_money, local_convenience_store, local_grocery_store, money, money_off, ... (+13 more)
+- **Travel** (61 icons): car_crash, car_rental, car_repair, card_giftcard, card_membership, ... (+56 more)
+- **Social** (214 icons): 18_up_rating, 6_ft_apart, add_moderator, add_reaction, architecture, ... (+209 more)
+- **Device** (217 icons): 1x_mobiledata, 30fps, 3g_mobiledata, 4g_mobiledata, 4g_plus_mobiledata, ... (+212 more)
+- **Editor** (162 icons): add_chart, add_comment, align_horizontal_center, align_horizontal_center, align_horizontal_left, ... (+157 more)
+- **Maps** (228 icons): 360, add_business, add_location, add_location_alt, add_road, ... (+223 more)
+- **Notification** (83 icons): account_tree, adb, airline_seat_flat, airline_seat_flat_angled, airline_seat_individual_suite, ... (+78 more)
+- **Content** (105 icons): 30fps_select, 60fps_select, add, add_box, add_circle, ... (+100 more)
+- **Hardware** (128 icons): adf_scanner, battery_0_bar, battery_1_bar, battery_2_bar, battery_3_bar, ... (+123 more)
+- **Image** (286 icons): 10mp, 11mp, 12mp, 13mp, 14mp, ... (+281 more)
+- **Av** (125 icons): 10k, 1k, 1k_plus, 2k, 2k_plus, ... (+120 more)
+- **Places** (99 icons): ac_unit, airport_shuttle, all_inclusive, apartment, assured_workload, ... (+94 more)
+- **File** (54 icons): approval, archive, attach_email, attachment, attachment, ... (+49 more)
+- **Toggle** (193 icons): 3d_rotation, airplanemode_off, airplanemode_on, alarm_off, alarm_on, ... (+188 more)
+- **Other** (1138 icons): 10k, 10mp, 11mp, 123, 12mp, ... (+1133 more)
+
+## 🛠️ Development
+
+### Adding New Categories
+
+Edit the `category_keywords` in `generate_icons.py`:
+
+```python
+category_keywords = {
+    'my_category': ['keyword1', 'keyword2', 'keyword3'],
+    # ...
+}
+```
+
+### Custom Icon Validation
+
+```python
+from django_cfg.modules.django_unfold.icons import MaterialIcons
+
+# Check if icon exists
+if MaterialIcons.is_valid_icon('my_icon'):
+    print("Icon exists!")
+
+# Get suggestions for invalid icons
+suggestions = MaterialIcons.suggest_similar_icons('invalid_icon')
+print(f"Did you mean: {suggestions}")
+```
+
+## 📋 Icon Guidelines
+
+1. **Use Constants**: Always use `Icons.CONSTANT_NAME` instead of strings
+2. **Validate**: Use validation functions to check icon existence
+3. **Categories**: Browse `IconCategories` for organized icon selection
+4. **Update Regularly**: Run the generator script to get latest icons
+
+## 🔗 Resources
+
+- [Material Design Icons](https://fonts.google.com/icons)
+- [Google Material Icons GitHub](https://github.com/google/material-design-icons)
+- [Django Unfold Documentation](https://unfoldadmin.com/)
+
+---
+
+*This file is auto-generated. Last updated: 2025-09-21 01:14:22*

django_cfg/modules/django_unfold/icons/__init__.py

@@ -0,0 +1,12 @@
+"""
+Material Icons for Django CFG Unfold.
+
+Provides IDE-friendly Material Design Icons constants.
+"""
+
+from .constants import Icons, IconCategories
+
+__all__ = [
+    'Icons',
+    'IconCategories',
+]