certain/backend/app/routers/backup.py

"""Backup & Export: kompletter DB-Download (Admin), Datenexport je Nutzer und
das wiederherstellbare Voll-Backup als JSON (siehe ``services/backup_data``)."""

import csv
import io
import os
import re
import sqlite3
import tempfile
from datetime import datetime, timezone
from pathlib import Path

from fastapi import APIRouter, Depends, File, Form, HTTPException, Response, UploadFile
from fastapi.responses import FileResponse
from sqlalchemy.orm import Session
from starlette.background import BackgroundTask

from ..config import get_settings
from ..database import get_db
from ..deps import get_current_user, require_admin
from ..models import (
    Account,
    AccountIdentifier,
    BudgetTemplateLine,
    Category,
    CategoryGroup,
    DashboardLayout,
    PlannedIncomeLine,
    Role,
    Transaction,
    User,
)
from ..services import backup_data, sessions

router = APIRouter(tags=["backup"])

# Ein Backup ist reiner Text; alles darüber ist mit Sicherheit keins mehr.
MAX_BACKUP_BYTES = 64 * 1024 * 1024


def _ts() -> str:
    """Ortszeit als ``YYYY-MM-DD_HHMM`` – Dateinamen sollen lesbar sein.

    Bewusst nicht UTC: wer abends um 20 Uhr exportiert, soll im Downloads-Ordner
    keine Datei von 18 Uhr finden."""
    return datetime.now().astimezone().strftime("%Y-%m-%d_%H%M")


def _dateiname(art: str, endung: str) -> str:
    """Einheitlicher, sprechender Dateiname für alle Downloads.

    ``art`` muss erkennen lassen, worum es geht – im Downloads-Ordner liegen die
    Dateien sonst nebeneinander und man sieht ihnen nicht an, welche sich
    zurückladen lässt (``vollbackup``) und welche nur zum Ansehen taugt
    (``datenuebersicht``)."""
    return f"certain-finance_{art}_{_ts()}.{endung}"


def _namensteil(text: str) -> str:
    """Beliebigen Text auf etwas eindampfen, das in einem Dateinamen taugt."""
    sauber = re.sub(r"[^A-Za-z0-9]+", "-", text).strip("-").lower()
    return sauber[:32] or "unbekannt"


def _sqlite_path() -> str | None:
    url = get_settings().effective_database_url
    return url.replace("sqlite:///", "", 1) if url.startswith("sqlite:///") else None


def _snapshot_before_restore() -> str | None:
    """Legt vor einem ersetzenden Restore eine Kopie der Datenbank ab.

    Dieselbe Absicherung, die ``deploy/update.sh`` vor einem Update macht: wer
    versehentlich das falsche Backup einspielt, hat noch einen Weg zurück."""
    db_path = _sqlite_path()
    if db_path is None or not os.path.exists(db_path):
        return None
    ziel_ordner = Path(get_settings().data_dir) / "backups"
    ziel_ordner.mkdir(parents=True, exist_ok=True)
    ziel = ziel_ordner / f"pre-restore-{_ts()}.db"
    src = sqlite3.connect(db_path)
    dst = sqlite3.connect(str(ziel))
    try:
        with dst:
            src.backup(dst)
    finally:
        dst.close()
        src.close()
    return str(ziel)


def _money(cents: int | None) -> str:
    return f"{(cents or 0) / 100:.2f}"


# --- Komplettes DB-Backup (nur Admin) --------------------------------------


@router.get("/backup/db")
def backup_db(_: User = Depends(require_admin)):
    db_path = _sqlite_path()
    if db_path is None:
        raise HTTPException(status_code=400, detail="DB-Backup ist nur für SQLite verfügbar.")
    tmp = tempfile.NamedTemporaryFile(prefix="cf-backup-", suffix=".db", delete=False)
    tmp.close()
    # Online-Backup-API: konsistente Kopie auch bei laufendem Betrieb.
    src = sqlite3.connect(db_path)
    dst = sqlite3.connect(tmp.name)
    try:
        with dst:
            src.backup(dst)
    finally:
        dst.close()
        src.close()
    return FileResponse(
        tmp.name,
        media_type="application/octet-stream",
        filename=_dateiname("datenbank", "db"),
        background=BackgroundTask(os.remove, tmp.name),
    )


# --- Transaktionsexport ----------------------------------------------------


def _maps(db: Session, user: User) -> tuple[dict[int, Account], dict[int, Category]]:
    accs = {a.id: a for a in db.query(Account).filter(Account.owner_id == user.id)}
    cats = {c.id: c for c in db.query(Category).filter(Category.owner_id == user.id)}
    return accs, cats


def _txns(db: Session, user: User) -> list[Transaction]:
    return (
        db.query(Transaction)
        .filter(Transaction.owner_id == user.id)
        .order_by(Transaction.date, Transaction.id)
        .all()
    )


@router.get("/export/transactions.csv")
def export_transactions_csv(db: Session = Depends(get_db), user: User = Depends(get_current_user)):
    accs, cats = _maps(db, user)
    buf = io.StringIO()
    w = csv.writer(buf, delimiter=";")
    w.writerow(["Datum", "Typ", "Konto", "Betrag", "Waehrung", "EUR-Wert",
                "Zielkonto", "Kategorie", "Empfaenger", "Verwendungszweck", "Notiz"])
    for t in _txns(db, user):
        acc = accs.get(t.account_id)
        w.writerow([
            t.date.isoformat(), t.type.value, acc.name if acc else "",
            _money(t.amount_cents), acc.currency if acc else "", _money(t.amount_eur_cents),
            accs[t.to_account_id].name if t.to_account_id and t.to_account_id in accs else "",
            cats[t.category_id].name if t.category_id and t.category_id in cats else "",
            t.payee or "", t.description or "", t.notes or "",
        ])
    return Response(
        content=buf.getvalue().encode("utf-8-sig"),
        media_type="text/csv",
        headers={"Content-Disposition": f'attachment; filename="{_dateiname("buchungen", "csv")}"'},
    )


def _txn_dict(t: Transaction, accs: dict[int, Account], cats: dict[int, Category]) -> dict:
    acc = accs.get(t.account_id)
    return {
        "date": t.date.isoformat(),
        "type": t.type.value,
        "account": acc.name if acc else None,
        "currency": acc.currency if acc else None,
        "amount_cents": t.amount_cents,
        "amount_eur_cents": t.amount_eur_cents,
        "to_account": accs[t.to_account_id].name if t.to_account_id in accs else None,
        "to_amount_cents": t.to_amount_cents,
        "category": cats[t.category_id].name if t.category_id in cats else None,
        "payee": t.payee,
        "description": t.description,
        "notes": t.notes,
    }


@router.get("/export/transactions.json")
def export_transactions_json(db: Session = Depends(get_db), user: User = Depends(get_current_user)):
    accs, cats = _maps(db, user)
    data = [_txn_dict(t, accs, cats) for t in _txns(db, user)]
    return Response(
        content=_json_bytes(data),
        media_type="application/json",
        headers={"Content-Disposition": f'attachment; filename="{_dateiname("buchungen", "json")}"'},
    )


# --- Gesamt-Export (alle eigenen Daten als JSON) ---------------------------


def _json_bytes(obj) -> bytes:
    import json

    return json.dumps(obj, ensure_ascii=False, indent=2).encode("utf-8")


@router.get("/export/all.json")
def export_all_json(db: Session = Depends(get_db), user: User = Depends(get_current_user)):
    accs, cats = _maps(db, user)
    idents: dict[int, list] = {}
    for i in db.query(AccountIdentifier).join(Account).filter(Account.owner_id == user.id):
        idents.setdefault(i.account_id, []).append({"kind": i.kind.value, "value": i.value})

    accounts = [{
        "name": a.name, "type": a.type.value, "currency": a.currency,
        "opening_balance_cents": a.opening_balance_cents,
        "opening_date": a.opening_date.isoformat() if a.opening_date else None,
        "icon": a.icon, "color": a.color, "archived": a.is_archived,
        "identifiers": idents.get(a.id, []),
    } for a in accs.values()]

    groups = []
    for g in db.query(CategoryGroup).filter(CategoryGroup.owner_id == user.id).order_by(CategoryGroup.position):
        groups.append({
            "name": g.name, "kind": g.kind.value, "icon": g.icon, "color": g.color,
            "categories": [
                {"name": c.name, "icon": c.icon, "color": c.color}
                for c in sorted(g.categories, key=lambda x: x.position)
            ],
        })

    budget_template = [
        {"category": cats[l.category_id].name if l.category_id in cats else None, "planned_cents": l.planned_cents}
        for l in db.query(BudgetTemplateLine).filter(BudgetTemplateLine.owner_id == user.id)
    ]
    planned_income = [
        {"label": l.label, "planned_cents": l.planned_cents,
         "category": cats[l.category_id].name if l.category_id in cats else None,
         "target_account": accs[l.target_account_id].name if l.target_account_id in accs else None}
        for l in db.query(PlannedIncomeLine).filter(PlannedIncomeLine.owner_id == user.id)
    ]
    dash = db.query(DashboardLayout).filter(DashboardLayout.owner_id == user.id).first()

    data = {
        "exported_at": datetime.now(timezone.utc).isoformat(),
        "app": "Certain Finance",
        "user": user.username,
        "accounts": accounts,
        "category_groups": groups,
        "transactions": [_txn_dict(t, accs, cats) for t in _txns(db, user)],
        "budget_template": budget_template,
        "planned_income": planned_income,
        "dashboard_layout": dash.layout if dash else None,
    }
    return Response(
        content=_json_bytes(data),
        media_type="application/json",
        # „datenuebersicht", nicht „backup": diese Datei lässt sich bewusst
        # nicht zurückladen (siehe services/backup_data.parse).
        headers={
            "Content-Disposition": f'attachment; filename="{_dateiname("datenuebersicht", "json")}"'
        },
    )


# --- Voll-Backup (wiederherstellbar) ---------------------------------------


def _download(obj: dict, dateiname: str) -> Response:
    return Response(
        content=backup_data.to_bytes(obj),
        media_type="application/json",
        headers={"Content-Disposition": f'attachment; filename="{dateiname}"'},
    )


@router.get("/export/backup.json")
def export_backup(db: Session = Depends(get_db), user: User = Depends(get_current_user)):
    """Alle eigenen Daten – vollständig und wieder einspielbar.

    Der Benutzername steht im Dateinamen: bei mehreren Konten liegen sonst
    gleichnamige Backups im selben Ordner."""
    return _download(
        backup_data.export_user(db, user),
        _dateiname(f"vollbackup_{_namensteil(user.username)}", "json"),
    )


@router.get("/export/system-backup.json")
def export_system_backup(db: Session = Depends(get_db), _: User = Depends(require_admin)):
    """Die ganze Instanz inklusive Benutzerkonten. Enthält Passwort-Hashes und
    TOTP-Secrets – die Datei ist wie ein Passwort zu behandeln."""
    return _download(backup_data.export_system(db), _dateiname("vollbackup-system", "json"))


async def _read_upload(file: UploadFile) -> bytes:
    roh = await file.read()
    if len(roh) > MAX_BACKUP_BYTES:
        raise HTTPException(status_code=400, detail="Die Datei ist zu gross für ein Backup.")
    return roh


@router.post("/backup/restore/preview")
async def restore_preview(
    file: UploadFile = File(...),
    db: Session = Depends(get_db),
    user: User = Depends(get_current_user),
):
    """Prüft die Datei und meldet, was darin steckt. Schreibt nichts."""
    try:
        data = backup_data.parse(await _read_upload(file))
    except backup_data.BackupError as exc:
        raise HTTPException(status_code=400, detail=str(exc)) from exc

    scope = data["scope"]
    if scope == "system" and user.role != Role.admin:
        raise HTTPException(
            status_code=403,
            detail="Ein systemweites Backup darf nur ein Administrator einspielen.",
        )
    hinweise: list[str] = []
    if scope == "system":
        hinweise.append(
            "Systemweite Wiederherstellung: alle Benutzer und deren Daten werden "
            "ersetzt. Danach sind alle Sitzungen beendet und du musst dich neu anmelden."
        )
        if not any(u.get("role") == "admin" for u in data.get("users") or []):
            hinweise.append("Achtung: im Backup ist kein Administrator enthalten.")
    return {
        "scope": scope,
        "exported_at": data.get("exported_at"),
        "app_version": data.get("app_version"),
        "username": data.get("username"),
        "user_count": len(data.get("users") or []) if scope == "system" else 1,
        "tables": backup_data.summarize(data),
        "notes": hinweise,
    }


@router.post("/backup/restore")
async def restore(
    file: UploadFile = File(...),
    mode: str = Form("replace"),
    db: Session = Depends(get_db),
    user: User = Depends(get_current_user),
):
    """Spielt ein Backup ein – ``replace`` (ersetzen) oder ``merge`` (ergänzen).

    Alles läuft in einer Transaktion: entweder es geht komplett durch oder es
    wird gar nichts geschrieben."""
    if mode not in ("replace", "merge"):
        raise HTTPException(status_code=400, detail="Unbekannter Modus.")
    try:
        data = backup_data.parse(await _read_upload(file))
    except backup_data.BackupError as exc:
        raise HTTPException(status_code=400, detail=str(exc)) from exc

    scope = data["scope"]
    if scope == "system" and user.role != Role.admin:
        raise HTTPException(
            status_code=403,
            detail="Ein systemweites Backup darf nur ein Administrator einspielen.",
        )
    if scope == "system" and mode != "replace":
        raise HTTPException(
            status_code=400,
            detail="Ein systemweites Backup kann nur ersetzend eingespielt werden.",
        )

    schnappschuss = _snapshot_before_restore() if mode == "replace" else None
    try:
        if scope == "system":
            bilanz = backup_data.restore_system(db, data)
        else:
            bilanz = backup_data.restore_user_data(
                db, user, data.get("data") or {}, merge=(mode == "merge")
            )
        db.commit()
    except backup_data.BackupError as exc:
        db.rollback()
        raise HTTPException(status_code=400, detail=str(exc)) from exc
    except Exception as exc:  # pragma: no cover - Schutznetz gegen halbe Zustände
        db.rollback()
        raise HTTPException(
            status_code=400, detail=f"Wiederherstellung fehlgeschlagen: {exc}"
        ) from exc

    if scope == "system":
        # Die eigene Sitzung wurde mitgelöscht; alle übrigen ebenfalls beenden.
        sessions.revoke_all_everywhere(db)
    return {
        "scope": scope,
        "mode": mode,
        "restored": bilanz,
        "snapshot": os.path.basename(schnappschuss) if schnappschuss else None,
        "logout_required": scope == "system",
    }