FDA

Fractal Domain Architecture — код для бизнеса, а не для вымышленных абстракций

Знак FDA: квадрат домена, разделённый на четыре таких же квадрата

FDA организует код приложения вокруг бизнес-доменов. Внутри каждого домена — одинаковый набор слоёв и файлов с предсказуемыми ролями. Структура самоподобна от компонентов до уровня всего приложения

Принципы

Фрактальность

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

Инверсия зависимостей

Repo → Model → RPC → Controller → UI. Слои имеют низкую связность и линейную зависимость в одном направлении

Явные контракты

Каждый файл — одна роль и один набор экспортов. Нарушение бросается в глаза на ревью

Framework-agnostic

SvelteKit, Next.js и Nuxt: меняются имена файлов, а слои и контракты остаются теми же

Документация

01. Введение

Проблема, которую решает FDA, и для каких проектов она подходит

02. Основные концепции

Фрактальность, слои и контракты — фундамент, на котором держится всё

03. Структура проекта

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

04. Домены и субдомены

Фрактальная организация и взаимодействие между модулями

05. Контракты файлов

Роль и экспорты каждого файла — с примерами из живого кода

06. Кросс-доменное взаимодействие

Родитель и потомок, соседние домены, публичный вход и алиасы

07. FAQ и Checklist

Частые вопросы и чеклист проверки модуля перед мержем

08. Скилл для AI-агентов

Правила FDA в виде скилла для Qwen Code, Claude Code и других агентов

Примеры

Сквозной пример документации — домен cart: корзина товаров с полным набором слоёв. Его код используется во всех разделах.

SvelteKit · Cart

Корзина товаров с полным набором слоёв на SvelteKit

Готово

Скилл для AI-агентов

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

FDA