architect/decisions/003-seven-components.md

type: decision
layer: arch
object: platform
aspect: structure
title: "ADR-003: 7 компонентов workspace"
status: active
date: 2026-04-14
id: ADR-003


ADR-003: 7 компонентов workspace

Дата: 2026-04-14
Статус: APPROVED


Контекст

Workspace платформы рос хаотично: architect/, system/, library/, projects/ на одном уровне с legacy-папками (constructors/, L0-ORG/, lideravto/ и др.). Не было чёткого ответа на вопрос "что куда кладём".

Нужна была единая модель: конечный список компонентов с чёткой ответственностью каждого.


Решение

Зафиксировать 7 компонентов верхнего уровня:

Компонент Вопрос Что хранит
architect/ ЧТО ЗНАЕМ? Теория, концепция, стандарты
projector/ КАК УПРАВЛЯЕМ? Методология проектов, шаблоны
projects/ ЧТО СТРОИМ? Клиентские и системные проекты
coder/ ЧЕМ СТРОИМ? Библиотека кода, IT-стеки
system/ КАК РАБОТАЕМ? AI-агенты, сервисы, мониторинг
infra/ НА ЧЁМ РАБОТАЕМ? Серверы, хранилища, сеть
services/ ЧТО ЗАПУЩЕНО? Docker-сервисы

Альтернативы

Плоская структура без деления — отклонена: масштаб платформы требует структуры.

Деление по технологиям (frontend/, backend/, devops/) — отклонена: смешивает знания и реализацию.

Доменная структура (org/, tech/, ops/) — отклонена: неочевидная граница между доменами на практике.


Последствия