moneyfy/backend/app/api/routes/transactions.py

"""Einmalige Buchungen."""

from datetime import date

from fastapi import APIRouter, Query, status
from sqlalchemy import func, or_, select

from app.api.deps import DbSession
from app.core.errors import ValidationError
from app.models import Category, Transaction
from app.models.enums import EntryKind
from app.schemas.common import ErrorResponse, MessageResponse, Page
from app.schemas.transaction import TransactionCreate, TransactionOut, TransactionUpdate
from app.services.crud import apply_updates, get_or_404

router = APIRouter(prefix="/transactions", tags=["transactions"])

NOT_FOUND = {status.HTTP_404_NOT_FOUND: {"model": ErrorResponse}}


async def _check_category(session: DbSession, category_id: int, kind: EntryKind) -> None:
    category = await get_or_404(session, Category, category_id)
    if category.kind is not kind:
        richtung = "Einkünfte" if kind is EntryKind.INCOME else "Ausgaben"
        raise ValidationError(
            f"Die Kategorie '{category.name}' ist nicht für {richtung} vorgesehen.",
            code="category_kind_mismatch",
        )


@router.get(
    "",
    response_model=Page[TransactionOut],
    summary="Buchungen auflisten",
    description="Neueste zuerst. Alle Filter sind kombinierbar.",
)
async def list_transactions(
    session: DbSession,
    date_from: date | None = Query(default=None, alias="from"),
    date_to: date | None = Query(default=None, alias="to"),
    kind: EntryKind | None = Query(default=None),
    category_id: int | None = Query(default=None),
    account_id: int | None = Query(default=None),
    merchant_id: int | None = Query(default=None),
    q: str | None = Query(default=None, description="Suche in Titel und Notiz."),
    limit: int = Query(default=50, ge=1, le=500),
    offset: int = Query(default=0, ge=0),
) -> Page[TransactionOut]:
    if date_from and date_to and date_to < date_from:
        raise ValidationError("'to' darf nicht vor 'from' liegen.", code="invalid_date_range")

    stmt = select(Transaction).order_by(Transaction.booking_date.desc(), Transaction.id.desc())
    if date_from is not None:
        stmt = stmt.where(Transaction.booking_date >= date_from)
    if date_to is not None:
        stmt = stmt.where(Transaction.booking_date <= date_to)
    if kind is not None:
        stmt = stmt.where(Transaction.kind == kind)
    if category_id is not None:
        stmt = stmt.where(Transaction.category_id == category_id)
    if account_id is not None:
        stmt = stmt.where(Transaction.account_id == account_id)
    if merchant_id is not None:
        stmt = stmt.where(Transaction.merchant_id == merchant_id)
    if q:
        pattern = f"%{q.strip()}%"
        stmt = stmt.where(or_(Transaction.title.ilike(pattern), Transaction.note.ilike(pattern)))

    total = (
        await session.execute(select(func.count()).select_from(stmt.order_by(None).subquery()))
    ).scalar_one()
    items = (await session.execute(stmt.limit(limit).offset(offset))).scalars().all()
    return Page[TransactionOut](
        items=[TransactionOut.model_validate(item) for item in items],
        total=total,
        limit=limit,
        offset=offset,
    )


@router.post(
    "",
    response_model=TransactionOut,
    status_code=status.HTTP_201_CREATED,
    summary="Buchung anlegen",
)
async def create_transaction(payload: TransactionCreate, session: DbSession) -> Transaction:
    await _check_category(session, payload.category_id, payload.kind)
    transaction = Transaction(**payload.model_dump())
    session.add(transaction)
    await session.commit()
    await session.refresh(transaction)
    return transaction


@router.get(
    "/{transaction_id}",
    response_model=TransactionOut,
    responses=NOT_FOUND,
    summary="Buchung lesen",
)
async def read_transaction(transaction_id: int, session: DbSession) -> Transaction:
    return await get_or_404(session, Transaction, transaction_id)


@router.patch(
    "/{transaction_id}",
    response_model=TransactionOut,
    responses=NOT_FOUND,
    summary="Buchung ändern",
)
async def update_transaction(
    transaction_id: int, payload: TransactionUpdate, session: DbSession
) -> Transaction:
    transaction = await get_or_404(session, Transaction, transaction_id)
    if payload.category_id is not None or payload.kind is not None:
        await _check_category(
            session,
            payload.category_id or transaction.category_id,
            payload.kind or transaction.kind,
        )
    apply_updates(transaction, payload)
    await session.commit()
    await session.refresh(transaction)
    return transaction


@router.delete(
    "/{transaction_id}",
    response_model=MessageResponse,
    responses=NOT_FOUND,
    summary="Buchung löschen",
)
async def delete_transaction(transaction_id: int, session: DbSession) -> MessageResponse:
    transaction = await get_or_404(session, Transaction, transaction_id)
    await session.delete(transaction)
    await session.commit()
    return MessageResponse(detail="Buchung gelöscht.")