Модуль 12. Термины и «Словарь бизнес-аналитика» (RU/EN)
Зачем и что именно должно получиться
Цель: один язык для бизнеса, ИТ и аналитиков — без «GM% у всех разный» и «по-русски одно, по-английски другое».
Выход модуля:
- Корпоративный словарь (глоссарий) с карточками терминов (RU/EN), владельцами и версиями.
- Style-guide именований для колонок, метрик, таблиц, диаграмм, документов.
- Процесс управления: как добавлять/менять термины, кто утверждает, где хранится.
Карточка термина: из чего состоит (минимально достаточная)
Рекомендуемый состав полей (однообразно во всём словаре):
- ID: TERM-XXXX (уникальный код).
- RU: краткое русское название (ед. число: «Остаток»).
- EN: точный английский эквивалент («Inventory on hand»).
- Определение (RU): 2–4 строки, без жаргона.
- Definition (EN): одно предложение.
- Класс: Business / Data / Metric / Visualization / Process / Governance / Security и т.д.
- Синонимы/NOT: разрешённые синонимы; Not to use: запретные/устаревшие.
- Формула/Правила: если метрика — формула, гранулярность, исключения.
- Единицы/Формат: %, ₽, шт., дни; #,##0.0% и т.п.
- Поле/Колонка: рекомендуемое системное имя (gm_pct, inventory_qty).
- Владелец: Data/Metric Owner.
- Версия: semver (напр., 1.3.0) + дата.
- Источники: таблицы/документы.
- Примечания: частые ошибки, пограничные случаи.
Шаблон YAML (копируйте в Confluence/Notion):
id: TERM-0123 ru: Остаток en: Inventory on hand class: Metric definition_ru: Количество товара, доступное к продаже на момент X. Не включает товар в транзите. definition_en: Quantity of goods available for sale at a point in time; excludes in-transit stock. formula: snapshot on day_end; sum(stock_qty) where location_type = 'STORE|DC' units: units column: inventory_qty owner: Ops Data Steward version: 1.1.0 (2025-05-15) sources: [fact_inventory_snapshot, dim_store] notes: Не путать с 'Availability' (уровень сервиса). Возвраты попадают в день оприходования.
Style-guide именований (данные, метрики, визуализации, документы)
Таблицы и колонки (DWH/БД)
- Факты: fact_<сущность> → fact_sales, fact_inventory_snapshot.
- Измерения: dim_<сущность> → dim_product, dim_store.
- Агрегаты: agg_<тема>_<период> → agg_sales_week_sku.
-
Колонки:
- идентификаторы: <entity>_id → product_id.
- даты: date_… для календарных (date_sold), ts_… для таймстампов (ts_loaded).
- булевы: is_… → is_promo, is_return.
- валюта/единицы: суффиксы _rub, _usd, _eur, _qty, _days, _kg.
- процент: _pct → gm_pct, формат по умолчанию 0.0%.
- Историчность (SCD): valid_from, valid_to, is_current.
Метрики (семантика BI)
- Меры (measures): GM% (отображение) ↔ gm_pct (тех. имя).
- Иерархии: Год→Квартал→Месяц→День (year/quarter/month/date).
- Нотация единиц: в скобках: Revenue (₽), Lead Time (days).
- Антипаттерны: Profitability, Маржа — без формул запрещены. Всегда держим стандартизированное: GM/GM% c формулой.
Диаграммы/листинги
- Названия графиков: вопрос, на который отвечает график: GM% by Channel (YoY).
- Оси: подписи и единицы обязательны: GM% (pp), Revenue (₽ mln).
- Цвета: бизнес-ключевые категории фиксированные; «красный» зарезервирован под warning.
Документы и артефакты
-
Идентификаторы:
- BRD: BRD-<PRJ>-<NNN> → BRD-RET-012.
- SRS: SRS-<PRJ>-<NNN>.
- Change Request: CR-<PRJ>-<YYYYMM>-<NN>.
- Версионирование: semver MAJOR.MINOR.PATCH. MAJOR — меняет методику/поведение, MINOR — совместимые добавления, PATCH — правки/опечатки.
- Статусы: Draft → Review → Approved → Deprecated.
RU↔EN: карта соответствий (частые и «ложные друзья»)
Ниже — концентрат по 90+ часто встречающимся терминам. Для полного корпоративного словаря расширьте список до 300+ (см. практику).
Бизнес-метрики и финансы
- Выручка — Revenue (net of VAT?)
- Себестоимость — COGS
- GM, GM% — Gross margin, Gross margin %
- EBITDA — EBITDA (не переводится)
- Операционные расходы — OPEX
- Капитальные затраты — CAPEX
- Оборачиваемость запасов — Inventory turnover
- Дни запасов — Days of inventory (DOI)
- Дебиторская/Кредиторская — AR/AP
- DSO/DPO — Days Sales/Payables Outstanding
- Курсовая разница — FX difference
- НДС включён/исключён — VAT included/excluded
Продажи/ритейл/промо
- Трафик (футфол) — Footfall
- Конверсия — Conversion rate
- Средний чек — Average ticket / AOV
- Товары-локомотивы (KVI) — Key Value Items (KVI)
- Акция/промо — Promotion
- Uplift промо — Promo uplift
- Лайк-фор-лайк — Like-for-like (LFL)
- Возвраты — Returns
- Out-of-Stock (OOS) — Out of stock
- Уровень сервиса — Service level (не «availability»)
- Остатки — Inventory on hand
- Распределение/перемещение — Replenishment/Transfer
Логистика/SCM
- Lead time — Lead time
- On-time in-full (OTIF) — OTIF
- Последняя миля — Last mile
- Склад (РЦ) — DC (Distribution Center)
- Комплектация — Picking
- Кросс-докинг — Cross-docking
- Слоттинг — Slotting
- Паллетоместо — Pallet position
Данные/архитектура
- Источник данных — Data source
- Хранилище данных — Data warehouse (DWH)
- Витрина данных — Data mart
- Измерение / Факт — Dimension / Fact
- Гранулярность — Grain
- Кардинальность — Cardinality
- Историчность (SCD) — Slowly Changing Dimension (Type 1/2/4)
- Снимок — Snapshot
- Ключ естественный/суррогатный — Natural/Surrogate key
- Согласованное измерение — Conformed dimension
- Линейдж — Data lineage
- Контракт данных — Data contract
- Качество данных — Data quality (DQ)
- Своевременность — Timeliness
- Полнота — Completeness
- Валидность — Validity
- Уникальность — Uniqueness
- Точность — Accuracy
- Согласованность — Consistency
- Выбросы — Outliers
- Обогащение — Enrichment
- Дедупликация — Deduplication
Интеграции/BI/эксплуатация
- ETL/ELT — ETL/ELT
- CDC (изменения данных) — Change Data Capture
- Стриминг — Streaming
- Семантический слой — Semantic layer / Headless BI
- Ролевые доступы — Row-level security (RLS)
- Соглашение об уровне сервиса — SLA
- Доступность — Availability
- Время отклика p95 — p95 response time
- Деградация — Degradation
- Аудит/журналирование — Audit/Logging
- Отчёт/дашборд — Report/Dashboard
- Экспорт/выгрузка — Export/Download
Аналитика/продукт
- Когорта — Cohort
- Retention/Churn — Retention/Churn
- ARPU/ARPPU — ARPU/ARPPU
- Воронка — Funnel
- A/B-тест — A/B test
- Разница-в-разницах — Difference-in-Differences (DiD)
- MDE — Minimum Detectable Effect
Процессы/BA/управление
- Требование — Requirement
- Бизнес-требование — Business requirement
- Функциональное / Нефункциональное — Functional / Non-functional (NFR)
- BRD/SRS/Use Case/User Story — BRD/SRS/Use Case/User Story
- Критерии приёмки — Acceptance criteria
- DoR/DoD — Definition of Ready/Done
- Приоритизация MoSCoW/WSJF — MoSCoW/WSJF
- UAT — User Acceptance Testing
- RACI/DACI — RACI/DACI
- Дорожная карта — Roadmap
- Изменение (CR) — Change request
Визуализация/статистика
- Столбчатая диаграмма — Bar chart (по категориям)
- Гистограмма — Histogram (распределение!)
- Линейный график — Line chart
- Ящик с усами — Boxplot
- Тепловая карта — Heatmap
- Диаграмма рассеяния — Scatter plot
- Percentage-points — Процентные пункты (pp)
Ложные друзья (частые ошибки):
Availability ≠ «наличие на складе» (это inventory on hand).
Accuracy ≠ «точность прогноза» в общем (лучше forecast accuracy).
Uptime ≠ Freshness.
Часто используемые аббревиатуры (единый стандарт написания)
KPI, OKR, SLA, SLI/SLO, NFR, RLS, DQ, ETL/ELT, CDC, SCD, OLAP/OLTP, CRUD, UAT, DR (Disaster Recovery), RTO/RPO, PII, MAU/WAU/DAU, LTV, CAC, NPS, E2E, WSJF, BOM (для производства), OTIF, OOS, DOI/DOH (Days of Inventory), ABC/XYZ (классификации).
Правило: при первом употреблении — полная форма + аббревиатура в скобках, далее — только аббревиатура.
Губернанс словаря: роли и процесс
- Владелец практики (Glossary Owner): утверждает стандарты, ведёт релизы словаря.
- Data/Metric Owners: отвечают за конкретные термины/метрики.
-
Процесс изменений:
- Предложение (Proposal) — карточка термина (через форму/тикет).
- Ревью — BA/Data/Legal/Security (по необходимости).
- Решение — Approved/Rejected/Needs work.
- Публикация — версия словаря ↑, release notes, рассылка.
- Частота релизов: ежемесячно (minor), срочные правки — patch.
- Места хранения: Confluence (читают все) + Git/репозиторий (версионирование YAML/CSV).
- Правило «один источник истины»: отображение в BI/доках ссылается только на текущую версию словаря.
Практические примеры карточек (3 шт.)
GM%
- RU/EN: GM% — Gross margin percentage
- Определение: доля валовой маржи в выручке периода; GM% = (Revenue−COGS−Logistics)/Revenue.
- Единицы/формат: 0.0%, округление до 0,1 п.п.
- Исключения: трансферы/самовыкупы, отрицательные продажи; возвраты — по политике методологии.
- Колонка: gm_pct. Владелец: Фин.контролёр. Версия: 1.3.1.
Out-of-Stock rate
- RU/EN: Доля OOS — Out-of-stock rate
- Определение: доля SKU-дней с нулевым остатком при наличии спроса.
- Формула: count(SKU-day where stock<=0 and demand>0) / count(SKU-day)
- Единицы: 0.0%. Колонка: oos_rate_pct. Owner: Операции. Версия: 1.1.0.
Like-for-like YoY
- RU/EN: LFL-рост — Like-for-like YoY growth
- Определение: изменение выручки сопоставимых магазинов «май к маю» при отсутствии открытий/закрытий/ремонтов.
- Примечание: «30 к 30 дней» — не LFL. Колонка: lfl_yoy_pct. Owner: Коммерция. Версия: 1.0.2.
Риски и анти-паттерны
|
Риск |
Как проявляется |
Что делать |
|---|---|---|
|
Многозначность терминов |
«Маржа» у всех своя |
Делайте конкретные GM/GM%, «где считать/что исключать», запрет «общих» слов |
|
RU/EN несоответствие |
В БД одно, в BI другое |
В карточке всегда RU и EN + «рекомендуемое системное имя» |
|
Необновлённый словарь |
Переименовали метрику — отчёты «сломались» |
Версионность, релиз-ноты, баннер «изменена методология» |
|
«Сарай» с аббревиатурами |
KPI/OKR/SLA вразнобой |
Обязательный раздел «аббревиатуры», первое упоминание — с расшифровкой |
|
Нет владельца |
Никто не решает споры |
Назначайте Owner на каждый термин/метрику |
|
Словарь «в столе» |
Никто не читает |
Ссылки в дашбордах/доках, быстрый поиск, короткие определения |
Вопрос–ответ (FAQ)
Q: Зачем EN-названия, если команда русскоязычная?
A: Чтобы имена колонок/таблиц были единообразными, а интеграции/вендоры понимали вас без перевода. EN — в системных именах, RU — в интерфейсах/доках.
Q: Можно ли хранить определения прямо в BI?
A: Да, но источник истины — глоссарий. В BI делайте ссылки/всплывающие подсказки на карточку термина.
Q: Сколько символов допустимо в системных именах?
A: Держите ≤30–40. Используйте snake_case, без пробелов/кириллицы, чёткие суффиксы _pct/_rub/_qty/_days.
Q: Как решать спор о формуле метрики?
A: Через карточку термина: формула, исключения, гранулярность, эталон. Решение — за Metric Owner + протокол в release notes.
Q: Когда повышать MAJOR-версию словаря?
A: Если меняется смысл/формула метрики, и это влияет на тренды/сравнимость.
Практика (что сделать и сдать)
A. «Скелет» корпоративного словаря (100+ записей сейчас, 300+ к релизу)
- Создайте каталог разделов: Бизнес, Метрики, Данные, Процессы, Визуализация, Интеграции, Безопасность.
- Заполните ядро из 100 терминов (по спискам из §4–5).
- Укажите владельцев и версии; включите YAML/табличный экспорт.
B. Style-guide именований (1–2 страницы)
- Правила для таблиц/колонок/мер/единиц/дат.
- Список запрещённых слов/двусмысленностей.
- Примеры правильных/неправильных имён.
C. Процесс изменений (1 страница)
- Шаги Proposal→Review→Decision→Publish, роли, SLA на ревью, семантическая версия, release notes.
D. Витрина в BI
- На ключевых дашбордах добавьте иконку «ℹ︎», ведущую на карточку термина; включите «версию методологии» и «последний релиз словаря».
Мини-каталог терминов (старт-пак 120 шт.)
Чтобы не перегружать ответ, приведу структурированный старт-пак (по 10–20 на раздел):
Бизнес/Финансы: Revenue, Net Sales, Gross Sales, COGS, GM, GM%, OPEX, CAPEX, EBITDA, FX rate, AR/AP, DSO/DPO, Write-off, Accruals, Fiscal period.
Продажи/Ретейл: Footfall, Conversion, AOV, Basket size, LFL, Promo uplift, Markdown, KVI, Planogram, Cannibalization, Cross-sell, Up-sell, Category, SKU.
Логистика/SCM: OTIF, Lead time, Fill rate, Backorder, Safety stock, Reorder point, ASN, Pick/Pack/Ship, Dock door, Cross-dock, Slotting, Last mile.
Метрики/Операции: OOS rate, DOI/DOH, Service level, Forecast accuracy, Bias, MAPE, Cycle time, Throughput, Flow efficiency.
Данные/Архитектура: Data source, DWH, Data mart, Star schema, Snowflake, Fact, Dimension, Grain, Cardinality, SCD, Snapshot, Surrogate key, Conformed dim, Lineage, Data contract, DQ (Completeness/Consistency/Accuracy/Timeliness/Validity/Uniqueness).
Интеграции/Эксплуатация: ETL/ELT, CDC, Streaming, Batch, Micro-batch, API, Rate limit, Idempotency, Retry/back-off, Dead letter, Semantic layer, RLS, Caching, p95/p99, Uptime, DR, RTO/RPO.
BA/Управление: Requirement, BRD, SRS, Use Case, User Story, Acceptance criteria, DoR/DoD, MoSCoW, WSJF, UAT, RACI/DACI, Roadmap, CR, Traceability.
Визуализация: Bar/Line/Area, Histogram, Boxplot, Heatmap, Scatter, Treemap, Sankey, KPI card, Tooltip, Dual axis (avoid), Small multiples.
Этого достаточно, чтобы быстро собрать 300+ карточек: добавьте доменные разделы (банк/производство/медицина) и специфические показатели.
Чек-листы готовности
Словарь:
- 100+ терминов заполнены (RU/EN, определения, владельцы).
- Есть экспорт (YAML/CSV) и версия словаря (semver).
- Release notes на последнюю версию опубликованы.
- В BI/доках ссылки ведут на карточки терминов.
Style-guide:
- Описаны правила имён таблиц/колонок/мер.
- Заданы суффиксы единиц (_pct/_rub/_qty/_days).
- Перечень запретных и «ложных друзей» приложен.
Процесс:
- Заведен тикет-тип «Glossary Proposal».
- Назначены Owners по разделам.
- SLA ревью ≤ 5 раб. дней.
Вы запускаете единый словарь и правила именований, связываете RU↔EN, фиксируете владельцев и версионность. Это снижает споры на UAT, ускоряет онбординг и делает метрики сопоставимыми между командами и системами.
