Files
aurum/backend/app/models/settings.py
ZProger 09a0e383e0 feat: idle cash alert and category hierarchy (subcategories)
Two of the four ideas picked from the Maybe/Sure feature audit:

- Idle cash: a 5th proactive alert flags a depository account (checking/
  savings/cash) sitting at or above a configurable balance with no
  transaction touching it for a configurable number of days.
- Category hierarchy: categories can now have one level of subcategories
  (Groceries -> Alcohol). Dashboard/report aggregations roll a
  subcategory's spending into its parent's slice.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-25 02:27:46 +03:00

32 lines
1.8 KiB
Python

"""App-wide configuration that isn't tied to any single account/asset — a
single-row table (id is always 1). Primary display currency (see UPDATES.md
for why this doesn't do currency conversion) and the proactive-alert
thresholds consumed by services/insights_service.py."""
from decimal import Decimal
from sqlalchemy import Integer, Numeric, String
from sqlalchemy.orm import Mapped, mapped_column
from app.db.base import Base
class AppSettings(Base):
__tablename__ = "app_settings"
id: Mapped[int] = mapped_column(primary_key=True)
currency: Mapped[str] = mapped_column(String(3), nullable=False, default="USD")
# Consecutive complete months of negative cash flow / declining net worth
# before insights_service.py raises the corresponding alert.
negative_cash_flow_threshold_months: Mapped[int] = mapped_column(Integer, nullable=False, default=2)
net_worth_decline_threshold_months: Mapped[int] = mapped_column(Integer, nullable=False, default=2)
# Max % of total capital (cash + assets) allowed in medium/high risk
# tiers before insights_service.py raises risky_allocation_exceeded —
# the classic "80% at zero risk, 20% at most exposed" rule.
risky_allocation_threshold_percent: Mapped[int] = mapped_column(Integer, nullable=False, default=20)
# A depository account (checking/savings/cash) sitting at or above this
# balance with no transaction touching it in idle_cash_threshold_days
# raises insights_service.py's idle_cash alert — money that isn't
# working. In the app's display currency (see `currency` above).
idle_cash_threshold_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("1000"))
idle_cash_threshold_days: Mapped[int] = mapped_column(Integer, nullable=False, default=60)