S0ER – Telegram

S0ER

Недавно на созвоне в Соер.Клубе обсуждали вопросы создания Architecture Decision Record (ADR), у нас была задача описать условия при которых целесообразно создавать и вести ADR.
Обсудили огромное количество деталей, которые хочется обобщить и зафиксировать в виде коротких подсказок. Возможно вам тоже будет полезно.

#cards #adr

1👍4296🔥5

7.9K views11:18

S0ER

Forwarded from Соер.Клуб | инженерный подход

Первый шаг к понимаю архитектуры ПО - понимание контекста решаемого вопроса.

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

Сложность в том, что по архитектуре ПО нет общего стандарта, который можно было бы брать за основу и говорить всем "так и только так правильно", одни и те же термины используются разными авторами в разных контекстам по-разному (например, "зависимость" в UML и зависимость в DIP - имеют разные смыслы, или "пасивность view" в MVC и MVP тоже разные, более того есть свой вариант MVC для десктопов и веб).

Поэтому при проектировании я придерживаюсь следующего порядка:
1. Определить контекст
2. Определит архитектурную идею (об этом как-нибудь тоже расскажу)
3. Отразить схему или диаграмму для иллюстрации идеи.

Графическое представление идеи - очень важно, но без контекста может сильно запутать. Пока не появится привычки отделять "мух от котлет" ни о каком понимании речи идти не может.

1👍1443

7.05K views06:41

S0ER

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

Please open Telegram to view this post

VIEW IN TELEGRAM

SOER.MEDIA

Как правильно использовать и обрабатывать исключения в программе (для бэкенда)

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

176🔥298

8.55K views04:36

S0ER

Сейчас на практике встречается четыре основных подход в архитектуре:

1️⃣ Монолит

2️⃣ Сервисный подход

3️⃣ Микросервисный

4️⃣ Событийный подход

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

Это базовая четвёрка является основой абсолютного большинства решений на рынке. Я сделал небольшой обзор каждого из них. Думаю будет полезно ознакомиться каждому.

Please open Telegram to view this post

VIEW IN TELEGRAM

SOER.MEDIA

Чем отличаются монолитная, сервисная, микросервисная и event-driven архитектуры

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

3❤34👍2296

7.16K views00:42

S0ER

В прошлом посте об обработке ошибок на бэкенде мы собрали больше 100 отметок 💡, выполняю свое обещание и публикую новую заметку на тему исключений - Как правильно обрабатывать исключения (для фронтенда). На этот раз я больше задумался об архитектурных вопросах обработки ошибок, и в итоге получил более полный и глубокий разбор, надеюсь вам понравится.

SOER | PRO | Boosty

Please open Telegram to view this post

VIEW IN TELEGRAM

S0ER

119👍134

4.96K viewsedited 05:56

S0ER

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

Ради справедливости стоит сказать, что некоторые правила оказываются весьма удачными, потому что просты и понятны. Примеры хороших правил - "is-a" и "has-a".

IS-A
гласит, что наследование уместно использовать там, где можно вместо слова "наследование" подставить "is-a" (является). Если мы хотим понять, может ли стул наследоваться от стола, то фраза "стул является столом" подсказывает, что нет, не можем.

HAS-A
гласит, что композицию уместно использовать там, где слово "композиция" может быть заменена на "has-a" (имеет). Например, "Стол это композиция столешницы и ножек" может быть заменен на "Стол имеет столешницу и ножки", правило выполняется, а следовательно композиция в данном случае применима.

2👍61106❤2👎2🔥1👌1

4.74K views00:38

S0ER

Forwarded from Соер.Клуб | инженерный подход

⬛️

⬜️

⚫️

⚪️

💡

Please open Telegram to view this post

VIEW IN TELEGRAM

👍15🔥6❤1

3.96K views10:13

S0ER

Промпт для исправления ошибок в коде

Некоторое время использую QWEN3-Coder-480b-А35b-Instruct и QWEN Coder. Модель в чем-то хороша, в чем-то не очень. Хочу рассказать о своем опыте борьбы с неверным поведением модели.

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

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

Сообщение от интерпретатора выглядит так:

Failed to run `config` for agentsoer.nvim
                                                                                                                                                                                                                                                                      
vim/loader.lua:0: ...soer/projects/agentsoer.nvim/lua/agentsoer/engine/ai.lua:43: '<name>' expected near 'function'                                                                                                                                                   
                                                                                                                                                                                                                                                                      
# stacktrace:                                                                                                                                                                                                                                                         
  - vim/loader.lua:0                                                                                                                                                                                                                                                  
  - lua/agentsoer/commands.lua:5                                                                                                                                                                                                                                      
  - lua/agentsoer/init.lua:4                                                                                                                                                                                                                                          
  - ~/.config/nvim/lua/plugins/init.lua:34 _in_ **config**                                                                                                                                                                                                            
  - ~/.config/nvim/init.lua:17

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

42 local function handle_tool_call(tool_call)
43  if tool_call.function.name == "list_directory" then
44    local success, params = pcall(vim.fn.json_decode, tool_call.function.arguments)
45    if success then

Особенность в том, что "function" здесь представляет собой имя поля в таблице, а не ключевое слово Lua для объявления функций. Это требование продиктовано не локальными особенностями, а спецификацией OpenAI API. Следовательно, ИИ должен не только диагностировать суть недочёта, но и предложить корректное решение. Например, вместо замены имени поля следует использовать обращение через квадратные скобки: ['function'].name.

GitHub

GitHub - QwenLM/qwen-code: Qwen Code is a coding agent that lives in the digital world.

Qwen Code is a coding agent that lives in the digital world. - QwenLM/qwen-code

❤7👍7👎6

3.3K viewsedited 05:33

S0ER

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

Неудачный промпт:

Исправь ошибку

vim/loader.lua:0: ...soer/projects/agentsoer.nvim/lua/agentsoer/engine/ai.lua:43: '<name>' expected near 'function'                                                                                                                                                   
                                                                                                                                                                                                                                                                      
# stacktrace:                                                                                                                                                                                                                                                         
...

Эффективный промпт:

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

vim/loader.lua:0: ...soer/projects/agentsoer.nvim/lua/agentsoer/engine/ai.lua:43: '<name>' expected near 'function'                                                                                                                                                   
                                                                                                                                                                                                                                                                      
# stacktrace:                                                                                                                                                                                                                                                         
...

👎7👍42

4.09K viewsedited 05:33

S0ER

В своих экспериментах я использовал QWEN3-Coder-480b-А35b-Instruct. При первом подходе модель начинала с синтаксического разбора, затем последовательно анализировала файл в поисках непечатных символов, способных сбить с толку интерпретатор, после чего пыталась создать минимально работоспособную версию и доработать её. В конечном счёте этот процесс приводил к исчерпанию лимитов сессии.

При втором, более эффективном подходе, та же самая модель находила и корректировала неточность всего за 2-3 итерации после начала диалога.

Чтобы сэкономить токины я в первую очередь предлагаю исправлять ИИ ошибки как синтаксические, потому что стадия "анализа ошибки" может быть весьма объемной, если ИИ не справляется с первого раза, то переходить на второй вариант. Если и второй вариант не помог, то смотреть ошибку самому. Как я уже сказал, большая часть проблема отсекается на первом этапе, семантические проблемы на втором. И крайне редко приходится смотреть самому, как правило если речь заходит о рефакторинге, где старый код сильно сбивает ИИ.

👍9👎51

5.09K viewsedited 05:33

S0ER

Завел себе канал в Максе, говорят там самая адекватная аудитория! Когда телегу поблочат, увидимся с вами там)

https://max.ru/softwareengineervlog

max.ru

MAX – быстрое и легкое приложение для общения и решения повседневных задач

MAX позволяет отправлять любые виды сообщений и звонить даже на слабых устройствах и при низкой скорости интернета.