DSAC Engine — проверочный экземпляр программы для ЭВМ
========================================================

Полное наименование:
Программа для ЭВМ «DSAC Engine — модуль формирования сезонно-адаптивного
контента», версия 1.0

Правообладатель: ООО «Группа компаний ВФ»
ИНН 7723911079, ОГРН 1147746650061
Автор: Линьков Олег Александрович
Версия: 1.0
Год выпуска: 2025

1. НАЗНАЧЕНИЕ ПРОВЕРОЧНОГО ЭКЗЕМПЛЯРА
--------------------------------------

Настоящий комплект предоставляется для проведения экспертной проверки при
рассмотрении заявления о включении сведений о программе в единый реестр
российских программ для электронных вычислительных машин и баз данных.

Экземпляр содержит исходный текст программы и контрольный набор данных,
достаточный для проверки заявленных функциональных характеристик.

2. ОТСУТСТВИЕ ТЕХНИЧЕСКИХ ОГРАНИЧЕНИЙ
--------------------------------------

Проверочный экземпляр:

- не содержит технических средств защиты авторских прав;
- не требует активации, лицензионного ключа или регистрации;
- не защищён паролем;
- не ограничивает количество и продолжительность запусков;
- не требует подключения к сети Интернет;
- не обращается к внешним сервисам при выполнении проверки.

Исключительное право на программу сохраняется за ООО «Группа компаний ВФ».
Предоставление экземпляра для экспертной проверки не является предоставлением
открытой или безвозмездной лицензии третьим лицам.

3. НАЗНАЧЕНИЕ ПРОГРАММЫ
------------------------

Программа формирует правила сезонно-адаптивного показа контента для сайтов
предприятий агропромышленного комплекса. По региону, сельскохозяйственной
культуре и дате программа:

- определяет климатическую зону и текущую фенологическую фазу;
- рассчитывает ближайшую агрооперацию и число дней до неё;
- определяет необходимость запуска контента и его приоритет;
- формирует заголовок и призыв к действию;
- подбирает средства защиты растений по регламентной базе;
- выгружает результаты в JSON и CSV для интеграции с CMS.

4. СОСТАВ КОМПЛЕКТА
--------------------

cli.py                 точка входа командной строки
dsac_engine.py         ядро принятия решений
phenology.py           фенологический календарь и климатические зоны
data_loader.py         загрузка и проверка данных CSV и JSON
run_compat_test.py     автоматическая проверка по пяти контрольным сценариям
data/                  контрольный набор справочников и регламентов
README.txt             инструкция по развёртыванию и эксплуатации
NOTICE_FOR_EXPERT.txt  сведения о назначении экземпляра и отсутствии защиты
VERSION.txt            сведения о версии
requirements.txt       сведения о программных зависимостях

5. ТРЕБОВАНИЯ К СРЕДЕ
----------------------

- операционная система: Linux или Windows;
- Python 3.10 или выше;
- архитектура: x86_64 или совместимая;
- свободное место: не менее 20 МБ;
- права администратора не требуются;
- внешние библиотеки, СУБД и сетевой доступ не требуются.

Проверка версии Python:

Linux:
    python3 --version

Windows:
    py --version

6. РАЗВЁРТЫВАНИЕ
-----------------

1) Скачать файл DSAC_Engine_1.0_verification.zip.
2) Распаковать архив в отдельную папку без изменения структуры каталогов.
3) Открыть терминал или командную строку в папке dsac_engine.
4) Убедиться, что файлы программы и подкаталог data присутствуют.

Установка через setup.py или pip не требуется. Программа запускается напрямую
интерпретатором Python.

7. БЫСТРАЯ АВТОМАТИЧЕСКАЯ ПРОВЕРКА
----------------------------------

Linux:
    cd dsac_engine
    python3 run_compat_test.py

Windows:
    cd dsac_engine
    py run_compat_test.py

Сценарий выполняет пять проверок:

1) проверка версии Python;
2) загрузка контрольной базы данных;
3) формирование правила и проверка расчёта;
4) пакетный расчёт по регионам;
5) формирование выгрузок JSON и CSV.

Успешный результат:

    ОБЩЕЕ ЗАКЛЮЧЕНИЕ: программное обеспечение СОВМЕСТИМО

Отчёт дополнительно сохраняется в файл compat_report.txt. В ходе пятого теста
создаются файлы rules.json и rules.csv. Эти файлы являются результатами работы
и могут быть удалены после проверки.

8. РУЧНАЯ ПРОВЕРКА
-------------------

Linux:
    python3 cli.py --data ./data --region "Краснодарский край" --culture "Пшеница" --date 2026-03-10

Windows:
    py cli.py --data .\data --region "Краснодарский край" --culture "Пшеница" --date 2026-03-10

Ожидаемый результат включает:

- сообщение об успешной загрузке базы данных;
- климатическую зону «Юг России»;
- рассчитанный приоритет;
- ближайшую агрооперацию и количество дней до неё;
- сформированный заголовок и призыв к действию;
- непустой перечень рекомендуемых препаратов.

Пакетный расчёт с выгрузкой результатов:

Linux:
    python3 cli.py --data ./data --all-regions --culture "Пшеница" --date 2026-03-10 --out-json rules.json --out-csv rules.csv

Windows:
    py cli.py --data .\data --all-regions --culture "Пшеница" --date 2026-03-10 --out-json rules.json --out-csv rules.csv

9. ПАРАМЕТРЫ КОМАНДНОЙ СТРОКИ
-----------------------------

--data         путь к папке с файлами базы данных, обязателен
--region       регион пользователя
--culture      сельскохозяйственная культура
--source       источник трафика: paid, organic или direct
--date         дата расчёта в формате ГГГГ-ММ-ДД
--all-regions  расчёт по всем известным регионам
--out-json     путь для выгрузки результата в JSON
--out-csv      путь для выгрузки результата в CSV

10. ТЕХНИЧЕСКАЯ ПОДДЕРЖКА ЭКСПЕРТНОЙ ПРОВЕРКИ
----------------------------------------------

Технический специалист: Линьков Олег Александрович
Телефон: +7 961 850-80-51
Электронная почта: linkovoleg@yandex.ru

В обращении рекомендуется указать наименование программы и версию 1.0.
