BUSINESS TO IT FLOW — От бизнес-идеи до ИТ-реализации

БИЗНЕС-ИДЕЯ
    ↓
┌─────────────────────────────────────────────────────────────────┐
│ ФАЗА 0: БИЗНЕС (biz/)                                          │
│                                                                 │
│ • Идея: vision.biz.md                                          │
│ • Стратегия: strategy.biz.md                                   │
│ • Процессы: processes.ops.md                                   │
│ • Требования к ИТ: it-requirements.biz.md                      │
└─────────────────────────────────────────────────────────────────┘
    ↓
┌─────────────────────────────────────────────────────────────────┐
│ ФАЗА 1: ПЕРЕХОД (biz/ → it/)                                   │
│                                                                 │
│ • Техническое задание (ТЗ)                                     │
│ • Согласование требований                                      │
│ • Бюджет и сроки                                               │
└─────────────────────────────────────────────────────────────────┘
    ↓
┌─────────────────────────────────────────────────────────────────┐
│ ФАЗА 2: ИТ ПРОЕКТИРОВАНИЕ (it/)                                │
│                                                                 │
│ • Получение: requirements.biz.md                               │
│ • Архитектура: architecture.arc.md                             │
│ • План проекта: roadmap.prj.md                                 │
│ • Создание проекта: lideravto-2026/                            │
└─────────────────────────────────────────────────────────────────┘
    ↓
┌─────────────────────────────────────────────────────────────────┐
│ ФАЗА 3: ИТ РЕАЛИЗАЦИЯ (it/project/)                            │
│                                                                 │
│ • Движок: cscart/                                              │
│ • Модули: catalog/, orders/                                    │
│ • Компоненты: src/Products.php                                 │
└─────────────────────────────────────────────────────────────────┘
    ↓
ГОТОВОЕ РЕШЕНИЕ

lideravto/
└── biz/                          ← БИЗНЕС ДОМЕН
    ├── index.yaml                ← domain: business
    │
    ├─── БИЗНЕС-СТРАТЕГИЯ
    │    ├── vision.biz.md        ← зачем компания, миссия
    │    ├── strategy.biz.md      ← как развиваемся
    │    └── markets.biz.md       ← где работаем
    │
    ├─── БИЗНЕС-ПРОЦЕССЫ
    │    ├── processes.ops.md     ← процессы компании
    │    ├── sales.ops.md         ← процесс продаж
    │    └── logistics.ops.md     ← процесс доставки
    │
    ├─── ОРГАНИЗАЦИЯ
    │    └── structure.str.md     ← оргструктура
    │
    └─── ТРЕБОВАНИЯ К ИТ (переходный документ!)
         └── it-requirements.biz.md  ← ЧТО нужно от ИТ

# Видение компании Лидер Авто

## Миссия
Стать №1 поставщиком запчастей для грузовиков в России

## Цели 2026
- Увеличить продажи на 40%
- Выйти на маркетплейсы (OZON, WB)
- Автоматизировать обработку заказов

## Вызовы
- Ручная обработка заказов
- Нет интеграции с поставщиками
- Каталог не актуализируется

# Требования к ИТ от бизнеса

## Проблемы (что не работает)
1. Заказы обрабатываются вручную (3 часа в день)
2. Каталог устаревает (обновление раз в месяц)
3. Нет интеграции с OZON

## Что нужно от ИТ
1. Автоматическая синхронизация заказов с OZON
2. Автообновление каталога из 1С
3. Личный кабинет для клиентов

## Бюджет: до 500к руб
## Срок: до марта 2026

lideravto/
├── biz/
│   └── it-requirements.biz.md    ← ИСТОЧНИК ПРАВДЫ
└── it/
    └── requirements.biz.md        ← ссылка: см. biz/it-requirements.biz.md

lideravto/
├── biz/
│   └── it-requirements.biz.md    ← ЧТО нужно (бизнес-язык)
└── it/
    └── requirements.biz.md        ← ЧТО сделаем (техязык)

Нужна интеграция с OZON (автозагрузка заказов)

Требование: Интеграция с OZON API
Источник: biz/it-requirements.biz.md

Техническое уточнение:
- OZON API v3 (FBS + FBO)
- Sync каждые 15 минут
- Webhook для новых заказов

lideravto/
└── it/                           ← ИТ ДОМЕН
    ├── index.yaml                ← domain: it
    │
    ├─── ОБЩИЕ (domain-level)
    │    ├── requirements.biz.md  ← требования к ИТ (от бизнеса)
    │    ├── architecture.arc.md  ← общая ИТ архитектура
    │    ├── tech-stack.arc.md    ← технологии
    │    └── infrastructure.ops.md ← серверы, инфра
    │
    └─── ПРОЕКТЫ (project-level)
         └── lideravto-2026/      ← КОНКРЕТНЫЙ ПРОЕКТ
             ├── index.yaml
             ├── requirements.biz.md    ← требования к проекту
             ├── architecture.arc.md    ← архитектура проекта
             ├── roadmap.prj.md         ← план реализации
             └── cscart/                ← ENGINE (движок)
                 ├── catalog/           ← module
                 └── orders/            ← module

1. it/requirements.biz.md          ← получили от бизнеса
       ↓
2. it/architecture.arc.md          ← решили КАК (общий план)
       ↓
3. it/lideravto-2026/              ← создали ПРОЕКТ
       ↓
4. it/lideravto-2026/requirements.biz.md   ← требования к проекту
       ↓
5. it/lideravto-2026/architecture.arc.md   ← архитектура проекта
       ↓
6. it/lideravto-2026/roadmap.prj.md        ← план реализации
       ↓
7. it/lideravto-2026/cscart/               ← движок

lideravto-2026/
└── cscart/                       ← ENGINE
    ├── index.yaml
    │
    ├─── МОДУЛИ (module-level)
    │    ├── catalog/
    │    │   ├── index.yaml
    │    │   ├── purpose.biz.md        ← зачем модуль
    │    │   ├── design.dsg.md         ← как общее
    │    │   ├── catalog-products.spc.md  ← спека функций
    │    │   ├── products-create.pmt.md   ← промпт для AI
    │    │   ├── api.api.md            ← API модуля
    │    │   ├── test.tst.md           ← тесты
    │    │   └── src/                  ← КОД
    │    │       └── Products.php
    │    │
    │    └── orders/
    │        ├── index.yaml
    │        ├── purpose.biz.md
    │        ├── ozon-sync.spc.md
    │        └── src/
    │            └── OzonSync.php
    │
    └─── ОКРУЖЕНИЯ (environments)
         ├── dev/
         ├── test/
         └── prod/

1. catalog/index.yaml              ← мастер-файл
       ↓
2. catalog/purpose.biz.md          ← ЗАЧЕМ модуль
       ↓
3. catalog/design.dsg.md           ← КАК (компоненты)
       ↓
4. catalog/catalog-products.spc.md ← ЧТО делает (детали)
       ↓
5. catalog/products-create.pmt.md  ← инструкции для AI
       ↓
6. catalog/src/Products.php        ← КОД
       ↓
7. catalog/api.api.md              ← документация API
       ↓
8. catalog/test.tst.md             ← тесты

lideravto/
└── biz/
    └── expansion-2026.prj.md     ← бизнес-инициатива

lideravto/
└── it/
    └── lideravto-2026/           ← техническая реализация

┌────────────────────────────────────────────────────────────┐
│ ТЗ = ПЕРЕХОД от бизнес-требований к техреализации          │
└────────────────────────────────────────────────────────────┘

ЭТАП 1: Бизнес описывает ЧТО нужно
  → biz/it-requirements.biz.md

ЭТАП 2: ИТ уточняет КАК технически
  → it/requirements.biz.md

ЭТАП 3: ИТ проектирует решение
  → it/architecture.arc.md

ЭТАП 4: ИТ создает проект
  → it/lideravto-2026/requirements.biz.md
  → it/lideravto-2026/architecture.arc.md

1. DOMAIN (бизнес → ИТ)
   biz/it-requirements.biz.md     ← ЧТО нужно от ИТ
   it/requirements.biz.md         ← ЧТО сделаем

2. PROJECT (требования к проекту)
   it/lideravto-2026/requirements.biz.md  ← требования к версии 2026

3. MODULE (требования к модулю)
   it/lideravto-2026/cscart/catalog/purpose.biz.md  ← зачем модуль

# Создать бизнес-документы
mkdir -p lideravto/biz
cd lideravto/biz

# 1. Видение
cat > vision.biz.md << 'END'
# Видение Лидер Авто
Стать №1 поставщиком запчастей для грузовиков
END

# 2. Требования к ИТ
cat > it-requirements.biz.md << 'END'
# Требования к ИТ

## Проблема
Заказы с OZON обрабатываются вручную

## Решение
Автоматическая синхронизация заказов

## Бюджет: 500к
## Срок: март 2026
END

# Создать ИТ домен
mkdir -p lideravto/it
cd lideravto/it

# 1. Получить требования
cat > requirements.biz.md << 'END'
# Требования к ИТ

Источник: ../biz/it-requirements.biz.md

## Техническое уточнение
- OZON API v3
- Sync каждые 15 минут
- Webhook для новых заказов
END

# 2. Архитектура
cat > architecture.arc.md << 'END'
# ИТ Архитектура

## Решение
CS-Cart + модуль OZON интеграции

## Компоненты
- OzonSync (синхронизация)
- OrdersProcessor (обработка)
END

# Создать проект
mkdir -p lideravto/it/lideravto-2026
cd lideravto/it/lideravto-2026

# Мастер-файл
cat > index.yaml << 'END'
type: project
version: 2026
status: development
engine:
  name: cscart
  version: 4.17
END

# Требования к проекту
cat > requirements.biz.md << 'END'
# Требования к lideravto-2026

## Цель
Интеграция с OZON

## Модули
1. OZON Orders Sync
2. Products Catalog
END

# План проекта
cat > roadmap.prj.md << 'END'
# Roadmap 2026

## Волна 1 (февраль)
- [x] OZON API интеграция
- [ ] Catalog module

## Волна 2 (март)
- [ ] Testing
- [ ] Prod deploy
END

# Создать модуль
mkdir -p lideravto/it/lideravto-2026/cscart/orders
cd orders

# 1. Мастер-файл
cat > index.yaml << 'END'
type: module
name: orders
dependencies:
  - ozon-api
END

# 2. Зачем
cat > purpose.biz.md << 'END'
# Orders Module

## Зачем
Автоматическая синхронизация заказов с OZON
END

# 3. Как (дизайн)
cat > design.dsg.md << 'END'
# Orders Design

## Компоненты
- OzonSync — синхронизация
- OrdersProcessor — обработка
END

# 4. Спека
cat > ozon-sync.spc.md << 'END'
# OZON Sync Specification

## Функция: sync_orders()
- Получить заказы из OZON API
- Сохранить в таблицу Orders
- Вернуть количество новых
END

# 5. Промпт
cat > ozon-sync-create.pmt.md << 'END'
# Промпт: Создать OzonSync

Создай класс OzonSync в src/OzonSync.php

Требования:
1. Метод sync_orders()
2. OZON API v3
3. Сохранение в БД
END

# 6. Код (создаст AI по промпту)
mkdir src
# ... AI создаст src/OzonSync.php

# 7. API документация
cat > api.api.md << 'END'
# Orders API

## sync_orders()
Синхронизирует заказы с OZON
END

# 8. Тесты
cat > test.tst.md << 'END'
# Tests

- [ ] Синхронизация работает
- [ ] Новые заказы сохраняются
END

┌─────────────────────────────────────────────────────────────────┐
│ ПОСЛЕДОВАТЕЛЬНОСТЬ РАЗРАБОТКИ ЛЮБОГО ИТ ПРОЕКТА                 │
└─────────────────────────────────────────────────────────────────┘

1. БИЗНЕС-ИДЕЯ
   → biz/vision.biz.md

2. БИЗНЕС-ПРОЦЕССЫ
   → biz/processes.ops.md

3. ТРЕБОВАНИЯ К ИТ (ЭТО НАЧАЛО ТЗ!)
   → biz/it-requirements.biz.md

4. ИТ АНАЛИЗ (ЭТО ПРОДОЛЖЕНИЕ ТЗ!)
   → it/requirements.biz.md
   → it/architecture.arc.md

5. СОЗДАНИЕ ПРОЕКТА
   → it/project-2026/index.yaml
   → it/project-2026/requirements.biz.md
   → it/project-2026/architecture.arc.md
   → it/project-2026/roadmap.prj.md

6. ВЫБОР ДВИЖКА
   → it/project-2026/engine/

7. СОЗДАНИЕ МОДУЛЕЙ (для каждого модуля)
   → module/index.yaml               ← мастер-файл
   → module/purpose.biz.md           ← зачем
   → module/design.dsg.md            ← как общее
   → module/spec.spc.md              ← детали
   → module/prompt.pmt.md            ← инструкции AI
   → module/src/                     ← код
   → module/api.api.md               ← API
   → module/test.tst.md              ← тесты

8. ТЕСТИРОВАНИЕ
   → dev/ → test/ → prod/

9. ДЕПЛОЙ
   → prod/

it/index.yaml
it/project/index.yaml
it/project/engine/index.yaml
it/project/engine/module/index.yaml

it/project/
├── index.yaml              ← обязательно
├── requirements.biz.md     ← обязательно
└── engine/                 ← обязательно
    └── module/
        ├── index.yaml
        ├── purpose.biz.md
        └── src/