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

Разделение Planning (проектирование) и Coding (реализация)

Версия: 1.0.0
Дата: 2026-02-03
Статус: ОБЯЗАТЕЛЬНО

ПРИНЦИП

ПРОЕКТИРОВАНИЕ (planning/) ≠ РЕАЛИЗАЦИЯ (it/)

Сначала ДУМАЕМ → потом ДЕЛАЕМ

Разделение по СТАДИИ работы:
- planning/ — документы (ЧТО, ЗАЧЕМ, КАК)
- it/ — код (реализация, specs, implementation)

СТРУКТУРА

projects/org/{project}/
│
├── PROJECT.md                ← корневой (обзор проекта)
│
├── planning/                 ← ПРОЕКТИРОВАНИЕ (документы)
│   ├── README.md             ← обзор планирования
│   │
│   ├── 01-purpose.md         ← БИЗНЕС (маркетинг)
│   ├── 02-audience.md
│   ├── 03-product.md
│   ├── 04-content.md
│   │
│   ├── 05-solution.md        ← IT (БЕЗ платформы)
│   ├── 06-architecture.md
│   ├── 07-platform.md        ← ВЫБОР платформы
│   │
│   ├── 08-implementation.md  ← РЕАЛИЗАЦИЯ (план)
│   ├── 09-infrastructure.md
│   ├── 10-timeline.md
│   └── 11-budget.md
│
├── biz/                      ← минимальный (контекст организации)
│   └── PROJECT.md
│
├── fin/                      ← минимальный (контекст финансов)
│   └── PROJECT.md
│
└── it/                       ← РЕАЛИЗАЦИЯ (код)
    └── web/
        └── cscart/
            └── sites/
                └── {site}/
                    ├── specs/           ← CODE-PROMPT (на основе planning/)
                    └── implementation/  ← КОД

СТАДИИ

СТАДИЯ 1: ПРОЕКТИРОВАНИЕ
    ↓
    planning/01-11.md (документы)
    ↓
СТАДИЯ 2: СПЕЦИФИКАЦИЯ
    ↓
    it/.../specs/ (CODE-PROMPT на основе planning/)
    ↓
СТАДИЯ 3: РЕАЛИЗАЦИЯ
    ↓
    it/.../implementation/ (КОД на основе specs/)

PLANNING/ — Проектирование

Что в planning/

ВСЁ проектирование проекта (сайта, системы, приложения):

planning/
├── README.md                 ← Обзор планирования
│
├── 01-purpose.md             ← ЗАЧЕМ (цели, метрики)
├── 02-audience.md            ← КТО (ЦА, сегменты)
├── 03-product.md             ← ЧТО (продукты, оффер)
├── 04-content.md             ← КАК ДОНЕСТИ (контент, месседжи)
│
├── 05-solution.md            ← КАКОЙ ИНСТРУМЕНТ (структура, функции)
├── 06-architecture.md        ← АРХИТЕКТУРА (данные, алгоритмы)
├── 07-platform.md            ← ВЫБОР ПЛАТФОРМЫ (CS-Cart, Drupal, ...)
│
├── 08-implementation.md      ← КАК РЕАЛИЗОВАТЬ (модули, интеграции)
├── 09-infrastructure.md      ← ГДЕ (хостинг, домены)
├── 10-timeline.md            ← КОГДА (сроки, фазы)
└── 11-budget.md              ← СКОЛЬКО (смета)

Формат: Markdown

Читают: Люди (маркетинг, IT, менеджмент)

Не читает: Кодер (кодер читает только specs/)

Блоки планирования

БЛОК 1: БИЗНЕС (01-04) — Маркетинг заполняет

01-purpose.md:
# Цель проекта

## Зачем
[описание цели]

## Метрики
- KPI 1: значение
- KPI 2: значение

---

02-audience.md:
# Целевая аудитория

## Сегменты
[описание ЦА]

## Боли
[проблемы аудитории]

---

03-product.md:
# Продукт

## Что продаём/предоставляем
[описание продукта]

## Оффер
[уникальное предложение]

---

04-content.md:
# Контент-стратегия

## Типы контента
[какой контент]

## Тон коммуникации
[как общаемся с аудиторией]

Кто заполняет: Маркетинг/Бизнес
Когда: Перед началом IT
НЕ упоминает: Платформы, технологии

БЛОК 2: РЕШЕНИЕ (05-06) — IT планирует БЕЗ платформы

05-solution.md:
# Решение (инструмент)

## Структура сайта/системы
[разделы, страницы, экраны]

## Функции
[что должна уметь система]

## Пользовательские сценарии
[как пользователь работает]

## Архитектура данных
[сущности, связи]

## Алгоритмы
[импорт, поиск, фильтрация]

БЕЗ упоминания платформы!

---

06-architecture.md:
# Архитектура решения

## Схема данных
[таблицы, связи]

## Алгоритмы
[подробное описание]

## Интеграции
[внешние системы]

## Требования к производительности
[метрики]

БЕЗ упоминания платформы!

Кто заполняет: IT (Проектор)
Читает: planning/01-04.md
НЕ упоминает: CS-Cart, Drupal, конкретные модули
Описывает: Абстрактное решение (что нужно сделать)

БЛОК 3: ПЛАТФОРМА (07) — Выбор движка

07-platform.md:
# Выбор платформы

## Варианты
- CS-Cart
- Drupal
- Next.js
- WooCommerce

## Критерии выбора
[по каким критериям выбираем]

## Сравнение
[таблица сравнения]

## Обоснование выбора
[почему выбрали CS-Cart]

## Решение
CS-Cart 4.19.1

Кто заполняет: IT (Проектор)
Читает: planning/05-06.md (требования к решению)
Результат: Выбрана платформа

БЛОК 4: РЕАЛИЗАЦИЯ (08-11) — План реализации

08-implementation.md:
# План реализации на CS-Cart

## Модули
- lider_import — импорт из BAZON
- catalog — каталог, фильтры
- seo — SEO-оптимизация

## Темы оформления
[какие темы]

## Интеграции
- 1С
- OZON API

## Кастомизация платформы
[что нужно изменить в платформе]

---

09-infrastructure.md:
# Инфраструктура

## Хостинг
[где размещаем]

## Домены
[какие домены]

## SSL, бэкапы
[безопасность]

---

10-timeline.md:
# Сроки

## Фазы
1. Фаза 1 (срок)
2. Фаза 2 (срок)

---

11-budget.md:
# Бюджет

## Разработка
[смета разработки]

## Инфраструктура
[ежемесячные расходы]

Кто заполняет: IT (Проектор)
Читает: planning/05-07.md
Упоминает: Конкретную платформу (CS-Cart), модули, технологии

IT/ — Реализация (код)

Что в it/

ТОЛЬКО реализация (specs + код):

it/web/cscart/sites/lideravto.ru/
│
├── specs/                    ← CODE-PROMPT (для кодера)
│   ├── catalog/
│   │   ├── SPEC.yaml
│   │   └── CODE-PROMPT.md
│   └── seo/
│       ├── SPEC.yaml
│       └── CODE-PROMPT.md
│
└── implementation/           ← КОД
    ├── modules/
    │   ├── lider_import/
    │   ├── catalog/
    │   └── seo/
    ├── themes/
    └── sites/

specs/ — Спецификации для кодера

Формат: YAML + Markdown

Читает: Кодер (Claude Code)

Создаёт: IT (Проектор) на основе planning/08-implementation.md

Структура:

specs/catalog/SPEC.yaml:
---
module: catalog
type: cscart-addon
version: 1.0.0

dependencies:
  cscart: ^4.19.0

features:
  - filters
  - search
  - variations

specs/catalog/CODE-PROMPT.md:
# Модуль: Каталог товаров

## Контекст

См. планирование:
- [planning/05-solution.md](../../../../planning/05-solution.md)
- [planning/08-implementation.md](../../../../planning/08-implementation.md)

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

### 1. Фильтры
[подробное описание]

### 2. Поиск
[подробное описание]

### 3. Вариации
[подробное описание]

## Структура кода

addon.xml
func.php
init.php
schemas/
templates/
tests/

## Тесты

### Unit
[что тестировать]

### E2E
[сценарии]

## Критерии готовности

- [ ] Фильтры работают
- [ ] Поиск работает
- [ ] Тесты: 15/15 ✅

implementation/ — Код

Формат: PHP, JS, CSS, ...

Читает: Никто (кроме кодера и runtime)

Создаёт: Кодер на основе specs/

implementation/modules/catalog/
├── addon.xml
├── func.php
├── init.php
├── schemas/
├── templates/
└── tests/

СВЯЗИ

planning/ → specs/ → implementation/

1. planning/08-implementation.md говорит:
   "Нужен модуль catalog (фильтры, поиск, вариации)"

   ↓

2. IT создаёт specs/catalog/:
   - SPEC.yaml (конфигурация)
   - CODE-PROMPT.md (подробное ТЗ кодеру)

   ↓

3. Кодер читает specs/catalog/ и создаёт:
   - implementation/modules/catalog/

Явные ссылки

planning/ → specs/:

specs/catalog/CODE-PROMPT.md:

## Контекст

См. планирование:
- [planning/05-solution.md](../../../../planning/05-solution.md) — требования к каталогу
- [planning/08-implementation.md](../../../../planning/08-implementation.md) — план реализации

specs/ → implementation/:

Нет прямых ссылок (specs → код)

ПРАВИЛА

Что в planning/

✅ МОЖНО:
- Описание бизнес-целей (01-04)
- Описание решения БЕЗ платформы (05-06)
- Выбор платформы (07)
- План реализации (08-11)

❌ НЕЛЬЗЯ:
- Код
- Конфигурации (YAML)
- CODE-PROMPT (это в specs/)

Что в it/specs/

✅ МОЖНО:
- SPEC.yaml (конфигурация модуля)
- CODE-PROMPT.md (ТЗ кодеру)
- Ссылки на planning/

❌ НЕЛЬЗЯ:
- Код (это в implementation/)
- Общее планирование (это в planning/)

Что в it/implementation/

✅ МОЖНО:
- Код (PHP, JS, CSS, ...)
- Тесты
- Конфигурации модулей

❌ НЕЛЬЗЯ:
- Документы планирования
- CODE-PROMPT (это в specs/)

ПЕРЕХОДЫ

Переход 1: planning/01-04 → planning/05-11

Триггер: Маркетинг заполнил 01-04.md

Действие: IT читает 01-04, заполняет 05-11

Результат: План проекта готов (01-11)

Переход 2: planning/08 → it/specs/

Триггер: planning/08-implementation.md говорит "нужен модуль catalog"

Действие: IT создаёт specs/catalog/ (SPEC.yaml + CODE-PROMPT.md)

Результат: ТЗ для кодера готово

Переход 3: it/specs/ → it/implementation/

Триггер: specs/ созданы

Действие: Кодер читает specs/, пишет код

Результат: Модуль готов в implementation/

ПРИМЕР: САЙТ LIDERAVTO.RU

Структура

projects/org/lideravto/
│
├── PROJECT.md                        ← корневой (обзор проекта)
│
├── planning/                         ← ПРОЕКТИРОВАНИЕ
│   ├── README.md
│   │
│   ├── 01-purpose.md                 ← Цель: продажи запчастей 2М/мес
│   ├── 02-audience.md                ← ЦА: владельцы грузовиков, СТО
│   ├── 03-product.md                 ← Продукт: каталог 50k запчастей
│   ├── 04-content.md                 ← Контент: SEO-тексты, гайды
│   │
│   ├── 05-solution.md                ← Инструмент: интернет-магазин
│   │                                    - Каталог 3 уровня
│   │                                    - Поиск, фильтры
│   │                                    - Корзина, оформление
│   │                                    - Импорт из BAZON
│   │
│   ├── 06-architecture.md            ← Архитектура:
│   │                                    - Схема данных (Product, Category, Brand)
│   │                                    - Алгоритм импорта
│   │                                    - Алгоритм поиска
│   │
│   ├── 07-platform.md                ← ВЫБОР: CS-Cart 4.19.1
│   │                                    (сравнение с Drupal, WooCommerce)
│   │
│   ├── 08-implementation.md          ← ПЛАН:
│   │                                    - Модуль lider_import
│   │                                    - Модуль catalog
│   │                                    - Модуль seo
│   │
│   ├── 09-infrastructure.md          ← VPS beget, 16GB RAM
│   ├── 10-timeline.md                ← 3 фазы, 3 месяца
│   └── 11-budget.md                  ← 500k разработка + 50k/мес инфра
│
├── biz/                              ← минимальный (контекст)
│   └── PROJECT.md
│
├── fin/                              ← минимальный (контекст)
│   └── PROJECT.md
│
└── it/                               ← РЕАЛИЗАЦИЯ
    └── web/
        └── cscart/
            └── sites/
                └── lideravto.ru/
                    │
                    ├── specs/                ← CODE-PROMPT
                    │   ├── catalog/
                    │   │   ├── SPEC.yaml
                    │   │   └── CODE-PROMPT.md
                    │   └── seo/
                    │       ├── SPEC.yaml
                    │       └── CODE-PROMPT.md
                    │
                    └── implementation/       ← КОД
                        ├── modules/
                        │   ├── lider_import/
                        │   ├── catalog/
                        │   └── seo/
                        ├── themes/
                        └── sites/

Workflow (пошагово)

Шаг 1: Маркетинг планирует (01-04)

Где: planning/01-04.md

planning/01-purpose.md:
Цель: продажи запчастей B2C + B2B, 2М/мес

planning/02-audience.md:
ЦА: владельцы грузовиков, СТО

planning/03-product.md:
Продукт: каталог 50k запчастей

planning/04-content.md:
Контент: SEO-тексты, гайды

Статус: 01-04 готовы → переход к IT

Шаг 2: IT планирует решение (05-06) БЕЗ платформы

Где: planning/05-06.md

Читает: planning/01-04.md

planning/05-solution.md:
# Решение: Интернет-магазин запчастей

## Структура
- Главная
- Каталог (3 уровня: марка → модель → группа)
- Карточка товара
- Поиск
- Корзина
- Оформление

## Функции
- F1: Импорт из BAZON (50k товаров, ежедневно)
- F2: Каталог с фильтрами
- F3: Поиск (артикул приоритет)
- F4: Корзина
- F5: Оформление заказа

planning/06-architecture.md:
# Архитектура

## Схема данных
Product → Category → Brand

## Алгоритм импорта
1. Скачать CSV
2. Парсинг
3. Маппинг категорий
4. Сохранение товаров

## Алгоритм поиска
1. Если артикул → точное совпадение
2. Иначе → LIKE по названию

НЕ упоминает: CS-Cart, Drupal, конкретные модули

Статус: 05-06 готовы → переход к выбору платформы

Шаг 3: IT выбирает платформу (07)

Где: planning/07-platform.md

Читает: planning/05-06.md (требования)

planning/07-platform.md:
# Выбор платформы

## Варианты
1. CS-Cart
2. Drupal Commerce
3. WooCommerce
4. Next.js (custom)

## Сравнение
[таблица с оценками]

## Решение
CS-Cart 4.19.1

## Обоснование
- Готовый интернет-магазин
- Поддержка 50k+ товаров
- Есть опыт работы

Статус: Платформа выбрана → переход к плану реализации

Шаг 4: IT планирует реализацию (08-11)

Где: planning/08-11.md

Читает: planning/05-07.md

planning/08-implementation.md:
# План реализации на CS-Cart

## Модули
1. lider_import — импорт из BAZON
2. catalog — фильтры, поиск, вариации
3. seo — canonical, meta, sitemap

## Интеграции
- 1С
- OZON API

planning/09-infrastructure.md:
VPS beget, 16GB RAM

planning/10-timeline.md:
3 фазы, 3 месяца

planning/11-budget.md:
500k разработка + 50k/мес

Упоминает: CS-Cart, конкретные модули, технологии

Статус: План готов → переход к specs

Шаг 5: IT создаёт specs (CODE-PROMPT)

Где: it/web/cscart/sites/lideravto.ru/specs/

Читает: planning/08-implementation.md

planning/08-implementation.md говорит:
"Модуль catalog — фильтры, поиск, вариации"

↓ IT создаёт

specs/catalog/SPEC.yaml:
---
module: catalog
features:
  - filters
  - search
  - variations

specs/catalog/CODE-PROMPT.md:
# Модуль: Каталог товаров

## Контекст
См. [planning/05-solution.md](../../../../planning/05-solution.md)

## Требования
1. Фильтры (категория, цена, марка)
2. Поиск (артикул приоритет)
3. Вариации (цвет, размер)

## Структура кода
addon.xml, func.php, init.php

## Тесты
Unit: 10/10
E2E: 5/5

Статус: specs готовы → переход к коду

Шаг 6: Кодер реализует

Где: it/web/cscart/sites/lideravto.ru/implementation/

Читает: ТОЛЬКО specs/catalog/ (НЕ читает planning/)

Кодер:
1. Читает specs/catalog/SPEC.yaml
2. Читает specs/catalog/CODE-PROMPT.md
3. Пишет код:
   implementation/modules/catalog/
   ├── addon.xml
   ├── func.php
   ├── init.php
   └── tests/

4. Запускает тесты: 15/15 ✅

5. Отчитывается:
   ВЫПОЛНЕНО:
   [1] ✅ Фильтры
   [2] ✅ Поиск
   [3] ✅ Вариации

НЕ читает: planning/ (только specs/)

ПРЕИМУЩЕСТВА

✅ Разделение concerns

✅ Независимость планирования

✅ Чёткая последовательность

planning/01-04 (бизнес)
  ↓
planning/05-06 (решение БЕЗ платформы)
  ↓
planning/07 (выбор платформы)
  ↓
planning/08-11 (план реализации)
  ↓
it/specs/ (CODE-PROMPT)
  ↓
it/implementation/ (код)

✅ Кодер изолирован

✅ biz/ и fin/ минимальные

ПРОВЕРКА

Чеклист planning/

Чеклист it/specs/

Чеклист it/implementation/

ССЫЛКИ

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