type: standard
aspect: guidance
title: "Граница БИЗНЕС ↔ IT"
version: 1.0.0
date: 2026-02-19
status: active

Граница БИЗНЕС ↔ IT

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

ПРИНЦИП

БИЗНЕС и IT — ДВЕ РАЗНЫЕ МЕРНОСТИ

БИЗНЕС планирует ЧТО → IT реализует КАК

Граница: REQUIREMENTS (требования от бизнеса к IT)

ДВЕ ИЕРАРХИИ

Бизнес-иерархия (ЗАЧЕМ, ЧТО, КТО)

ORG (организация)
  ↓
BIZ (направление бизнеса)
  ↓
MARKETING (стратегия продвижения)
  ↓
CHANNELS (каналы коммуникации)
  ├── WEBSITE (сайт как канал)
  ├── MARKETPLACE (маркетплейс)
  ├── SOCIAL (соцсети)
  └── EMAIL (рассылки)

Ответственность: Маркетинг/Бизнес
Документы: planning/01-04.md, requirements/, metrics/

IT-иерархия (КАК, ЧЕМ, ГДЕ)

ORG (организация)
  ↓
IT (информационные технологии)
  ↓
WEB (веб-направление)
  ↓
CSCART (решение CS-Cart)
  ↓
SITE (реализация сайта)
  ├── modules/
  ├── themes/
  └── sites/

Ответственность: IT
Документы: planning/05-09.md, specs/, implementation/

ГРАНИЦА (переход бизнес → IT)

БИЗНЕС планирует канал:
    ↓
    planning/01-04.md (бизнес-план канала)
    requirements.md (что нужно от IT)
    ↓
    ↓ ГРАНИЦА = REQUIREMENTS
    ↓
IT получает требования:
    ↓
    PROJECT.md (входящие требования от бизнеса)
    planning/05-09.md (техническое планирование)
    specs/ (ТЗ для кодера)
    ↓
    ↓ ГРАНИЦА = SPECS
    ↓
КОДЕР получает задачу:
    ↓
    SPEC.yaml + CODE-PROMPT.md
    ↓
    реализует код

СТРУКТУРА ДОКУМЕНТОВ

Уровень БИЗНЕС (канал)

biz/marketing/channels/website/
├── planning/                    ← бизнес-планирование
│   ├── 01-purpose.md            ← ЗАЧЕМ канал (цели, метрики)
│   ├── 02-audience.md           ← КТО (ЦА, сегменты)
│   ├── 03-product.md            ← ЧТО (продукты, оффер)
│   └── 04-content.md            ← КАК ДОНЕСТИ (контент, месседжи)
│
├── requirements/                ← требования к IT
│   ├── functional.md            ← функциональные (каталог, поиск, корзина)
│   ├── content.md               ← контентные (тексты, изображения)
│   └── metrics.md               ← метрики (скорость, конверсия)
│
└── metrics/                     ← KPI, аналитика
    ├── goals.md                 ← цели (выручка, конверсия)
    └── reports/                 ← отчёты

Кто пишет: Маркетинг, Бизнес
Когда: ДО начала разработки IT
Формат: Markdown (читается людьми)

Уровень IT (реализация)

it/web/cscart/sites/lideravto.ru/
├── PROJECT.md                   ← ВХОДЯЩИЕ требования от бизнеса
│   └── → ссылка на biz/marketing/channels/website/requirements/
│
├── planning/                    ← техническое планирование
│   ├── 05-tech-stack.md         ← КАК технически (платформа)
│   ├── 06-architecture.md       ← ЧЕМ (модули, интеграции)
│   ├── 07-infrastructure.md     ← ГДЕ (хостинг, домены)
│   ├── 08-timeline.md           ← КОГДА (этапы, сроки)
│   └── 09-budget.md             ← СКОЛЬКО (смета)
│
├── specs/                       ← ТЗ для кодера
│   ├── catalog/
│   │   ├── SPEC.yaml            ← конфигурация
│   │   └── CODE-PROMPT.md       ← задача кодеру
│   └── seo/
│       ├── SPEC.yaml
│       └── CODE-PROMPT.md
│
└── implementation/              ← реализация
    ├── modules/
    ├── themes/
    └── sites/

Кто пишет: IT (Проектор → Кодер)
Когда: ПОСЛЕ получения requirements от бизнеса
Формат:
- planning/ → Markdown (люди)
- specs/ → YAML + Markdown (кодер)
- implementation/ → Код

ПЕРЕХОД 1: БИЗНЕС → IT

Вход: Бизнес запланировал канал (website)

Что происходит:

Маркетинг пишет (в biz/):
planning/01-purpose.md — Зачем сайт, цели planning/02-audience.md — Кто наша ЦА planning/03-product.md — Что продаём planning/04-content.md — Контент-стратегия
Маркетинг формирует requirements (в biz/):
```
requirements/functional.md:
- Каталог 50k товаров
- Поиск по артикулу/названию
- Фильтры по категориям
- Корзина + оформление заказа

requirements/content.md:
- SEO-тексты для категорий
- Изображения товаров
- Описания

requirements/metrics.md:
- Скорость загрузки < 2 сек
- Конверсия > 2%
- Uptime > 99%
```

Бизнес передаёт IT (ГРАНИЦА):
СОЗДАЁТ: it/web/cscart/sites/lideravto.ru/ ПИШЕТ: PROJECT.md со ссылкой на requirements

Выход: IT получил требования, начинает планирование

ПЕРЕХОД 2: IT ПЛАНИРОВАНИЕ

Вход: IT получил requirements от бизнеса

Что происходит:

IT читает requirements:
biz/marketing/channels/website/requirements/ ├── functional.md — что должно быть ├── content.md — контент └── metrics.md — KPI
IT пишет техническое планирование (в it/):
```
planning/05-tech-stack.md:
- Платформа: CS-Cart 4.19.1
- PHP 8.1, MySQL 8.0, nginx

planning/06-architecture.md:
- Модули: lider_import, catalog, seo
- Интеграции: 1С, OZON API
- 3-уровневая категоризация

planning/07-infrastructure.md:
- VPS beget, 16GB RAM
- Домен: lideravto.ru
- SSL: Let's Encrypt

planning/08-timeline.md:
- Фаза 1: базовый сайт (1 мес)
- Фаза 2: импорт каталога (1 мес)
- Фаза 3: SEO (1 мес)

planning/09-budget.md:
- Разработка: 500k
- Инфраструктура: 50k/мес
```

IT декомпозирует на модули:
requirements → модули: - Каталог 50k → catalog module - Поиск → catalog module - SEO-тексты → seo module - Корзина → CS-Cart core

Выход: План реализации готов, начинаем создавать specs

ПЕРЕХОД 3: IT → КОДЕР

Вход: Техническое планирование готово

Что происходит:

IT создаёт SPEC для каждого модуля:
```
specs/catalog/SPEC.yaml:

module: catalog
type: cscart-addon
version: 1.0.0
dependencies:
- cscart: ^4.19.0
features:
- filters: категории, цена, марка
- variations: цвет, размер
- search: артикул, название, описание
```

IT создаёт CODE-PROMPT для кодера:
```
specs/catalog/CODE-PROMPT.md:

# Модуль: Каталог товаров

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

Фильтры (filters/):
- По категориям (3 уровня)
- По цене (диапазон)
- По марке (checkbox)
Вариации (variations/):
- Цвет товара
- Размер
- Выбор в карточке товара
Поиск (search/):
- По артикулу (точное совпадение)
- По названию (LIKE)
- По описанию (FULLTEXT)

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

addon.xml — метаданные
func.php — функции фильтрации
init.php — хуки
schemas/ — схемы данных

## Тесты

Unit: фильтрация, поиск
E2E: выбор фильтров → результаты
```

ГРАНИЦА: IT → Кодер
SPEC.yaml + CODE-PROMPT.md → Кодер

Выход: Кодер получил ТЗ, начинает писать код

ПЕРЕХОД 4: КОДЕР → КОД

Вход: SPEC.yaml + CODE-PROMPT.md

Что происходит:

Кодер читает:
- SPEC.yaml — конфигурация, зависимости
- CODE-PROMPT.md — подробное ТЗ
Кодер пишет код:
implementation/modules/catalog/ ├── addon.xml ├── func.php ├── init.php ├── schemas/ └── tests/
Кодер тестирует:
- Unit tests
- Integration tests
- E2E tests
Кодер отчитывается:
```
ВЫПОЛНЕНО:
[1] ✅ Фильтры (категории, цена, марка)
[2] ✅ Вариации (цвет, размер)
[3] ✅ Поиск (артикул, название)

Тесты: 25/25 ✅
```

Выход: Модуль готов, можно тестировать

ФОРМАТЫ ДОКУМЕНТОВ

БИЗНЕС (planning/01-04.md)

Формат: Markdown
Читает: Человек (маркетинг, бизнес, IT для понимания контекста)
Структура:

# Цель канала

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

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

## Целевая аудитория
[описание ЦА]

БИЗНЕС (requirements/)

Формат: Markdown
Читает: IT (для планирования)
Структура:

# Функциональные требования

## Каталог
- [ ] 50k товаров
- [ ] 3 уровня категорий
- [ ] Фильтры: категория, цена, марка

## Поиск
- [ ] По артикулу
- [ ] По названию
- [ ] Автодополнение

IT (planning/05-09.md)

Формат: Markdown
Читает: IT, разработчики
Структура:

# Техническое решение

## Платформа
CS-Cart 4.19.1

## Модули
- lider_import — импорт товаров
- catalog — каталог
- seo — оптимизация

## Архитектура
[схема]

IT (specs/SPEC.yaml)

Формат: YAML
Читает: Кодер (автоматическая обработка)
Структура:

module: catalog
type: cscart-addon
version: 1.0.0
dependencies:
  cscart: ^4.19.0
features:
  - filters
  - variations
  - search

IT (specs/CODE-PROMPT.md)

Формат: Markdown (структурированный)
Читает: Кодер (Claude Code)
Структура:

# Модуль: {название}

## Требования
[список требований]

## Структура кода
[файлы и функции]

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

## Критерии готовности
- [ ] Функция X работает
- [ ] Тесты пройдены

ПРАВИЛА

Разделение ответственности

Кто	Пишет	Где	Формат
Маркетинг	Бизнес-планирование	biz/.../planning/01-04.md	Markdown
Маркетинг	Требования	biz/.../requirements/	Markdown
IT	Техническое планирование	it/.../planning/05-09.md	Markdown
IT	Спецификации	it/.../specs/SPEC.yaml	YAML
IT	Задачи кодеру	it/.../specs/CODE-PROMPT.md	Markdown
Кодер	Код	it/.../implementation/	PHP/JS/...

Границы (кто что не делает)

Граница	❌ НЕЛЬЗЯ
Маркетинг	НЕ пишет технические решения (платформа, стек)
Маркетинг	НЕ создаёт specs для кодера
IT	НЕ пишет бизнес-планирование (01-04.md)
IT	НЕ определяет цели канала, ЦА, контент-стратегию
Кодер	НЕ решает что реализовывать (получает specs)
Кодер	НЕ планирует архитектуру (получает готовую)

Обязательные связи

IT/PROJECT.md ОБЯЗАТЕЛЬНО ссылается на biz/requirements/
```markdown
## Входящие требования

См. biz/marketing/channels/website/requirements/
```

specs/CODE-PROMPT.md ОБЯЗАТЕЛЬНО ссылается на planning/
```markdown
## Контекст

См. техническое планирование:
- 05-tech-stack.md
- 06-architecture.md
```

SPEC.yaml ОБЯЗАТЕЛЬНО содержит версию и зависимости
yaml version: 1.0.0 dependencies: cscart: ^4.19.0

ПРИМЕРЫ

Пример 1: Сайт lideravto.ru

Бизнес-планирование:

biz/marketing/channels/website/
├── planning/
│   ├── 01-purpose.md     — Продажи B2C + B2B, 2М/мес
│   ├── 02-audience.md    — Владельцы грузовиков, СТО
│   ├── 03-product.md     — Каталог 50k запчастей
│   └── 04-content.md     — SEO-тексты, гайды
└── requirements/
    ├── functional.md     — Каталог, поиск, фильтры, корзина
    ├── content.md        — SEO-тексты, изображения
    └── metrics.md        — Конверсия 2%, скорость < 2 сек

IT реализация:

it/web/cscart/sites/lideravto.ru/
├── PROJECT.md            — Ссылка на requirements
├── planning/
│   ├── 05-tech-stack.md  — CS-Cart 4.19.1, PHP 8.1
│   ├── 06-architecture.md — 3 модуля (import, catalog, seo)
│   ├── 07-infrastructure.md — VPS beget, 16GB
│   ├── 08-timeline.md    — 3 фазы, 3 месяца
│   └── 09-budget.md      — 500k разработка + 50k/мес инфра
├── specs/
│   ├── catalog/
│   │   ├── SPEC.yaml
│   │   └── CODE-PROMPT.md
│   └── seo/
│       ├── SPEC.yaml
│       └── CODE-PROMPT.md
└── implementation/
    └── modules/
        ├── lider_import/
        ├── catalog/
        └── seo/

Пример 2: Переход БИЗНЕС → IT

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

biz/marketing/channels/website/requirements/functional.md:

# Функциональные требования

## Каталог товаров
- [ ] 50,000 товаров в каталоге
- [ ] 3 уровня категорий (марка → модель → группа)
- [ ] Фильтры:
  - По марке (MAZ, KAMAZ, VOLVO...)
  - По цене (диапазон)
  - По наличию (в наличии / под заказ)
- [ ] Поиск:
  - По артикулу (точное совпадение)
  - По названию (нечёткий поиск)
  - Автодополнение

## Корзина и оформление
- [ ] Добавление в корзину
- [ ] Быстрый заказ (без регистрации)
- [ ] Оформление для юрлиц (с реквизитами)

Шаг 2: IT получает и планирует

it/web/cscart/sites/lideravto.ru/PROJECT.md:

# Проект: Сайт lideravto.ru

## Входящие требования

См. [biz/marketing/channels/website/requirements/](../../../../biz/marketing/channels/website/requirements/)

## Реализация

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

### Фазы
1. Базовый сайт + импорт (1 мес)
2. Каталог + фильтры (1 мес)
3. SEO-оптимизация (1 мес)

Шаг 3: IT создаёт specs для модуля

it/web/cscart/sites/lideravto.ru/specs/catalog/SPEC.yaml:

---
module: catalog
type: cscart-addon
version: 1.0.0

dependencies:
  cscart: ^4.19.0

features:
  filters:
    - category: 3 уровня
    - price: range slider
    - brand: checkbox list
    - availability: в наличии/под заказ

  search:
    - by_article: exact match
    - by_name: LIKE %query%
    - autocomplete: top 10 results

  variations:
    - color: если есть
    - size: если есть

it/web/cscart/sites/lideravto.ru/specs/catalog/CODE-PROMPT.md:

# Модуль: Каталог товаров

## Контекст

См. требования: [biz/.../requirements/functional.md](../../../../../biz/marketing/channels/website/requirements/functional.md)

## Задача

Создать модуль расширенного каталога для CS-Cart.

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

### 1. Фильтры (filters/)

Создать:
- `func.php` → функция `fn_catalog_apply_filters($params)`
- Параметры фильтрации:
  - category_id (array) — категории
  - price_from, price_to (int) — цена
  - brand (array) — марки
  - availability (enum: in_stock, on_order, all)

### 2. Поиск (search/)

Создать:
- `func.php` → функция `fn_catalog_search($query)`
- Алгоритм:
  1. Точное совпадение по артикулу
  2. LIKE поиск по названию
  3. FULLTEXT по описанию
- Автодополнение: top 10 результатов

### 3. Вариации (variations/)

Если товар имеет вариации (цвет, размер):
- Показать селектор в карточке
- Обновлять цену при выборе
- Обновлять артикул

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

addon.xml — метаданные модуля
func.php — функции (filters, search)
init.php — хуки CS-Cart
schemas/
filters.php — схема фильтров
search.php — схема поиска
templates/
filters.tpl — шаблон фильтров
results.tpl — результаты
tests/
FiltersTest.php — unit тесты
SearchTest.php — unit тесты

## Тесты

### Unit
- fn_catalog_apply_filters() с разными параметрами
- fn_catalog_search() с артикулом, названием

### E2E
- Выбор фильтров → проверка результатов
- Поиск → проверка результатов
- Автодополнение → проверка top 10

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

- [ ] Фильтры работают (категория, цена, марка, наличие)
- [ ] Поиск работает (артикул, название)
- [ ] Автодополнение работает
- [ ] Вариации работают (если есть)
- [ ] Unit тесты: 10/10 ✅
- [ ] E2E тесты: 5/5 ✅

Шаг 4: Кодер получает specs и реализует

КОДЕР получает:
- SPEC.yaml (конфигурация)
- CODE-PROMPT.md (подробное ТЗ)

КОДЕР создаёт:
it/web/cscart/sites/lideravto.ru/implementation/modules/catalog/
├── addon.xml
├── func.php
├── init.php
├── schemas/
├── templates/
└── tests/

КОДЕР отчитывается:
ВЫПОЛНЕНО:
[1] ✅ Фильтры (категория, цена, марка, наличие)
[2] ✅ Поиск (артикул, название, автодополнение)
[3] ✅ Вариации (цвет, размер)

Тесты: 15/15 ✅

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

Чеклист БИЗНЕС

[ ] planning/01-04.md заполнены
[ ] requirements/ созданы (functional, content, metrics)
[ ] requirements/ содержат конкретные требования (не общие слова)

Чеклист IT

[ ] PROJECT.md ссылается на biz/requirements/
[ ] planning/05-09.md заполнены
[ ] specs/ созданы для каждого модуля
[ ] SPEC.yaml содержит version, dependencies, features
[ ] CODE-PROMPT.md подробный (структура, тесты, критерии)

Чеклист СВЯЗЕЙ

[ ] it/PROJECT.md → biz/requirements/ (ссылка существует)
[ ] specs/CODE-PROMPT.md → planning/ (ссылка существует)
[ ] specs/SPEC.yaml → CODE-PROMPT.md (файлы в одной папке)

ССЫЛКИ

UNIVERSAL_PROJECT_STRUCTURE.md — общая структура проекта
CODE_PROMPT.md — формат CODE-PROMPT
FRACTAL_ARCHITECTURE.md — фрактальная архитектура

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