← Index · ← File index · ← Prev · Next → · 📄 source

#889: `AbstractRechnungsStatistik.kt`

projectforge-business/src/main/kotlin/org/projectforge/business/fibu/AbstractRechnungsStatistik.kt

Type: Abstract generic class (Serializable)

Package: org.projectforge.business.fibu

Full path: projectforge-business/src/main/kotlin/org/projectforge/business/fibu/AbstractRechnungsStatistik.kt

223 lines · 148 code · 53 comments · 22 blank

Abstract statistics calculator for invoices. Aggregates financial metrics across a collection of invoices (outgoing or incoming): gross (brutto), net (netto), with cash discount (bruttoMitSkonto), paid (gezahlt), open (offen), overdue (ueberfaellig), and cash discount amounts (skonto). Also tracks payment term averages and provides Markdown-formatted output for Wicket UI display. Supports multi-currency conversion with warning tracking.

Type Parameter

T : AbstractRechnungDO? — The concrete invoice type (e.g., RechnungDO or EingangsrechnungDO).

Aggregated Properties

Property	Type	Description
`brutto`	`BigDecimal`	Total gross sum across all invoices
`netto`	`BigDecimal`	Total net sum
`bruttoMitSkonto`	`BigDecimal`	Total gross with discount applied
`gezahlt`	`BigDecimal`	Total amount paid
`offen`	`BigDecimal`	Total outstanding (not yet paid)
`ueberfaellig`	`BigDecimal`	Total overdue amount
`skonto`	`BigDecimal`	Accepted shortfall (discounts granted by customer)
`counter`	`Int`	Total number of invoices counted
`counterBezahlt`	`Int`	Number of fully paid invoices

Core Method: `add(rechnung: T)`

The primary entry point. For each invoice added:

Retrieves cached invoice info via rechnungCache.getRechnungInfo(rechnung)
Converts all amounts to the system's configured currency using currencyConversionService.convert()
If currency conversion fails for any invoice, a warning message is accumulated in currencyConversionWarnings and the original (unconverted) amount is used as fallback
Accumulates gross, net, gross-with-discount, and paid/open/overdue amounts
Calculates cash discount (skonto) when paid amount is less than gross
Tracks payment term averages: contractual (zahlungsZielSum) and actual (tatsaechlichesZahlungsZiel)
Detects overdue invoices via rechnungInfo.isUeberfaellig

Currency Conversion

The private convertToSystemCurrency() method handles multi-currency scenarios:

Skips conversion if source and target currencies match (case-insensitive)
Uses useFallbackToOldestRate = true for historical invoices where an exact exchange rate may not exist
Builds warning messages for display in the format: "invoiceRef (date): USD → EUR"
Falls back to the original amount when conversion is unavailable

Computed Properties

Companion Object Dependencies

The companion object holds lateinit service references that must be set externally before use:

rechnungCache: RechnungCache — provides RechnungInfo for each invoice
currencyConversionService: CurrencyConversionService — handles multi-currency amount conversion
configurationService: ConfigurationService — provides the system default currency

Git History

868d6abb7 2025 -> 2026
472fbc977 WIP: currency conversion with Claude Code.
8c2bf04f0 WIP: currency conversion with Claude Code.
6be9c2b84 WIP: currency conversion with Claude Code.
63081666f Source file headers: 2024-> 2025.
b47c21af6 Refactored caching and calculations with invoices (not yet finished)
ccb7ca64d Migration stuff in progress...
b6092df09 Copyright 2023 -> 2024
ab45d51fa Copyright 2001-2022 -> 2001-2023.
09b3f0df7 WIP: Jobmonitor. ListStatisticsSupport -> MarkdownBuilder
0b835b27e Support of statistics or other infos on result set on list page.
a286007ee Mass update of creditor invoices: handling of discount implemented.
832934b14 WIP: mass update

Property	Type	Description
`zahlungszielAverage`	`Int`	Average contractual payment term in days
`tatsaechlichesZahlungzielAverage`	`Int`	Weighted average actual payment duration in days
`asMarkdown`	`String`	Markdown table with all financial metrics, colored for open (blue) and overdue (red) amounts
`hasCurrencyConversionWarnings`	`Boolean`	True if any currency conversion failures occurred
`currencyConversionWarningsList`	`List<String>`	List of warning messages for Wicket display

#889: AbstractRechnungsStatistik.kt