Версия: 1.0.0
Дата: 2026-03-24
Область: Внутренняя структура IT-проекта
IT-проект = Продукт (ЧТО) + Реализации (КАК на каком стеке).
Продукт не меняется — меняется технология. Требования, wireframes, чеклист —
написаны один раз. Каждая техническая реализация живёт в отдельной папке.
it/
├── CLAUDE.md ← Контекст IT-проекта (навигация)
├── docs/ ← Требования НЕ зависящие от технологии
│ ├── CHECKLIST.md ← Функциональный чеклист
│ ├── ROADMAP.md ← Роадмап продукта
│ ├── requirements/ ← Функциональные требования
│ │ ├── 1-ENGINE.md
│ │ ├── 2-THEME.md
│ │ ├── 3-MODULES.md
│ │ └── 4-SERVICES.md
│ ├── wireframes/ ← UI макеты (не зависят от технологии)
│ └── design/ ← Дизайн-система
│
├── V1-{платформа}-{стек}/ ← Реализация 1 (может быть архивной)
│ ├── CLAUDE.md ← Контекст этой версии
│ ├── STACK.md ← Стек + обоснование выбора
│ ├── BUILD-PLAN.md ← Как собирали
│ └── ... ← Специфика реализации
│
└── V2-{платформа}-{стек}/ ← Реализация 2 (активная)
├── CLAUDE.md
├── STACK.md
├── BUILD-PLAN.md
└── ...
Формат: V{N}-{платформа}-{ключевая-технология}
| Папка | Расшифровка |
|---|---|
V1-cscart-4 |
CS-Cart 4.x |
V1-opencart-3 |
OpenCart 3.x |
V2-drupal11-bootstrap |
Drupal 11 + Bootstrap Barrio |
V3-drupal11-canvas |
Drupal 11 + Experience Builder |
V1-wordpress-woo |
WordPress + WooCommerce |
V2-nextjs-medusa |
Next.js + Medusa headless |
V1-bitrix-d7 |
Bitrix D7 |
Правила:
- V{N} — порядковый номер, начиная с 1
- Платформа и стек — строчными буквами, через дефис
- Версия платформы — только мажорная (drupal11, cscart-4)
- Без пробелов и спецсимволов
docs/ — общее для всех версий| Документ | Описание | Меняется при смене стека? |
|---|---|---|
| CHECKLIST.md | Функциональный чеклист | Нет |
| ROADMAP.md | Роадмап продукта | Нет |
| requirements/1-ENGINE.md | Требования к движку | Нет (требования одни) |
| requirements/2-THEME.md | Требования к теме | Нет |
| requirements/3-MODULES.md | Модули и фичи | Нет |
| requirements/4-SERVICES.md | Внешние сервисы | Нет |
| wireframes/*.md | UI макеты | Нет |
| MARKETS.md | Рынки продаж | Нет |
| LICENSING.md | Лицензирование | Нет |
V{N}-*/ — специфика реализации| Документ | Описание | Меняется при смене стека? |
|---|---|---|
| STACK.md | Стек + обоснование | Да — каждая версия свой стек |
| BUILD-PLAN.md | Как собирать | Да — разные команды/рецепты |
| RECIPES.md | Drupal рецепты / скрипты установки | Да |
| THEME-SPEC.md | Спецификация темы | Да |
| theme/ / src/ | Код темы/приложения | Да |
В CLAUDE.md IT-проекта всегда указывать статус каждой версии:
| Версия | Стек | Статус |
|--------|------|--------|
| V1-cscart-4 | CS-Cart 4.15 | архив |
| V2-drupal11-bootstrap | Drupal 11 + Bootstrap Barrio | ✅ активная |
| V3-drupal11-canvas | Drupal 11 + Canvas | планируется |
Статусы:
- активная — текущая production/dev версия
- архив — завершена, не развивается, код сохранён
- планируется — принято решение, разработка не начата
- заморожена — разработка остановлена, может быть возобновлена
Если проект уже существует без этой структуры:
Было: Стало:
theme/ V1-drupal11-preline/
ideal_theme/ ideal_theme/
v2-d2b/ V2-drupal11-bootstrap/
archive/ BUILD-PLAN.md
STACK.md
RECIPES.md
Шаги миграции:
1. Создать V{N}-*/ папки
2. Переместить специфику реализации
3. Оставить docs/ с общими требованиями
4. Обновить CLAUDE.md с таблицей версий
5. Проверить все ссылки
ideal-shop/
└── theme/
├── ideal_theme/ ← v1 код
├── v2-d2b/ ← v2 документация
└── archive/ ← хаос
ideal-shop/
├── docs/ ← общие требования (wireframes, checklist)
├── V1-drupal11-preline/ ← Preline + Tailwind (архив)
└── V2-drupal11-bootstrap/ ← Bootstrap Barrio (активная)
@biz-lideravto/it/
├── docs/ ← требования к автозапчастям
├── V1-cscart-4/ ← старый сайт на CS-Cart (архив)
└── V2-drupal11-bootstrap/ ← новый Drupal (активная)
Версия: 1.0.0
Дата: 2026-03-24