django-cfg 1.4.117__py3-none-any.whl → 1.4.118__py3-none-any.whl

django_cfg/__init__.py

@@ -32,7 +32,7 @@ Example:
 default_app_config = "django_cfg.apps.DjangoCfgConfig"
 
 # Version information
-__version__ = "1.4.117"
+__version__ = "1.4.118"
 __license__ = "MIT"
 
 # Import registry for organized lazy loading

django_cfg/core/builders/apps_builder.py

@@ -166,6 +166,8 @@ class InstalledAppsBuilder:
         # Add django-q2 if enabled
         if hasattr(self.config, "django_q2") and self.config.django_q2 and self.config.django_q2.enabled:
             apps.append("django_q")
+            # Auto-add django_q2 module for automatic schedule synchronization
+            apps.append("django_cfg.modules.django_q2")
 
         # Add DRF Tailwind theme module (uses Tailwind via CDN)
         if self.config.enable_drf_tailwind:

django_cfg/models/django/django_q2.py

@@ -302,6 +302,19 @@ class DjangoQ2Config(BaseModel):
         )
         ```
 
+    Schedule Synchronization (AUTOMATIC):
+        When Django-Q2 is enabled, schedules are automatically synced after migrations.
+
+        The module 'django_cfg.modules.django_q2' is automatically added to INSTALLED_APPS
+        when django_q2.enabled=True, so you don't need to add it manually.
+
+        It uses Django's post_migrate signal to sync schedules from config to database.
+
+        Manual sync (optional):
+        ```bash
+        python manage.py sync_django_q_schedules
+        ```
+
     Admin interface:
         - Visit /admin/django_q/ to view tasks and schedules
         - Monitor task execution, failures, and performance

django_cfg/modules/django_q2/README.md

@@ -0,0 +1,140 @@
+# Django-Q2 Module
+
+Автоматическая синхронизация расписаний Django-Q2 из конфига в базу данных.
+
+## Зачем это нужно?
+
+Django-Q2 хранит расписания в базе данных, но **не создаёт их автоматически** из конфига.
+Этот модуль решает эту проблему - синхронизирует расписания после каждой миграции.
+
+## Использование
+
+### 1. Включи Django-Q2 в конфиге
+
+```python
+# config.py
+from django_cfg.models.django import DjangoQ2Config
+
+django_q2 = DjangoQ2Config(
+    enabled=True,  # ← Автоматически добавит django_q и django_cfg.modules.django_q2 в INSTALLED_APPS
+    schedules=[...]
+)
+```
+
+**Модуль подключается автоматически!** Не нужно вручную добавлять в INSTALLED_APPS.
+
+### 2. Определи расписания в конфиге
+
+```python
+from django_cfg.models.django import DjangoQ2Config, DjangoQ2ScheduleConfig
+
+django_q2 = DjangoQ2Config(
+    enabled=True,
+    schedules=[
+        DjangoQ2ScheduleConfig(
+            name="Sync balances hourly",
+            schedule_type="hourly",
+            command="sync_account_balances",
+            command_args=["--verbose"],
+        ),
+        DjangoQ2ScheduleConfig(
+            name="Cleanup daily",
+            schedule_type="cron",
+            cron="0 2 * * *",  # 2 AM каждый день
+            command="cleanup_old_data",
+            command_kwargs={"days": 30},
+        ),
+    ],
+)
+```
+
+### 3. Запусти миграции
+
+```bash
+python manage.py migrate
+```
+
+**Вывод:**
+```
+Running migrations:
+  ...
+  Syncing 2 Django-Q2 schedule(s)...
+    ✓ Created schedule: Sync balances hourly
+    ✓ Created schedule: Cleanup daily
+  ✅ Django-Q2 schedules synced: 2 created, 0 updated
+```
+
+### 4. Запусти qcluster
+
+```bash
+python manage.py qcluster
+```
+
+Готово! Расписания автоматически синхронизированы и работают.
+
+## Как это работает?
+
+1. **Модуль подключается** к сигналу `post_migrate`
+2. **После миграций** автоматически:
+   - Читает расписания из конфига
+   - Создаёт/обновляет их в базе данных (Schedule model)
+3. **Django-Q2 читает** расписания из базы и выполняет задачи
+
+## Ручная синхронизация (опционально)
+
+Если нужно синхронизировать без миграций:
+
+```bash
+python manage.py sync_django_q_schedules
+
+# Или с --dry-run для проверки:
+python manage.py sync_django_q_schedules --dry-run
+```
+
+## Безопасность
+
+- ✅ **Идемпотентность**: можно запускать много раз, не создаст дубликаты
+- ✅ **Без race conditions**: синхронизация происходит один раз за цикл миграций
+- ✅ **Graceful degradation**: если Django-Q2 не установлен, модуль просто молча пропустит синхронизацию
+- ✅ **Logging**: все операции логируются для отладки
+
+## Преимущества перед ручной синхронизацией
+
+| Аспект | Ручная синхронизация | Модуль |
+|--------|---------------------|--------|
+| Автоматизация | Нужно помнить запускать | Автоматически |
+| Деплой | Легко забыть | Всегда синхронизировано |
+| CI/CD | Нужно добавлять в скрипты | Работает из коробки |
+| Ошибки | Легко пропустить | Логи миграций |
+
+## Troubleshooting
+
+### Расписания не создаются
+
+Проверь:
+1. Модуль добавлен в INSTALLED_APPS
+2. `django_q2.enabled = True` в конфиге
+3. В конфиге есть расписания
+4. Миграции запущены: `python manage.py migrate`
+
+### Расписания не обновляются
+
+Запусти миграции повторно или используй ручную синхронизацию:
+```bash
+python manage.py migrate --run-syncdb
+# или
+python manage.py sync_django_q_schedules
+```
+
+### Логи синхронизации
+
+Включи DEBUG логи:
+```python
+LOGGING = {
+    'loggers': {
+        'django_cfg.modules.django_q2': {
+            'level': 'DEBUG',
+        },
+    },
+}
+```

django_cfg/modules/django_q2/__init__.py

@@ -0,0 +1,8 @@
+"""
+Django-Q2 module for django-cfg.
+
+Provides automatic schedule synchronization from config to database.
+"""
+from .apps import DjangoQ2ModuleConfig
+
+__all__ = ['DjangoQ2ModuleConfig']

django_cfg/modules/django_q2/apps.py

@@ -0,0 +1,107 @@
+"""
+AppConfig for Django-Q2 module with automatic schedule synchronization.
+"""
+import logging
+from django.apps import AppConfig
+from django.db.models.signals import post_migrate
+
+logger = logging.getLogger(__name__)
+
+
+def sync_schedules_after_migrate(sender, **kwargs):
+    """
+    Automatically sync Django-Q2 schedules after migrations.
+
+    This ensures schedules are always up-to-date after deployment.
+    Runs only once per migration cycle, safe from race conditions.
+    """
+    # Only run for the django_cfg_django_q2 app itself
+    if sender.name != 'django_cfg.modules.django_q2':
+        return
+
+    # Import here to avoid circular imports and ensure Django is ready
+    try:
+        from django_q.models import Schedule
+        from django_cfg.core.config import get_current_config
+    except ImportError as e:
+        logger.warning(f"Could not import Django-Q2 dependencies: {e}")
+        return
+
+    config = get_current_config()
+
+    if not config or not hasattr(config, 'django_q2') or not config.django_q2 or not config.django_q2.enabled:
+        logger.debug("Django-Q2 not enabled, skipping schedule sync")
+        return
+
+    enabled_schedules = config.django_q2.get_enabled_schedules()
+
+    if not enabled_schedules:
+        logger.debug("No Django-Q2 schedules found in config")
+        return
+
+    logger.info(f"Syncing {len(enabled_schedules)} Django-Q2 schedule(s)...")
+
+    created = 0
+    updated = 0
+
+    for schedule_config in enabled_schedules:
+        schedule_dict = schedule_config.to_django_q_format()
+        name = schedule_dict['name']
+
+        try:
+            schedule, created_flag = Schedule.objects.update_or_create(
+                name=name,
+                defaults=schedule_dict
+            )
+
+            if created_flag:
+                created += 1
+                logger.info(f"  ✓ Created schedule: {name}")
+            else:
+                updated += 1
+                logger.debug(f"  ✓ Updated schedule: {name}")
+
+        except Exception as e:
+            logger.error(f"  ✗ Failed to sync schedule '{name}': {e}")
+
+    logger.info(f"✅ Django-Q2 schedules synced: {created} created, {updated} updated")
+
+
+class DjangoQ2ModuleConfig(AppConfig):
+    """
+    AppConfig for Django-Q2 module.
+
+    Automatically syncs schedules from config to database after migrations.
+    This eliminates the need for manual `sync_django_q_schedules` command.
+
+    Features:
+    - Automatic schedule sync after migrations
+    - Safe from race conditions (runs only once)
+    - Logs all sync operations
+    - Gracefully handles missing dependencies
+
+    Usage:
+        Add to INSTALLED_APPS:
+        INSTALLED_APPS = [
+            ...
+            'django_cfg.modules.django_q2',  # Auto-syncs schedules
+        ]
+    """
+
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_cfg.modules.django_q2'
+    verbose_name = 'Django-CFG Django-Q2 Module'
+
+    def ready(self):
+        """
+        Connect post_migrate signal to automatically sync schedules.
+
+        This runs after all migrations are complete, ensuring:
+        1. Database tables exist
+        2. Config is loaded
+        3. Schedules are synced only once per migration cycle
+        """
+        # Connect the signal
+        post_migrate.connect(sync_schedules_after_migrate, sender=self)
+
+        logger.debug(f"{self.verbose_name} initialized - auto-sync enabled")

django_cfg/modules/django_q2/management/commands/sync_django_q_schedules.py

@@ -0,0 +1,74 @@
+"""
+Management command to sync Django-Q2 schedules from config.
+
+Usage:
+    python manage.py sync_django_q_schedules           # Create/update schedules
+    python manage.py sync_django_q_schedules --dry-run # Show what would be created
+"""
+from django.core.management.base import BaseCommand
+from django_q.models import Schedule
+from django_cfg.core.config import get_current_config
+
+
+class Command(BaseCommand):
+    help = 'Sync Django-Q2 schedules from config to database'
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            '--dry-run',
+            action='store_true',
+            help='Show what would be created without actually creating',
+        )
+
+    def handle(self, *args, **options):
+        config = get_current_config()
+        
+        if not config:
+            self.stdout.write(self.style.ERROR('❌ No config found'))
+            return
+            
+        # Check if Django-Q2 is enabled
+        if not hasattr(config, 'django_q2') or not config.django_q2 or not config.django_q2.enabled:
+            self.stdout.write(self.style.WARNING('⚠️  Django-Q2 is not enabled in config'))
+            return
+        
+        enabled_schedules = config.django_q2.get_enabled_schedules()
+        
+        if not enabled_schedules:
+            self.stdout.write(self.style.WARNING('⚠️  No schedules found in config'))
+            return
+        
+        self.stdout.write(f'📋 Found {len(enabled_schedules)} schedule(s) in config\n')
+        
+        created = 0
+        updated = 0
+        
+        for schedule_config in enabled_schedules:
+            schedule_dict = schedule_config.to_django_q_format()
+            name = schedule_dict['name']
+            
+            if options['dry_run']:
+                self.stdout.write(f'  [DRY RUN] Would create/update: {name}')
+                continue
+            
+            # Update or create schedule
+            schedule, created_flag = Schedule.objects.update_or_create(
+                name=name,
+                defaults=schedule_dict
+            )
+            
+            if created_flag:
+                created += 1
+                self.stdout.write(self.style.SUCCESS(f'  ✓ Created: {name}'))
+            else:
+                updated += 1
+                self.stdout.write(self.style.SUCCESS(f'  ✓ Updated: {name}'))
+        
+        if not options['dry_run']:
+            self.stdout.write(self.style.SUCCESS(
+                f'\n✅ Summary: {created} created, {updated} updated'
+            ))
+        else:
+            self.stdout.write(self.style.WARNING(
+                f'\n[DRY RUN] Would create {len(enabled_schedules)} schedule(s)'
+            ))

django_cfg/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.4.117"
+version = "1.4.118"
 description = "Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features."
 readme = "README.md"
 keywords = [ "django", "configuration", "pydantic", "settings", "type-safety", "pydantic-settings", "django-environ", "startup-validation", "ide-autocomplete", "nextjs-admin", "react-admin", "websocket", "centrifugo", "real-time", "typescript-generation", "ai-agents", "enterprise-django", "django-settings", "type-safe-config", "modern-django",]

{django_cfg-1.4.117.dist-info → django_cfg-1.4.118.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.4.117
+Version: 1.4.118
 Summary: Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features.
 Project-URL: Homepage, https://djangocfg.com
 Project-URL: Documentation, https://djangocfg.com

{django_cfg-1.4.117.dist-info → django_cfg-1.4.118.dist-info}/RECORD

@@ -1,5 +1,5 @@
 django_cfg/README.md,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-django_cfg/__init__.py,sha256=a-zgNY8EXo7-I6ZParGfaJYes0Qu_GNrYhqILSkLhAU,1621
+django_cfg/__init__.py,sha256=czBPTVeDvyLUMK-04V3RRLhBFzXwK7DP_dDyzQq7ZNw,1621
 django_cfg/apps.py,sha256=72m3uuvyqGiLx6gOfE-BD3P61jddCCERuBOYpxTX518,1605
 django_cfg/config.py,sha256=xdwFE8bocOEnMjqDOwr1_M02oUgdaMG_2M6F_IuB9GQ,1351
 django_cfg/apps/__init__.py,sha256=JtDmEYt1OcleWM2ZaeX0LKDnRQzPOavfaXBWG4ECB5Q,26
@@ -544,7 +544,7 @@ django_cfg/core/backends/smtp.py,sha256=kWkNMG7UwLsHcFYSKRgrk1HbP9mU1fxzWYnalHXq
 django_cfg/core/base/__init__.py,sha256=Z3bZvxejxk4vvWqmqTBLUi9XJpo6A_5Bq4R0J8q81Y4,116
 django_cfg/core/base/config_model.py,sha256=fnmvjOs2fHTb8ifjFv0EsbVPFScG87ExikIqVAqpDZc,21810
 django_cfg/core/builders/__init__.py,sha256=jkInI7_jbxcjitapohw6QmbJPpacnnID6V1JovqtOFM,282
-django_cfg/core/builders/apps_builder.py,sha256=96o35vB7-eIzAv32bZ505H6lGmcxjqZmhUDsxbOQ4Ug,6675
+django_cfg/core/builders/apps_builder.py,sha256=1C7M3Uq4aScuz4syuNGHyl3USus1h_FgULPfzKAerak,6810
 django_cfg/core/builders/middleware_builder.py,sha256=OwqQRoJKYWlXsQNPFBfUvVMYdppUHCPw-UDczV_esYg,3101
 django_cfg/core/builders/security_builder.py,sha256=W8Lk9eTMi3PuNK5qH-BIHegeE0cbvmuHKTumLcwOAh8,23961
 django_cfg/core/environment/__init__.py,sha256=sMOIe9z1i51j8B1VGjpLHJMaeDsBfsgn1TmL03FIeNo,141
@@ -644,7 +644,7 @@ django_cfg/models/django/__init__.py,sha256=J4VRl77vgXzfKcdUcX-sPxpBSOJ4qA-8RstP
 django_cfg/models/django/axes.py,sha256=-4nk2gSfpj7lNY5vnm_2jHVLz8VAKoEd9yF2TuCR8O8,5624
 django_cfg/models/django/constance.py,sha256=6x57bi40mDX0fKcKeQKgV2BO3WIVYPQllAchWsj4KvM,8847
 django_cfg/models/django/crypto_fields.py,sha256=OguITidM4Mp564p_gbsokeNCZxjL9hrK1Vw0McuA3yo,4700
-django_cfg/models/django/django_q2.py,sha256=le-Zjg2JjiFyfOJoHeODrjUylUBBm7eoneaGmVOmq1I,15067
+django_cfg/models/django/django_q2.py,sha256=G8m2hg0-IE-GLsGabaHetGVdbb_cNas8RCbZBBr-xz4,15564
 django_cfg/models/django/environment.py,sha256=lBCHBs1lphv9tlu1BCTfLZeH_kUame0p66A_BIjBY7M,9440
 django_cfg/models/django/openapi.py,sha256=avE3iapaCj8eyOqVUum_v2EExR3V-hwHrexqtXMHtTQ,3739
 django_cfg/models/django/revolution_legacy.py,sha256=Z4SPUS7QSv62EuPAeFFoXGEgqLmdXnVEr7Ofk1IDtVc,8918
@@ -947,6 +947,12 @@ django_cfg/modules/django_ngrok/service.py,sha256=Xkh9Gl6Rth32UcT0UYjD0ckROHFw6F
 django_cfg/modules/django_ngrok/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 django_cfg/modules/django_ngrok/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 django_cfg/modules/django_ngrok/management/commands/runserver_ngrok.py,sha256=urwO1nPjcBMPn7k8WXBzfWQpjzCsIKaiET2Gf5afYwk,6259
+django_cfg/modules/django_q2/README.md,sha256=pyY0EqefXTJ47k_liMv22d0zx-9dHVPGFUSZS3aLQjE,4763
+django_cfg/modules/django_q2/__init__.py,sha256=6Eu26O-4ddwE8qO27pTT6x13-iPc9eA2Pzq8_cRHZMc,186
+django_cfg/modules/django_q2/apps.py,sha256=UoSbow-Wlkwriem5mEud1vrUD7_TnqANMzoajGLBVQs,3396
+django_cfg/modules/django_q2/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_cfg/modules/django_q2/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_cfg/modules/django_q2/management/commands/sync_django_q_schedules.py,sha256=ik_4kmKp9RUTOaxewWK6KgwK_1_1wJcVZQ2LAdSG0Lo,2671
 django_cfg/modules/django_tailwind/README.md,sha256=tPQd4ir79MLFSVUKBGfPAF22LZWE0BcmzcNdQhJ4k7I,10804
 django_cfg/modules/django_tailwind/__init__.py,sha256=K0GbFxjemNixRUgexurSTDfN4kB--TmuFCk9n5DbLYc,186
 django_cfg/modules/django_tailwind/apps.py,sha256=CKNd0xDoLaQpe7SEfay0ZtWkjLUVRgofkB8FobKLXV8,313
@@ -1060,9 +1066,9 @@ django_cfg/utils/version_check.py,sha256=WO51J2m2e-wVqWCRwbultEwu3q1lQasV67Mw2aa
 django_cfg/CHANGELOG.md,sha256=jtT3EprqEJkqSUh7IraP73vQ8PmKUMdRtznQsEnqDZk,2052
 django_cfg/CONTRIBUTING.md,sha256=DU2kyQ6PU0Z24ob7O_OqKWEYHcZmJDgzw-lQCmu6uBg,3041
 django_cfg/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
-django_cfg/pyproject.toml,sha256=MwMh3DgYM1djCIx9K6E9rCngbKw5nVTDLWGmYMH6Ueo,8665
-django_cfg-1.4.117.dist-info/METADATA,sha256=Ll9z9f22ytdtCrn-anLFdvYpvVLBer0V7pqxnuefcFI,23876
-django_cfg-1.4.117.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-django_cfg-1.4.117.dist-info/entry_points.txt,sha256=Ucmde4Z2wEzgb4AggxxZ0zaYDb9HpyE5blM3uJ0_VNg,56
-django_cfg-1.4.117.dist-info/licenses/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
-django_cfg-1.4.117.dist-info/RECORD,,
+django_cfg/pyproject.toml,sha256=fZ9FGyvoUZbCwaNqWJDQwUNYeN11UYgds7UsrzwGFO0,8665
+django_cfg-1.4.118.dist-info/METADATA,sha256=NcD294dwA8ckrblk-0er6UcqtHdYYren4RsZh77BqkU,23876
+django_cfg-1.4.118.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+django_cfg-1.4.118.dist-info/entry_points.txt,sha256=Ucmde4Z2wEzgb4AggxxZ0zaYDb9HpyE5blM3uJ0_VNg,56
+django_cfg-1.4.118.dist-info/licenses/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
+django_cfg-1.4.118.dist-info/RECORD,,