# Отправка кампании

Данные для авторизации в ЛК Суперсервиса - Егор Денисов (@SadDrummer)
Пример запросов на ИС Воробушек - [Postman Collection](https://drive.google.com/file/d/1NOhq0Rj1Ut9UdP55JX268DRE_ZGhEwpV/view?usp=share_link)

## Отправка базовой информации
Базовая информация:
- название/год/кол-во направлений/uid есть в данных из приёма
- ссылки на документы вносятся вручную (их нет в ИС Прием, но можно, например, записать в ИС Воробушек и брать оттуда)


Создание кампании:
- с помощью Воробушка
- запрос на /send_package/ для entity *CampaignList* action *Add* по данным из ИС Приём
- через UI Суперсервиса\*
- \*наиболее простой быстрый способ

_Примечание: После создания необходимо сохранить UID кампании (сейчас этот параметр в .env)_

## Отправка дат кампании
- с помощью Воробушка
- запрос на /send_package/ для entity *CampaignEventList* action *Add* по данным из ИС Приём
- дополнительных действий по обработке данных не требуется - передача работает

## Отправка направлений подготовки
### Отправка образовательных программ
- Общее: вопрос ещё решается (Сергей Г.)
- Образовательная программа необходима для конкурсов с одного направления, но разной программой (название конкурса содержит круглые скобки)
- Добавление образовательных программ по API - **не реализовано**, но есть [трансформер](https://gitlab.etu.ru/ois/enroll/little-sparrow/-/blob/dev/app/transformers/campaign/dictionary_value_list_transformer.py)
- Прим.: в нём используется id словаря профилей, а нам нужны обр. программы
- Необходимо сохранить UID добавленных программ для добавления направлений подготовки (следующий подраздел), в которых указывается обр. программа
- редактирование направлений подготовки после добавления невозможно (т.е. нельзя создать направление через API, а потом к ЛК добавить обр. программу)

### Отправка направлений подготовки
Создание кампании:
- с помощью Воробушка
- запрос на /send_package/ для entity *OrgDirectionList* action *Add* по данным из ИС Приём
- существующий [трансформер](https://gitlab.etu.ru/ois/enroll/little-sparrow/-/blob/dev/app/transformers/campaign/org_direction_transformer.py) не учитывает возможное наличие обр. программ
- через UI Суперсервиса
- не рассматривается, кол-во направлений - 30 шт.

### Отправка конкурсов
С помощью Воробушка - запрос на /send_package/ для entity *CompetitionList* action *Add* по данным из ИС Приём
**Данные:** требуется формирование конкурсов из сущностей ИС Приём (пример есть в [блокноте](https://colab.research.google.com/drive/1bY6NQyuzoLMvgahTRoFKzFnJYPpTneG_?usp=sharing))
- в остальном отправка работает без доп. действий
- Прим.: часть конкурсов не передается из-за проблем в сопоставлении идентификаторов квот (специальные/др - dict_fin_source_id)

### Отправка вступительных испытаний
С помощью Воробушка - запрос на /send_package/ для entity *EntranceTestList* action *Add* по данным из ИС Приём
**Данные:** требуется формирование ВИ конкурсов из сущностей ИС Приём (пример есть в [блокноте](https://colab.research.google.com/drive/1bY6NQyuzoLMvgahTRoFKzFnJYPpTneG_?usp=sharing))
- в остальном отправка работает без доп. действий
- Прим.: при обработке на стороне СС могут возникнуть ситуация вида "Конкурс не найден" (речь про не переданные из-за квот конкурсы - см. выше)

### Отправка расписания вступительных испытаний
С помощью Воробушка - запрос на /send_package/ для entity *EntranceTestPlaceList* action *Add* по данным из ИС Приём
- дополнительных действий по обработке данных не требуется - передача работает

### Отправка целевых организаций
С помощью Воробушка - запрос на /send_package/ для entity *TargetOrganizationList* action *Add* по данным из ИС Приём
- Прим.: *ранее не проводилось/тестировалось*

# Просмотр результата обработки данных
После отправки данных в СС в ответ на запрос в ИС Воробушек возвращается task_id
- получение результата обработки СС по запросу `<sparrow_hostname>/tasks/<task_id>/`

# Проверка жизненного статуса СС
Запрос на `<sparrow_hostname>/tasks/<task_id>/`