Блог компании Os_Engine | Как правильно сдать коннектор? Коннекторы к OsEngine № 15.

Кол-во участников в нашем Open Source сообществе растёт, что очень радует. Однако, уже сейчас точно понятно, что работать над коннекторами к OsEngine будут совершенно разные люди. И начинающие и суперпродвинутые.

При этом делать надо всё хорошо! Делать для себя, для начинающих алго, больших и маленьких. Делать надо от души!

А чтобы получилось у разных по подготовке людей и от души, что надо? Правильно!

Ввести демократию и всем вместе отменить правила!

Свод правил от человека, который в этом понимает.

Так Вы сможете быть уверенными в том, что делаете всё правильно. Так будут довольны пользователи.

И в этой статье поговорим о том, что надо будет сделать, чтобы сдать коннектор в OsEngine.

Задачи перед нами стоит две:

1)     Сделать для OsEngine классные подключения, работающие.

2)     Дать сообществу OsEngine стимул для роста. Чтобы люди из сообщества планомерно развились в этом процессе. Чтобы кто-то из них остался на поддержке. Кто-то стал программистом.

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

Эти же правила касаются и коннекторов к Крипте / Форекс и прочему.

Чтобы такого у нас не случилось:

1 Соискатель должен быть из группы по созданию коннекторов.

Об этом будет объявлено отдельно. В начале февраля. В нее всех подряд мы пускать не будем, чтобы в помои ее не превращать.

От тех, кого в группе нет, никакого кода в OsEngine по направлению коннекторов принято не будет совсем, чтобы не тратить ничьё время.

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

ЯДРО КОМАНДЫ OSENGINE.

Чтобы туда попасть, у нас будут отдельные правила:

1. Программисты, явно участвующие в конкурирующих проектах, туда допущены не будут.
2. Телеграмм-аккаунт для допуска должен быть с открытым телефонным номером, записанным на человека, который хочет вступить в группу.
3. С каждым человеком, которого мы туда будем пускать, сначала я буду созваниваться, на предмет понимания уровня знаний в программировании и того, чтобы понять зачем он там. 5 – 10 минут придётся мне уделить. А я на основе этой информации буду понимать, какая у нас собирается команда. И что мне нужно в первую очередь делать, кому помогать.

2 Проф-коннектор MOEX не должен быть Вашим первым коннектором для OsEngine.

Это супер важно. Нельзя ставить эксперименты с архитектурой OsEngine на коннекторе Twime. Это закончится архитектурным АДОМ. 

Первый коннектор должен быть для крипты. Крипта очень проста в исполнении. 500 – 800 строк кода. В основном это будет борьба с архитектурой OsEngine и изучение автотестов, чтобы коннектор их проходил.

В общем, сначала учимся на котиках. И я не приму коннектор от человека, который сразу пушит FIX FAST или что-то такое. Просто не приму и смотреть не стану.

Добавитесь в группу и выберете, кто какой коннектор делает по крипте. И попрём вместе. На MOEX будем далее переходить постепенно.  

3 Коннектор должен полностью проходить автоматические тесты.

В проекте они здесь:

Это отдельный слой создания автотестов для коннекторов. Со своей архитектурой и логикой. 17 сценариев, около 200 различных проверок. По каждому сценарию будет отдельная статья и надо будет написать отдельный отчёт!

Инструкции по слою тестирования будут до февраля выложены в этот блог.

4 Коннектор должен быть написан с соблюдением стандартов написания кода.

Данные стандарты взорвут задницы местных программистов не хуже противотанковой мины. Т.е. отправят их в космос. Но тем не менее, они будут. И кто их не будет соблюдать – не увидит ни денег за MOEX коннекторы, ни моей благодарности.

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

Также нужно будет писать отчёт на сдаче по соблюдению стандартов. Это выполнил. Это – тоже. Этого в коде точно нет. А это выполнено вот в таком стиле.

Стандарты будут до февраля выложены в этот блог.

5 К коннектору должна быть написана статья-инструкция в FAQдля сообщества.

Коннекторы делаются не только для программистов. Они ещё и для людей, которые просто хотят торговать.

Поэтому, на сдаче каждого коннектора придётся написать к нему инструкцию для людей. С картинками и по определённым правилам.

Полноценный ГАЙД по этому вопросу будет в этом блоге до февраля.

6 Исходный код коннектора не должен нарушать нашей лицензии.

С сентября весь код в OsEngine принадлежит ООО «Ван Технологии». Закрыт коммерческой лицензией. Всё, что туда добавляется, становится собственностью этой компании и опосредованно Российской Федерации.

Лицензия позволяет:

1. Торговать почти всем кроме юр. Лиц, которые должны купить лицензию.
2. Использоваться в обучающих целях, некоммерческих проектах.
3. Подробности здесь: https://o-s-a.net/os-engine-license-about

Напоминаю. Сделано это исключительно из-за непрекращающихся атак на проект с целью им так или иначе завладеть и отжать, когда он был под лицензией Apache 2. Чуваками НЕ ИЗ РОССИИ, которые никакого отношения не имеют к его созданию. И допустить я не могу, чтобы наш проект родненький из Сибири уехал на ПМЖ в Китай.

Писал про это статью: https://smart-lab.ru/company/os_engine/blog/940929.php

Поэтому, это должен быть НОВЫЙ код, которого нет на ГитХаб и в других проектах. Допускается использовать куски кода под Apache 2 лицензией. На этом всё.

7 Прежде, чем коннектор будет добавлен на ГитХаб, необходимо написать отчёты о проделанной работе.

1. Отчёт о соблюдении стандартов написания кода.
2. Отчёт о прохождении автоматических тестов.
3. Отчёт о неиспользовании чужого и закрытого лицензиями кода.
4. Отчёт о написании статьи для FAQ.

ГАЙД о том, как писать отчёт, будет в этом блоге до февраля.

8 Соискатель должен быть зарегистрирован как самозанятый, если хочет денег за коннекторы к MOEX.

Оплата за коннекторы будет в белую по срочному договору разработки ПО.

9 Не оферта. Всё на усмотрение Алексея Ван.

Не пугайтесь. Дополнительных правил с 99% вероятностью не будет.

Тут дело такое, что для многих «ругаться» и требовать с юридических лиц лишнего считается нормой или даже богоугодным делом. Это тут для самозащиты.

Удачных алгоритмов!

Пост из серии «Коннекторы к OsEngine»

Серия о том, как стать настоящим программистом и изменить свою профессию.

Оглавление и смыслы здесь: https://smart-lab.ru/company/os_engine/blog/959953.php

Комментарии открыты для друзей, добавляйтесь!

OsEngine: https://github.com/AlexWan/OsEngine
FAQ: https://o-s-a.net/os-engine-faq
Поддержка OsEngine: https://t.me/osengine_official_support

Регистрируйся в АЛОР и получай бонусы: https://www.alorbroker.ru/open
Сайт АЛОР БРОКЕР: https://www.alorbroker.ru
Раздел «Для клиентов»: https://www.alorbroker.ru/openinfo/for-clients