"""Schnellerfassung für Geräte ohne Anmeldung (iOS-Kurzbefehle). Der Kontoauszug kommt erst am Monatsende. Wer im Laden bezahlt hat, weiss in dem Moment noch, wofür – auf dem Auszug steht später oft nur ein nichtssagender Betreibername. Diese Endpunkte nehmen so eine Zahlung entgegen. Die Anmeldung läuft NICHT über die Sitzung, sondern über eine Gerätemarke (``require_quick_token``). Deren Geltungsbereich ist eng: erfassen ja, lesen nein. Die einzige Ausnahme ist die Kontoliste, die der Kurzbefehl für seine Auswahl braucht – sie liefert nur Name, Symbol und Farbe, keine Salden. """ from datetime import date as date_t from decimal import ROUND_HALF_UP, Decimal import json from fastapi import APIRouter, Depends, File, Form, HTTPException, UploadFile, status from sqlalchemy.orm import Session from ..database import get_db from ..deps import require_quick_token from ..models import ( Account, ApiToken, ImportBatch, ImportStatus, ImportTemplate, InboxItem, InboxSource, InboxStatus, Transaction, TxnType, User, ) from ..schemas import InboxItemOut, QuickBookingIn, QuickBookingOut from ..services import csv_import, currency router = APIRouter(prefix="/quick", tags=["quick"]) def _konto(db: Session, marke: ApiToken, gewuenscht: int | None) -> Account: """Zielkonto bestimmen: ausdrücklich genannt, sonst das der Marke.""" konto_id = gewuenscht or marke.default_account_id if konto_id is None: raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail="Kein Konto angegeben und die Marke hat kein Standardkonto", ) konto = db.get(Account, konto_id) if konto is None or konto.owner_id != marke.owner_id: raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Konto nicht gefunden") return konto @router.get("/accounts") def quick_accounts( marke: ApiToken = Depends(require_quick_token), db: Session = Depends(get_db) ) -> list[dict]: """Konten für die Auswahlliste im Kurzbefehl – ohne Salden.""" konten = ( db.query(Account) .filter(Account.owner_id == marke.owner_id, Account.is_archived.is_(False)) .order_by(Account.position, Account.name) .all() ) return [ {"id": a.id, "name": a.name, "currency": a.currency, "icon": a.icon, "color": a.color, "default": a.id == marke.default_account_id} for a in konten ] @router.post("/booking", response_model=QuickBookingOut, status_code=status.HTTP_201_CREATED) def quick_booking( payload: QuickBookingIn, marke: ApiToken = Depends(require_quick_token), db: Session = Depends(get_db), ) -> QuickBookingOut: konto = _konto(db, marke, payload.account_id) user = db.get(User, marke.owner_id) tag = payload.date or date_t.today() betrag = int( (payload.amount.copy_abs() * 100).quantize(Decimal("1"), rounding=ROUND_HALF_UP) ) if betrag == 0: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Betrag ist null") # Ein doppelt ausgelöster Kurzbefehl (schlechtes Netz, Doppeltipp) darf # nicht zweimal buchen. Die bestehende Erfassung wird zurückgemeldet. if payload.external_id: schon = ( db.query(InboxItem) .filter(InboxItem.owner_id == user.id, InboxItem.source == InboxSource.shortcut, InboxItem.external_id == payload.external_id) .first() ) if schon is not None: return QuickBookingOut( message="Bereits erfasst", item=InboxItemOut.model_validate(schon) ) # Durch die normale Erkennung schicken, damit Schlagwort- und Betragsregeln # die Kategorie vorschlagen – dieselbe Strecke wie beim CSV-Import. vorzeichen = -betrag if payload.kind == "expense" else betrag erkannt = csv_import.detect_rows(db, user, konto, [{ "date": tag.isoformat(), "amount_cents": vorzeichen, "payee": payload.payee, "purpose": payload.note, }]) kategorie_id = erkannt[0].get("category_id") if erkannt else None txn = Transaction( owner_id=user.id, type=TxnType.expense if payload.kind == "expense" else TxnType.income, date=tag, account_id=konto.id, amount_cents=betrag, amount_eur_cents=currency.compute_amount_eur_cents(db, betrag, konto.currency, tag), category_id=kategorie_id, payee=(payload.payee or None), description=(payload.note or None), ) db.add(txn) db.flush() eintrag = InboxItem( owner_id=user.id, source=InboxSource.shortcut, status=InboxStatus.booked, account_id=konto.id, date=tag, amount_cents=vorzeichen, currency=konto.currency, payee=(payload.payee or None), note=(payload.note or None), category_id=kategorie_id, transaction_id=txn.id, external_id=(payload.external_id or None), ) db.add(eintrag) db.commit() db.refresh(eintrag) wohin = f" · {payload.payee}" if payload.payee else "" return QuickBookingOut( message=f"{betrag / 100:.2f} {konto.currency} auf {konto.name}{wohin}", item=InboxItemOut.model_validate(eintrag), ) def _letzte_vorlage(db: Session, konto: Account) -> ImportTemplate | None: """Die Einstellung, mit der dieses Konto zuletzt erfolgreich eingelesen wurde. Am Telefon lässt sich keine Spaltenzuordnung vornehmen. Der Kurzbefehl setzt deshalb voraus, dass die Datei am Rechner schon einmal für dieses Konto eingelesen wurde – dann steht im Import-Verlauf, wie es ging. """ stapel = ( db.query(ImportBatch) .filter(ImportBatch.owner_id == konto.owner_id, ImportBatch.account_id == konto.id, ImportBatch.status == ImportStatus.committed) .order_by(ImportBatch.created_at.desc(), ImportBatch.id.desc()) .first() ) if stapel is None: return None if stapel.template_id: vorlage = db.get(ImportTemplate, stapel.template_id) if vorlage is not None and vorlage.owner_id == konto.owner_id: return vorlage if stapel.preset: for p in csv_import.PRESETS: if p["name"] == stapel.preset: felder = {k: v for k, v in p.items() if k not in ("name", "column_map")} return ImportTemplate(owner_id=konto.owner_id, name="_kurzbefehl", column_map=json.dumps(p["column_map"]), **felder) return None @router.post("/statement", status_code=status.HTTP_201_CREATED) async def quick_statement( file: UploadFile = File(...), account_id: int = Form(...), marke: ApiToken = Depends(require_quick_token), db: Session = Depends(get_db), ) -> dict: """Kontoauszug vom Telefon aus einlesen (Teilen-Menü). Gebucht wird sofort – ein Auszug hat schnell hunderte Zeilen, die einzeln abzunicken wäre keine Erleichterung. Sicher ist das, weil die Duplikaterkennung greift und der ganze Stapel im Import-Verlauf mit einem Klick rückgängig zu machen ist. """ konto = _konto(db, marke, account_id) user = db.get(User, marke.owner_id) vorlage = _letzte_vorlage(db, konto) if vorlage is None: raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail=(f"Für „{konto.name}“ gibt es noch keine Einstellung. Bitte einen Auszug " "dieses Kontos einmal am Rechner einlesen – danach geht es vom Telefon."), ) daten = await file.read() try: kandidaten = csv_import.parse_file_to_candidates(daten, vorlage) except Exception as e: raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=f"Datei nicht lesbar: {e}") from e zeilen = csv_import.detect_rows(db, user, konto, kandidaten) zu_buchen = [z for z in zeilen if z.get("include")] stapel = csv_import.commit_import( db, user, konto, vorlage.id if vorlage.id else None, (file.filename or "Vom Telefon")[:255], zu_buchen, preset=None if vorlage.id else vorlage.name, ) dubletten = sum(1 for z in zeilen if z.get("is_duplicate")) return { "gelesen": len(zeilen), "gebucht": stapel.imported_count, "duplikate": dubletten, "konto": konto.name, "message": f"{stapel.imported_count} gebucht auf {konto.name}" f" · {dubletten} schon vorhanden", }