feat: Der Soll-Betrag kann sich aus den Vertraegen rechnen

Die Vertraege standen bisher nur auf ihrer eigenen Seite. Im Budget sah man
nichts davon – man musste selbst nachrechnen, was fest gebunden ist, und beim
naechsten Preisaufschlag noch einmal.

Jetzt hat jede Kategorie zwei Betriebsarten, umschaltbar ueber ein Sigma neben
dem Eingabefeld:

  fest        eine Zahl, die man hinschreibt. Wie bisher.
  berechnet   Summe der Vertraege dieser Kategorie plus einem Zuschlag.

Der Zuschlag ist der Punkt. Wer fuer Streaming 62 plant, weil 42 gebunden sind
und 20 Luft sein sollen, muss beim naechsten Preisaufschlag nicht nachrechnen
– und verliert seine 20 dabei auch nicht. Unter der Zeile steht die Rechnung
offen, sonst stuende im Feld eine Zahl, die nicht der Soll-Betrag ist.

Das gilt fuer JEDE Kategorie, nicht nur fuer eine Abo-Kategorie: Ein
Handyvertrag liegt in "Telefon & Internet", und die rechnet sich genauso.

Auch auf "fest" steht der Hinweis da ("davon 16.84 fest gebunden") – sonst
sieht man nie, was einen schon bindet.

Zwei Dinge, die sonst still danebengingen, melden sich jetzt oben auf der
Seite: Vertraege OHNE Kategorie (ihr Geld fehlt im Budget, ohne dass irgendwo
steht, dass es fehlt) und Waehrungen ohne Kurs.

Gerechnet wird in effective_planned – der einen Stelle, aus der Budget-Seite
UND Dashboard ihr Soll beziehen. Damit koennen die beiden gar nicht erst
auseinanderlaufen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Scarriffle
2026-09-07 20:49:21 +02:00
co-authored by Claude Opus 5
parent 26718b1301
commit ab5d18e0d0
11 changed files with 613 additions and 31 deletions
+53 -10
View File
@@ -15,7 +15,7 @@ from ..models import (
User,
)
from ..schemas import PlannedIncomeCreate, PlannedIncomeOut, PlannedIncomeUpdate
from ..services import budget
from ..services import abos, budget
from .accounts import base_currency
from .settings import BUDGET_START_DAY_KEY, get_user_setting
@@ -51,31 +51,51 @@ def get_template(db: Session = Depends(get_db), user: User = Depends(get_current
}
MODI = ("fest", "berechnet")
def _pruefe_modus(modus: str | None) -> None:
if modus is not None and modus not in MODI:
raise HTTPException(
status_code=status.HTTP_400_BAD_REQUEST,
detail=f"Unbekannte Betriebsart '{modus}'. Moeglich: {', '.join(MODI)}.",
)
@router.put("/template/category/{category_id}")
def set_template_category(
category_id: int,
planned_cents: int,
planned_cents: int | None = None,
modus: str | None = None,
zuschlag_cents: int | None = None,
db: Session = Depends(get_db),
user: User = Depends(get_current_user),
) -> dict:
_require_expense_category(db, user, category_id)
_pruefe_modus(modus)
line = (
db.query(BudgetTemplateLine)
.filter(BudgetTemplateLine.owner_id == user.id, BudgetTemplateLine.category_id == category_id)
.first()
)
if planned_cents <= 0:
ziel_modus = modus or (line.modus if line is not None else "fest")
# Eine Zeile ohne Inhalt wird geloescht – sie ist dasselbe wie "kein
# Budget". Bei "berechnet" gilt das NICHT: Dort ist die Zeile selbst die
# Aussage ("rechne aus den Vertraegen"), auch wenn der Zuschlag null ist.
leer = ziel_modus == "fest" and (planned_cents is not None and planned_cents <= 0)
if leer:
if line is not None:
db.delete(line)
db.commit()
return {"category_id": category_id, "planned_cents": 0}
return {"category_id": category_id, "planned_cents": 0, "modus": "fest",
"zuschlag_cents": 0}
if line is None:
line = BudgetTemplateLine(owner_id=user.id, category_id=category_id, planned_cents=planned_cents)
line = BudgetTemplateLine(owner_id=user.id, category_id=category_id, planned_cents=0)
db.add(line)
else:
line.planned_cents = planned_cents
budget.uebernimm(line, planned_cents, modus, zuschlag_cents)
db.commit()
return {"category_id": category_id, "planned_cents": planned_cents}
return {"category_id": category_id, "planned_cents": line.planned_cents,
"modus": line.modus, "zuschlag_cents": line.zuschlag_cents}
# --- Geplante Einnahmen ----------------------------------------------------
@@ -148,6 +168,10 @@ def _build_view(db: Session, user: User, label: str) -> dict:
planned = budget.effective_planned(db, user, label)
actual = budget.actual_expense_by_category(db, user, label, start, end, base)
income_actual = budget.income_by_category(db, user, label, start, end, base)
# Was aus Vertraegen kommt – auch fuer Kategorien auf "fest". Dort ist es
# kein Rechenwert, sondern ein Hinweis: "hier sind 43.89 gebunden".
vertraege = abos.uebersicht(db, user, base)
zeilen = {ln.category_id: ln for ln in budget._zeilen(db, user, label)}
groups_out = []
total_planned = total_actual = 0
@@ -167,9 +191,16 @@ def _build_view(db: Session, user: User, label: str) -> dict:
a = actual.get(c.id, 0)
g_planned += p
g_actual += a
zeile = zeilen.get(c.id)
cats.append({
"category_id": c.id, "name": c.name, "icon": c.icon, "color": c.color,
"planned_cents": p, "actual_cents": a, "delta_cents": p - a, "over": a > p,
# Woraus sich der Soll-Betrag ergibt. "aus_vertraegen_cents"
# steht auch bei "fest" – dann als Hinweis, nicht als Summand.
"modus": zeile.modus if zeile is not None else "fest",
"zuschlag_cents": zeile.zuschlag_cents if zeile is not None else 0,
"aus_vertraegen_cents": vertraege["je_kategorie"].get(c.id, 0),
"vertraege_anzahl": vertraege["anzahl"].get(c.id, 0),
# "over" bleibt die nackte Tatsache; ob sie eine Warnung IST,
# entscheidet die Kategorie. Wer mehr zuruecklegt als geplant,
# hat nichts ueberzogen.
@@ -190,6 +221,7 @@ def _build_view(db: Session, user: User, label: str) -> dict:
"planned_cents": g_planned, "actual_cents": g_actual,
"over": echt_ist > echt_geplant,
"good": bool(cats) and all(c["good"] for c in cats),
"aus_vertraegen_cents": sum(c["aus_vertraegen_cents"] for c in cats),
"categories": cats,
})
@@ -221,6 +253,13 @@ def _build_view(db: Session, user: User, label: str) -> dict:
"next": budget.shift_label(label, 1),
"groups": groups_out,
"income": income_out,
# Was sich NICHT zuordnen liess. Ohne diese zwei Angaben fehlt das Geld
# im Budget, ohne dass irgendwo steht, dass es fehlt.
"vertraege": {
"ohne_kategorie_cents": vertraege["ohne_kategorie_cents"],
"ohne_kategorie_anzahl": vertraege["ohne_kategorie_anzahl"],
"ohne_kurs": vertraege["ohne_kurs"],
},
"totals": {
"planned_expense": total_planned,
"actual_expense": total_actual,
@@ -248,13 +287,17 @@ def view(label: str, db: Session = Depends(get_db), user: User = Depends(get_cur
def set_month_category(
label: str,
category_id: int,
planned_cents: int,
planned_cents: int | None = None,
modus: str | None = None,
zuschlag_cents: int | None = None,
db: Session = Depends(get_db),
user: User = Depends(get_current_user),
) -> dict:
budget.parse_label(label)
_require_expense_category(db, user, category_id)
budget.set_month_category(db, user, label, category_id, max(0, planned_cents))
_pruefe_modus(modus)
budget.set_month_category(db, user, label, category_id, planned_cents, modus,
zuschlag_cents)
return _build_view(db, user, label)