Files
aurum/backend/app/models/category.py
ZProger fe9b079c12 Initial public release
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.
2026-08-16 18:39:52 +03:00

27 lines
1.2 KiB
Python

"""A spending/income category, colored so it maps 1:1 to a dashboard chart slot."""
from sqlalchemy import Boolean, Enum, Integer, String
from sqlalchemy.orm import Mapped, mapped_column, relationship
from app.db.base import Base
from app.models.enums import CategoryKind
class Category(Base):
__tablename__ = "categories"
id: Mapped[int] = mapped_column(primary_key=True)
name: Mapped[str] = mapped_column(String(100), nullable=False)
kind: Mapped[CategoryKind] = mapped_column(
Enum(CategoryKind, name="category_kind", native_enum=False, length=10), nullable=False
)
# Lucide icon name rendered in the frontend (kept as a plain string so new
# icons don't require a migration).
icon: Mapped[str | None] = mapped_column(String(50), nullable=True)
# Hex color drawn from the dataviz skill's validated categorical palette.
color: Mapped[str] = mapped_column(String(7), nullable=False)
# Fixed slot ordering keeps the donut chart's category order stable across renders.
sort_order: Mapped[int] = mapped_column(Integer, nullable=False, default=0)
is_default: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
transactions: Mapped[list["Transaction"]] = relationship(back_populates="category")