Смериться или смириться как правильно пишется

Как я сказал в первой части этой статьи, мы решили написать систему, которая преобразует команды для отправки многочисленных инструкций на различные IoT реле на Blazor. Где по-быстрому, практически на коленке собрали отличную систему работы с этими реле. Всё было просто замечательно и быстро! Но не всё было так просто, как обещали.

Теперь давайте погрузимся в тёмный лес странных вещей, с которыми пришлось разбираться в Blazor. Естественно, технология не самая новая, и на Stackoverflow с большинством описанных проблем более-менее разобрались. Местами остался неприятный осадок, местами — недопонимание.

Итак, подводные камни Blazor, на которые вы наткнётесь в ваших проектах.

Камень 1 — WASM

Практически самая бесполезная часть работы с Blazor. Почему? Потому что итоговый размер бинарника поражает воображение. Во время дебага приложения я залез в консоль и увидел, что конечный размер всех бинарников превысил 15 мегабайт. После запуска релиза размер был взят под контроль и составил 7 мегабайт.

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

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

Но при всём при этом, если писать на vugu(golang), то можно начать с 3-х мегабайт и жать до одного.

Так что сама разработка на подобном фреймворке — это что-то, что должно происходить после долгого и основательного обдумывания. Опять же, даже если мы переключим наше приложение в режим server-side, то оно не будет по-человечески работать без стабильного канала. А если связь выпадает один раз и что-то не рендерится, то приложение вылетает по полной программе и страницу надо будет перезагружать. При этом теряется весь стейт приложения.

Итак, заключение: WASM в Blazor хоть и есть, но является одним из самых тяжеловесных фреймворков, которые существуют на рынке.

Камень 2 — Razor

Название Blazor происходит от Razor. И хотя сам Razor (2010) намного старше Blazor (2018), в нём есть определённые, мягко выражаясь, странности.

Например, очень странно видеть, как такой, казалось бы, достаточно старый движок, непростительно относится к мелким ошибкам в коде. Один пропущенный символ @ приводит к абсолютно полному пересмотру всего кода страницы. Причём это никак не сообщается в процессе разработки. VSCode вообще об этом умалчивает (и подсвечивает код, как будто он написан правильно), а Visual Studio просто перестаёт подсвечивать код как код, и показывает его как текст.

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

Для людей, пришедших в разработку с React, это будет очень раздражительно.

Вывод? За Razor нужен глаз да глаз. Пишите бога ради, но обязательно проверяйте, что вы написали, потому что очепятки останутся незамеченными без хорошего тестирования.

Камень 3 — Общение компонентов

Как и в React, в Blazor существует понятие о том, что такое компоненты. И действительно, лично для меня в обоих языках компонентная система была самой используемой фичей. Но при всём при этом компоненты в Blazor намного более необщительные, чем в React.

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

В React с этим не всё так гладко, но всё же, есть намного больше способов общаться между компонентами. Существуют Overmind, MobX и старый добрый Redux. В Blazor такого пока что не наблюдается. Приходится использовать свои собственные костыли или просто смириться с существующей системой компонентов.

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

Конечно, альтернативным вариантом было бы написание различных страниц и просто пропуск функционала обновления одних компонентов из других компонентов. Но это как-то бедно, я бы сказал.

Выводы: Прекрасное общение между компонентами нужно будет реализовывать руками.

Камень 4 — Жизненный цикл

И борьба с этим жизненным циклом. Если вы пришли из мира MVC, то вы наверняка знаете, что существуют различные стадии жизненного цикла страниц и компонентов. В Blazor незнание и непонимание любых аспектов жизненного цикла просто фатально.

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

Прекрасно, так и сделаем.

async protected override Task OnInitializedAsync()

{

	Refresher.Subscribe("ReBlaze.Pages.Devices", () =>

	{

    	UpdateDb().Wait();

    	InvokeAsync(StateHasChanged);

	});

	await UpdateDb();

	await base.OnInitializedAsync();

}

public void Dispose()

{

	Refresher.Unsubscribe("ReBlaze.Pages.Devices");

	Context?.Dispose();

}

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

Пришлось лезть и разбираться, и в итоге после недолгих поисков был найден виновник. Им оказался тот ученик, который не сел и не изучил систему обработки жизненного цикла от начала и до конца. Естественно, жизненный цикл будет разным для WASM и Server-side приложения. Это да.

Но он в том числе будет разным для Server-side и Server-side. Чего? Ну да, мы как бы забыли вам сказать, и вы с этим встретитесь в мануалах, но чуть глубже. У нас есть два варианта Server-Side Blazor, один из них это Server Pre-Render. Этот замечательный вариант обработки будет рендерить страницу на сервере, чтобы она была. Это сделано для совместимости с поисковиками и для того, чтобы страница быстрее доставлялась на клиент при первом открытии.

Когда пользователь обращается к странице в первый раз, мы её рендерим на сервере и отсылаем на сторону пользователя. А когда она отобразится, то специальный javascript дозагрузит все необходимые компоненты, и страница начнёт работать. Всё замечательно, но при этом мы ещё раз запустим ваше событие OnInitialized. Ну так, чисто чтобы поржать.

Что мы получаем в итоге?

Жесть и безобразие. Страницы, которые неправильно отображают пустые компоненты, двойные запросы и поломанные менеджеры состояния.

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

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

Ввиду того что приложение было локальным, мы просто отключили Server-Sider Pre-render и пошли простым путём.

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

Камень 5 — Сообщество

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

На Blazor написана одна и большая CMS под названием oqtane. Система позволяет писать свой код на Blazor и при этом более-менее по-человечески управлять контентом. С точки зрения разработки, выглядит это просто жестоко.

При создании плагина для Oqtane вам нужно будет установить саму CMS, после чего вам нужно будет создать сайт и в нём уже создавать плагин. Результатом создания плагина будет новый Solution, который надо будет открывать в VS и продолжать писать этот плагин.

Сомнительное удовольствие. Сам Oqtane пушится повсюду его создателем, и хотя коммиты делаются до сих пор, выглядит CMS в лучших традициях 2016 года.

Вывод? Самый лучший способ выучить Blazor — это либо прочитать инструкцию, либо взяться за толковый талмуд, учить методом тыка его не стоит. Он к этому очень непростителен.

Выводы

Что мы имеем? Что-то такое очень интересное. Попытка взять первое место в мире подобных фреймворков идёт в никуда. Если в 2019 году я ещё видел статьи о том, что Microsoft наконец-то выпустила убийцу React, то в 2021 году подобных статей поубавилось, да и хайпа не так много.

В итоге у нас получилась очень хорошая система для тех, кто работает в корпоративном секторе. Blazor как нельзя лучше подойдёт для внутрисетевых веб-сайтов, которые будут подгружать корпоративные данные и показывать их на экране. Портирование уже существующего C# кода на Blazor и WASM не займёт много времени. Поддержка компилирования на очень высоком уровне. И да, вы сможете напрямую использовать .NET WASM, он компилируется и очень даже стабилен. Естественно, определённые вещи в WASM недоступны, но обычная бизнес-логика переносится за секунды.

Плюс, Blazor очень легко встроить в уже существующие .NET проекты. С этим особых проблем нет.

Писать 3Д игру в браузере на Blazor? Нет, всё же лучше не стоит. Если уж очень хочется таким заниматься, то добро пожаловать в мир Rust. Yew вам в помощь. Тут мы получаем намного более компактные бинарники. Или, если хочется, вот вам C++ awesome-wasm.

С другой стороны, в мире WASM фреймворков высокоуровневых языков .NET является самым продвинутым. pyodide.org и vugu.org ещё не видели такой поддержки, как .NET. Только вот в этом и заключается загвоздка. .NET, golang, python — это языки, изначально разработанные для другой платформы, нежели WASM. И хотя мы и научили их компилироваться прямо в окно браузера, выглядят эти фреймворки очень даже сомнительно, в основном потому что тянут за собой наследие платформ, для которых они разрабатывались.

Хотя, несомненно, Server-Side Blazor лишён этих недостатков и просто является большой утилитой по сокрытию огромного количества подлежащего кода, который служит для выполнения ваших инструкций.

При наличии хорошего стабильного канала, эта утилита работает более чем прилично.

Учить Blazor стоит, но только если вы уже погружены в инфраструктуру .NET и готовы с ней работать. Начинать новый сервис можно и на более распространённых языках. Возьмитесь лучше за изучение TS и React.

НЛО прилетело и оставило здесь промокоды для читателей нашего блога:

— 15% на все тарифы VDS (кроме тарифа Прогрев) — HABRFIRSTVDS.

— 20% на выделенные серверы AMD Ryzen и Intel Core — HABRFIRSTDEDIC.

Доступно до 31 декабря 2021 г.

…сначала он подло стреляет ему в грудь, затем доносит на него правительству.

Чувство несправедливости, обида, гнев, желание доказать правду- все это вбирает в себя месть; именно эти чувства начинают управлять человеком.

Руководствуясь осознанием ответственности за свою семью…

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

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

Иногда месть может стать страшнее, суровее, чем само преступления.

Швабрин расценивает влюбленность Гринева в Машу как предательство, не пытаясь принять то, что девушка не любит его.

Ведь месть для него становится не средством борьбы со злом, не восстановлением справедливости, а способом поднятия самооценки, чествования своего эго.

Как ничего не упустить при подготовке техзадания? Как все правильно и удобно оформить? Можно ли вообще обойтись без ТЗ? Рассказывает аккаунт-директор scrum-студии Сибирикс Анна Кожевина.

Разработка интернет-магазинов становится все сложнее. В основном из-за конкуренции с готовыми решениями. Если нужны только базовые функции, чаще всего хватит и коробочного решения или даже конструктора сайтов. В них есть все основное: список товаров, карточка товара, корзина, оформление заказа, подключение оплаты и доставки, скидки, и даже история заказов в личном кабинете. Можно начать продажи очень быстро и с минимальными затратами на разработку.

Чаще всего за разработкой на заказ компании идут, когда по какой-то причине не подошло коробочное решение. Часто приходят с уже работающим интернет-магазином на подобной платформе. Приходят потому, что в коробке стало тесно – развитие невозможно без новых и нетиповых функций. Другая причина – на больших объемах каталога типовые решения начинают тормозить. 

Эти изменения произошли буквально за два года. Рынок заказной разработки интернет-магазинов стал другим. Но большинство аналитиков в веб-студиях привыкли писать технические задания на довольно простые проекты и начинают буксовать там, где надо продумать бизнес-логику. Можно получить объемное техническое задание, листов эдак на сто, которое на первый взгляд – ок. Только при разработке не сойдутся концы с концами. 

С чего начать?

Перспектива искать нестыковки в многостраничном документе не радует. Там более это не должно быть проблемой заказчика. Рекомендую начинать не с технического задания, а с предварительной аналитики. Проанализировать целевых пользователей и их пути по сайту, нарисовать диаграммы бизнес-процессов и спроектировать структуру сайта. Для ключевых страниц – разработать интерактивные прототипы. Чтобы можно было прокликать весь путь пользователя от входа на сайт до покупки и сразу увидеть, если какой-то шаг пропущен или что-то неудобно.

Второй момент – не стоит сразу писать техническое задание на все-все-все функции, которые вам хочется видеть на сайте. Лучше разбить проект на два контура. Начать лучше с MVP (или даже MLP – minimum lovable product): интернет-магазин с базовыми возможностями, с которыми можно запускаться. После – развитие проекта: все фишки и необязательные функции.

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

Все готово? Пишем ТЗ

Итак, вы определись с MVP и готовы переходить к техническому заданию. Есть два подхода: можно строить техническое задание исходя из ролей и сценариев пользователей, а можно – из разделов и функций интернет-магазина.

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

Кстати, очевидные вроде бы вещи, которые не описаны в ТЗ, никому, кроме вас, не очевидны.  И, скорее всего, в итоговый проект не попадут. И это не только в web-разработке. 

В далеком 2014 году мы строили себе офис. Прихожу я на стройку, и вижу, что сантехники сверлят одно отверстие под трубы с водой. Начинаю выяснять — почему так. Говорят: «Только под холодную сказали делать». Звоню застройщику — уточнить, когда же под горячую будут сверлить. Выясняю, что по проекту горячая вода в здании не предусмотрена. В смысле совсем. Все коммуникации в договоре (считай, в ТЗ) значились одной строкой. Мне же было очевидно, что они включают горячую воду. Пришлось вежливо удивиться. Горячую воду в здании в итоге подключили. 

Что же надо учесть в техническом задании, кроме описания страниц, чтобы потом не было неожиданностей? По опыту скажу, что нужны следующие разделы:

1. Общие требования к реализации

• Редакция CMS. Либо какой фреймворк  и админ-панель к нему используем. 
• Требования к верстке – делаем ли адаптивную версию? Под какими браузерами и начиная с какой версии сайт должен работать.
• Интеграция с внешними API – что именно подключаем: доставки, эквайринг, фискализация, sms-гейт, рекомендательные системы и т.д. Интеграция с ERP обычно описывается в отдельном документе – протоколе интеграции.

2. Базовая оптимизация

• SEO: уникальные классы, требования к ссылкам, редактирование мета-информации, настройка аналитики и т.д.
• Оптимизация для публикации в социальных сетях.
• Использование семантической разметки Schema.org.

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

4. Настройка прав доступа. Какие роли пользователей предусмотрены на сайте. Что могут пользователи в каждой из ролей.

5. Общие блоки и сервисы. Шапку сайта, футер, меню, хлебные крошки, формы – все желательно описать в одном месте, чтобы не дублировать описания на каждой странице.

6. Уведомления. Какие оповещения, кому, и при каких действиях пользователей приходят.  

Как упростить задачу?

Для написания технического задания удобно пользоваться шаблонами. Так делает большинство студий. Многие модули на сайтах – типовые. Нет смысла описывать их каждый раз заново. Если есть шаблон – задача сводится к тому, чтобы сделать копию шаблона, удалить в ней лишнее, а после – описать структуру страниц (по дизайну или прототипам) и нестандартные вещи. Поэтому разработка технического задания на проект у студии займет значительно меньше времени, чем если заказчик будет писать ТЗ самостоятельно.

Свои технические задания мы обязательно проверяем по чек-листу. Кстати, он подходит для проверки любых технических заданий.

Кроме того, готовый документ надо проверить на отсутствие явных «дыр». По сути – везде ответить на вопрос «Откуда это берется на странице?». Вариантов не так много:

1. Это хардкод? Это написали программисты и никто кроме них это поменять не может?

2. Это включаемая область? Сюда любой пользователь с доступом в админку может писать что угодно, что только позволяет HTML?

3. Это выборка из базы данных?

• Из какой сущности?
• Из каких полей?
• Это случайно не файл?
• Надо ли при этом что-то считать? Если «да» — то это формула!
• Кто эти данные сюда вносит? Админ? А ему на это хватит штатных возможностей админ-панели?
• Импорт? Откуда? Со стороннего ресурса?

4. Это формула?

• Какая? Да, ее надо написать.
• Откуда берутся ее коэффициенты?

5. Со стороннего ресурса? 

• С какого?
• По какому протоколу? Парсер? API? Добавляйте в ТЗ документацию.

А можно вообще без ТЗ?

С техническими заданиями множество проблем:

• Писать их трудоемко. Например, для интернет-магазина объем технического задания с достаточной детализацией составляет от 70 до 150 страниц. Чтобы написать такой документ, требуется дней пять работы хорошего аналитика. 
• Они моментально устаревают. С них чаще всего начинают разработку, но требования в процессе всегда уточняются. У заказчика появляются пожелания, особенно – когда он видит дизайн. Как итог, на этапе дизайна техническое задание чаще всего уже не актуально. Надо или смириться с этим, или после каждого изменения актуализировать ТЗ. Закладывайте время и деньги.
• Для разработчиков они либо слишком подробные, либо не полные. Либо и то и другое вместе. Часто компании проводят тендер на разработку ТЗ, чтобы потом по этому техническому заданию провести тендер на разработку сайта. Только чем подробнее описание задачи, тем больше времени надо, чтобы его понять, и тем больше в нем можно найти нестыковок. Как результат – разобраться в чужом техническом задании зачастую более трудоемко, чем написать свое с нуля.
• Для заказчиков они слишком сложные. Чтобы просто прочитать ТЗ целиком, надо потратить часов пять-шесть. Поэтому заказчики часто читают технические задания по диагонали и подписывают не глядя, а потом получают явно не то, что ждет начальство и акционеры. 

Нужно ли вообще ТЗ – вопрос спорный. Оно позволяет получить относительно точную оценку проекта, но только если его оценивает та же компания, которая техническое задание писала. Позволяет заказчику прикрыть тылы, но только если не давать ему устаревать. С другой стороны, чем детальнее и больше ТЗ – тем быстрее оно устареет и тем больше в нем будет нестыковок. 

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

Уже после предварительной аналитики и согласования прототипов, а в идеале и дизайна – писать техническое задание силами компании-разработчика. В таком техническом задании будут учтены все моменты из аналитики, а также требования команды разработки. Например, программисты могут работать по бэклогам – спискам конкретных задач. В таких случаях технические задания предпочтительнее готовить так, чтобы их можно было быстро и просто разобрать на такие списки. Кстати, можно и наоборот – подготовить бэклог и выгрузить его в техническое задание.

Основные рекомендации в одном месте

1. Напишите предварительное техническое задание – краткий документ с описанием ваших ожиданий от проекта. Его будет достаточно, чтобы получить оценку на разработку проекта. 

2. Делегируйте написание подробного технического задания компании-разработчику интернет-магазина. Не менять коней на переправе. Если сменить команду после написания ТЗ – будет ниже вовлеченность и, скорее всего, ТЗ будет переписываться. Это окажется в смете, хотя может и не явно, а вы оплатите разработку технического задания повторно.

3. Начинайте писать техническое задание как можно позже, в идеале – после согласования дизайна. Так есть шанс, что к этапу программирования оно не устареет.

4. Техническое задание нужно только на MVP. Все, что будет после первого релиза проекта, окажется неактуальным в момент этого релиза. Для развития проекта удобнее использовать бэклоги.

5. Техническое задание лучше писать исходя из страниц и функций. Оставьте пути пользователей предварительной аналитике. По такому техническому заданию можно быстро сформировать бэклог для программистов.