mirror of
https://github.com/Zproger/Aurum.git
synced 2026-10-12 18:46:40 +07:00
fe9b079c12
Aurum — a self-hosted personal finance operating system: cash flow, net worth tracking, budgets, goals, recurring payments, reports, proactive alerts, and a compound-interest returns calculator, all bilingual (RU/EN) and mobile-first. Ships as a three-container Docker Compose stack (Postgres + FastAPI + nginx-served React frontend). See README.md for setup and CONTRIBUTING.md for development.
39 lines
1.6 KiB
Python
39 lines
1.6 KiB
Python
"""A savings goal, tracked by a manual contribution log (GoalContribution) —
|
|
same "you record it, we sum it" shape as Asset/AssetValuation, except
|
|
contributions are deltas added together, not point-in-time snapshots."""
|
|
from datetime import date as date_
|
|
|
|
from sqlalchemy import Date, ForeignKey, Numeric, String
|
|
from sqlalchemy.orm import Mapped, mapped_column, relationship
|
|
|
|
from app.db.base import Base
|
|
from app.models.mixins import TimestampMixin
|
|
|
|
|
|
class Goal(Base, TimestampMixin):
|
|
__tablename__ = "goals"
|
|
|
|
id: Mapped[int] = mapped_column(primary_key=True)
|
|
name: Mapped[str] = mapped_column(String(150), nullable=False)
|
|
target_amount: Mapped[Numeric] = mapped_column(Numeric(14, 2), nullable=False)
|
|
target_date: Mapped[date_ | None] = mapped_column(Date, nullable=True)
|
|
|
|
contributions: Mapped[list["GoalContribution"]] = relationship(
|
|
back_populates="goal", cascade="all, delete-orphan", order_by="GoalContribution.date"
|
|
)
|
|
|
|
|
|
class GoalContribution(Base):
|
|
"""One deposit (or, with a negative amount, a withdrawal) toward a goal.
|
|
A goal's current amount is the sum of all its contributions."""
|
|
|
|
__tablename__ = "goal_contributions"
|
|
|
|
id: Mapped[int] = mapped_column(primary_key=True)
|
|
goal_id: Mapped[int] = mapped_column(ForeignKey("goals.id", ondelete="CASCADE"), nullable=False)
|
|
amount: Mapped[Numeric] = mapped_column(Numeric(14, 2), nullable=False)
|
|
date: Mapped[date_] = mapped_column(Date, nullable=False)
|
|
note: Mapped[str | None] = mapped_column(String(200), nullable=True)
|
|
|
|
goal: Mapped["Goal"] = relationship(back_populates="contributions")
|