СТАНДАРТ ТЕРМИНОЛОГИИ ПЛАТФОРМЫ

ПРОЕКТ (процесс) = Временная деятельность по созданию/изменению

Примеры:
✅ Проект интеграции с OZON        (работа клиентская)
✅ Проект внедрения CRM             (внутренняя работа)
✅ Проект запуска нового сайта      (работа)
✅ Проект миграции БД               (работа)

Характеристики:
- Начало: 2025-12-01
- Конец: 2026-03-31
- Команда: 3 человека
- Бюджет: 500 000₽
- Результат: Работающая интеграция

ПРОЕКТ (документация) = Спецификация/чертёж того что создаём

Примеры:
✅ Проект дома (чертежи)
✅ Проект системы (SPECIFICATION.md)
✅ Проект бизнеса (бизнес-план)

НО ЛУЧШЕ НАЗВАТЬ:
✅ Спецификация системы
✅ Описание бизнеса
✅ План здания

┌─────────────────────────────────────────────────────────┐
│  Используй "ПРОЕКТ" ТОЛЬКО для:                         │
│                                                         │
│  1. Временной организационной работы                   │
│     ✅ "Проект интеграции с OZON"                       │
│     ✅ "Проект внедрения CRM"                           │
│                                                         │
│  Для документации используй точные термины:            │
│  ✅ Спецификация системы (SPECIFICATION.md)             │
│  ✅ Описание бизнес-единицы (SPECIFICATION.md)          │
│  ✅ План / Чертёж                                       │
└─────────────────────────────────────────────────────────┘

БИЗНЕС-ЕДИНИЦА = Организация, которая работает непрерывно

Примеры:
✅ pirotehnika    (торговля фейерверками)
✅ lideravto      (торговля автозапчастями)
✅ content-factory (SaaS-продукт)

Характеристики:
- ❌ НЕ временная (работает пока существует)
- ✅ Постоянная
- ✅ Имеет выручку, прибыль, команду
- ✅ Может быть продана/закрыта

ИТ-СИСТЕМА = Программа/сервис с определённой функцией

Примеры:
✅ PIM       (Product Information Management)
✅ CRM       (Customer Relationship Management)
✅ Analytics (Аналитическая система)

Характеристики:
- ✅ Постоянная (пока используется)
- ✅ Имеет код, данные, API
- ✅ Обслуживает пользователей
- ✅ Эволюционирует (версии)

НАБОР ДАННЫХ = Коллекция данных с определённой структурой

Примеры:
✅ pim_products     (товары)
✅ customers        (клиенты)
✅ orders           (заказы)

Характеристики:
- ✅ Имеет схему (структуру)
- ✅ Имеет владельца
- ✅ Имеет подключение к хранилищу

РЕСУРС = Физическая или виртуальная сущность инфраструктуры

Примеры:
✅ beget-kondurov   (физический сервер)
✅ postgresql-001   (инстанс СУБД)
✅ hub              (S3 хранилище)

Характеристики:
- ✅ Физически существует
- ✅ Имеет характеристики (CPU, RAM, Storage)
- ✅ Может быть общим или выделенным

КАНАЛ = Путь продажи товаров/услуг клиентам

Примеры:
✅ retail       (розничная торговля через сайт)
✅ ozon         (маркетплейс OZON)
✅ wholesale    (оптовые продажи)

Характеристики:
- ✅ Принадлежит бизнес-единице
- ✅ Имеет свою специфику
- ✅ Генерирует выручку

ОПЕРАЦИЯ = Постоянная функция бизнеса

Примеры:
✅ logistics    (логистика)
✅ warehouse    (склад)
✅ procurement  (закупки)
✅ pim          (управление товарами)

Характеристики:
- ✅ Постоянная функция
- ✅ Обслуживает бизнес
- ✅ Имеет процессы и ресурсы

НАПРАВЛЕНИЕ = Стратегический вектор развития

РЕКОМЕНДАЦИЯ: Не использовать, заменить на:
- Канал продаж (для продаж)
- Операция (для функций)

ЦЕЛЕВАЯ = Продаём клиентам, решаем их проблему

Примеры:
✅ Сайт pirotehnika.spb.ru   (клиенты покупают товары)
✅ SaaS платформа            (клиенты используют)
✅ Мобильное приложение       (клиенты используют)

Вопросов: 9 (ПОЧЕМУ, ЗАЧЕМ, ЧТО, КТО, КАК, ЧЕМ, ГДЕ, КОГДА, СКОЛЬКО)

ОБЕСПЕЧИВАЮЩАЯ = Поддерживает другие системы

Примеры:
✅ PIM          (данные для сайта и маркетплейсов)
✅ 1C           (учёт для всех бизнесов)
✅ Логистика    (доставка для торговли)

Вопросов: 7 (нет ПОЧЕМУ и ЗАЧЕМ, есть ПРИНЦИПЫ и МИССИЯ)

ИНФОРМАЦИОННАЯ = Хранит и передаёт информацию

Примеры:
✅ Architect       (методология)
✅ База знаний     (документация)
✅ Wiki            (знания компании)

Вопросов: 5 (ЧТО, ЧЕМ, КАК, ГДЕ, СКОЛЬКО)

ПРОЦЕСС = Workflow, преобразование входа в выход

Примеры:
✅ Логистика           (заказ → доставленный товар)
✅ Производство        (сырьё → продукт)
✅ Обработка заказа    (новый заказ → выполненный)

Вопросов: 8 (ПОЧЕМУ, ЗАЧЕМ, ВХОД, ВЫХОД, КТО, КАК, ЧЕМ, ГДЕ)

АГЕНТ = Автономная система с собственным поведением

Примеры:
✅ Telegram бот        (общается с пользователями)
✅ Worker синхронизации (автоматически синхронизирует данные)
✅ Мониторинг          (отслеживает и реагирует)

Вопросов: 6 (ЗАЧЕМ, ЧТО, КТО, КАК, ЧЕМ, ГДЕ)

L0:ORG = Как мы организованы

Содержит:
- business-units/      (постоянные бизнесы)
- projects/            (временные работы)
- methodology/         (методология)

L1:SERVICE = Что делают системы

Содержит:
- systems/             (ИТ-системы)
  - api/               (REST/GraphQL)
  - ui/                (Web/Mobile)
  - cli/               (Командная строка)
  - processors/        (ETL обработки)

L2:DATA = Как работать с данными

Содержит:
- connections/         (подключения к ресурсам)
- datasets/            (наборы данных)
- schemas/             (схемы структур)

L3:INFRA = Физическая база

Содержит:
- compute/             (серверы, VM, контейнеры)
- storage/             (хранилища)
- network/             (сеть, домены)
- database-engines/    (СУБД инстансы)

❌ PROJECT.md              → Используй SPECIFICATION.md
❌ DESCRIPTION.md          → Используй SPECIFICATION.md
❌ INFO.md                 → Используй README.md
❌ DOCS.md                 → Используй README.md или API.md

Формат: lowercase-with-dashes

Примеры:
✅ business-units
✅ client-projects
✅ database-engines
✅ sales-channels

❌ BusinessUnits
❌ client_projects
❌ Database-Engines

Формат: 4-6 букв, lowercase

Примеры:
✅ piro         (pirotehnika)
✅ lider        (lideravto)
✅ sys          (system)
✅ bu           (business unit)

Использование:
- Префиксы в БД: bu_piro, sys_pim
- Коды ресурсов: piro-db, lider-s3

❌ "Проект" без уточнения (используй точные термины)
❌ "Направление" (используй Channel или Operation)
❌ "PROJECT.md" (используй SPECIFICATION.md)
❌ "Данные" в значении "код работы с данными" (используй Connection, Schema)

projector:
  entity_types:
    - business-unit
    - system
    - dataset
    - project           # Только для временных работ!

  forbidden_terms:
    - "бизнес-проект"
    - "ИТ-проект"
    - "проект данных"
    - "направление" (вместо channel)

  standard_files:
    - SPECIFICATION.md  # НЕ PROJECT.md!
    - ARCHITECTURE.md
    - README.md
    - CLAUDE.md
    - index.yaml