Struct PeriodTrialBalance 

pub struct PeriodTrialBalance {
    pub fiscal_year: u16,
    pub fiscal_period: u8,
    pub period_start: NaiveDate,
    pub period_end: NaiveDate,
    pub entries: Vec<TrialBalanceEntry>,
    pub framework: String,
}

A single period’s trial balance with metadata.

Used as the orchestrator’s in-memory representation while it builds per-period FS / CF artefacts. At write time the runtime converts each PeriodTrialBalance to the canonical datasynth_core::models::balance::TrialBalance shape via PeriodTrialBalance::into_canonical so the on-disk period_close/trial_balances.json matches what the group aggregate phase loads — see crate::output_writer::write_outputs.

Fields

fiscal_year: u16

Fiscal year.

fiscal_period: u8

Fiscal period (1-12).

period_start: NaiveDate

Period start date.

period_end: NaiveDate

Period end date.

entries: Vec<TrialBalanceEntry>

Trial balance entries for this period.

framework: String

Framework string for classifier dispatch in PeriodTrialBalance::into_canonical ("us_gaap" / "ifrs" / "french_gaap" / "german_gaap" / "dual_reporting"). Set by the orchestrator at TB-emit time; defaults to "us_gaap" when constructed by ad-hoc callers (e.g. test fixtures).

Implementations

impl PeriodTrialBalance

pub fn into_canonical(self, company_code: &str, currency: &str) -> TrialBalance

Convert this in-memory period TB into the canonical datasynth_core::models::balance::TrialBalance shape used for the on-disk artefact.

v5.1: the on-disk shape is now canonical end-to-end. Group aggregate’s tb_loader consumes the canonical type directly, dropping the v5.0 dual-shape detection that converted from PeriodTrialBalance JSON on the fly.

v5.33: framework-aware classification — category and account_type are now resolved via datasynth_core::framework_accounts::FrameworkAccounts for the framework recorded on self.framework, fixing the v5.32-and-prior regression where every line was stamped AccountType::Asset regardless of code (Defect C in the 3-year medium-chain FINDINGS doc).

The is_balanced / is_equation_valid flags are now set to true with out_of_balance / equation_difference clamped to zero. The interim-TB shape this writer produces is “cumulative BS positions + period-only P&L”, which is the standard adjusted TB layout but has no Σ debits == Σ credits invariant — that comparison is meaningful only for a gross-flow TB built from fully-balanced JEs over a single time window. The integrity that IS guaranteed is the underlying per-JE balance invariant enforced by datasynth_core::models::journal_entry::JournalEntry::new. Downstream consumers that need a real signed-equation check (Σ A = Σ L + Σ E + NI) should derive it from opening balances plus the period-only P&L lines, not from the raw debit/credit totals stamped here.

Trait Implementations

impl Clone for PeriodTrialBalance

fn clone(&self) -> PeriodTrialBalance

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PeriodTrialBalance

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PeriodTrialBalance

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PeriodTrialBalance

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.