django-cfg 1.4.11__py3-none-any.whl → 1.4.14__py3-none-any.whl

django_cfg/dashboard/DEBUG_README.md

@@ -1,105 +0,0 @@
-# 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

@@ -1,237 +0,0 @@
-# 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/
-```