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

django_cfg/modules/django_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.modules.django_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.modules.django_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/modules/django_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.modules.django_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/modules/django_drf_theme/CHANGELOG.md

@@ -1,210 +0,0 @@
-# Changelog
-
-All notable changes to the Django DRF Tailwind Theme module will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.0.0] - 2025-01-XX
-
-### 🎉 Initial Release
-
-First production-ready release of the modern Tailwind CSS theme for Django REST Framework Browsable API.
-
-### ✨ Added
-
-#### Design & UI
-- Glass morphism design with backdrop-blur effects
-- Responsive mobile-first layout
-- Custom styled scrollbars
-- Smooth CSS transitions (200ms cubic-bezier)
-- Gradient color schemes (blue → purple)
-- HTTP method badges with color coding
-- Status code badges (success/error/warning)
-
-#### Theme System
-- Three-mode theme system (Light/Dark/Auto)
-- System preference detection and auto-switching
-- Cookie-based theme persistence
-- Smooth theme transitions
-- Theme dropdown in navbar
-
-#### Power User Features
-- **Command Palette** (⌘K) with quick actions:
-  - Copy current URL
-  - Toggle theme
-  - Show keyboard shortcuts
-- **Keyboard Shortcuts**:
-  - `⌘K` / `Ctrl+K` - Open command palette
-  - `⌘D` / `Ctrl+D` - Toggle theme
-  - `⌘C` / `Ctrl+C` - Copy URL
-  - `?` - Show shortcuts help
-  - `Esc` - Close dialogs
-- Toast notification system with auto-dismiss
-- One-click copy for JSON and URLs
-
-#### Response Viewer
-- Tabbed interface (Pretty/Raw/Headers)
-- Syntax highlighting with Prism.js
-- Copy button for JSON content
-- Collapsible JSON tree view
-- Character count for responses
-- Empty state placeholder
-
-#### Request Forms
-- Content type selector (JSON/Form Data/Multipart/Text)
-- JSON formatting and validation
-- Character counter for request body
-- Quick templates (empty object/array)
-- Additional headers support
-- Method selector (GET/POST/PUT/PATCH/DELETE)
-- Delete confirmation dialog
-
-#### Filters & Search
-- Smart field type detection
-- Active filters summary
-- One-click clear buttons
-- Help text tooltips
-- Filter persistence in URL
-
-#### Pagination
-- Clean pagination controls
-- Result count display
-- Previous/Next navigation
-
-#### Technical
-- Alpine.js v3 for reactivity (replaces jQuery)
-- Prism.js v1.29 for syntax highlighting
-- Tailwind CSS v4 integration
-- Template fallback mechanism
-- Full DRF compatibility
-- Extends `BrowsableAPIRenderer`
-
-### 🔧 Configuration
-
-- Added `enable_drf_tailwind` field to `DjangoConfig` (default: `True`)
-- Added `renderer_classes` field to `DRFConfig`
-- Auto-registration in `INSTALLED_APPS` via `InstalledAppsBuilder`
-- Zero-configuration setup (works out of the box)
-
-### 📊 Performance
-
-- **88% bundle size reduction** (278 KB → 33 KB)
-  - CSS: 139 KB → 15 KB (89% reduction)
-  - JS: 139 KB → 18 KB (87% reduction)
-- **+23 Lighthouse score improvement** (72 → 95)
-- **66% faster First Contentful Paint** (3.2s → 1.1s)
-
-### 📚 Documentation
-
-- Complete README.md with features and usage
-- EXAMPLE.md with code examples
-- IMPLEMENTATION.md with technical details
-- Inline code documentation
-- Keyboard shortcuts help
-
-### 🎯 Browser Support
-
-- Chrome/Edge 90+
-- Firefox 88+
-- Safari 14+
-- iOS Safari 14+
-- Chrome Mobile 90+
-
-### 🔒 Security
-
-- No external JavaScript dependencies (CDN only for Alpine.js and Prism.js)
-- CSRF token handling
-- XSS protection via Django templating
-- Secure cookie handling for theme preference
-
----
-
-## [Unreleased]
-
-### 🚀 Planned Features
-
-#### Priority 2 (Next Release)
-- [ ] Pagination template (`pagination/numbers.html`)
-- [ ] Standalone JSON viewer component
-- [ ] Search functionality in command palette
-- [ ] LocalStorage theme persistence (in addition to cookies)
-- [ ] Export/download JSON functionality
-- [ ] Response time display
-- [ ] Request history
-
-#### Priority 3 (Future)
-- [ ] Unit tests with pytest
-- [ ] Integration tests
-- [ ] Visual regression tests (Playwright)
-- [ ] Accessibility audit (WCAG 2.1 AA compliance)
-- [ ] I18n support (multiple languages)
-- [ ] Custom color scheme configurator
-- [ ] Printable response view
-- [ ] API request bookmarks
-
-### 🐛 Known Issues
-
-None currently. Please report issues at [GitHub Issues](https://github.com/your-org/django-cfg/issues).
-
----
-
-## Version History
-
-### [1.0.0] - 2025-01-XX
-- Initial production release
-
----
-
-## Migration Guide
-
-### From Bootstrap 3 (Standard DRF)
-
-No migration needed! The Tailwind theme is enabled by default and fully backward compatible.
-
-**To keep Bootstrap theme:**
-```python
-class MyConfig(DjangoConfig):
-    enable_drf_tailwind: bool = False
-```
-
-**To use both:**
-```python
-drf: DRFConfig = DRFConfig(
-    renderer_classes=[
-        'rest_framework.renderers.JSONRenderer',
-        'django_cfg.modules.django_drf_theme.renderers.TailwindBrowsableAPIRenderer',
-        'rest_framework.renderers.BrowsableAPIRenderer',  # Bootstrap fallback
-    ]
-)
-```
-
-### Template Customization
-
-If you had custom DRF templates:
-
-**Old location:**
-```
-your_app/templates/rest_framework/api.html
-```
-
-**New location for Tailwind:**
-```
-your_app/templates/rest_framework/tailwind/api.html
-```
-
-Templates automatically fall back to standard DRF templates if not found.
-
----
-
-## Credits
-
-- **Design Inspiration**: VS Code, Raycast, Linear, Vercel
-- **Technologies**: Django REST Framework, Tailwind CSS, Alpine.js, Prism.js
-- **Built for**: django-cfg package
-
----
-
-## License
-
-Part of django-cfg. See main LICENSE file.