О курсе
О курсе
Как устроен курс, для кого он, чем отличается от туториалов и обзоров.
Для кого этот курс
Для инженера, у которого уже есть 2–3 года бэкенд-разработки и который сталкивался с ситуацией «код работает, но что-то не так». Для того, кто читал одну-две статьи про Clean Architecture, но остались вопросы «а куда именно класть это?».
Не подходит для первого знакомства с бэкендом. Здесь нет разбора, как поднять FastAPI или подключить PostgreSQL. Курс исходит из того, что базовый стек вы знаете — обсуждаются архитектурные решения поверх него.
Философия
Не мнение автора, а карта мнений. Evans говорит одно про Repository. Seemann — противоположное. Khorikov — третье. Мы показываем всех, объясняем разницу и даём инструмент выбирать. Слепо следовать одному авторитету — плохой способ строить архитектуру.
Различаем «правильно» и «вкусовщина». Правило зависимостей (Dependency Rule) — правильно, с этим спорят только те, кто ещё не жёгся. Куда положить Port (в Domain или в Application) — вкусовщина, аргументы есть с обеих сторон. Мы явно маркируем одно и другое.
Реальный код, а не BankAccount. В курсах архитектуры обычно разбирают либо BankAccount с депозитами, либо Blog с постами. Мы разбираем настоящий Python-микросервис (анонимизированный) — со всеми компромиссами, которые бывают в живом проекте.
Каждое утверждение — либо очевидно, либо с ссылкой, либо помечено как мнение. В курсе нет «стоит отметить», «на самом деле», «как известно». Опытная аудитория теряет к таким оборотам доверие с первого абзаца.
Как построен
Курс — 25 глав, разбитых на 7 уровней прогрессии от фундамента (Coupling, Cohesion, SOLID) до Event Sourcing и антипаттернов. Каждая глава — самостоятельная страница. Читать можно подряд или входить точечно.
Внутри главы:
- TL;DR из 3–4 буллетов сверху;
- мотивация — какую проблему решает подход;
- теория с определениями и цитатами;
- «как правильно» и «как не надо» с код-примерами;
- trade-offs — когда применять и когда нет;
- интерактивная практика в некоторых главах;
- разбор реального кода из анонимизированного микросервиса;
- мини-quiz на закрепление;
- ссылки на первоисточники.
Технически
Сайт статический (Astro), никакой аналитики без cookie не отправляется. Прогресс чтения, ответы на quiz-ы и результаты интерактивов хранятся у вас в браузере через LocalStorage — вы полностью контролируете эти данные.
Курс — open source, каждая MDX-глава лежит в репозитории. Нашли ошибку — предлагайте правку через pull request.
Как читать
Первый раз. С «Фундамента», по порядку. Второй уровень (архитектурные стили) читается за один вечер и структурирует картину.
Прицельно. Через глоссарий или библиотеку источников. Скажем, если застряли на вопросе «где живёт транзакция?» — сразу в главу Repository и Unit of Work.
Как справочник. Каждая глава заканчивается списком первоисточников. Если хочется глубже — идёте к оригиналам Fowler / Evans / Vernon.