django-cfg 1.3.13__py3-none-any.whl → 1.4.3__py3-none-any.whl

django_cfg/core/types/__init__.py

@@ -0,0 +1,15 @@
+"""Core type definitions for django-cfg."""
+
+from .enums import EnvironmentMode, StartupInfoMode
+from .aliases import EnvironmentString, DatabaseAlias, AppLabel, MiddlewareLabel, UrlPath, UrlPattern
+
+__all__ = [
+    "EnvironmentMode",
+    "StartupInfoMode",
+    "EnvironmentString",
+    "DatabaseAlias",
+    "AppLabel",
+    "MiddlewareLabel",
+    "UrlPath",
+    "UrlPattern",
+]

django_cfg/core/types/aliases.py

@@ -0,0 +1,15 @@
+"""Type aliases for common patterns."""
+
+from typing import Literal
+
+# Environment types
+EnvironmentString = Literal["development", "production", "test"]
+
+# Django types
+DatabaseAlias = str
+AppLabel = str
+MiddlewareLabel = str
+
+# URL types
+UrlPath = str
+UrlPattern = str

django_cfg/core/types/enums.py

@@ -0,0 +1,49 @@
+"""Core enumerations for django-cfg."""
+
+from enum import Enum
+
+
+class EnvironmentMode(str, Enum):
+    """Environment mode enumeration."""
+
+    DEVELOPMENT = "development"
+    PRODUCTION = "production"
+    TEST = "test"
+
+    @classmethod
+    def from_debug(cls, debug: bool) -> "EnvironmentMode":
+        """
+        Get environment mode from debug flag.
+
+        Args:
+            debug: Debug mode flag
+
+        Returns:
+            DEVELOPMENT if debug=True, PRODUCTION otherwise
+        """
+        return cls.DEVELOPMENT if debug else cls.PRODUCTION
+
+    @classmethod
+    def is_valid(cls, value: str) -> bool:
+        """
+        Check if value is a valid environment mode.
+
+        Args:
+            value: Value to check
+
+        Returns:
+            True if valid, False otherwise
+        """
+        return value in [mode.value for mode in cls]
+
+
+class StartupInfoMode(str, Enum):
+    """Startup information display mode."""
+
+    NONE = "none"
+    SHORT = "short"
+    FULL = "full"
+
+    def should_display(self) -> bool:
+        """Check if should display startup info."""
+        return self != self.NONE

django_cfg/dashboard/DEBUG_README.md

@@ -0,0 +1,105 @@
+# Dashboard Debug Tool
+
+Инструмент для отладки рендеринга dashboard секций.
+
+## Использование
+
+### 1. Management Command
+
+Запустить из командной строки для тестирования рендера:
+
+```bash
+# Рендер всех секций
+python manage.py debug_dashboard
+
+# Рендер конкретной секции
+python manage.py debug_dashboard --section overview
+python manage.py debug_dashboard --section stats
+
+# Указать пользователя
+python manage.py debug_dashboard --user admin
+```
+
+### 2. Автоматическое сохранение
+
+При каждом рендере dashboard секции автоматически сохраняются в:
+```
+libs/django_cfg/src/django_cfg/debug/dashboard/
+```
+
+Файлы:
+- `section_overview_YYYYMMDD_HHMMSS.html` - отрендеренный HTML
+- `section_overview_YYYYMMDD_HHMMSS_context.json` - контекст шаблона
+- `section_overview_YYYYMMDD_HHMMSS_meta.json` - метаданные
+
+**Важно**: Директория `debug/` добавлена в `.gitignore` и не попадает в git.
+
+### 3. Программное использование
+
+```python
+from django_cfg.dashboard.debug import save_section_render
+
+# В коде секции
+html = section.render()
+save_section_render('my_section', html, section_data={'key': 'value'})
+```
+
+## Структура
+
+```
+dashboard/
+├── debug.py              # DashboardDebugger класс
+├── sections/             # Секции dashboard
+│   ├── overview.py       # Overview секция
+│   ├── stats.py          # Stats секция
+│   ├── system.py         # System секция
+│   └── commands.py       # Commands секция
+└── management/
+    └── commands/
+        └── debug_dashboard.py  # Management command
+```
+
+## Сравнение с архивом
+
+```python
+from django_cfg.dashboard.debug import get_debugger
+from pathlib import Path
+
+debugger = get_debugger()
+archive = Path('@archieves/now/dashboard.html')
+
+comparison = debugger.compare_with_archive(current_html, archive)
+print(comparison)
+```
+
+## Debugging workflow
+
+1. Запустить `python manage.py debug_dashboard`
+2. Проверить `@archieves/debug/renders/`
+3. Сравнить с `@archieves/now/dashboard.html`
+4. Проверить context.json для диагностики данных
+5. Исправить проблемы в секциях/шаблонах
+6. Повторить
+
+## Примеры проблем
+
+### Пустой вывод данных
+Проверить в `_context.json`:
+- Наличие ключа `data`
+- Структуру данных (`data.stats`, `data.system_health`)
+- Значения (не None, не пустые)
+
+### Template не найден
+```
+TemplateDoesNotExist: admin/sections/overview_section.html
+```
+Проверить:
+- Путь к шаблону в `section.template_name`
+- Наличие файла в `templates/admin/sections/`
+- Правильность extends/include
+
+### Ошибки импорта
+Проверить:
+- Наличие всех зависимостей
+- Правильность импортов в секциях
+- Доступность моделей/конфигов

django_cfg/dashboard/REFACTORING_SUMMARY.md

@@ -0,0 +1,237 @@
+# Dashboard Refactoring Summary
+
+## Проблема
+
+После рефакторинга dashboard секции данные отображаются не полностью:
+- Отсутствуют Quick Actions
+- Отсутствует Charts Section
+- Отсутствуют System Metrics
+- Отсутствует Activity Tracker
+- По умолчанию открывается таб "API Zones" вместо "Overview"
+
+## Анализ
+
+### Старая структура (`@archieves/django_cfg/templates`)
+```
+admin/
+├── layouts/
+│   └── dashboard_with_tabs.html    # Layout с табами и JavaScript
+└── snippets/
+    ├── tabs/
+    │   └── overview_tab.html        # Полный overview с includes
+    └── components/
+        ├── stats_cards.html
+        ├── quick_actions.html
+        ├── charts_section.html
+        ├── recent_activity.html
+        ├── system_health.html
+        ├── system_metrics.html
+        └── activity_tracker.html
+```
+
+### Новая структура (после рефакторинга)
+```
+django_cfg/
+├── dashboard/
+│   ├── sections/
+│   │   ├── base.py                  # Базовые классы секций
+│   │   ├── overview.py              # Overview секция (УПРОЩЕННАЯ!)
+│   │   ├── stats.py
+│   │   ├── system.py
+│   │   └── commands.py
+│   ├── debug.py                     # Инструмент отладки
+│   └── management/commands/
+│       └── debug_dashboard.py       # Management command
+└── templates/admin/
+    ├── index.html                   # Использует новые секции
+    └── sections/
+        ├── overview_section.html    # Шаблон overview (УПРОЩЕННЫЙ!)
+        └── ...
+```
+
+## Решение
+
+### 1. Debug инструмент ✅
+Создан инструмент для отладки рендеринга:
+```bash
+python manage.py debug_dashboard
+```
+
+Сохраняет рендеры в `@archieves/debug/renders/`:
+- `section_overview_YYYYMMDD_HHMMSS.html`
+- `section_overview_YYYYMMDD_HHMMSS_context.json`
+- `section_overview_YYYYMMDD_HHMMSS_meta.json`
+
+### 2. Автоматическое сохранение рендеров ✅
+При каждом рендере секции автоматически сохраняются через:
+```python
+from django_cfg.dashboard.debug import save_section_render
+
+save_section_render('overview', html)
+```
+
+### 3. Восстановление недостающих компонентов ✅
+Обновлен `overview_section.html` чтобы включать:
+- ✅ Quick Actions (через include)
+- ✅ Charts Section (через include)
+- ✅ Recent Activity (через include)
+- ✅ System Metrics (через include)
+- ✅ Activity Tracker (через include)
+
+### 4. Исправление активного таба
+**Проблема**: По умолчанию активен таб "API Zones" (data-tab="1")
+**Причина**: JavaScript использует URL hash или сохраненное состояние
+
+**Решение**:
+- JavaScript корректно активирует первый таб при загрузке
+- Проблема возникает только если сохранить страницу с активным другим табом
+
+## Архитектура
+
+### Старый подход
+```django
+{% extends 'admin/layouts/dashboard_with_tabs.html' %}
+
+{% block overview_tab %}
+    {% include 'admin/snippets/tabs/overview_tab.html' %}
+{% endblock %}
+```
+
+**Плюсы:**
+- Простая структура
+- Все компоненты в templates
+
+**Минусы:**
+- Нет разделения логики и представления
+- Нет типизации данных
+- Сложно тестировать
+
+### Новый подход
+```python
+class OverviewSection(DataSection):
+    template_name = "admin/sections/overview_section.html"
+
+    def get_data(self):
+        return {
+            'stats': self.get_key_stats(),
+            'system_health': self.get_system_health(),
+        }
+```
+
+**Плюсы:**
+- Разделение логики и представления
+- Типизация данных
+- Легко тестировать
+- Переиспользуемые компоненты
+
+**Минусы:**
+- Более сложная структура
+- Нужно поддерживать совместимость со старыми компонентами
+
+## Рекомендации
+
+### Краткосрочные
+1. ✅ Восстановить все компоненты в overview секции
+2. ⏳ Проверить остальные секции (stats, system, commands)
+3. ⏳ Добавить тесты для секций
+
+### Долгосрочные
+1. Создать templatetags для упрощения:
+   ```django
+   {% render_section 'overview' %}
+   {% render_card stats %}
+   ```
+
+2. Унифицировать компоненты:
+   - Переписать старые snippets как Python классы
+   - Единый стиль для всех секций
+
+3. Добавить конфигурацию:
+   ```python
+   DJANGO_CFG_DASHBOARD = {
+       'sections': ['overview', 'stats', 'system'],
+       'default_tab': 0,
+   }
+   ```
+
+## Миграция со старой версии
+
+### Вариант 1: Использовать новые секции (текущий)
+```django
+{% extends 'admin/layouts/dashboard_with_tabs.html' %}
+
+{% block overview_tab %}
+    {% if overview_section %}
+        {{ overview_section|safe }}
+    {% else %}
+        {% include 'admin/snippets/tabs/overview_tab.html' %}
+    {% endif %}
+{% endblock %}
+```
+
+### Вариант 2: Вернуться к старым includes
+```django
+{% extends 'admin/layouts/dashboard_with_tabs.html' %}
+
+{% block overview_tab %}
+    {% include 'admin/snippets/tabs/overview_tab.html' %}
+{% endblock %}
+```
+
+### Вариант 3: Гибридный подход (рекомендуется)
+```django
+{% block overview_tab %}
+    {% if use_new_sections %}
+        {{ overview_section|safe }}
+    {% else %}
+        {% include 'admin/snippets/tabs/overview_tab.html' %}
+    {% endif %}
+{% endblock %}
+```
+
+## Файлы
+
+### Изменены
+- `modules/django_unfold/callbacks/main.py` - добавлен рендер секций с debug
+- `templates/admin/index.html` - использует новые секции
+- `templates/admin/sections/overview_section.html` - восстановлены компоненты
+
+### Добавлены
+- `dashboard/` - новая директория с секциями
+  - `sections/` - классы секций
+  - `debug.py` - отладочный инструмент
+  - `management/commands/debug_dashboard.py` - management command
+  - `DEBUG_README.md` - документация
+  - `REFACTORING_SUMMARY.md` - этот файл
+
+### Архив
+- `@archieves/django_cfg/templates/` - старые шаблоны
+- `@archieves/now/dashboard.html` - последний рендер до исправлений
+- `@archieves/debug/renders/` - сохраненные рендеры для отладки
+
+## Команды
+
+### Отладка
+```bash
+# Рендер всех секций
+python manage.py debug_dashboard
+
+# Рендер конкретной секции
+python manage.py debug_dashboard --section overview
+
+# Сравнение с архивом
+diff @archieves/now/dashboard.html @archieves/debug/renders/section_overview_*.html
+```
+
+### Git
+```bash
+# Статус изменений
+git status libs/django_cfg/src/django_cfg
+
+# Diff изменений
+git diff libs/django_cfg/src/django_cfg
+
+# Добавить новые файлы
+git add libs/django_cfg/src/django_cfg/dashboard/
+git add libs/django_cfg/src/django_cfg/templates/admin/sections/
+```

django_cfg/dashboard/__init__.py

@@ -0,0 +1,24 @@
+"""
+Django CFG Dashboard Module.
+
+Section-based architecture for dashboard rendering.
+Inspired by Unfold's clean component approach.
+"""
+
+from .sections.base import DashboardSection
+from .sections.overview import OverviewSection
+from .sections.stats import StatsSection
+from .sections.system import SystemSection
+from .sections.commands import CommandsSection
+
+# Import components to register them with Unfold
+# The @register_component decorator runs on import
+from . import components  # noqa: F401
+
+__all__ = [
+    'DashboardSection',
+    'OverviewSection',
+    'StatsSection',
+    'SystemSection',
+    'CommandsSection',
+]