architect/standards/1-structure/structure-platform.md

type: standard
aspect: structure
title: "Стандарт папок платформы"
status: active
version: 1.0.0
date: 2026-02-18
owner: architect
related:
- architect/standards/1-structure/structure-project.md
- architect/standards/1-structure/structure-workspace.md

Стандарт папок платформы

Определение

Универсальный принцип организации папок на всех уровнях платформы.

Базовый принцип

Прод — в корне. Разработка — в dev/. Архив — в arh/.

корень/        ← ПРОД (активная рабочая версия)
├── dev/       ← РАЗРАБОТКА (черновики, эксперименты)
└── arh/       ← АРХИВ (старые версии, история)

Этот принцип применяется на каждом уровне платформы.

Уровни применения

1. Воркспейс (workspace/)

Верхний уровень платформы:

workspace/
│
├── architect/          ← ПРОД: методология и стандарты
├── system/             ← ПРОД: ядро платформы
├── library/            ← ПРОД: библиотека компонентов
├── infra/              ← ПРОД: инфраструктура
├── constructors/       ← ПРОД: конструкторы
├── solutions/          ← ПРОД: готовые решения
├── projects/           ← ПРОД: бизнес-проекты
│
├── dev/                ← РАЗРАБОТКА (эксперименты)
└── arh/                ← АРХИВ (устаревшее)

2. Платформа (architect/)

Документация и стандарты:

architect/
│
├── theory/             ← ПРОД: теория (LOCKED)
├── concept/            ← ПРОД: концепция
├── standards/          ← ПРОД: стандарты
├── patterns/           ← ПРОД: паттерны
├── decisions/          ← ПРОД: решения (ADR)
├── templates/          ← ПРОД: шаблоны
├── research/           ← ПРОД: исследования
├── management/         ← ПРОД: управление платформой
│
├── dev/                ← РАЗРАБОТКА: черновики стандартов
└── arh/                ← АРХИВ: устаревшие документы

3. Блоки платформы (system/)

Функциональные блоки:

system/
│
├── agents/             ← Блок: AI-агенты
├── scheduler/          ← Блок: планировщик задач
├── monitor/            ← Блок: мониторинг
├── services/           ← Блок: сервисы платформы
│
├── dev/                ← РАЗРАБОТКА: новые блоки
└── arh/                ← АРХИВ: выведенные блоки

4. Группа проектов (projects/org/)

Организационный контейнер:

projects/
│
└── org/                ← ГРУППА: организации и компании
    ├── lideravto/      ← проект 1
    ├── pirotehnika/    ← проект 2
    └── ...

5. Проект (projects/org/name/)

Бизнес-проект (тип ORG):

project-name/
│
├── it/                 ← TYPE: IT направление
├── biz/                ← TYPE: Бизнес
├── fin/                ← TYPE: Финансы
│
├── dev/                ← РАЗРАБОТКА: черновики, исследования
└── arh/                ← АРХИВ: старые версии

6. IT-решение (it/solution/)

Технический компонент:

solution/
│
├── dev/                ← РАЗРАБОТКА: наш код
├── tst/                ← ТЕСТ: копия из dev/
├── prd/                ← ПРОД: боевая версия
├── app/                ← ШТАТНОЕ: core/vendor/contrib
│
├── deploy/             ← Деплой-скрипты
└── arh/                ← АРХИВ: бэкапы, старые версии

Именование папок

Папка Расшифровка Назначение
dev/ development Разработка / черновики
tst/ testing Тестирование (стейджинг)
prd/ production Продакшн (боевая версия)
app/ application Штатный код (не наш)
arh/ archive Архив (история, бэкапы)
biz/ business Бизнес-направление
fin/ finance Финансовое направление
it/ IT IT-направление

Правила:
- 3 буквы строчными (dev, tst, prd, arh)
- Без цифр и дефисов в базовых папках
- Исключения: app/ (3 буквы), deploy/ (семантика важнее)

Что куда идёт

dev/ (разработка)

Что Куда
Черновик стандарта architect/dev/
Эксперимент с новым блоком system/dev/
Активная разработка модуля it/solution/dev/custom/
Новый коннектор (sandbox) library/sandbox/

arh/ (архив)

Что Куда
Устаревший стандарт architect/arh/
Старая версия документации architect/arh/YYYY/
Бэкап перед деплоем it/solution/arh/YYYY-MM-DD_backup/
Старый сайт projects/name/arh/2025/

Прод (корень/папки без суффикса)

Что Куда
Утверждённый стандарт architect/standards/
Рабочий агент system/agents/
Боевой модуль it/solution/prd/
Стабильный коннектор library/connectors/

Жизненный цикл

dev/  →  (проверено)  →  прод  →  (устарело)  →  arh/

Для IT-решений:

dev/custom/  →  tst/custom/  →  prd/custom/  →  arh/YYYY-MM-DD/

Для документов:

dev/DRAFT.md  →  standards/DOCUMENT.md  →  arh/2026/DOCUMENT.md

Правила

  1. Прод — всегда в корне (или в именованной папке без суффикса)
  2. Нет суффиксов у прода — не standards-v2/, а standards/
  3. dev/ — только незавершённое — готовое сразу переносим в прод
  4. arh/ — только при явном устаревании — не "на всякий случай"
  5. Даты в arh/ — папки вида YYYY-MM-DD_описание/

Связи