architect/arh/standards/structure-old/README.md

STRUCTURE STANDARDS — Стандарты структуры

Версия: 1.0.0
Дата: 2026-02-07

НАВИГАЦИЯ

Основные стандарты

Стандарт Когда использовать
FOLDERS_FILES_STRUCTURE.md ⭐ Начни здесь! Папки/файлы, уровни иерархии, слои документов
PROJECT_STRUCTURE.md DATA/PLAN/BUILD/OPS структура проекта
DOCUMENT_DRIVEN_DEVELOPMENT.md DDD подход, документы → код
PROJECT_HIERARCHY_PMI.md PMI-совместимая иерархия (Portfolio → Program → Project)

FOLDERS_FILES_STRUCTURE.md ⭐

Используй для:
- Организации проектов (organization → domain → project → engine → module)
- Понимания папки vs файлы
- Слоёв документов (.biz.md, .arc.md, .spc.md)
- Версионирования проектов (по годам)
- Терминологии

Пример:

it/
├── lideravto-2025/         ← проект (старый)
│   ├── index.yaml
│   ├── requirements.biz.md
│   └── cscart/             ← движок
│
└── lideravto-2026/         ← проект (новый)
    ├── index.yaml
    ├── architecture.arc.md
    └── cscart/

PROJECT_STRUCTURE.md

Используй для:
- Производственного цикла (DATA → PLAN → BUILD → OPS)
- Фрактальных блоков
- Универсальной структуры любого проекта

Пример:

project/
├── data/       ← источники данных
├── plan/       ← проектирование
├── build/      ← производство
└── ops/        ← эксплуатация

DOCUMENT_DRIVEN_DEVELOPMENT.md

Используй для:
- Подхода "документы → код"
- Понимания слоёв (business → design → specs → code)
- Трансформации документов

PROJECT_HIERARCHY_PMI.md

Используй для:
- PMI-совместимой иерархии
- Portfolio/Program уровней
- Крупных организаций (>20 проектов, >10M бюджет)

Пример:

organization → domain → portfolio → program → project

ПОСЛЕДОВАТЕЛЬНОСТЬ РАЗРАБОТКИ

Файл Описание
BUSINESS_TO_IT_FLOW.md 🔥 От бизнес-идеи до ИТ — полный цикл, что до ИТ, где ТЗ, переход biz→it
DOCUMENT_SEQUENCE.md ⏱️ Порядок создания документов — что создавать первым, триггеры, master file
WALKTHROUGH.md 👣 Пошаговый пример — создание lideravto с нуля (7 шагов, 2.5ч)

ГАЙДЫ ПО СЛОЯМ

Файл Описание
LAYERS_GUIDE.md ⭐ Какие слои на каких уровнях — матрица, примеры, правила
LAYERS_EXPLAINED.md 💡 Почему слои не последовательны — прогрессивные vs специализированные

ДРУГИЕ СТАНДАРТЫ

Файл Описание
UNIVERSAL_PROJECT_STRUCTURE.md ORG структура (biz/fin/it)
ORGANIZATION.md Организация workspace
ENTITY_HIERARCHY.md Иерархия сущностей
COMPONENTS.md Компоненты системы
WORKSPACE.md Структура workspace

БЫСТРЫЙ СТАРТ

1. Создание проекта

# Читай: FOLDERS_FILES_STRUCTURE.md

# Создать структуру
mkdir -p it/myproject-2026
cd it/myproject-2026

# Создать index.yaml
cat > index.yaml << EOF
type: project
version: 1.0.0
year: 2026
status: development
domain: dev.myproject.com
target-domain: myproject.com
engine:
  name: nodejs
EOF

# Создать документы
touch requirements.biz.md
touch architecture.arc.md

2. Организация производства

# Читай: PROJECT_STRUCTURE.md

# Создать структуру DATA/PLAN/BUILD/OPS
mkdir -p data/{sources,storage}
mkdir -p plan/{requirements,architecture}
mkdir -p build/dev
mkdir -p ops/{deploy,backup}

КАКОЙ СТАНДАРТ ВЫБРАТЬ?

Для малого проекта (<5 проектов)

→ FOLDERS_FILES_STRUCTURE.md

Простая иерархия:

organization → domain → project → engine → module

Для среднего проекта (5-20 проектов)

→ FOLDERS_FILES_STRUCTURE.md + PROJECT_STRUCTURE.md

Иерархия + производственный цикл:

it/myproject/
├── index.yaml
├── requirements.biz.md
├── data/
├── plan/
├── build/
└── ops/

Для крупного (>20 проектов, >10M)

→ Все стандарты + PROJECT_HIERARCHY_PMI.md

PMI иерархия:

organization → domain → portfolio → program → project

СВЯЗЬ СТАНДАРТОВ

FOLDERS_FILES_STRUCTURE.md      ← БАЗОВЫЙ (начни здесь!)
    ↓
PROJECT_STRUCTURE.md            ← внутри проекта (DATA/PLAN/BUILD/OPS)
    ↓
PROJECT_HIERARCHY_PMI.md        ← для крупных (Portfolio/Program)
    ↓
DOCUMENT_DRIVEN_DEVELOPMENT.md  ← подход (документы → код)

ВОПРОСЫ

Q: Какую структуру использовать для нового проекта?
A: Начни с FOLDERS_FILES_STRUCTURE.md (минимальная иерархия)

Q: Нужны ли Portfolio/Program уровни?
A: Только если >20 проектов или бюджет >10M (см. PROJECT_HIERARCHY_PMI.md)

Q: Где хранить документы и где код?
A: Документы = файлы .md, код = папки src/ (см. FOLDERS_FILES_STRUCTURE.md)

Q: Как версионировать проекты?
A: По годам: lideravto-2025/, lideravto-2026/ (см. FOLDERS_FILES_STRUCTURE.md, раздел "Версионирование")

Q: Нужна ли структура DATA/PLAN/BUILD/OPS?
A: Да, если проект средний/большой (см. PROJECT_STRUCTURE.md)

МИГРАЦИЯ

Если у тебя уже есть проект:

  1. Читай: FOLDERS_FILES_STRUCTURE.md, раздел "Миграция"
  2. Создай: новую структуру по стандарту
  3. Перенеси: файлы в новые папки
  4. Создай: index.yaml для каждого уровня
  5. Обнови: документацию (CLAUDE.md, README.md)

Версия: 1.0.0
Дата: 2026-02-07