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

#949: `IRechnungsPosition.kt`

projectforge-business/src/main/kotlin/org/projectforge/business/fibu/IRechnungsPosition.kt Type: Interface · Purpose: Abstract contract for invoice position items used by RechnungCalculator · Source: projectforge-business/src/main/kotlin/org/projectforge/business/fibu/IRechnungsPosition.kt 34 lines · 9 code · 22 comments · 3 blank

Core interface defining the contract for individual line items within an invoice. Works in tandem with IRechnung to decouple the invoice calculation engine from concrete JPA entity types.

Interface Design

Property	Type	Description
`id`	`Long?`	Database identifier (nullable for new positions)
`deleted`	`Boolean`	Soft-delete flag
`menge`	`BigDecimal?`	Quantity of the line item
`einzelNetto`	`BigDecimal?`	Net unit price of a single item
`vat`	`BigDecimal?`	VAT rate as percentage (e.g. 19.00)

Implementors

AbstractRechnungsPositionDO — base class implementing IRechnungsPosition
RechnungsPositionDO — outgoing invoice position
EingangsrechnungsPositionDO — incoming invoice position

Design Rationale

Introduced alongside IRechnung (commit 07cb34acb) to enable RechnungCalculator to compute net/gross totals, VAT amounts, and cost summaries without depending on concrete entity types. The deleted property allows the calculator to skip soft-deleted positions. Using BigDecimal for financial amounts ensures precision (no floating-point errors).

Architecture Analysis

Resides in projectforge-business, the core module containing domain logic, services, and persistence. Defines a contract/interface that multiple implementations can satisfy, enabling polymorphic behavior and testability.

Git History