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

FOLDERS & FILES STRUCTURE — Папки и файлы

Версия: 3.0.0
Дата: 2026-02-07
Статус: Active

НАЗНАЧЕНИЕ

Стандарт организации проектов через папки и файлы:
- Уровни иерархии (organization → project)
- Слои документов (.biz.md, .arc.md)
- Версионирование проектов
- Терминология

БАЗОВЫЙ ПРИНЦИП

ПАПКА = уровень иерархии ИЛИ код
ФАЙЛ  = документ (слой)

Правила разделения

ПАПКА — если это:
1. Уровень иерархии (organization, domain, project)
2. Движок/платформа (cscart, wordpress, drupal)
3. Модуль/компонент (catalog, import, auth)
4. Код (src/, lib/, modules/)

ФАЙЛ — если это:
1. Документ (.biz.md, .arc.md, .spc.md, .api.md, .ops.md, .tst.md)
2. Метаданные (index.yaml)
3. Конфигурация (.env, config.yaml)
4. Исходный код (.php, .js, .py)

⚠️ ВАЖНОЕ ПРАВИЛО: Создавать только нужное

НЕ создавать все файлы и папки заранее!

❌ НЕПРАВИЛЬНО (всё сразу):
project/
├── requirements.biz.md
├── architecture.arc.md
├── spec.spc.md
├── api.api.md
├── deployment.ops.md
├── test.tst.md
├── dev/
├── test/
└── prod/

✅ ПРАВИЛЬНО (только нужное):
project/
├── index.yaml
└── requirements.biz.md    ← начали с этого

Правило: Создавай файл/папку только когда она нужна:
- Начинаешь проект → создай index.yaml + requirements.biz.md
- Появилась архитектура → создай architecture.arc.md
- Нужен деплой → создай dev/ окружение
- Готов к продакшн → создай prod/

УРОВНИ ИЕРАРХИИ

organization        lideravto/
    ↓
domain              it/, biz/, fin/
    ↓
project             lideravto-2026/
    ↓
engine              cscart/
    ↓
module              catalog/, import/
    ↓
component           Filter/, Search/

1. ORGANIZATION (организация)

lideravto/
├── index.yaml              ← метаданные
├── vision.biz.md           ← документы
├── strategy.biz.md
│
├── biz/                    ← domains
├── fin/
└── it/

index.yaml

type: organization
name: ЛидерАвто
industry: retail
business-model: b2c
size: small

domains:
  - biz
  - fin
  - it

2. DOMAIN (направление)

it/
├── index.yaml              ← метаданные
├── tech-stack.arc.md       ← документы
├── infrastructure.ops.md
│
├── lideravto-2025/         ← projects
└── lideravto-2026/

index.yaml

type: domain
area: it
parent: lideravto

projects:
  - lideravto-2025
  - lideravto-2026

3. PROJECT (проект)

lideravto-2026/
├── index.yaml              ← метаданные
├── requirements.biz.md     ← документы
├── architecture.arc.md
├── api-catalog.api.md
├── deployment.ops.md
│
├── dev/                    ← окружение разработки
│   ├── .env
│   └── cscart/             ← engine (dev)
│       └── modules/
│
├── test/                   ← окружение тестирования
│   ├── .env
│   └── cscart/             ← engine (test)
│       └── modules/
│
└── prod/                   ← окружение продакшн
    ├── .env
    └── cscart/             ← engine (prod)
        └── modules/

index.yaml

type: project
name: ЛидерАвто (новый сайт)

version: 2.0.0
year: 2026
status: development

# Домены
domain: work.lideravto.ru       # текущий (временный)
target-domain: lideravto.ru     # целевой (после запуска)

# Движок
engine:
  name: cscart
  version: 4.19.1

# Технологии
tech:
  frontend: javascript
  backend: php
  database: mysql

# Окружения (папки)
environments:
  - dev       # → dev/
  - test      # → test/
  - prod      # → prod/

4. ENGINE (движок)

cscart/
├── index.yaml              ← метаданные
├── config.php              ← конфигурация
├── var/                    ← данные движка
│
└── modules/                ← модули
    ├── catalog/
    └── import/

index.yaml

type: engine
name: CS-Cart
version: 4.19.1

5. MODULE (модуль)

modules/catalog/
├── index.yaml              ← метаданные
├── spec.spc.md             ← документы
├── api.api.md
│
└── src/                    ← код
    ├── Catalog.php
    ├── CatalogService.php
    └── CatalogRepository.php

index.yaml

type: module
name: Catalog
purpose: Управление каталогом товаров

dependencies:
  - import
  - search

6. COMPONENT (компонент)

src/components/Filter/
├── Filter.php
├── FilterService.php
└── FilterRepository.php

Компоненты обычно НЕ имеют отдельных документов, только код.

СЛОИ ДОКУМЕНТОВ

ВАЖНО: Слои имеют ДВОЙНУЮ природу:

  1. Слои как ПРОГРЕССИЯ — эволюция документа от идеи к коду:
    business → design → specs → prompts → code

  2. Слои как РАСШИРЕНИЯ — типы файлов на каждом уровне иерархии:
    .biz.md, .arc.md, .spc.md, .api.md, .pmt.md, .ops.md, .tst.md

Прогрессия документов

ИДЕЯ (business)
    ↓ конкретизация
ДИЗАЙН (design)
    ↓ детализация
СПЕЦИФИКАЦИЯ (specs)
    ↓ инструкции
ПРОМПТЫ (prompts)
    ↓ реализация
КОД (code)

Пример потока:
1. purpose.biz.md — зачем нужен каталог
2. design.dsg.md — как устроен каталог
3. spec-features.spc.md — что умеет каталог
4. prompt-create.pmt.md — инструкция для AI
5. src/Catalog.php — готовый код

Матрица слоёв × уровней

Какие слои применимы на каких уровнях:

Уровень .biz .ops .str .prj .arc .dsg .spc .api .pmt .tst src/
organization ✅ ✅ ✅ — — — — — — — ❌
domain ✅ ✅ — — ✅ — — — — — ❌
project ✅ ⚠️ — ✅ ✅ — — — — — ⚠️
engine — ⚠️ — — — — — — — — ✅
module ⚠️ — — — — ✅ ✅ ✅ ✅ ✅ ✅
component — — — — — — ✅ — ✅ ⚠️ ✅

Обозначения:
- ✅ — рекомендуется использовать
- ⚠️ — опционально (создавать только если нужно)
- ❌ — не использовать (код на этом уровне не пишем)
- — — не применимо

Расширения (подробно)

Расширение Слой Основные уровни Содержимое
.biz.md Бизнес org, domain, project Vision, strategy, requirements
.ops.md Операции org, domain Deploy, monitoring, backup, processes
.str.md Структура org Organization structure, departments
.prj.md Проект project Project plan, roadmap, milestones
.arc.md Архитектура domain, project Tech stack, architecture, design
.dsg.md Дизайн module Component design, patterns, решения
.spc.md Спецификации module, component Features, функции, детали реализации
.api.md API module Endpoints, методы, схемы данных
.pmt.md Промпты module, component Инструкции для AI-кодера
.tst.md Тесты module, component Test plan, test cases, сценарии

Правило выбора слоя:

Уровень organization → .biz (стратегия), .ops (процессы), .str (структура)
Уровень domain       → .biz (требования), .arc (техстек), .ops (инфра)
Уровень project      → .biz (требования), .prj (план), .arc (архитектура)
Уровень engine       → только конфиги движка (config.php, .env)
Уровень module       → .spc (спеки), .api (API), .pmt (промпты), .tst (тесты)
Уровень component    → .spc (спеки), .pmt (промпты)

Примеры файлов

# Бизнес-слой
vision.biz.md               ← видение компании
strategy-2026-2028.biz.md   ← стратегия
requirements.biz.md         ← требования к проекту

# Архитектура
tech-stack.arc.md           ← технологии
architecture.arc.md         ← архитектура системы
infrastructure.ops.md       ← инфраструктура

# Спецификации
catalog-spec.spc.md         ← спецификация каталога
features.spc.md             ← описание функций

# API
api-catalog.api.md          ← API каталога
api-orders.api.md           ← API заказов

# Операции
deployment.ops.md           ← инструкции деплоя
monitoring.ops.md           ← мониторинг системы

# Тесты
testing-plan.tst.md         ← план тестирования
test-cases.tst.md           ← тест-кейсы

ШАБЛОНЫ ФАЙЛОВ

Правило именования

ФОРМАТ:

{entity}-{detail}-{number}.{layer}.md

Части:
- entity — сущность (catalog, import, features, categories)
- detail — детализация (create, update, delete, list) — опционально
- number — номер части (01, 02, 03) — опционально, для дробления
- layer — тип слоя (biz, arc, spc, pmt, api, ops, tst)

Примеры:

# Простые (один документ)
requirements.biz.md             ← требования проекта
architecture.arc.md             ← архитектура
catalog.spc.md                  ← спека каталога

# С детализацией
catalog-features.spc.md         ← фичи каталога
catalog-api.api.md              ← API каталога
catalog-install.pmt.md          ← промпт установки

# С детализацией + детали
catalog-features-create.spc.md  ← создание фичи
catalog-features-update.spc.md  ← обновление фичи
catalog-features-delete.spc.md  ← удаление фичи

# Дробление большого документа (номера)
catalog-features-01.spc.md      ← фичи часть 1
catalog-features-02.spc.md      ← фичи часть 2
catalog-features-03.spc.md      ← фичи часть 3

# Детализация + дробление
import-parser-01.spc.md         ← парсер часть 1
import-parser-02.spc.md         ← парсер часть 2
import-validator-01.spc.md      ← валидатор часть 1

Сокращённые формы (допустимы):

spec.spc.md                     ← если один файл спеки
api.api.md                      ← если один файл API
test.tst.md                     ← если один файл тестов

index.yaml

type: project                    # organization|domain|project|engine|module|component
version: 1.0.0                   # Версия (опционально)
year: 2026                       # Год создания (для проектов)
status: development              # planning|development|production|maintenance
domain: work.lideravto.ru        # Текущий домен
target-domain: lideravto.ru      # Целевой домен (опционально)

# Движок (для проектов)
engine:
  name: cscart
  version: 4.19.1

# Окружения (для проектов)
environments:
  - dev
  - test
  - prod

# Дочерние сущности (опционально)
children:
  - catalog
  - import

.biz.md (Бизнес)

# Назначение

Краткое описание зачем.

## Бизнес-задача

Какую проблему решаем.

## Ценность

Что получим.

## Требования

- Требование 1
- Требование 2

Примеры: vision.biz.md, requirements.biz.md, purpose.biz.md

.arc.md (Архитектура)

# Архитектура: Название

## Технологии

- Frontend: React
- Backend: PHP
- Database: MySQL

## Структура

module/
├── src/
└── tests/

## Компоненты

1. Компонент 1 - описание
2. Компонент 2 - описание

Примеры: architecture.arc.md, tech-stack.arc.md, infrastructure.arc.md

.spc.md (Спецификация)

# Спецификация: Название

## Функция

**Имя:** `fn_name()`

**Параметры:**
- `$param` (type) - описание

**Возвращает:**
- type - описание

## Логика

1. Шаг 1
2. Шаг 2

## Тесты

- [ ] Создаёт сущность
- [ ] Обрабатывает ошибки

Примеры: spec.spc.md, spec-features.spc.md, spec-features-create.spc.md

.api.md (API)

# API: Название

## Функции

### fn_name()

**Описание:** Что делает

**Параметры:**
- `$param` (type) - описание

**Возвращает:**
- type - описание

**Пример:**
```php
$result = fn_name($param);

**Примеры:** `api.api.md`, `api-catalog.api.md`, `api-orders.api.md`

### .pmt.md (Промпт для AI)

```markdown
# Промпт: Название

Создай [что] в файле `src/[путь]`

## Требования

1. Требование 1
2. Требование 2

## Логика

1. Шаг 1
2. Шаг 2

## Использовать

- API функция 1
- API функция 2

## НЕ использовать

- Прямые SQL

Примеры: prompt-install.pmt.md, prompt-features.pmt.md

.ops.md (Операции)

# Операции: Название

## Развёртывание

1. Шаг 1
2. Шаг 2

## Мониторинг

- Метрика 1
- Метрика 2

## Бэкап

- Что бэкапим
- Как часто

Примеры: deployment.ops.md, monitoring.ops.md, backup.ops.md

.tst.md (Тесты)

# Тесты: Название

## Unit-тесты

- [ ] Функция создаёт
- [ ] Функция обрабатывает ошибки

## Интеграционные

- [ ] Модуль устанавливается
- [ ] Данные в БД корректны

## Ручные

1. Шаг 1
2. Шаг 2
3. Проверить результат

Примеры: test.tst.md, testing-plan.tst.md, test-cases.tst.md

ДРОБЛЕНИЕ БОЛЬШИХ ДОКУМЕНТОВ

Когда дробить

Дробить документ на части если:
- Размер > 500 строк
- Несколько независимых разделов
- Удобнее редактировать отдельно
- Нужна параллельная работа

Не дробить если:
- Размер < 200 строк
- Всё связано (одна мысль)
- Части сильно зависят друг от друга

Способы дробления

1. По номерам (последовательные части):

catalog-features-01.spc.md      ← часть 1: фичи A-M
catalog-features-02.spc.md      ← часть 2: фичи N-Z

Когда: Один большой список, логически однородный

2. По сущностям (разные темы):

catalog-products.spc.md         ← спека товаров
catalog-categories.spc.md       ← спека категорий
catalog-filters.spc.md          ← спека фильтров

Когда: Разные сущности, независимые разделы

3. По операциям (CRUD):

catalog-create.spc.md           ← создание
catalog-read.spc.md             ← чтение
catalog-update.spc.md           ← обновление
catalog-delete.spc.md           ← удаление

Когда: Операции над одной сущностью

4. Комбинированное:

catalog-products-create.spc.md      ← создание товара
catalog-products-update.spc.md      ← обновление товара
catalog-categories-create.spc.md    ← создание категории
catalog-filters-apply.spc.md        ← применение фильтров

Когда: Много сущностей × много операций

Главный файл (index)

При дроблении создай главный файл-навигатор:

# catalog.spc.md (главный)

## Структура документации

Спецификация каталога разбита на части:

1. [Товары](catalog-products.spc.md) — управление товарами
2. [Категории](catalog-categories.spc.md) — дерево категорий
3. [Фильтры](catalog-filters.spc.md) — фильтрация и поиск

## Зависимости

- catalog-products требует catalog-categories
- catalog-filters использует catalog-products

## Общая информация

[Общие принципы, используемые во всех частях]

ДЕКОМПОЗИЦИЯ И ДЕТАЛИЗАЦИЯ

Два процесса

ДЕКОМПОЗИЦИЯ — разбиение на составные части (вертикаль):

project                    ← целое
  ↓
module A, module B         ← части
  ↓
component X, component Y   ← подчасти

ДЕТАЛИЗАЦИЯ — углубление описания (горизонталь):

business → architecture → specs → prompts → code

Процесс декомпозиции

Шаг 1: Верхний уровень (project)

lideravto-2026/
└── requirements.biz.md         ← ЧТО нужно (общее)

Шаг 2: Декомпозиция на модули

lideravto-2026/
├── requirements.biz.md         ← общее
│
└── dev/cscart/modules/
    ├── catalog/                ← модуль 1
    │   └── purpose.biz.md      ← ЧТО делает каталог
    │
    └── import/                 ← модуль 2
        └── purpose.biz.md      ← ЧТО делает импорт

Шаг 3: Декомпозиция модуля на компоненты

catalog/
├── purpose.biz.md              ← ЧТО делает модуль
├── catalog.spc.md              ← КАК устроен (общее)
│
└── src/
    ├── Products/               ← компонент 1
    │   └── products.spc.md
    │
    ├── Categories/             ← компонент 2
    │   └── categories.spc.md
    │
    └── Filters/                ← компонент 3
        └── filters.spc.md

Процесс детализации

Горизонтальная прогрессия (один модуль):

ЭТАП 1: Бизнес-идея
catalog/purpose.biz.md
→ "Нужен каталог товаров для сайта"

ЭТАП 2: Дизайн
catalog/design.dsg.md
→ "Используем Products, Categories, Filters"

ЭТАП 3: Спецификации
catalog/catalog-products.spc.md
catalog/catalog-categories.spc.md
catalog/catalog-filters.spc.md
→ Детальное описание каждого компонента

ЭТАП 4: API
catalog/api.api.md
→ "fn_get_products($filter), fn_get_categories()"

ЭТАП 5: Промпты
catalog/products-create.pmt.md
→ "Создай класс Products в src/Products.php"

ЭТАП 6: Код
catalog/src/Products.php
→ Готовый код

Правило связности

При декомпозиции:
- Каждая часть = автономная (минимум зависимостей)
- Части связаны через API (явные интерфейсы)
- Зависимости указаны в index.yaml

При детализации:
- Каждый следующий слой конкретизирует предыдущий
- Не противоречит вышестоящим слоям
- Трансформируется от общего к частному

Пример: декомпозиция + детализация

project: lideravto-2026
│
├── requirements.biz.md          ← project, бизнес
├── architecture.arc.md          ← project, архитектура
│
└── dev/cscart/modules/
    │
    ├── catalog/                 ← МОДУЛЬ (декомпозиция ↓)
    │   ├── purpose.biz.md       │← бизнес      }
    │   ├── design.dsg.md        │← дизайн      }
    │   ├── catalog.spc.md       │← спека       } ДЕТАЛИЗАЦИЯ →
    │   ├── api.api.md           │← API         }
    │   ├── install.pmt.md       │← промпт      }
    │   │                        ↓
    │   └── src/                 ← код
    │       ├── Products/        ← компонент (декомпозиция ↓)
    │       ├── Categories/      ← компонент (декомпозиция ↓)
    │       └── Filters/         ← компонент (декомпозиция ↓)
    │
    └── import/                  ← МОДУЛЬ (декомпозиция ↓)
        ├── purpose.biz.md
        └── ...

Ключевое правило:
- Вертикаль (↓) = декомпозиция (целое → части)
- Горизонталь (→) = детализация (идея → код)

ВЕРСИОНИРОВАНИЕ ПРОЕКТОВ

Именование по годам

it/
├── lideravto-2025/         ← старый проект (v1)
├── lideravto-2026/         ← новый проект (v2)
└── lideravto-2027/         ← следующий (v3, future)

Правило: Год = год создания/запуска проекта

Домены и версии

ВАЖНО: Домен lideravto.ru не меняется, меняется проект на нём.

# lideravto-2025/index.yaml
version: 1.0.0
year: 2025
domain: lideravto.ru            # работает сейчас
status: maintenance

# lideravto-2026/index.yaml
version: 2.0.0
year: 2026
domain: work.lideravto.ru       # временный (разработка)
target-domain: lideravto.ru     # целевой (после запуска)
status: development

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

Сейчас (февраль 2026):

lideravto-2025/
  domain: lideravto.ru          ← работает
  status: maintenance

lideravto-2026/
  domain: work.lideravto.ru     ← разработка
  status: development

Через 6 месяцев (август 2026) — запуск v2:

lideravto-2025/
  domain: old.lideravto.ru      ← временный backup
  status: sunset

lideravto-2026/
  domain: lideravto.ru          ← ЗАМЕНИЛИ! ⭐
  status: production

Через год (февраль 2027):

lideravto-2025/
  → archive/lideravto-2025/     ← в архив

lideravto-2026/
  domain: lideravto.ru
  status: maintenance

lideravto-2027/                 ← новая версия
  domain: work.lideravto.ru
  status: development

СТАТУСЫ ПРОЕКТА

Статус Описание Что делаем
planning Планирование Документы, прототипы
development Разработка Активное программирование
testing Тестирование QA, bug fixing
staging Предпродакшн Финальная проверка
production Продакшн Работает для пользователей
maintenance Поддержка Только баги + security
sunset Вывод Готовим к отключению
archived Архив Выключен, в архиве

ОКРУЖЕНИЯ

Окружения = стадии ОДНОЙ версии проекта

Окружение Назначение Пример URL
dev/ Разработка work.lideravto.ru
test/ Тестирование test.lideravto.ru
staging/ Предпродакшн staging.lideravto.ru
prod/ Продакшн lideravto.ru

Правило: Окружения = папки внутри проекта, каждая со своими конфигами.

Структура окружения:

dev/
├── .env                    ← конфиг окружения
├── docker-compose.yml      ← если нужно
└── cscart/                 ← копия движка
    ├── config.php
    ├── var/
    └── modules/

Зачем отдельные папки:
- Разные версии движка в разных окружениях
- Изолированные конфиги (.env, config)
- Независимое развёртывание
- Можно тестировать prod локально

ТЕРМИНОЛОГИЯ

Уровни иерархии

Термин Определение Пример
organization Компания, организация lideravto/
domain Направление деятельности it/, biz/, fin/
project Проект, сайт, приложение lideravto-2026/
engine Движок, платформа cscart/, wordpress/
module Модуль движка catalog/, import/
component Компонент модуля Filter/, Search/

Слои документов

Термин Определение Расширение
бизнес-слой Vision, strategy, requirements .biz.md
архитектурный слой Tech stack, design .arc.md
спецификация Детальное описание функций .spc.md
API документация Endpoints, методы .api.md
операции Deploy, monitoring .ops.md
тесты Test plan, test cases .tst.md

Версии и статусы

Термин Определение
версия Номер версии проекта (1.0.0, 2.0.0)
год Год создания/запуска проекта
старый проект Текущий продакшн (maintenance)
новый проект В разработке (development)
статус Состояние проекта (development, production, etc)
окружение Стадия (dev, test, prod)
домен URL проекта
целевой домен URL после запуска

Типы изменений

Термин Описание
update Обновление текущей версии (1.0 → 1.1)
upgrade Улучшение версии (1.0 → 1.5)
rewrite Новая версия с нуля (v1 → v2)
migration Переход на новую версию
replacement Замена старой новой (v1 → v2 на prod)

ПОЛНЫЙ ПРИМЕР

lideravto/                              ← ORGANIZATION
├── index.yaml
│   type: organization
│   name: ЛидерАвто
│
├── vision.biz.md                       ← документ (бизнес-слой)
├── strategy-2026-2028.biz.md          ← документ (бизнес-слой)
│
├── biz/                                ← DOMAIN
│   ├── index.yaml
│   │   type: domain
│   │   area: biz
│   │
│   └── sales-strategy.biz.md          ← документ
│
├── fin/                                ← DOMAIN
│   ├── index.yaml
│   └── budget-2026.biz.md
│
└── it/                                 ← DOMAIN
    ├── index.yaml
    │   type: domain
    │   area: it
    │
    ├── tech-stack.arc.md               ← документ (архитектура)
    ├── infrastructure.ops.md           ← документ (операции)
    │
    ├── lideravto-2025/                 ← PROJECT (старый)
    │   ├── index.yaml
    │   │   version: 1.0.0
    │   │   year: 2025
    │   │   status: maintenance
    │   │   domain: lideravto.ru
    │   │
    │   ├── requirements.biz.md         ← документ
    │   ├── architecture.arc.md         ← документ
    │   │
    │   └── cscart/                     ← ENGINE
    │       ├── index.yaml
    │       │   version: 4.18.2
    │       │
    │       ├── config.php
    │       ├── var/
    │       │
    │       └── modules/                ← КОД
    │           ├── catalog/            ← MODULE
    │           │   ├── index.yaml
    │           │   ├── spec.spc.md    ← документ
    │           │   └── src/            ← КОД
    │           │       ├── Catalog.php
    │           │       └── CatalogService.php
    │           │
    │           └── import/             ← MODULE
    │               ├── index.yaml
    │               ├── spec.spc.md
    │               └── src/
    │                   └── Import.php
    │
    └── lideravto-2026/                 ← PROJECT (новый)
        ├── index.yaml
        │   version: 2.0.0
        │   year: 2026
        │   status: development
        │   domain: work.lideravto.ru
        │   target-domain: lideravto.ru
        │
        ├── requirements.biz.md
        ├── architecture.arc.md
        ├── api-catalog.api.md          ← документ API
        ├── deployment.ops.md           ← документ операции
        ├── testing-plan.tst.md         ← документ тесты
        │
        ├── dev/                        ← ОКРУЖЕНИЕ dev
        │   ├── .env
        │   └── cscart/                 ← ENGINE
        │       ├── index.yaml
        │       │   version: 4.19.1
        │       │
        │       └── modules/
        │           ├── catalog/
        │           │   ├── index.yaml
        │           │   ├── spec.spc.md
        │           │   ├── api.api.md
        │           │   └── src/
        │           │
        │           └── import/
        │               ├── index.yaml
        │               ├── spec.spc.md
        │               └── src/
        │
        ├── test/                       ← ОКРУЖЕНИЕ test
        │   ├── .env
        │   └── cscart/
        │
        └── prod/                       ← ОКРУЖЕНИЕ prod
            ├── .env
            └── cscart/

НАВИГАЦИЯ

Найти все проекты

find projects -type f -name "index.yaml" \
  -exec grep -l "type: project" {} \;

Найти документы по слою

# Все бизнес-документы
find . -name "*.biz.md"

# Все архитектурные
find . -name "*.arc.md"

# Все спецификации
find . -name "*.spc.md"

# Все API документы
find . -name "*.api.md"

Найти все модули

find . -type f -name "index.yaml" \
  -exec grep -l "type: module" {} \;

Найти проекты по статусу

# В разработке
find . -name "index.yaml" \
  -exec grep -l "status: development" {} \;

# На продакшне
find . -name "index.yaml" \
  -exec grep -l "status: production" {} \;

МИГРАЦИЯ

Текущая структура lideravto

Было:

it/web/cscart/
├── CLAUDE.md
├── README.md
├── GUIDE.md
├── modules/
│   ├── lider_import/
│   └── lider_setup/
└── sites/
    ├── lideravto.ru/
    └── work.lideravto.ru/

Стало:

it/
├── index.yaml
├── tech-stack.arc.md           ← было: GUIDE.md
│
├── lideravto-2025/             ← было: sites/lideravto.ru/
│   ├── index.yaml
│   ├── requirements.biz.md     ← было: CLAUDE.md + README.md
│   │
│   └── prod/                   ← окружение
│       └── cscart/
│           └── modules/
│               ├── lider_import/
│               └── lider_setup/
│
└── lideravto-2026/             ← было: sites/work.lideravto.ru/
    ├── index.yaml
    ├── requirements.biz.md
    │
    ├── dev/                    ← окружение
    │   ├── .env
    │   └── cscart/
    │       └── modules/
    │
    ├── test/                   ← окружение (создать)
    │   └── cscart/
    │
    └── prod/                   ← окружение (создать)
        └── cscart/

Шаги миграции

# 1. Создать структуру с окружениями
mkdir -p it/lideravto-2025/prod/cscart
mkdir -p it/lideravto-2026/dev/cscart
mkdir -p it/lideravto-2026/test/cscart
mkdir -p it/lideravto-2026/prod/cscart

# 2. Переместить старый сайт → prod окружение
mv it/web/cscart/sites/lideravto.ru/* it/lideravto-2025/prod/cscart/
cp -r it/web/cscart/modules/* it/lideravto-2025/prod/cscart/modules/

# 3. Переместить новый сайт → dev окружение
mv it/web/cscart/sites/work.lideravto.ru/* it/lideravto-2026/dev/cscart/
cp -r it/web/cscart/modules/* it/lideravto-2026/dev/cscart/modules/

# 4. Создать .env для окружений
cat > it/lideravto-2026/dev/.env << EOF
APP_ENV=development
APP_URL=https://work.lideravto.ru
DB_NAME=lideravto_dev
EOF

cat > it/lideravto-2026/test/.env << EOF
APP_ENV=testing
APP_URL=https://test.lideravto.ru
DB_NAME=lideravto_test
EOF

cat > it/lideravto-2026/prod/.env << EOF
APP_ENV=production
APP_URL=https://lideravto.ru
DB_NAME=lideravto_prod
EOF

# 5. Создать index.yaml
cat > it/lideravto-2025/index.yaml << EOF
type: project
version: 1.0.0
year: 2025
status: maintenance
domain: lideravto.ru

engine:
  name: cscart
  version: 4.18.2

environments:
  - prod
EOF

cat > it/lideravto-2026/index.yaml << EOF
type: project
version: 2.0.0
year: 2026
status: development
domain: work.lideravto.ru
target-domain: lideravto.ru

engine:
  name: cscart
  version: 4.19.1

environments:
  - dev
  - test
  - prod
EOF

# 6. Создать документы
# requirements.biz.md на основе CLAUDE.md + README.md
cat > it/lideravto-2026/requirements.biz.md << EOF
# Требования к новому сайту

## Бизнес-задача

Полный редизайн сайта lideravto.ru

## Ценность

- Современный дизайн
- Улучшенный каталог
- SEO оптимизация
EOF

# 7. Удалить старое
rm -rf it/web/

ЧЕКЛИСТ СОЗДАНИЯ ПРОЕКТА

СВЯЗАННЫЕ СТАНДАРТЫ

ИСТОРИЯ ИЗМЕНЕНИЙ

Версия Дата Изменения
3.0.0 2026-02-07 Правило "только нужное", единый формат именования, матрица слоёв, дробление документов, декомпозиция + детализация
2.0.0 2026-02-07 Окружения как папки, слои как двойная концепция, шаблоны файлов
1.0.0 2026-02-07 Создание стандарта папок и файлов

Версия: 3.0.0
Автор: Architect
Статус: Active