whekin/household-bot
1
0
Fork 0
mirror of https://github.com/whekin/household-bot.git synced 2026-03-31 17:24:02 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(finance): add settlement currency and cycle fx rates

Browse Source
This commit is contained in:
whekin
2026-03-10 16:46:59 +04:00
parent 4c0508f618
commit fb85219409
38 changed files with 3546 additions and 114 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
docs/specs/HOUSEBOT-079-settlement-currency-and-nbg-fx.md Normal file
View File

@@ -0,0 +1,23 @@
# HOUSEBOT-079 Settlement Currency And NBG FX
## Goal
Make household balances settle in a configurable household currency while preserving original entry currencies.
## Scope
- add a household `settlementCurrency` setting, defaulting to `GEL`
- open new billing cycles in the settlement currency by default
- keep rent rules in their original source currency
- convert rent, utility bills, and purchase entries into the billing cycle currency for settlement
- lock cycle exchange rates in the database once the configured reminder day has passed
- use NBG as the FX source for GEL conversions
- show both original and converted amounts in the mini app when they differ
- default utility entry currency and bare purchase parsing currency to the household settlement currency
## Notes
- this slice does not add payment confirmation tracking yet
- current FX behavior uses the configured reminder day as the target lock date
- before the reminder day passes, the app may preview the latest available NBG rate without persisting it
- after the reminder day passes, the rate is persisted per cycle and currency pair for deterministic future statements