Зафиксировать правило фабрик и билдеров в код-стайле

2026-09-13 03:41:39 +03:00
parent d172b6408b
commit f788b6d39b
1 changed files with 19 additions and 0 deletions
@@ -103,6 +103,25 @@
 - Асинхронность: суффикс `Async`, `CancellationToken` пробрасывать до конца; `.Result` / `.Wait()`
  запрещены — только `await`.

+### 4.1. Фабрики и билдеры
+
+- **Нетривиальные объекты с интерфейсом создаются только фабриками.** Реализация сервиса/адаптера,
+  у которого есть порт-интерфейс, не создаётся прямым `new` в прикладном коде или композиционном корне —
+  только внутри фабрики. Форма пары: `IXxxFactory` (порт фабрики) + `XxxFactory` (реализация), метод
+  `Create(...)` возвращает **интерфейс** готового объекта (`ISecretCipher`, `IFileStorage`, …).
+- Фабрика сама регистрируется в DI (`AddScoped`/`AddSingleton<IXxxFactory, XxxFactory>()`) — контейнер
+  конструирует её без `new`; зависимости фабрики — тоже DI.
+- **Билдер** (`IXxxBuilder`/`XxxBuilder`) добавляется, когда объект собирается итеративно из многих частей
+  или опций; фабрика делегирует сборку билдеру, а не повторяет её.
+- Исключения из правила (прямой `new` допустим):
+  - DTO, рекорды, value-объекты, `Options`/`Settings`-снимки;
+  - исключения (`*Exception`) и примитивы/BCL-типы (`StringBuilder`, `NpgsqlConnection`, `MinioClient`, …);
+  - статические классы и хэлперы без состояния (фабрику для них не заводим);
+  - EF-конфигурации (`IEntityTypeConfiguration`) — это метаданные модели, а не прикладные объекты;
+  - обёртки ресурсов без порт-интерфейса (gRPC-соединения с `IDisposable`);
+  - объекты без порт-интерфейса, создаваемые контейнером (`AddScoped<Concrete>()`).
+- Тесты могут конструировать проверяемый тип прямым `new` — это часть самого теста, а не прикладного кода.
+
 ## 5. Комментирование кода

 Все комментарии — на русском языке.