раздел 16
Архитектура и решения
Архитектура живёт в решениях, документы фиксируют "почему".
Начать раздел
Хочу пройти
Не получилось изменить список. Попробуй ещё раз.
Без входа у каждого урока видно начало. Войди, чтобы читать целиком, отмечать пройденное и решать задачи. войти
Уроки раздела
- Архитектура: декомпозиция, именование, связывание
- Описание против интерпретации: одна идея от монад до event sourcing
- Один Decider, четыре рантайма: Gleam, Effect, Haskell и Rust бок о бок
- Вертикальные и горизонтальные срезы: как резать фичу на проверяемые куски
- Карта документов: от vision до критериев приёмки
- Design records и ADR: как записывать устройство и решения
- Документы исполнения: от бэклога до плана отката
- Качество, эксплуатация и governance: документы вокруг живой системы
- API contract governance: контракт как закон для двух команд
- Тактические решения: автомат, состояние, ошибки, границы
- Контракт модуля: скрытые типы и несколько взглядов на реализацию
- Выбор реализации: функторы и модули как значения
- Слои как морфизмы: категорная модель гексагональной архитектуры
- Last Responsible Moment: когда принимать архитектурное решение
- NFR и переписывание с нуля: почему рабочие системы выбрасывают
- Обратимые и необратимые решения: сколько стоит откат
- Spike, прототип и tracer bullet: как проверять предположения
- Premortem: как найти тихий отказ до того, как он случится
- Эволюционная архитектура
- Fitness functions
- Анализ влияния изменений
- Язык стейкхолдеров и RFC
- Bus factor и передача знаний
- Архитектурная автономия
- Антипаттерн: спека должна быть проще кода
- Гомоморфизмы и абстракции
- Интерфейсы, контракты и абстракции
- Абстракции против паттерна MVC
- Хорошие абстракции для интерфейсов
Понятия курса
Понятия разобраны внутри уроков. Нажми на понятие, чтобы открыть урок, где оно объясняется.
Базис
- Vocabulary: ADR/RFC/BCP/NFR/PRD/HLD/LLDЧто чем называют. Records: для AI и для людей.урок 5 · Карта документов: от vision до критериев приёмкиопираются: урок 6, урок 7, урок 8
- Абстракции против MVCСимптом 1:1 interface↔class, RAP, ролевые интерфейсы, ISP против толстого CRUD, CQRS и вариантность, клиент владеет портом.урок 28 · Абстракции против паттерна MVCопираются: урок 29
- Архитектура: декомпозиция, именование, связываниеЧем режем систему, как называем части и какой топологией связываем. Контракты (типы, тесты, runtime-проверки), четыре способа связать модули, платформенный код.урок 1 · Архитектура: декомпозиция, именование, связываниеопираются: урок 5, урок 10, урок 11, урок 25
- Интерфейсы, контракты и абстракцииТри пересекающихся множества. Header, поверхностные и протекающие интерфейсы; Extract Interface не даёт абстракцию.урок 27 · Интерфейсы, контракты и абстракцииопираются: урок 28
- Модули: скрытое представление и явный контрактТип модуля объединяет операции и абстрактные типы. Подстановка реализации, законы стека сверх сигнатур и несколько публичных представлений одной реализации.урок 11 · Контракт модуля: скрытые типы и несколько взглядов на реализациюопираются: урок 12
- Спека может быть сложнее кодаАнтипаттерн «интерфейс проще реализации»: призрачное состояние, намеренная неточность и абстрактный барьер, из-за которого спека длиннее кода.урок 25 · Антипаттерн: спека должна быть проще кодаопираются: урок 26
- Тактические решения: автомат, состояние, ошибки, границыЧетыре повторяющихся решения на уровне кода, по три способа на каждое: конечный автомат, shared mutable state, обработка ошибок, связи модулей и видимость. Единый критерий выбора: восстановит ли читатель поведение через год.урок 10 · Тактические решения: автомат, состояние, ошибки, границы
- Гомоморфизмы и абстракцииАбстракция как классы одинакового поведения относительно операции: связь с гомоморфизмом, неточность домена и старт АТД от операций.урок 26 · Гомоморфизмы и абстракцииопираются: урок 27
- Модули: выбор реализации и связанные типыФункторы OCaml, явный выбор реализации и упаковка модуля со скрытым типом. Совместимость состояний, ограничения бинарных операций и отличие от классов типов.урок 12 · Выбор реализации: функторы и модули как значения
- Описание против интерпретацииОдин приём от монад до event sourcing: программа как данные, исполнение отдельным интерпретатором. Лестница абстракции и где приём оправдан.урок 2 · Описание против интерпретации: одна идея от монад до event sourcingопираются: урок 13
- Слои как морфизмы: категорная модельПорт как контейнер, слой один к одному как естественное преобразование, контравариантность ответа и версии API, категория слоёв над свободной монадой и бесплатная композиция.урок 13 · Слои как морфизмы: категорная модель гексагональной архитектуры
- Хорошие абстракции для интерфейсовRAP и Composite как лакмус; лестница ISP → Command → замыкание операций → ослабления; мост к контракту модуля.урок 29 · Хорошие абстракции для интерфейсов
Strategy
- Strategy & scopeVision, Roadmap, Stakeholders, Risks, Assumptions.урок 5 · Карта документов: от vision до критериев приёмкиопираются: урок 18
Requirements
- Requirements & analysisProblem, Scope, Functional & NFR, User story, Use case, Acceptance criteria (BDD), Domain glossary, Compliance.урок 5 · Карта документов: от vision до критериев приёмкиопираются: урок 6, урок 15
Design
- ADR подробноКогда писать. Контекст, причины, ограничения, альтернативы, последствия, статус, связи, метрики, триггеры пересмотра.урок 6 · Design records и ADR: как записывать устройство и решенияопираются: урок 14, урок 16, урок 22
- Architecture & design recordsC4, deployment, context map, domain model, API spec, schema, event/command catalog, threat model, RFC, ADR, PoC, migration plan, capacity/cost models.урок 6 · Design records и ADR: как записывать устройство и решенияопираются: урок 2, урок 9
Execution
- Planning & executionBacklog, Sprint plan, Release plan, Milestones, Retro, Lessons learned.урок 7 · Документы исполнения: от бэклога до плана откатаопираются: урок 4
- Source / Build / DeliveryREADME, contribution, coding standard, PR/review, release notes, CI/CD spec, IaC, deployment record, rollback, feature flag register, secrets inventory.урок 7 · Документы исполнения: от бэклога до плана откатаопираются: урок 4, урок 8
- Вертикальные и горизонтальные срезыКак резать фичу на проверяемые куски: сквозной скелет, тонкие вертикальные срезы, когда горизонталь оправдана, обозримость диффа в эпоху AI-агентов.урок 4 · Вертикальные и горизонтальные срезы: как резать фичу на проверяемые кускиопираются: урок 17
Quality
- Testing & quality recordsTest plan, coverage, perf/security report, defect record, audit report.урок 8 · Качество, эксплуатация и governance: документы вокруг живой системы
- Operations & reliabilitySLI/SLA, incident record, postmortem, known issue, availability report, restore test, DR plan.урок 8 · Качество, эксплуатация и governance: документы вокруг живой системыопираются: урок 9
Governance
- Knowledge & onboardingArchitecture/engineering handbook, onboarding guide, FAQ.урок 8 · Качество, эксплуатация и governance: документы вокруг живой системыопираются: урок 23
- Security / Legal / GovernanceSecurity policy, PIA, retention, license record, vendor assessment.урок 8 · Качество, эксплуатация и governance: документы вокруг живой системы
Practice
- API Contract GovernanceКонтракты обязывают обе стороны. Schema-first. Контракт != реализация. Матрица владения. CI вместо доверия.урок 9 · API contract governance: контракт как закон для двух командопираются: урок 21
Functional DDD
- Один Decider, два рантайма: Gleam и EffectОдин Reservation Decider бок о бок на Gleam и Effect. Что меняется со сменой языка (номинальный тип, эффекты, ошибки), а что остаётся (домен, тройка функций, закон replay).урок 3 · Один Decider, четыре рантайма: Gleam, Effect, Haskell и Rust бок о бок
Решения во времени
- Обратимые и необратимые решенияОдностворчатые и двустворчатые двери (Amazon, 2015). Цена отката: данные, простой, версии API, мобильные клиенты, другие команды. Как удешевить выбор: изоляция, адаптеры, флаги, двойная запись.урок 16 · Обратимые и необратимые решения: сколько стоит откатопираются: урок 24
- Last Responsible Moment: когда решатьОткладывать решение до момента, когда есть нужная информация, а не как можно дольше. Затянутый выбор как проблема, most responsible moment, дешёвая гибкость, пока NFR неясны, и что фиксировать рано.урок 14 · Last Responsible Moment: когда принимать архитектурное решениеопираются: урок 19
- NFR и переписывание с нуляПочему рабочие системы выбрасывают: проигнорированные объём данных, задержка, надёжность, масштаб. NFR числами: ISO/IEC 25010, arc42, сценарии качества, ASR. Цена овер-инжиниринга против цены переписывания.урок 15 · NFR и переписывание с нуля: почему рабочие системы выбрасывают
- Premortem и риск тихих отказовPremortem (Klein): представить, что система уже сломалась, и назвать причины. Тихая порча данных, редкая ошибка хуже постоянной, масштаб последствий, ранжирование сценариев. Доказательная база техники.урок 18 · Premortem: как найти тихий отказ до того, как он случится
- Spike, PoC, прототип и tracer bulletПроверить рискованное предположение за часы или дни: вопрос, таймбокс, изолированный стенд, запись результата. Что выбрасывают, а что наращивают. R&D в плане и DSL архитектуры (C4, Structurizr, LikeC4).урок 17 · Spike, прототип и tracer bullet: как проверять предположения
Эволюция
- Анализ влияния измененийМаленький дифф не значит безопасный: путь изменения через конфиги, контракты, типы и схемы событий. Трассировка, зависимости, экспертиза; радиус поражения и что смотреть в PR кроме строк.урок 21 · Анализ влияния изменений
- Эволюционная архитектураНаправляемые маленькие изменения вместо переписывания (Ford, Parsons, Kua): корректировка курса, дешёвая гибкость там, где изменения вероятны, и никакой там, где их не будет.урок 19 · Эволюционная архитектураопираются: урок 20
- Fitness functionsПроверки архитектурных свойств в CI: циклы, слои, идемпотентность, связность, сложность. ArchUnit, dependency-cruiser, заморозка старых нарушений. Время и токены агента на типовое изменение как метрика.урок 20 · Fitness functions
Люди и решения
- Архитектурная автономия и владениеПраво на маленькие решения, границы владения (таблицы, модули, контракты, процессы), CODEOWNERS и закон Конвея. Путь от исполнения к авторству принципов; вернуть решение владельцу.урок 24 · Архитектурная автономия
- Язык стейкхолдеров и RFCГоворить о техдолге языком риска и предсказуемости, а не «плохих абстракций». RFC до ADR: повод для обсуждения, клапан для несогласия, способ узнать новое от коллег.урок 22 · Язык стейкхолдеров и RFC
- Bus factor и передача знанийBus factor как показатель людей и архитектуры, оценка по истории репозитория. Незаменимость как ловушка, онбординг и привычки команды важнее фреймворка.урок 23 · Bus factor и передача знаний