edu-rdm-integration 3.18.4__tar.gz → 3.19.0__tar.gz

{edu_rdm_integration-3.18.4 → edu_rdm_integration-3.19.0}/CHANGELOG.md

@@ -29,6 +29,57 @@
 ### Удалено
 
 
+## [3.19.0] - 2025-09-26
+
+Добавлено предупреждение пользователя о недостаточности данных при формировании команды на выгрузку.
+
+### Добавлено
+
+- [EDUCLLG-7932](https://jira.bars.group/browse/EDUCLLG-7932)
+  MINOR в `actions` добавлен вывод предупреждения, если данных за выбранный период нет.
+
+
+## [3.18.5] - 2025-09-19
+
+Добавлена возможность отключения зачистки устаревших данных моделей РВД.
+
+Добавлены новые настройки
+
+| Название настройки в settings           | Описание                                         | Значение по умолчанию |
+|-----------------------------------------|--------------------------------------------------|-----------------------|
+| RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA | Включение зачистки устаревших данных моделей РВД | False                 |
+
+В settings.py:
+
+- Добавить значение по умолчанию:
+  ```
+    PROJECT_DEFAULT_CONFIG.update({
+        ...
+        ('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA'): False,
+        ...
+    })
+  ```
+
+- Получить значение настройки из конфигурационного файла:
+  ```
+    # Включить зачистку устаревших данных моделей РВД
+    RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA = conf.get_bool('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA')
+  ```
+
+- В дефолтный конфиг проекта необходимо добавить:
+  ```
+    # Настройка зачистки устаревших данных
+    [rdm_cleanup_outdated_data]
+    # Включить зачистку устаревших данных моделей РВД
+    ENABLE_CLEANUP_MODELS_OUTDATED_DATA = False
+  ```
+
+### Добавлено
+
+- [EDUSCHL-23942](https://jira.bars.group/browse/EDUSCHL-23942)
+  PATCH Добавлена возможность отключения зачистки устаревших данных моделей РВД.
+
+
 ## [3.18.4] - 2025-09-16
 
 Добавлены параметры `safe` и `log_sql` в команду `rdm_cleanup_outdated_data` для запуска команды в безопасном режиме 
@@ -68,11 +119,14 @@
 
 Доработки модели перечисления RDMModelEnum для расширения функционала механизма зачистки устаревших данных моделей РВД.
 
+У всех моделей РВД, которые являются основными для сущности необходимо заменить базовый класс на 
+`edu_rdm_integration.rdm_models.models.BaseMainRDMModel`.
+
 ### Добавлено
 
 - [EDUDEVOPS-94](https://jira.bars.group/browse/EDUDEVOPS-94)
   PATCH Добавлена базовая модель для определения модели являющейся основной для сущности.
-- 
+
 - [EDUDEVOPS-94](https://jira.bars.group/browse/EDUDEVOPS-94)
   PATCH Добавлен механизм расчета обратных связей для моделей в модели-перечислении RDMModelEnum.
 
@@ -131,11 +185,13 @@ settings.py в установленные приложения.
 Добавлено предупреждение пользователя о недостаточности данных и новая зависимость m3-ui.
 
 ### Добавлено
-  [EDUCLLG-7932](https://jira.bars.group/browse/EDUCLLG-7932)
+
+- [EDUCLLG-7932](https://jira.bars.group/browse/EDUCLLG-7932)
   MINOR Добавлена зависимость `m3-ui>=2.2.122,<2.3` в `pyproject.toml`
 
 ### Изменено
-  [EDUCLLG-7932](https://jira.bars.group/browse/EDUCLLG-7932)
+
+- [EDUCLLG-7932](https://jira.bars.group/browse/EDUCLLG-7932)
   MINOR `generate` в `generators.py`: изменена логика - вместо создания пустых команд при отсутствии данных теперь возвращается предупреждение
 
 
@@ -199,9 +255,8 @@ settings.py в установленные приложения.
     # Размер батча для bulk_create операций при сборе данных РВД.
     COLLECT_PROGRESS_BATCH_SIZE = conf.get_int('rmd_general', 'COLLECT_PROGRESS_BATCH_SIZE')
   ```
-  
-В дефолтный конфиг проекта необходимо добавить:
 
+- В дефолтный конфиг проекта необходимо добавить:
   ```
     [rmd_general]
     # Размер батча для bulk_create операций при сборе данных РВД.
@@ -352,9 +407,8 @@ settings.py в установленные приложения.
     # Размер батча для bulk_create операций при сборе данных РВД.
     COLLECT_PROGRESS_BATCH_SIZE = conf.get_int('rmd_general', 'COLLECT_PROGRESS_BATCH_SIZE')
   ```
-  
-В дефолтный конфиг проекта необходимо добавить:
 
+- В дефолтный конфиг проекта необходимо добавить:
   ```
     [rmd_general]
     # Размер батча для bulk_create операций при сборе данных РВД.

{edu_rdm_integration-3.18.4 → edu_rdm_integration-3.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: edu-rdm-integration
-Version: 3.18.4
+Version: 3.19.0
 Summary: Интеграция с Региональной витриной данных
 Author-email: BARS Group <education_dev@bars.group>
 Project-URL: Homepage, https://stash.bars-open.ru/projects/EDUBASE/repos/edu-rdm-integration/browse
@@ -197,6 +197,7 @@ INSTALLED_APPS = (
         ('uploader_client', 'ORGANIZATION_OGRN'): '',
         ('uploader_client', 'INSTALLATION_NAME'): '',
         ('uploader_client', 'INSTALLATION_ID'): '',
+        ('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA'): False,
     })  
     ```
 - Получение значений настроек из конфигурационного файла в settings.py:
@@ -309,6 +310,9 @@ INSTALLED_APPS = (
     # Директория логов отправки данных в витрину, доступных для скачивания
     RDM_UPLOAD_LOG_DIR = os.path.join('logs', 'rdm', 'upload')
     os.makedirs(os.path.join(MEDIA_ROOT, RDM_UPLOAD_LOG_DIR), exist_ok=True)
+  
+    # Включить зачистку устаревших данных моделей РВД
+    RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA = conf.get_bool('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA')
     ```
 
 Перечень настроек в settings.py указан в таблице ниже.
@@ -368,6 +372,7 @@ INSTALLED_APPS = (
 | RDM_COLLECT_LOG_DIR                          | Директория логов сбора данных, доступных для скачивания                                                                            |                         |
 | RDM_EXPORT_LOG_DIR                           | Директория логов экспорта данных, доступных для скачивания                                                                         |                         |
 | RDM_UPLOAD_LOG_DIR                           | Директория логов отправки данных в витрину, доступных для скачивания                                                               |                         |
+| RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA      | Включение зачистки устаревших данных моделей РВД                                                                                   | False                   |
 
 - В дефолтный конфиг проекта необходимо добавить:
 
@@ -463,6 +468,11 @@ INSTALLED_APPS = (
     INSTALLATION_NAME =
     # Идентификатор инсталляции в целевой Витрине
     INSTALLATION_ID =
+    
+    # Настройка зачистки устаревших данных
+    [rdm_cleanup_outdated_data]
+    # Включить зачистку устаревших данных моделей РВД
+    ENABLE_CLEANUP_MODELS_OUTDATED_DATA = False
     ```
 На основе дефолтного конфига произвести конфигурирование приложений.
 

{edu_rdm_integration-3.18.4 → edu_rdm_integration-3.19.0}/README.md

@@ -149,6 +149,7 @@ INSTALLED_APPS = (
         ('uploader_client', 'ORGANIZATION_OGRN'): '',
         ('uploader_client', 'INSTALLATION_NAME'): '',
         ('uploader_client', 'INSTALLATION_ID'): '',
+        ('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA'): False,
     })  
     ```
 - Получение значений настроек из конфигурационного файла в settings.py:
@@ -261,6 +262,9 @@ INSTALLED_APPS = (
     # Директория логов отправки данных в витрину, доступных для скачивания
     RDM_UPLOAD_LOG_DIR = os.path.join('logs', 'rdm', 'upload')
     os.makedirs(os.path.join(MEDIA_ROOT, RDM_UPLOAD_LOG_DIR), exist_ok=True)
+  
+    # Включить зачистку устаревших данных моделей РВД
+    RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA = conf.get_bool('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA')
     ```
 
 Перечень настроек в settings.py указан в таблице ниже.
@@ -320,6 +324,7 @@ INSTALLED_APPS = (
 | RDM_COLLECT_LOG_DIR                          | Директория логов сбора данных, доступных для скачивания                                                                            |                         |
 | RDM_EXPORT_LOG_DIR                           | Директория логов экспорта данных, доступных для скачивания                                                                         |                         |
 | RDM_UPLOAD_LOG_DIR                           | Директория логов отправки данных в витрину, доступных для скачивания                                                               |                         |
+| RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA      | Включение зачистки устаревших данных моделей РВД                                                                                   | False                   |
 
 - В дефолтный конфиг проекта необходимо добавить:
 
@@ -415,6 +420,11 @@ INSTALLED_APPS = (
     INSTALLATION_NAME =
     # Идентификатор инсталляции в целевой Витрине
     INSTALLATION_ID =
+    
+    # Настройка зачистки устаревших данных
+    [rdm_cleanup_outdated_data]
+    # Включить зачистку устаревших данных моделей РВД
+    ENABLE_CLEANUP_MODELS_OUTDATED_DATA = False
     ```
 На основе дефолтного конфига произвести конфигурирование приложений.
 

{edu_rdm_integration-3.18.4 → edu_rdm_integration-3.19.0}/src/edu_rdm_integration/pipelines/cleanup_outdated_data/management/commands/rdm_cleanup_outdated_data.py

@@ -1,3 +1,6 @@
+from django.conf import (
+    settings,
+)
 from django.core.management import (
     BaseCommand,
 )
@@ -50,9 +53,16 @@ class Command(BaseCommand):
             help='Включить логирование SQL-запросов, выполняемых во время работы команды.',
         )
 
-    def handle(self, *args, **options):
-        """Запуск очистки устаревших данных РВД."""
+    def _cleanup_model_outdated_data(self, options):
+        """Очистка устаревших данных моделей РВД."""
         model_data_cleaner_manager = ModelOutdatedDataCleanerManager(
-            models=options['models'], safe=options['safe'], log_sql=options['log_sql']
+            models=options['models'],
+            safe=options['safe'],
+            log_sql=options['log_sql'],
         )
         model_data_cleaner_manager.run()
+
+    def handle(self, *args, **options):
+        """Запуск очистки устаревших данных РВД."""
+        if settings.RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA:
+            self._cleanup_model_outdated_data(options)

{edu_rdm_integration-3.18.4 → edu_rdm_integration-3.19.0}/src/edu_rdm_integration/stages/export_data/registry/actions.py

@@ -13,6 +13,9 @@ from django.db.models import (
 from django.db.transaction import (
     atomic,
 )
+from m3.actions.exceptions import (
+    ApplicationLogicException,
+)
 from m3.actions.results import (
     OperationResult,
 )
@@ -258,6 +261,13 @@ class BaseExportingDataProgressPack(BaseCommandProgressPack):
             batch_size=context.batch_size,
         ).generate()
 
+        if not commands:
+            raise ApplicationLogicException(
+                f'Недостаточно данных для выгрузки по модели "{obj.entity_id}" '
+                f'в указанный период с {context.period_started_at} по {context.period_ended_at}. '
+                f'Проверьте наличие данных в указанном временном диапазоне.'
+            )
+
         for command in commands:
             obj = self.model(
                 entity_id=obj.entity_id,

{edu_rdm_integration-3.18.4 → edu_rdm_integration-3.19.0}/src/edu_rdm_integration.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: edu-rdm-integration
-Version: 3.18.4
+Version: 3.19.0
 Summary: Интеграция с Региональной витриной данных
 Author-email: BARS Group <education_dev@bars.group>
 Project-URL: Homepage, https://stash.bars-open.ru/projects/EDUBASE/repos/edu-rdm-integration/browse
@@ -197,6 +197,7 @@ INSTALLED_APPS = (
         ('uploader_client', 'ORGANIZATION_OGRN'): '',
         ('uploader_client', 'INSTALLATION_NAME'): '',
         ('uploader_client', 'INSTALLATION_ID'): '',
+        ('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA'): False,
     })  
     ```
 - Получение значений настроек из конфигурационного файла в settings.py:
@@ -309,6 +310,9 @@ INSTALLED_APPS = (
     # Директория логов отправки данных в витрину, доступных для скачивания
     RDM_UPLOAD_LOG_DIR = os.path.join('logs', 'rdm', 'upload')
     os.makedirs(os.path.join(MEDIA_ROOT, RDM_UPLOAD_LOG_DIR), exist_ok=True)
+  
+    # Включить зачистку устаревших данных моделей РВД
+    RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA = conf.get_bool('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA')
     ```
 
 Перечень настроек в settings.py указан в таблице ниже.
@@ -368,6 +372,7 @@ INSTALLED_APPS = (
 | RDM_COLLECT_LOG_DIR                          | Директория логов сбора данных, доступных для скачивания                                                                            |                         |
 | RDM_EXPORT_LOG_DIR                           | Директория логов экспорта данных, доступных для скачивания                                                                         |                         |
 | RDM_UPLOAD_LOG_DIR                           | Директория логов отправки данных в витрину, доступных для скачивания                                                               |                         |
+| RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA      | Включение зачистки устаревших данных моделей РВД                                                                                   | False                   |
 
 - В дефолтный конфиг проекта необходимо добавить:
 
@@ -463,6 +468,11 @@ INSTALLED_APPS = (
     INSTALLATION_NAME =
     # Идентификатор инсталляции в целевой Витрине
     INSTALLATION_ID =
+    
+    # Настройка зачистки устаревших данных
+    [rdm_cleanup_outdated_data]
+    # Включить зачистку устаревших данных моделей РВД
+    ENABLE_CLEANUP_MODELS_OUTDATED_DATA = False
     ```
 На основе дефолтного конфига произвести конфигурирование приложений.