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

django_cfg/modules/django_unfold/__init__.py

@@ -0,0 +1,69 @@
+"""
+Django CFG Unfold Module
+
+Provides complete Unfold admin interface integration with dashboard,
+navigation, theming, and callback support.
+"""
+
+from .dashboard import DashboardManager, get_dashboard_manager
+from .callbacks import UnfoldCallbacks
+from .system_monitor import SystemMonitor
+from .tailwind import get_unfold_colors, get_css_variables
+from .models import *
+
+# Lazy initialization functions to avoid circular imports
+def get_system_monitor() -> SystemMonitor:
+    """Get the global system monitor instance."""
+    global _system_monitor
+    if '_system_monitor' not in globals():
+        globals()['_system_monitor'] = SystemMonitor()
+    return globals()['_system_monitor']
+
+def get_unfold_callbacks() -> UnfoldCallbacks:
+    """Get the global unfold callbacks instance."""
+    global _unfold_callbacks
+    if '_unfold_callbacks' not in globals():
+        globals()['_unfold_callbacks'] = UnfoldCallbacks()
+    return globals()['_unfold_callbacks']
+
+# Export main components
+__all__ = [
+    'DashboardManager',
+    'get_dashboard_manager',
+    'UnfoldCallbacks', 
+    'get_unfold_callbacks',
+    'SystemMonitor',
+    'get_system_monitor',
+    'get_unfold_colors',
+    'get_css_variables',
+    # Models
+    'UnfoldConfig',
+    'UnfoldTheme', 
+    'UnfoldColors',
+    'UnfoldSidebar',
+    'UnfoldThemeConfig',
+    'UnfoldDashboardConfig',
+    'NavigationItem',
+    'NavigationSection',
+    'NavigationItemType',
+    'SiteDropdownItem',
+    'StatCard',
+    'SystemHealthItem',
+    'QuickAction',
+    'DashboardWidget',
+    'DashboardData',
+    'ChartDataset',
+    'ChartData',
+    'TabConfiguration',
+    'TabItem',
+]
+
+# Version info
+__version__ = '1.0.0'
+__author__ = 'Django CFG Team'
+__email__ = 'team@djangocfg.com'
+
+# Module metadata
+__title__ = 'Django CFG Unfold'
+__description__ = 'Complete Unfold admin interface integration'
+__url__ = 'https://github.com/djangocfg/django-cfg'

django_cfg/modules/{unfold → django_unfold}/callbacks.py

@@ -21,8 +21,9 @@ from django.db import connection
 from django.core.cache import cache
 from django.apps import apps
 
-from ..base import BaseModule
-from .models import DashboardData, StatCard, SystemHealthItem, QuickAction
+from ..base import BaseCfgModule
+from .models.dashboard import DashboardData, StatCard, SystemHealthItem, QuickAction
+from .icons import Icons
 
 logger = logging.getLogger(__name__)
 
@@ -119,7 +120,7 @@ def get_user_admin_urls():
         }
 
 
-class UnfoldCallbacks(BaseModule):
+class UnfoldCallbacks(BaseCfgModule):
     """
     Base Unfold dashboard callbacks with full system monitoring.
     
@@ -148,7 +149,7 @@ class UnfoldCallbacks(BaseModule):
                 StatCard(
                     title="Total Users",
                     value=f"{total_users:,}",
-                    icon="people",
+                    icon=Icons.PEOPLE,
                     change=f"+{new_users_7d}" if new_users_7d > 0 else None,
                     change_type="positive" if new_users_7d > 0 else "neutral",
                     description="Registered users",
@@ -156,7 +157,7 @@ class UnfoldCallbacks(BaseModule):
                 StatCard(
                     title="Active Users",
                     value=f"{active_users:,}",
-                    icon="person",
+                    icon=Icons.PERSON,
                     change=(
                         f"{(active_users/total_users*100):.1f}%"
                         if total_users > 0
@@ -170,14 +171,14 @@ class UnfoldCallbacks(BaseModule):
                 StatCard(
                     title="New This Week",
                     value=f"{new_users_7d:,}",
-                    icon="person_add",
+                    icon=Icons.PERSON_ADD,
                     change_type="positive" if new_users_7d > 0 else "neutral",
                     description="Last 7 days",
                 ),
                 StatCard(
                     title="Staff Members",
                     value=f"{staff_users:,}",
-                    icon="admin_panel_settings",
+                    icon=Icons.ADMIN_PANEL_SETTINGS,
                     change=(
                         f"{(staff_users/total_users*100):.1f}%" if total_users > 0 else "0%"
                     ),
@@ -191,7 +192,7 @@ class UnfoldCallbacks(BaseModule):
                 StatCard(
                     title="Users",
                     value="N/A",
-                    icon="people",
+                    icon=Icons.PEOPLE,
                     description="Data unavailable",
                 )
             ]
@@ -316,7 +317,7 @@ class UnfoldCallbacks(BaseModule):
             QuickAction(
                 title="Add User",
                 description="Create new user account",
-                icon="person_add",
+                icon=Icons.PERSON_ADD,
                 link=user_admin_urls["add"],
                 color="primary",
                 category="admin",
@@ -324,16 +325,16 @@ class UnfoldCallbacks(BaseModule):
             QuickAction(
                 title="Support Tickets",
                 description="Manage support tickets",
-                icon="support_agent",
+                icon=Icons.SUPPORT_AGENT,
                 link="admin:django_cfg_support_ticket_changelist",
-                color="info",
+                color="primary",
                 category="support",
             ),
             QuickAction(
                 title="Health Check",
                 description="System health status",
-                icon="health_and_safety",
-                link="django_cfg_health",
+                icon=Icons.HEALTH_AND_SAFETY,
+                link="/cfg/health/",
                 color="success",
                 category="system",
             ),
@@ -382,7 +383,7 @@ class UnfoldCallbacks(BaseModule):
                 StatCard(
                     title="Total Tickets",
                     value=f"{total_tickets:,}",
-                    icon="support_agent",
+                    icon=Icons.SUPPORT_AGENT,
                     change=f"+{new_tickets_7d}" if new_tickets_7d > 0 else None,
                     change_type="positive" if new_tickets_7d > 0 else "neutral",
                     description="All support tickets",
@@ -390,7 +391,7 @@ class UnfoldCallbacks(BaseModule):
                 StatCard(
                     title="Open Tickets",
                     value=f"{open_tickets:,}",
-                    icon="pending",
+                    icon=Icons.PENDING,
                     change=(
                         f"{(open_tickets/total_tickets*100):.1f}%"
                         if total_tickets > 0
@@ -406,7 +407,7 @@ class UnfoldCallbacks(BaseModule):
                 StatCard(
                     title="Resolved",
                     value=f"{resolved_tickets:,}",
-                    icon="check_circle",
+                    icon=Icons.CHECK_CIRCLE,
                     change=(
                         f"{(resolved_tickets/total_tickets*100):.1f}%"
                         if total_tickets > 0
@@ -418,7 +419,7 @@ class UnfoldCallbacks(BaseModule):
                 StatCard(
                     title="New This Week",
                     value=f"{new_tickets_7d:,}",
-                    icon="new_releases",
+                    icon=Icons.NEW_RELEASES,
                     change_type="positive" if new_tickets_7d > 0 else "neutral",
                     description="Last 7 days",
                 ),
@@ -429,7 +430,7 @@ class UnfoldCallbacks(BaseModule):
                 StatCard(
                     title="Support",
                     value="N/A",
-                    icon="support_agent",
+                    icon=Icons.SUPPORT_AGENT,
                     description="Data unavailable",
                 )
             ]
@@ -707,14 +708,14 @@ class UnfoldCallbacks(BaseModule):
                 environment=getattr(settings, "ENVIRONMENT", "development"),
             )
 
-            # Convert to template context (keeping Pydantic validation)
-            cards_data = [card.model_dump() for card in dashboard_data.stat_cards]
+            # Convert to template context (using to_dict for Unfold compatibility)
+            cards_data = [card.to_dict() for card in dashboard_data.stat_cards]
 
             context.update({
                 # Statistics cards
                 "cards": cards_data,
-                "user_stats": [card.model_dump() for card in user_stats],
-                "support_stats": [card.model_dump() for card in support_stats],
+                "user_stats": [card.to_dict() for card in user_stats],
+                "support_stats": [card.to_dict() for card in support_stats],
                 # System health (convert to dict for template)
                 "system_health": {
                     item.component + "_status": item.status

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',
+]