Legal Code
903 members
1 file
82 links
Канал о программировании руками (и головой) юриста

Задать вопрос можно в личку (@andrkosten).
Рекламу не предлагать. :)
Download Telegram
to view and join the conversation
Работают ли юристы с алгоритмами?

Да. Постоянно. Только чаще это скрывается под личиной таких слов: порядок/последовательность действий при подготовке консультации, рецепт успеха/выигрыша в суде, чеклист для похода к госрегистратору, политика вычитки договоров и т.д.

Полное определение и историю этого термина вы можете почитать на Википедии. Важно то, что любой алгоритм можно разложить на 3 составляющие. Рассмотрим сразу на двух параллельных примерах: охота за бананом на высокой пальме (🌴) и выигрыш вами суда как представителем истца (⚖️).

🎯 Конечный результат/цель — самая важная, ведь к ней вы стремитесь, её нужно заполучить, иначе в противном случае алгоритм был бы бессмыслицей. Её важно правильно сформулировать. С этого нужно начинать строить алгоритм:
1. достать/сорвать банан с пальмы;
2. получить решение суда, в котором удовлетворены ваши исковые требования.

🧸 Изначальные ресурсы/данные — думаем, что у нас есть из того, что могло бы оказаться полезным для достижения цели:
1. камни, палки, верёвки, ствол самой пальмы, хорошая физическая форма и т.д.;
2. доказательства, свидетели, собственная харизма и т.д.

🔗 Порядок действий над изначальными ресурсами/данными, завершающийся достижением цели. Самая сложная часть алгоритма. Но человечество доказало, что при хорошем знании своего дела и логическом мышлении можно строить очень сложные алгоритмы.
1.1. находим палку достаточной длины;
1.2. сбиваем этой палкой банан.
или
1.1. тупо лезем по стволу вверх
1.2. как долезли, срываем банан (и тут наш алгоритм обрывается, ибо мы же поставили себе цель достать/сорвать банан; так что можем оборваться и мы с пальмы, если не продумали эту ситуацию наперёд).

2.1. собираем у истца (и, возможно, у третьих лиц) нужную информацию, доказательства;
2.2. формируем иск (а это отдельный алгоритм);
2.3. подаём иск в суд;
2.4. являемся в первое заседание (и отдельный алгоритм, что делаем в нём);
2.5. подаём по ситуации нужные ходатайства;
(2.6.) если нужно, являемся в другие заседания;
2.7. ожидаем вынесение решения.

Как видите, алгоритм может быть довольно сложным, включать в себя подалгоритмы, а также шаги, о необходимости которых заранее неизвестно. Уверен, вам есть чем дополнить этот алгоритм.

#алгоритм
Из чего нам строить алгоритмы

Как видно по предыдущему посту, алгоритмы состоят из активных действий. И вот же совпадение: множество команд в разных языках программирования (далее — ЯП) — это тоже действия. Поэтому для обозначения этих команд используются глаголы.

Вот подборка примеров таких команд из разных ЯП:
append, apply, bind, call, decode, encode, explode, implode, join, replace, return, switch, test, trim, unset...

Это облегчает переход от алгоритмического описания порядка действий к самому коду. Давайте проверим это на реальном примере.

🎯 Постановка задачи:
Допустим, нужно найти и выписать из данного текста все предложения, где есть слово "суперфиций".

🧸 Ресурсы:
1) данный текст: "Суперфиций важен! Никто не может это отрицать. Понятие суперфиция дают на юрфаке. Юрист не может об этом не знать.";
2) возможности ЯП JavaScript и библиотеки jQuery.

🔗 Порядок действий (собственно алгоритм):
1) разделяем текст на предложения (тут я исхожу из гипотезы-упрощения, что все предложения оканчиваются знаками ".", "!", "?");
2) каждое предложение тестируем на наличие "суперфици";
3) если "суперфици" есть в текущем предложении, добавляем его к находкам.

⌨️ Код (жирным выделяю эти самые действия):
let myText = "Суперфиций важен! Никто не может это отрицать. Понятие суперфиция дают на юрфаке. Юрист не может об этом не знать.";
let sentences = myText.split(/[\.\?\!]/);
for( i=0; i<sentences.length; i++ ){
let isHere = /суперфици/i.test(sentences[i]);
if( isHere == true ){
$("body").append("<br>"+sentences[i]);
}
}

Результат — у нас на странице появится:
Суперфиций важен
Понятие суперфиция дают на юрфаке

🤔 Вопрос: что будет, если мы в коде поменяем true на false? Пишите в комменты)

Обратная связь:
Вам ок такой формат (🆗) или нужно меньше кода (⛔️)?

#алгоритм #код
Будни юриста и функции()

☝️ В прошлом посте в коде промелькнули такие команды, как "split", "test" и "append". То есть в языках программирования (далее — ЯП) есть какие-то слова, способные делать многое, экономя вам гораздо больше времени, нежели его вам потребуется на их написание. Откуда это вообще взялось? Дело в том, что разработчики ЯП не были садистами. И они создали функции.

🏹 Что такое функция? Представьте, что к вам в команду пришёл новичок. И вот вам нужно научить его/её готовить договор на подписание. Вы говорите ему следующее:
"Подготовить некий договор на подписание означает:
1) распечатать договор на принтере;
2) проверить, все ли страницы на месте и нету ли изъянов печати;
3) скрепить степлером страницы."

🧠 Отныне он/она будет понимать, что когда просят "подготовить договор на подписание", то это означает порядок названных трёх действий. То есть вы создали функцию в голове новичка. И вам не надо больше никогда озвучивать ни одно из трёх действий, достаточно назвать эту функцию (или, как говорят программисты, "вызвать" её). Удобно, не так ли? И этот механизм очень распространён в нашей жизни: "пожарить картофан", "съездить на дачу" и т.д.

📎 Зачем нужны скобки после имён функций? Туда вписываются параметры, необходимые для их работы. Одним из параметров функции нередко является указание на предмет, над которым нужно совершить действия. В нашем случае обсуждаемая функция может иметь вид:
подготовьДоговорНаПодписание(название_договора);

Так вот, в разные ЯП встроено достаточно много базовых функций. Поэтому вы одной строчкой можете написать команду, чтобы разбить текст на части, посчитать количество каких-то слов в нём и сделать многое другое. Кроме этого, вы можете создавать даже свои собственные функции. Благодаря им кодинг не настолько жесток, каким кажется на первый взгляд. Это первопроходцам приходилось морочиться с битами и кодить практически на железе.

🤔 Как часто вы используете подобный механизм в жизни?

P.S. В пятницу будет первое задание на канале)

#функция
Как выбрать материал для обучения

По стилю изложения можно обозначить такие две полярные группы, на отрезке между которыми расположены любые материалы по изучению программирования:
📄 Классика, где излагается сухая теория и при крайней необходимости приводятся скудные примеры. Встречаются практически такие же многоэтажные обороты, как и у юристов. О пороге входа автор часто не заботится: "либо вникай, либо проваливай". Это чаще книги и статьи на Википедии, чем видео.
🍿 Нечто необычное, где примеры зачастую опережают определения; примеры вполне понятны и связаны с бытом; даже есть некая доля юмора. Низкий порог входа. Это чаще видео (или живой перфоманс, который потом шерится как видео) и какие-то интерактивные штуки. Ну и этот телеграм-канал я стараюсь вести в таком ключе.

С чего начинать, тут на самом деле каждый для себя может решить. Если у вас научный бэкграунд или вы просто любите сложные тексты, то первая группа поможет хорошо углубиться и далеко пройти. Что же насчёт второй группы, то я не смотрел много видосов, но меня в своё время впечатлил видеокурс от CS50 на YouTube (вот, например, первая лекция). Они с потрясающим цинизмом помогают понять разные непростые явления в кодинге и вообще логику работы ЭВМ.

📨 Один подписчик написал мне, что хочет пойти на этот курс от Прометеуса (CS50: Основы программирования), ищет единомышленников (❗️). Курс бесплатный, свежий, українською мовою (есть и оригинал на английском). Я глянул описание, меня зацепила эта фраза "Практические задания курса базируются на реальных кейсах со сфер биологии, криптографии, финансов, судебно-медицинской экспертизы и разработки игр". Впервые вижу в этом уютном мирке кодинга судебно-медицинскую экспертизу (🍖)... И вот я подумал: а вдруг юристам понравится?

💬 В общем, можете найтись и скооперироваться в комментариях)

#курс #CS50
Первое ЗАДАНИЕ на канале!
... а что же ещё делает кодера сильным?

💭 В программировании очень важно понимать, как ваши слова, которыми вы описываете ещё не созданную технологию/продукт, превращать в итоговый код. Умение это делать быстро и с первого раза приходит со временем. Ранее, в этом посте я показал, как бытовушное описание через логическое описание эволюционирует в псевдокод (а из псевдокода уже легко выйти в конкретный код). Это очень важная последовательность для новичка.

💡 До меня это дошло, когда на курсах задали на дом написать код, который определяет, является ли любое введённое число палиндромом. Когда я пытался мыслить сразу программным кодом, никак не получалось. И так, и сяк — не получалось. Когда же взял и расписал необходимые действия (логику) пошагово, внезапно стало ясно, как из этого выстроить победный код.

🖊 Поэтому сейчас предлагаю вам задачу: какие инструкции нужно дать компьютеру, чтобы он мог сказать про любое число, является ли оно палиндромом? Кстати, вот палиндромы: 212, 55, 88488, а вот непалиндромы: 122, 56, 84888. Пока не нужно писать код. Сначала нужно просто объяснить себе словами необходимую последовательность действий. Здесь зарыто 80% успеха.

У вас для этого есть такие инструменты:
▪️ в любой момент можете запоминать любые значения, полученные вами, включая полученное на старте число;
▪️ в любой момент можете проверить что-либо на истинность или ложность перед тем, как выполнить какое-нибудь действие;
▪️ в любой момент можете сравнивать числа, проводить математические операции, округлять, брать остаток от деления;
▪️ можете повторять одни и те же действия (включая вышеперечисленные) некоторое количество раз или пока не изменится некоторое обстоятельство (то есть создавать циклы).

🌱 Согласен, палиндромы далеки от юриспруденции, но это будет очень показательно для тех, кто проникнется. Для меня это задание стало точкой роста. И, разумеется, не стоит гуглить решение. :) Сила приходит с ̶с̶т̶р̶а̶д̶а̶н̶и̶е̶м̶ усилиями.

Методику решения такой задачи опубликую в понедельник.
#мясо #задание #палиндром
🗝 Подсказка к задаче палиндрома

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

🐗 Я условно стал называть это пятым арифметическим действием (вот же неграмотный!), потому что в трёх моих любимых языках программирования (JavaScript, PHP и Python) оно записывается при помощи знака "%":
4 % 2 = 0, потому что 4 / 2 = 2, то есть в остатке ноль,
5 % 2 = 1, потому что 5 / 2 = 2 и в остаток идёт единица.

Зачем выделили под это отдельный знак? Ну, в коде проще записать result = 5 % 2; , чем:
1) result = 5 - 5 / 2 * 2, если деление целых чисел не приводит к получению дробного результата;
2) result = 5 - floor( 5 / 2 ) * 2, если появляется дробный результат, который нужно округлить.

🔎 Зачем это нужно и как это поможет решить задачу палиндрома?
У взятия остатка есть прекрасное свойство, благодаря которому можно легко получить последнюю цифру числа, поделив его с остатком на 10. Например, 245 % 10 = 5, 248 % 10 = 8. То есть это значит, что проблема вычленения нужной цифры — это не проблема.

А ещё деление с остатком на 2 позволяет определить, является число чётным или нечётным:
5 % 2 = 1, 7 % 2 = 1, 131 % 2 = 1, то есть нечётные числа всегда продуцируют единицу;
4 % 2 = 0; 6 % 2 = 0; 132 % 2 = 0, то есть чётные числа всегда продуцируют ноль.

Ещё подсказка: исходите из определения палиндрома и тех его свойств, которые из этого вытекают.

Как успехи с палиндромом?)
🆗что-то есть; ⛔️не хочу
💠 Решение задачи с палиндромом

1.
Смотрим внимательно дефиниции/свойства, чтобы найти зацепки: палиндром (число) — это число, которое читается одинаково в обоих направлениях, то есть которое будет равно числу, составленному из его цифр задом наперёд. Значит, его последняя цифра равна первой, предпоследняя — второй и т.д. И это правило соблюдается вплоть до центра этого числа, которым может быть одинокая цифра (212, 151, 11011) или же пара цифр (1221, 338833). Итак, мы можем сравнивать поочерёдно первую и последнюю цифры, а затем откидывать их... Но стоп... Кажется, я зашёл слишком далеко. Вернусь в начало.

2. ... читается одинаково в обоих направлениях. Значит, нужно записать его (далее — Старое число) задом наперёд, получив таким образом его зеркальное отражение (далее — Новое число) и сравнить их. Как это сделать? Проговариваю буквально:
0️⃣ буду оперировать Старым и Новым числами;
1️⃣ беру последнюю цифру Старого числа;
2️⃣ прибавляю её к телу Нового числа;
3️⃣ выкидываю её из Старого числа;
🔁 повторяю действия 1️⃣, 2️⃣, 3️⃣, пока в Старом числе не иссякнут цифры;
4️⃣ сравниваю Старое и Новое числа: если они равны, то это палиндром.

3. Вот воплощение этого алгоритма в виде кода на JavaScript:
0️⃣ let numberOldTest = numberOld;
let numberNew = 0; (подготовительная стадия, необходимая для работы)
🔁 while( numberOldTest > 0 ){
1️⃣ digitLast = numberOldTest % 10; (вот к чему относится вчерашняя подсказка)
2️⃣ numberNew = numberNew * 10 + digitLast; (чтобы цифры не суммировались арифметически, нужно повышать разряд числа, умножая основу на 10)
3️⃣ numberOldTest = Math.floor( numberOldTest / 10 ); (тут нужно округлять вниз, чтоб избавиться от дроби)
}
4️⃣ if( numberOld == numberNew ){ alert("это палиндром"); }

Вот и всё. А ведь я на старте чуть не переусложнил решение задачи. Ведь также можно путём математических ухищрений брать первую и последнюю цифры Старого числа и сравнивать их. Затем, если они равны, отбрасывать их (опять-таки, первую сложнее отбросить). И так двигаться до середины числа. И ещё нужно учитывать, что число может состоять как с парного, так и непарного количества цифр. А ещё есть и другие математические способы, просто логика работы и код будут сложнее.

А что получилось у вас? Было ли полезно?
Первый короткий пост на канале: ОПРОС

🏔 Народ, контента много и его ещё можно создавать и создавать, ибо право и программирование — это две очень благодатные нивы, полные загадок и свершений. Перед тем, как самозабвенно упарываться дальше, мне ценно услышать, что вас сейчас интересует больше всего:
1) элементы сугубо кодинга: переменные, классы, циклы, обработка ошибок, виды ошибок, отладчики и прочее;
2) алгоритмизация правовых процессов — примеры, подходы, идеи и прочее;
3) какие-то истории, факапы, личный опыт.

P.S. Очень круто, что всё больше людей начинает комментировать происходящее, причём приводя свои решения в виде кода. Давайте продолжать. 🎉

Пишите в комменты )

#опрос
КАК Я ВОШЁЛ В АЙТИ.
ЧАСТЬ 1. Игрульки и отказ от юридических тасков.
🤓

Спасибо за комментарии! Окей, расскажу сначала немного о своём бэкграунде.

🐣 Если не считать Pascal в лицее и немножко C++ на курсах (где вершиной моего познания стал палиндром и вложенные циклы для решения двумерных задач), то вменяемо программировать я начал в программе для ... создания игр. Это Construct 2, в ней практически не нужно писать код, вместо этого из блоков выстраиваются схемы по типу "событие — действие", "событие — проверка условий — действие" и т.д. То есть изначально я (наверное, как и многие), хотел создавать свои игры, это была реальная мотивация забивать свою голову всякой дичью в виде оптимизации, совместимости, компиляции и прочего. Но до конца я (наверное, как и многие) ни один проект не довёл, у меня там накопилось где-то 15 заготовок. Причём под конец я начал экспериментировать и смешивать жанры, например "тетрис-теннис с элементами RPG в духе World of Warcraft". Кстати, заниматься этим было особенно интересно во время унылых лекций на юрфаке.

🗽 После стажировки в юрфирме Axon Partners в конце 2016-го я обнаглел настолько, что предложил заняться лигалтеком прямо под Новый год, хотя ещё плохо понимал, что это такое (и вообще ещё не было решено, будут ли со мной сотрудничать дальше). И когда решили-таки сотрудничать, самое прикольное то, что первые три лигалтек-проекта я делал в этой программе аж до сентября 2017-го, нагло симулируя с её помощью веб-сайты. Она поддерживала компиляцию в html-файлы, но там были проблемы с вёрсткой, которые я не мог преодолеть, потому что а) не знал HTML и б) кое-что нельзя было преодолеть. Поэтому первые три лигалтек-проекта были уродливы, как не знаю что.

🥀 Итак, благодаря Construct 2 я почти сразу смог отказаться от юридических тасков в Аксоне. Почти сразу, потому что какой-то стрёмный рисёрч успел оставить легалистский шрам в моей душе. И спустя две-три недели Дима Гадомский вручил мне лигалинженерскую рясу, которую я ношу и по сей день. Дальше расскажу о том, какой язык программирования стал моим первым рабочим.
КАК Я ВОШЁЛ В АЙТИ.
ЧАСТЬ 2. Первые три проекта и первый язык программирования. 😎

🗺 1-й проект
: им стала интерактивная юридическая карта мира для разных видов бизнеса с фильтрацией по налогам, условиям открытия и поддержания компаний и т.д. Через две недели я принёс прототип в Construct 2, мы начали его наполнять содержимым и экспериментировать. Тут не требовалось никакого сложного программирования, просто распределение данных по группам и их визуальное представление. Но внезапно мы этот проект отложили в сторону, потому что переключились на второй.

🧟‍♂️ 2-й проект: когда Google объявили, что будут баниться приложения, не имеющие политики приватности, мы сразу же взялись решить эту проблему. За три дня сделали конструктор политик приватности, один из первых вебботов украинского лигалтека — Privacy Policy Bot, он же Франк. Запустили 13 февраля 2017. Он выглядел страшно, в первый день на нём подвисали кнопки, но он работал. Через несколько дней мы выпустили апдейт, в котором вы могли этот же документ получить в фановом виде: он был напикан шутками на английском языке, которые не исключали его юридическое значение. В эти дни я узнал, что такое хостинг и как его настраивать, а также понял, что на первом месте должна быть безотказность софта, а уже затем красивенькие анимации.

🛠 3-й проект: когда подошло время вернуться к 1-му проекту, Дима Гадомский поинтересовался, смогу ли я сделать конструктор таких ботов, как Франк, чтобы и другие юристы могли клепать такие вещи. Я написал в чате, что подумаю. Через 40 минут я сказал, что это возможно. В этот же день началась разработка, растянувшаяся на полгода. Через несколько дней наткнулся на проблему сохранения пользовательских данных на сервере. И вот на форуме Construct 2 нахожу инструкцию о том, как должен выглядеть делающий это скрипт на PHP. Вот так вопрос выбора языка программирования для дальнейшей работы решился сам собой. А к первому проекту мы так и не вернулись.
Надёжные способы автоматизировать создание документов
Способ 1. Заполнение шаблонов.
📇

Второй и третий проекты с прошлого поста дали мне знать, что есть два эффективных подхода к подготовке документов при помощи алгоритмов.

Заполнение шаблонов — до боли знакомая ситуация. Допустим, у вас есть готовый шаблон какого-то документа. Чтобы пустить его в дело, достаточно заполнить какие-то индивидуальные данные. Например: шаблоны заявлений в универе; договоры, которые вам подсовывают в банках; акты приёма-передачи результатов услуг и т.д. Чаще всего вписываем туда наименования, контакты, даты, суммы и т.д.

🎮 Автоматизировать такое до неприличия просто:
1.
В нужных местах шаблона ставим некие уникальные метки, которые не используются нигде в тексте (например: $name$, $date$, %sumOfMoney%, goodsQuantity).
2. Создаём опросник (можно и в виде чат-бота), где ответами на вопросы являются те данные, которые нам нужно вставить в документ ("Укажите фамилию и инициалы покупателя");
3. Подменяем каждую метку на каждый полученный ответ (таким образом, какой-нибудь "Шпак И.С." заменит собой какую-нибудь метку $nameOfBuyer$);

Чё ещё можно с этим сделать?
🔹 Одна и та же метка может встречаться несколько раз в разных местах документа (например, если наименование контрагента вы хотите разместить в начале и в конце договора).
🔹 Разумеется, между опросником и подменой меток можно втулить ещё алгоритм, который будет производить дополнительные операции над данными: преобразование, дополнение, обрезка и т.д. (например, дробные числа округлять вверх, когда речь идёт о ценах и вы хотите исключить копейки).
🔹 Метку можно заполнить ничем, чтобы она исчезла, если по выбранному юзером сценарию какое-то поле нужно оставить пустым (пустота в этом случае выглядит так: "", '').
🔹 Можно сделать так, что какие-то данные в документе будут формироваться на основе ответов, а не напрямую из них (например, в опроснике юзер выбрал опцию "плачу долларами", и вы добавляете к указанной денежной сумме словесное обозначение долларов).

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

А вы когда-нибудь пользовались подобными опросниками?
Или создавали свои?

#шаблон #алгоритмизация #документ
​​👁 Вычислительное право — выдумка бородачей в свитерах или ...

Вчера прошёл Computational Law & Blockchain Festival наконец и в Киеве, вот видеозапись. Мне очень понравилась презентация Егора Чурилова о вычислительном праве (см. ниже фото одного из слайдов). Кажется, мы сейчас пытаемся перевести наши правовые системы с третьего этапа (дигитализация) на четвёртый (онтологизация/семантизация), хотя в некоторых вопросах ещё застряли и на втором (механизация). В причинах такого пробуксовывания пытались разобраться на последующей панельной дискуссии.

Вот какие микровыводы для себя сделал:

▪️ Digital by default — не шутка, мы всерьёз собираемся двигать общество и право к цифровизации.

▪️ Кибернетики создали разные способы/модели представления человеческого знания (и юридических законов) в цифровом виде, так что у нас даже есть из чего выбирать.

▪️ Но переход не будет резким, привычки менять сложно, поэтому будем расходовать много бумаги ещё некоторое количество лет.

▪️ Технологии можно делать как прозрачными, так и не прозрачными. Но компьютеру всё равно проще логировать свои действия и отчитываться за них, чем судье-человеку, который даже не догадывается, что в послеобеденное время он склонен выносить более мягкие (и даже оправдательные) приговоры (спасибо Егору за классный пример).

▪️ Юристов digital by default и его последствия не вытеснят в один конкретный день, но это не повод его игнорировать. Эта профессия в плане инструментов и образа действий в следующие годы будет меняться значительно быстрее, чем за последние 100 лет. Но лигалхакеры всего мира помогут не потеряться в ворохе технологий и найти себя.
​​Надёжные способы автоматизировать создание документов
Способ 2. Соединение блоков.
🍢

Выше я рассказал о том, как заполнять шаблоны. Но это весьма тривиальная задача. Нередко структура и содержание документа должны различаться зависимо от ситуации клиента. И тут мы приходим к тому, что документ нужно строить из отдельных блоков, которые должны подставляться зависимо от полученных ответов.

Простая ситуация: задаём 3 вопроса подряд, на каждый из них даётся по 2 ответа, и каждый ответ связан с неким блоком текста, который должен подставиться в документ. У нас в Axon Partners такое было с тем самым Privacy Policy Bot, только там таких вопросов было около двенадцати. И на этой же идее я строил тот самый конструктор ботов, где можно было создать до 15-и вопросов с 4-мя возможными ответами.

🎲 Выходит, потенциально количество вариаций такого документа будет равно произведению сумм ответов по каждому вопросу: 2 х 2 х 2 = 8. И вам как юристу на этапе создания и тестирования такого конструктора необходимо убедиться, что все эти вариации жизнеспособны и не противоречивы: например, что блок из ответа №1 на вопрос №1 совместим с блоком из ответа №2 на вопрос №3 и т.д. Поэтому такое конструирование документа лучше подходит для консультаций, справок и некоторых "блочных" документов по типу несложных политик приватности. Ведь договоры обычно имеют более сложную логику, хотя при некоторой ловкости можно что-то эдакое сотворить и с ними.

И конечно же, при необходимости блок можно сделать пустым.
​​26-й день: запуск чатов! 👁‍🗨

Друзья, вот нас и стало уже 500! Очень благодарен всем, кто шерит канал. :) Заменяя неудобный интерфейс комментариев, запускаю целых два чата для желающих:

🗯 Common Chat, чтобы обсуждать контент и вообще тематику канала, а именно – более "гуманитарные" и "стратегические" вопросы.

💬 Coder Chat, чтобы обсуждать сугубо кодерские вопросы и, взаимопомогая, забрасывать друг друга кусками кода, осколками конструктивной критики и полезными материалами.

Завтра продолжаю своё повествование. А пока что зацените скриншот альфа версии нашего первого опубликованного лигалтек-продукта в феврале 2017-го. К чему я? Не нужно бояться, что без профессионального дизайнера у вас на старте получится антикрасивый интерфейс. В лигалтеке главное — нутро продукта: его движок, логика и функционал. Считаю, что юрист не обязан ещё и дизайнить. Это можно оставить людям с профессиональным чувством прекрасного. 🎨 Поэтому главное требование к лигалинженерам — хотя бы тексты сделать читабельными.
​​Надёжные способы автоматизировать создание документов
Способ 3. Шабменты или фраглоны.
🏈

Разумеется, на практике при создании документов (особенно договоров, актов, заявлений и т.д.) приходится комбинировать способ 1 и способ 2. То есть и данные от юзера напрямую вносить (имена, даты, адреса, номера, суммы и т.д), и какие-то блоки подставлять. Логику процесса я изобразил на картинке ниже.

Обратите внимание, что данные юзера можно вносить как в статичную ("чёрную") часть документа ("желтый" ответ), так и в сами фрагменты ("красный" ответ). Причём порядок действий по такой схеме не имеет значения, хотя с точки зрения оптимизации стоит вносить данные клиента в уже выбранный (используемый) фрагмент.

🧩 То есть на нижнем уровне эти фрагменты ("зелёные") сами становятся шаблонами. В кодинге нередко можно столкнуться с такой многоуровневостью, пошаговостью. Поэтому-то умение мыслить пошагово довольно важно.
​​КАК Я ВОШЁЛ В АЙТИ.
ЧАСТЬ 3. Третий проект и закручивание винтов молотком (аспект веры).
🥶

🤖 Как я уже говорил, в конце февраля 2017 я засел за конструктор ботов (не чат-ботов, а тех, которые работают прямо в браузере, я их позднее стал называть веб-ботами). Они должны были работать по вот этому принципу, а сам проект — реализован в виде веб-сайта. На меня свалился не просто пресловутый кодинг ряда процедур, а решение полноценной архитектурной задачи: создание базы данных для юзеров и их ботов, механизма регистрации юзеров, механизма восстановления паролей, разных других механизмов взаимодействия фронтенда и бэкенда в процессе создания, изменения, удаления, запуска и тестирования юзерами их ботов.

👞 Разумеется, осознавать сразу весь этот ворох задач было напряжно (я не сразу понял, с чем связался), поэтому делал маленькие шажки от фиче к фиче. На этом проекте я познал, что такое фуллстак-разработка + ещё дизайном занимался, кнопки всякие рисовал (см. скриншот ниже). Так получилось, что для фронтенда (внешней, доступной юзеру части проекта) я использовал ту самую Construct 2, а для бэкенда — текстовый редактор скриптов в панели управления хостингом сайта.

🔩 В какой-то момент я начал догадываться, что делать такой проект в программе для разработки игр — плохая, очень плохая идея. По скриншоту видно, какими извращениями пришлось заниматься. Но я в неё верил и пытался выжать максимум. К тому же не знал, как выйти на "чистый HTML и JavaScript" и работать "по-взрослому". Что ж, путь в айти бывает и таким.

🗺 Путь в айти: ЧАСТЬ 1, ЧАСТЬ 2
​​Надёжные способы автоматизировать создание документов
Способ 4. Оценка
комбинаций. 🌗

Описанные ранее способ 1, способ 2 и способ 3 — довольно просты, ведь в их основе гипотеза о том, что каждый ответ на каждый вопрос — "самостоятельная фигура", то есть влияет самостоятельно и напрямую на некоторый участок в документе. Но иногда бывает и так, что нужно "связать" два идущих один за другим вопроса, оценить ответы на них в совокупности. Например, когда речь идёт об оценке рисков (и мы делаем документ-консультацию по рискам), нужно видеть ситуацию клиента более масштабно и целостно.

🧮 Тогда приходится оценивать все возможные комбинации этих ответов. Если на первый вопрос 2 ответа, а на второй — 3, тогда комбинаций будет 2 х 3 = 6. "Карту" этих комбинаций на стадии прототипирования можно строить в виде таблицы. А соответствующий участок кода может выглядеть так, как изображено на картинке.

🥭 Кстати, в ходе своей работы в Аксоне над проектом Memelex мне пришлось научиться рисовать в Adobe Illustrator, чтобы не напрягать дизайнеров по мелочам. Теперь пользуюсь этим и здесь. Правда, нужно научиться ещё цвета подбирать. :)
🧗‍♂️ Личный ТОП 5 источников обучения кодерству, которые сформировали меня:

🛷 5.
Инструкции/мануалы по созданию несложных игр в программе Construct 2 и сам опыт взаимодействия с ней. Научился структурировать происходящее по ту сторону монитора, ставить цели, прокладывать пути и т.д.

🚴‍♂️ 4. Курсы программирования, на которые я пошёл в конце 2016-го и откуда ушёл где-то через два месяца. На них я научился думать над построением алгоритмов. Как пример я уже приводил задачу с палиндромом. На самом деле, там можно было взять гораздо больше, но решил дальше идти сам. Обобщённо: я не хотел учиться собирать Феррари, когда мне нужно было сделать электрочайник.

🥉 3. Также восполнить пробел в основах мне помогло приложение SoloLearn. В нём я прошёл курсы по HTML, CSS, JS, PHP, SQL, Python и jQuery. Ничего особо выдающегося в этом нет, просто основы синтаксиса всех этих технологий. Но у этого приложения есть своё коммьюнити по всему миру, всякие обсуждения, даже челленджи. К каждому обучающему заданию/вопросу прилагается своё обсуждение в комментах.

🥈 2. Далее идут некоторые книги, которые я очень выборочно и точечно изучал. В них информация обычно структурирована, подаётся в едином стиле, с нарастающей глубиной. Свою первую нейросеть я сделал именно благодаря книге. Это не тот жанр литературы, который нужно читать обязательно от корки до корки, хотя и здесь есть книги, которые этого заслуживают. Планирую скоро закупиться некоторыми.

🥇 1. Больше всего я самообучился, просто гугля вопросы и попадая на такие ресурсы, как stackovefrlow, w3schools и иногда даже форумы не первой свежести. Сюда же можно отнести мануалы типа php.net.

Расскажите в чате, какова ваша версия такого топа? От чего больше профита получили вы?
​​Надёжные способы автоматизировать создание документов
Приём "построение перечня из перечня".


Бывает так, что при опросе юзера/клиента нужно допускать выбор нескольких опций одновременно. Веб-разработчики знают, что для этого обычно используються "чекбоксы" (checkboxes). При создании юридических документов это может понадобиться, когда формируются перечни/списки, например: перечень товаров, услуг или работ, которые должны поставляться по договору.

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

Вам приходилось кодить похожие вещи? Можем обсудить в чате.
КАК Я ВОШЁЛ В АЙТИ.
ЧАСТЬ 4. Знакомство с HTML/CSS/JavaScript и боль.
🦷

Где-то на четвёртом месяце работы над конструктором ботов я понял, что параллельно нужно начать изучение HTML, CSS и JavaScript, чтобы больше не делать такую дичь. Его уже, так и быть, заканчивал в Construct 2, но новые проекты твёрдо решил пилить "по-взрослому".

Уже плохо помню, с чего начал изучать, это всё как-то в кучу свалилось. Меня кормил гугл: я там находил и общую документацию, и всякие форумы, и статьи на Хабре. Философию работы HTML с его padding-ами и margin-ами я закусывал стилизацией CSS, пытаясь управлять всем этим при помощи JavaScript-а. Голова взрывалась, учился методом проб и ошибок, причём на одну пробу приходилось две ошибки. Сразу попал на какой-то источник, который подсадил меня на иглу jQuery, с которой я не слажу до сих пор.

Для непосвящённых: jQuery — это такая штука, которую подключаешь у себя на сайте, и кодить на JavaScript становится проще. Например, нужно в элемент с id=myText1 вписать текст "hello":

😳 код без jQuery, т.е. на "чистом" JavaScript:
var el = document.getElementById("myText1");
el.innerHTML = "hello";

😌 Этот же код с jQuery:
$("#myText1").html("hello");

Но более-менее освоив этот букет, я с тех пор смог создавать фулл-стак проекты, то есть выполнять "в одно рыло" полный цикл разработки веб-сайта, начиная с управления его внешним видом и заканчивая самой отдалённой базой данных. Первой апробацией стал сайт-энциклопедия по украинскому лигалтеку в августе 2017. Недавно я основательно переделал его некоторые разделы, а другие прикрыл, ведь сделано было ужасно. Правда, я до сих пор так и не полюбил "верстать" сайты, то есть настраивать их внешний вид, интерфейс и т.д. Мне больше по душе писать алгоритмы на бэкенде, вплоть до нейросетей.

🗺 Путь в айти: ЧАСТЬ 1, ЧАСТЬ 2, ЧАСТЬ 3
​​🚥 Какими словами описывать свои разработки/алгоритмы

Как я уже писал раньше, алгоритмы своих разработок перед созданием важно грамотно описывать словами. Но это нужно не только для продуктивного самокопания, а и чтобы подключать к работе коллег, наёмников, инвесторов и прочих товарищей. Но описывать можно по-разному и с разным выхлопом. Чтобы объяснить это, я для своих презентаций соорудил "принцип светофора" (см. картинку), согласно которому разговоры о неначатых или недоделанных разработках/продуктах/алгоритмах нужно классифицировать на такие виды.

🅾️ Красные слова — ими описываете ваши глобальные цели и мечты, к которым вас ваша разработка должна приблизить. Эти слова лучше держать при себе. Разве что из них потом можно вывести какой-нибудь слоган в маркетинговых целях, для релиза или "ранних продаж". Эти слова не описывают сам алгоритм, лишь его глобальные последствия, ожидаемый эффект, миссию. Поэтому они нам как разработчикам не особо интересны (разве что для воодушевления, куда же без него в бессонные ночи).

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

Зелёные слова — здесь уже каждая фраза должна давать чёткое понимание того, что кодер должен сделать. Каждая такая фраза является "аватарой", заголовком для некоторого количества строк кода, примерно от десятка до сотни. По сути, из этих слов пишутся технические задания кодерам. Этими словами должны уметь разговаривать лигалинженеры (кстати, о лигалинженерах скоро поговорим отдельно).

Так что стараюсь выбивать из себя дурь и сразу говорить жёлтыми словами, а перед этим думать наперёд зелёными. Хотя во время брейншторминга люди думают всеми словами подряд, ведь хорошая идея может быть высказана и в общей абстрактной форме. Затем её нужно грамотно сузить и превратить в техническую задачу.