От экономического события к строкам бухгалтерской записи - и к атомарному факту в финансовом EDWH.
2 мин чтения·База знаний
Справочный материал. Контракты данных, архитектурные решения и ограничения применения. Источники приведены в материалах, где используются внешние основания.
Экономическое событие - факт хозяйственной деятельности (например, поступление оплаты). Документ фиксирует событие в операционной или учётной системе. Проводка отражает его на бухгалтерских счетах по правилам соответствующего учётного контура.
Это не обязательно взаимно-однозначное соответствие: один документ может породить несколько проводок, а запись может быть сформирована пакетным процессом. Поэтому ключ операционной транзакции, номер документа и идентификатор строки проводки нельзя безусловно считать одним идентификатором.
При определённой модели учёта и в пределах одной сбалансированной бухгалтерской записи:
Σ дебетовых сумм = Σ кредитовых сумм.
При машинном представлении можно выбрать соглашение: дебет положителен, кредит отрицателен. Тогда контроль по каждому документу и валюте:
sum(signed_amount_minor) = 0
Критически важно: равенство нужно проверять на корректном уровне детализации - обычно в рамках учётного документа / набора проводок, соответствующего валютного измерения и бухгалтерского контура. Общая нулевая сумма по всей базе может скрыть две компенсирующие ошибки.
Суммы в разных валютах нельзя складывать без установленной процедуры конвертации. В учебном стенде используется RUB и хранение целых копеек. Такой способ обеспечивает точность суммирования в выбранном диапазоне и при одной фиксированной размерности.
При промышленной реализации в PostgreSQL часто используют numeric(p,s) с явно определённой точностью, валютой, масштабом и правилами округления. Для Python следует предпочитать Decimal, а не двоичный float, когда нужны строгие десятичные расчёты.
The key distinction: event, document, journal entry#
An economic event is a business occurrence, such as a payment received. A document records the event in an operational or accounting system. A journal entry records it against accounting accounts under the rules of the relevant ledger.
These relationships are not necessarily one-to-one. One document may produce several journal entries, and an entry may be created by a batch process. Do not assume that an operational transaction key, document number, and journal-line ID are interchangeable.
Within a defined accounting model and one balanced journal entry:
Σ debit amounts = Σ credit amounts.
A machine-readable convention can treat debit as positive and credit as negative. Then the control for each document and currency is:
sum(signed_amount_minor) = 0
Critical: test equality at the correct level of detail, usually the accounting document or related entry set, currency, and ledger. A zero total across the entire database can hide two offsetting errors.
Amounts in different currencies cannot be added without a defined conversion procedure. The educational lab uses RUB and stores whole kopecks. This preserves summation accuracy within the selected range and fixed scale.
A production PostgreSQL implementation often uses numeric(p,s) with explicit precision, currency, scale, and rounding rules. In Python, prefer Decimal over binary float for strict decimal calculations.