LAYERS GUIDE — Слои для уровней иерархии

# Видение: ЛидерАвто

## Миссия
Лидер в продаже б/у запчастей для грузовой техники.

## Рынок
Разборка грузовиков в России.

## Цели 2026
- Увеличить выручку на 40%
- Запустить новый сайт
- Открыть 2 филиала

# Бизнес-процессы

## Продажа запчасти
1. Клиент звонит/заказывает на сайте
2. Менеджер проверяет наличие
3. Резерв запчасти на складе
4. Оплата
5. Доставка

## Приёмка грузовика
1. Осмотр
2. Оценка
3. Покупка
4. Разборка
5. Маркировка запчастей

# Структура компании

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

## Задачи IT отдела

- Поддержка сайтов (3 сайта)
- Интеграции (1С, BAZON, OZON)
- Инфраструктура (сервер, БД)

## Ресурсы

- 1 программист
- Бюджет: 500К/год
- Хостинг: VPS 4CPU/8GB

## Приоритеты 2026

1. Новый сайт lideravto.ru
2. Интеграция с OZON
3. CRM система

# Техстек IT-направления

## Веб

- Backend: PHP 8.1
- CMS: CS-Cart 4.19
- Frontend: JavaScript (Vanilla)
- БД: MySQL 8.0

## Инфраструктура

- Сервер: VPS (4CPU, 8GB RAM)
- ОС: Ubuntu 22.04
- Веб-сервер: Nginx
- PHP-FPM

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

- 1С через API
- BAZON через XML
- OZON через API

# Инфраструктура

## Серверы

### Production
- IP: 91.218.142.168
- Домены: lideravto.ru, pirotehnika.ru

### Development
- IP: тот же
- Домены: work.lideravto.ru, dev.pirotehnika.ru

## Сервисы

- MySQL: порт 3306
- Redis: порт 6379
- Nginx: порт 80/443

# Требования: Новый сайт lideravto.ru

## Цель

Современный сайт для продажи запчастей.

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

### Каталог
- Фильтры по марке
- Поиск по артикулу
- Пагинация

### Импорт
- Автоимпорт BAZON
- Обновление цен

### SEO
- ЧПУ URLs
- Meta-теги
- Sitemap

## Метрики успеха

- Конверсия +30%
- Скорость <2 сек

# Роадмап проекта

## Февраль 2026

- [x] Импорт BAZON
- [ ] Каталог с фильтрами
- [ ] SEO оптимизация

## Март 2026

- [ ] Тестирование
- [ ] Запуск на production

## Апрель 2026

- [ ] Интеграция с OZON
- [ ] Мобильное приложение

# Архитектура: lideravto.ru

## Движок

CS-Cart 4.19.1

## Модули

1. lider_import — импорт BAZON
2. catalog — каталог товаров
3. seo — SEO оптимизация

## База данных

MySQL 8.0
- 50,000 товаров
- 200 категорий
- 1,000 заказов/месяц

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

- BAZON (XML, каждые 6 часов)
- 1С (API, синхронизация заказов)

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

## Окружения

- dev: work.lideravto.ru
- test: test.lideravto.ru
- prod: lideravto.ru

## Процесс деплоя

1. Тесты в test/
2. Бэкап prod
3. Копирование dev → prod
4. Миграция БД
5. DNS переключение

## Откат

Restore из бэкапа

project/
├── requirements.biz.md
├── architecture.arc.md
└── src/               ← опционально
    └── lib/           ← общие библиотеки для всех модулей
        └── Utils.php

cscart/
├── config.php          ← конфиг движка
├── .env                ← переменные окружения
├── var/                ← данные движка
└── modules/            ← модули (следующий уровень)

cscart/
├── engine-upgrade.ops.md    ← как обновить CS-Cart 4.18 → 4.19
└── cache-clear.ops.md       ← как чистить кеш

# Назначение: Каталог

## Зачем

Удобный каталог товаров с фильтрами.

## Ценность

- Клиент быстро находит запчасть
- Конверсия +30%

# Дизайн: Каталог

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

1. ProductList — список товаров
2. Filters — фильтры
3. Search — поиск
4. Pagination — пагинация

## Данные

| Компонент | Таблица | API |
|-----------|---------|-----|
| ProductList | cscart_products | fn_get_products() |
| Filters | cscart_features | fn_get_filters() |

## Алгоритм

1. Получить фильтры (GET)
2. Построить SQL WHERE
3. Получить товары
4. Рендер

# Спецификация: Список товаров

## Функция

### fn_get_catalog_products($params)

**Параметры:**
- `category_id` (int)
- `brand` (string)
- `page` (int)

**Возвращает:**
```php
[
    'products' => [...],
    'total' => 150
]

SELECT * FROM cscart_products
WHERE category_id = ?
  AND brand = ?
LIMIT ?, ?

**api.api.md:**
```markdown
# API: Каталог

## Функции

### fn_get_catalog_products($params)
Получить товары

### fn_get_catalog_filters($category_id)
Получить фильтры

## Использование

```php
$products = fn_get_catalog_products([
    'category_id' => 5,
    'brand' => 'MAN'
]);

**products-create.pmt.md:**
```markdown
# Промпт: Создать Products

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

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

1. Метод getProducts($params)
2. По спеке catalog-products.spc.md
3. PDO prepared statements

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

- db_get_array()
- fn_paginate()

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

- Прямой SQL

# Тесты: Каталог

## Unit

- [ ] fn_get_products() работает
- [ ] Фильтры применяются

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

- [ ] Товары из БД
- [ ] Поиск работает

## Ручные

1. Открыть /catalog
2. Выбрать марку MAN
3. Проверить: только MAN

catalog/
├── purpose.biz.md              ← опционально
├── design.dsg.md               ← рекомендуется
├── catalog-products.spc.md     ← обязательно (дробление)
├── catalog-filters.spc.md
├── catalog-search.spc.md
├── api.api.md                  ← рекомендуется
├── products-create.pmt.md      ← если AI кодит
├── filters-create.pmt.md
├── test.tst.md                 ← рекомендуется
└── src/                        ← код
    ├── Products.php
    ├── Filters.php
    └── Search.php

# Спецификация: Products

## Класс

class Products

## Методы

### getProducts($params)

**Параметры:**
- `$params` (array)

**Возвращает:**
- array

**Логика:**
1. Валидировать params
2. Построить SQL
3. Выполнить запрос
4. Вернуть массив

# Промпт: Создать Products

Создай класс в `Products.php`

По спеке spec.spc.md

Требования:
- PSR-4
- Типизация
- PHPDoc

src/Products/
└── Products.php        ← только код (без документов)

src/Products/
├── spec.spc.md         ← если сложная логика
├── prompt.pmt.md       ← если генерируем AI
└── Products.php        ← код

1. Определить уровень (organization/domain/project/engine/module/component)
2. Посмотреть в матрицу слоёв
3. Выбрать нужные слои (✅ или ⚠️)
4. Создать ТОЛЬКО нужные файлы

Уровень: module
Нужно описать: ЧТО импортирует, КАК устроен, СПЕКА функций

Выбираю слои:
✅ purpose.biz.md    — зачем модуль
✅ design.dsg.md     — как устроен
✅ import.spc.md     — что делает функция
✅ api.api.md        — интерфейс
✅ create.pmt.md     — промпт для AI
✅ test.tst.md       — тесты
✅ src/func.php      — код

НЕ создаю:
❌ architecture.arc.md (это project уровень)
❌ deployment.ops.md (это project уровень)

Уровень: domain
Нужно описать: требования к IT, техстек, инфраструктуру

Выбираю слои:
✅ requirements.biz.md     — что нужно от IT
✅ tech-stack.arc.md       — технологии
✅ infrastructure.arc.md   — серверы, сервисы
✅ deployment.ops.md       — процессы деплоя

НЕ создаю:
❌ purpose.biz.md (слишком общо для domain)
❌ spec.spc.md (это module уровень)
❌ src/ (на domain уровне нет кода)

Уровень: project
Нужно описать: требования, план, архитектуру

Выбираю слои:
✅ requirements.biz.md   — бизнес-требования
✅ roadmap.prj.md        — план проекта
✅ architecture.arc.md   — техническая архитектура
⚠️ deployment.ops.md     — опционально (если сложный деплой)

НЕ создаю:
❌ design.dsg.md (это module уровень)
❌ spec.spc.md (это module уровень)
❌ src/ (код в модулях, не в проекте)

catalog/                    ← module
└── architecture.arc.md     ← ОШИБКА! это project уровень

project/
├── architecture.arc.md     ← архитектура проекта

catalog/                    ← module
└── design.dsg.md           ← дизайн модуля

catalog/
├── purpose.biz.md          ← зачем
├── vision.biz.md           ← дубликат! ❌
├── requirements.biz.md     ← дубликат! ❌
├── design.dsg.md
└── architecture.arc.md     ← не тот уровень! ❌

catalog/
├── purpose.biz.md          ← одного достаточно
├── design.dsg.md
└── catalog.spc.md

src/Products/
├── purpose.biz.md          ← зачем? компонент = код
├── design.dsg.md           ← избыточно
└── Products.php

src/Products/
└── Products.php            ← только код

ИЛИ (если сложный):

src/Products/
├── spec.spc.md             ← только спека
└── Products.php

lideravto/
├── vision.biz.md           ✅ видение компании
├── strategy.biz.md         ✅ стратегия
├── processes.ops.md        ✅ бизнес-процессы
└── departments.str.md      ✅ оргструктура

it/
├── requirements.biz.md     ✅ требования к IT
├── tech-stack.arc.md       ✅ технологии
├── infrastructure.arc.md   ✅ инфраструктура
└── deployment.ops.md       ✅ процессы деплоя

lideravto-2026/
├── requirements.biz.md     ✅ бизнес-требования
├── roadmap.prj.md          ✅ план проекта
├── architecture.arc.md     ✅ архитектура
└── deployment.ops.md       ⚠️ опционально

cscart/
├── config.php              ✅ конфиг
├── .env                    ✅ переменные
└── modules/                ✅ модули

catalog/
├── purpose.biz.md          ⚠️ опционально
├── design.dsg.md           ✅ дизайн
├── catalog-products.spc.md ✅ спеки
├── catalog-filters.spc.md  ✅ спеки
├── api.api.md              ✅ API
├── products-create.pmt.md  ✅ промпты
├── test.tst.md             ✅ тесты
└── src/                    ✅ код

src/Products/
└── Products.php            ✅ только код

ИЛИ:

src/Products/
├── spec.spc.md             ⚠️ если сложный
└── Products.php