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