Таблица путешествует без своего автора
Таблицу передали другой команде. Вместе с файлом нужно объяснить, что считается клиентом, почему исключены некоторые строки и к какой дате относится выгрузка. Паспорт данных сохраняет эти определения рядом с набором.
Пример: обращения как показатель спроса
Представим учебную ситуацию: служба поддержки передаёт аналитику таблицу обращений по продуктам. Аналитик хочет определить, какой продукт покупают чаще. Однако строки возникают при проблемах, повторных вопросах и уточнениях одного клиента. Популярность в поддержке может отражать сложность использования, а не объём продаж.
Паспорт не исправляет такую выборку, но объясняет механизм её появления. Запись «одна строка — одно обращение, включая повторные; покупки без обращений отсутствуют» сразу ограничивает вывод. Эти данные пригодны для изучения нагрузки поддержки. Для оценки продаж потребуется другой источник или явно описанное объединение.
Происхождение включает преобразования
Название системы недостаточно: выгрузка могла пройти фильтрацию, объединение и ручные исправления. Запишите, какой исходный набор использован, за какой период и какие преобразования существенно меняют смысл. Если исключены отменённые заявки, будущий пользователь должен знать это до сравнения с отчётом, где они учитываются.
Полезно отделять владельца смысла от исполнителя выгрузки. Аналитик может технически подготовить файл, но не иметь права решать, какие статусы считаются завершённой продажей. В карточке нужен контакт, способный объяснить определение и согласовать его изменение, а не только повторно прислать документ.
Словарь защищает от тихих ошибок
Для важных столбцов укажите единицы измерения, допустимые значения и значение пропуска. Пустая дата завершения может означать незавершённую работу, отсутствие сведений или неприменимость поля. Подмена всех вариантов нулём упростит расчёт, но изменит смысл. То же относится к суммам с налогом и без него.
Пример корректной строки помогает проверить понимание. Рядом полезно показать пограничную ситуацию, например возвращённую заявку. Если два читателя по описанию относят её к разным категориям, определение ещё не готово. Эта короткая проверка дешевле обсуждения противоречивых графиков после публикации отчёта.
Актуальность — несколько разных дат
Дата создания файла, время последнего обновления источника и период, который покрывают записи, могут различаться. Свежая выгрузка исторических сведений остаётся исторической. Поэтому карточка должна позволять ответить не только «когда скачали», но и «о каком времени говорят данные» и «когда ожидается следующее обновление».
Отдельно укажите известные задержки и неполное покрытие. Например, один филиал может передавать записи позже остальных. Такая пометка не обесценивает набор: она помогает выбрать подходящий момент сравнения. Без неё пользователь легко примет задержку поступления за изменение бизнеса.
Паспорт должен меняться вместе с набором
Когда переименовывают поле, меняют правила отбора или добавляют источник, обновляют и описание. Иначе паспорт превращается в ещё одну устаревшую таблицу. Удобно назначить его проверку частью выпуска очередной версии и сохранять краткую историю изменений, влияющих на интерпретацию.
