Labor & Steuer-Modul

Handbuch zum Labor-Bereich und zum Steuer-Modul von Smosby Finance.
Vorweg, das muss klar sein: Was wir hier bauen, ist eine Vorbereitungshilfe, keine Steuerberatung. Die App zeigt, was in deinen Daten steckt, und gibt Hinweise mit Paragraphenangabe. Sie rechnet keine Steuer aus, übermittelt nichts an ELSTER und haftet für nichts. Jeder Hinweis bekommt sichtbar den Zusatz „Stand 2025, ohne Gewähr — im Zweifel Steuerberater oder ELSTER-Hilfe". Alles andere wäre unseriös und für dich riskant.

1Die Spielwiese

Du willst einen Bereich, den nur du siehst — und der später weitere Experimente aufnimmt. Wichtig ist, dass „nur ich" nicht bloß heißt „im Menü versteckt". Wer die Adresse kennt, käme sonst trotzdem an die Daten.

Zwei Schlösser statt einem

Generisch, nicht für dieses eine Feature

Statt einer Ja/Nein-Spalte „darf Steuer" bauen wir eine Merkmalsverwaltung. Jedes künftige Experiment ist dann ein Eintrag, kein neues Schema:

-- supabase/12_feature_flags.sql
create table feature_flags (
  key         text primary key,   -- 'tax', 'income', 'trash', …
  label       text not null,      -- 'Steuererklärung'
  description text,
  stage       text default 'lab'   -- lab | beta | live
);
create table user_features (
  user_id      uuid references auth.users on delete cascade,
  feature_key  text references feature_flags(key) on delete cascade,
  enabled      boolean default true,
  granted_by   uuid, granted_at timestamptz default now(),
  primary key (user_id, feature_key)
);

-- Prüffunktion, die jede Labor-Policy mitbenutzt
create function has_feature(k text) returns boolean
  language sql stable security definer as $$
    select exists(select 1 from user_features
                  where user_id = auth.uid() and feature_key = k and enabled)
  $$;

Vergeben darfst nur du — dieselbe is_app_admin()-Prüfung, die schon die Rechteverwaltung schützt. In den Einstellungen kommt unter „Rechteverwaltung" eine Zeile je Merkmal und Konto dazu.

Sichtbar gekennzeichnet: Der Labor-Bereich trägt überall ein bernsteinfarbenes LABOR-Abzeichen und den Hinweis „in Erprobung". So verwechselst du in einem halben Jahr nicht Erprobtes mit Fertigem — und wenn du das Modul jemand anderem freischaltest, weiß der es auch.

2Aufbau des Steuer-Moduls

Fünf Ansichten unter einem Reiter, oben die Jahresauswahl. Alles filtert nach Steuerjahr — das ist die wichtigste Achse, denn Verträge laufen jahresübergreifend, die Erklärung ist aber immer ein Jahr.

AnsichtWas drin steht
ÜbersichtKacheln je Topf mit Betrag, Fortschritt der Checkliste, grobe Ersparnisschätzung, Frist bis wann das Jahr noch abgegeben werden kann
VorschlägeDas Herzstück. Was das Regelwerk in deinen Verträgen und Belegen gefunden hat, je Treffer mit Begründung, Betrag und Aktion (Übernehmen / Ablehnen / Später)
TöpfeDie Steuer-Kategorien mit allem Zugeordneten, Höchstbetrag, Balken „wie weit ausgeschöpft", Kurzhinweis mit Paragraph
BelegmappeAlle Dokumente des Jahres, nach Topf gruppiert; benennt ausdrücklich, welcher Nachweis fehlt
AbgabeSteuermappe als PDF, Belege als ZIP, CSV für den Steuerberater, Häkchenliste „eingereicht"

So sähe die Übersicht aus

Steuer LABOR Vorbereitungshilfe · Stand 2025 · ohne Gewähr Steuerjahr 2025 ▾
Erfasst absetzbar4.812 €
Davon wirksam3.106 €
Grobe Ersparnis≈ 1.090 €
Offene Vorschläge7
Töpfe
Handwerkerleistungen § 35a Abs. 3 1.840 € von 6.000 €
3 Einträge · 368 € Ermäßigung — zieht direkt von der Steuer ab, nicht vom Einkommen
Haushaltsnahe Dienstleistungen § 35a Abs. 2 640 € von 20.000 €
⚠ Deine Nebenkostenabrechnung fehlt — dort steckt fast immer etwas drin
Werbungskosten Anlage N 1.412 € von 1.230 €
✓ Pauschbetrag überschritten — ab hier zählt jeder weitere Euro
Sonstige Vorsorge Höchstbetrag ausgeschöpft 2.930 € von 1.900 €
Deine Krankenversicherung füllt den Topf allein. Haftpflicht & Co. eintragen schadet nicht, bringt aber nichts mehr.

Und so die Vorschläge

✓
Wartung Heizung (Viessmann) → Handwerkerleistungen
Wartungsverträge zählen zu den Handwerkerleistungen. Absetzbar ist aber nur der Lohnanteil — Material zählt nicht. Steht auf der Rechnung meist getrennt ausgewiesen.
Jahresbetrag 180 € · Nachweis: Rechnung mit Lohnanteil + Kontoauszug (Barzahlung wird nicht anerkannt) · § 35a Abs. 3 EStG
ÜbernehmenLohnanteil eintragenPasst nicht
?
Internet Vodafone → beruflicher Anteil?
Wenn du beruflich von zu Hause arbeitest, kannst du ohne Einzelnachweis 20 % der Kosten, höchstens 20 € im Monat als Werbungskosten ansetzen.
Jahresbetrag 480 € → 96 € ansetzbar · Arbeitest du im Homeoffice?
Ja, 96 € übernehmenAnderen AnteilNein
–
Netflix, Spotify, Fitnessstudio → nicht absetzbar
Private Lebensführung. Auch wenn oft anders behauptet: ein Fitnessstudio ist nur bei ärztlicher Verordnung und Reha-Charakter ansetzbar.
Verstanden, nicht mehr zeigen

Der dritte Kasten ist mir wichtig: Ein System, das nur „hier ist Geld!" ruft, erzeugt falsche Hoffnungen. Zu sagen was nicht geht und warum, macht die verbleibenden Treffer glaubwürdig.

3Datenmodell

Drei Tabellen, keine Änderung an Verträgen oder Belegen. Die bleiben unangetastet — das Steuermodul legt sich nur darüber.

-- Ein Datensatz je Nutzer und Steuerjahr: Profil-Antworten + Status
tax_years   (user_id, year, profile jsonb, status, updated_at)
            profile: {beschaeftigung, wohnform, kinder, pendeln_km,
                      homeoffice_tage, grenzsteuersatz, kirchensteuer, …}

-- Ein Datensatz je Posten. Quelle ist ein Vertrag, ein Beleg oder Handeingabe.
tax_items   (id, user_id, year, bucket, source_type, source_id,
             amount, amount_basis, note, status, origin, rule_id)
            bucket:       'handwerker' | 'haushaltsnah' | 'werbungskosten' | …
             source_type:  'contract' | 'document' | 'manual'
             amount_basis: 'full' | 'share' | 'labor_only' | 'flat' | 'manual'
             status:       'suggested' | 'accepted' | 'rejected' | 'submitted'
             origin:       'rule' | 'user'

-- Was der Nutzer dauerhaft nicht mehr sehen will
tax_dismissals (user_id, rule_id, source_id)
Die Regeln kommen nicht in die Datenbank. Sie gehören in eine steuer-regeln.json neben die App — genau wie vorlagen.json bei den Vertrags-Vorlagen. Ändert sich ein Höchstbetrag oder kommt ein Tipp dazu, bearbeitest du eine Textdatei und kopierst sie auf den Server. Kein SQL, keine Migration, kein Neustart. Das hat bei den Vorlagen gut funktioniert und ist hier noch wichtiger, weil Steuerrecht sich jedes Jahr bewegt.

Wie eine Regel aussieht

{
  "id": "handwerker-wartung",
  "topf": "handwerker",
  "treffer": {
    "name": "wartung|schornsteinfeger|heizung|kaminkehrer|abfluss|dachrinne",
    "kategorie": ["Wohnen"],
    "nicht": "versicherung"
  },
  "betrag": "labor_only",          // nur Lohnanteil, Nutzer trägt ein
  "sicherheit": "pruefen",
  "titel": "Zählt als Handwerkerleistung",
  "text": "Absetzbar ist nur der Lohnanteil, kein Material.",
  "nachweis": "Rechnung mit Lohnanteil + Kontoauszug (keine Barzahlung)",
  "paragraf": "§ 35a Abs. 3 EStG",
  "elster": "Hauptvordruck, Zeile 75",
  "nur_wenn": { "wohnform": ["miete", "eigentum"] }
}

Wie die Beträge abgeleitet werden

BasisBedeutungBeispiel
fullJahresbetrag komplettGewerkschaftsbeitrag
sharefester Prozentsatz, ggf. gedeckeltInternet 20 %, max. 20 €/Monat
labor_onlynur Lohnanteil — App fragt den Wert ab, weil er nur auf der Rechnung stehtHeizungswartung
flatPauschale mal AnzahlHomeoffice 6 € × Tage
manualnur Hinweis, Betrag trägt der Nutzer einKrankheitskosten

4Der Tipp-Katalog

Sortiert nach dem, was am meisten bringt. „Auslöser" heißt: das findet die App in deinen vorhandenen Daten, ohne dass du etwas Neues erfassen musst. Beträge Stand 2025.

WasAuslöser in deinen DatenHöchstbetragHakenWert
Handwerkerleistungen
§ 35a III
Verträge/Belege mit Wartung, Schornsteinfeger, Heizung, Elektro, Renovierung, Gartenbau 20 % von 6.000 €
= 1.200 €
nur Lohnkosten, unbar bezahltsehr hoch
Haushaltsnahe Dienstleistungen
§ 35a II
Reinigung, Gartenpflege, Winterdienst, Hausmeister, Pflegedienst — und die Nebenkostenabrechnung 20 % von 20.000 €
= 4.000 €
unbar, Materialanteil raussehr hoch
Nebenkostenabrechnung auswerten Beleg „Nebenkosten", „Betriebskosten", „Hausgeld" — App erinnert aktiv daran — (fließt oben ein) Vermieter muss den Anteil bescheinigensehr hoch
Homeoffice-Pauschale Profil-Frage „an wie vielen Tagen?" 6 €/Tag
max. 1.260 €
zählt in die Werbungskosten, gegen den Pauschbetraghoch
Pendlerpauschale Profil-Frage „Entfernung zur Arbeit" 0,30 €/km
ab 21. km 0,38 €
einfache Strecke, nicht Hin + Rückhoch
Arbeitsmittel Belege mit Notebook, Drucker, Fachbuch, Werkzeug, Büromöbel voll
(Computer sofort)
bei Mischnutzung nur der berufliche Anteilhoch
Telefon & Internet Verträge der Kategorie Kommunikation 20 %, max. 20 €/Mon.
= 240 €/Jahr
nur bei beruflicher Nutzungmittel
Berufsverband / Gewerkschaft Name enthält Gewerkschaft, ver.di, IG …, Kammer, Berufsverband voll—mittel
Spenden Belege/Verträge mit Spende, Hilfswerk, e. V., Förderbeitrag bis 20 % der Einkünfte bis 300 € reicht der Kontoauszugmittel
Kinderbetreuung Kita, Hort, Tagesmutter — Profil „Kinder ja" 80 %, max. 4.800 €
(ab 2025)
unbar bezahlt, Kind unter 14hoch
Fortbildung Kurs, Seminar, Zertifikat, Sprachkurs, Fachliteratur vollberufsbezogenmittel
Krankheitskosten Belege mit Zuzahlung, Brille, Zahnersatz, Physio, Rezept über der zumutbaren
Belastung (1–7 %)
App rechnet die Schwelle aus und sagt, ob Sammeln lohntsituativ
Energetische Sanierung
§ 35c
Belege mit Wärmepumpe, Dämmung, Fenster, Heizungstausch 20 % über 3 Jahre
max. 40.000 €
nur selbstgenutztes Eigentum, Fachunternehmer­bescheinigungsehr hoch
Riester / Rürup Verträge mit Riester, Basisrente, Rürup, Altersvorsorge Riester 2.100 €
Rürup: hoher Rahmen
eigene Anlage AVmittel
Doppelte Haushaltsführung zwei Mietverträge gleichzeitig — das sieht die App von selbst Unterkunft max.
1.000 €/Monat
beruflich veranlassthoch
Umzug aus beruflichem Grund Mietvertrag endet + neuer beginnt im selben Jahr Pauschale ~964 €
+ Umzugskosten
beruflicher Anlass nötigmittel
Kontoführung immer, wenn Werbungskosten vorhanden 16 € pauschalohne Nachweis anerkanntklein
Versicherungen Haftpflicht, Unfall, BU, Risikoleben, KFZ-Haftpflicht Topf 1.900 €
meist schon voll
ehrlicher Hinweis: bringt neben der Krankenversicherung meist nichtsmeist null
Hausrat, Kasko, Rechtsschutz privat —— nicht absetzbar — die App sagt es aktiv, statt zu schweigengeht nicht

Zwei Dinge, die kein Steuerprogramm von sich aus weiß — deine App aber schon

Rückwirkend abgeben

Freiwillig kannst du vier Jahre rückwirkend abgeben. Deine Verträge von 2022 liegen in der App — samt Preisverlauf und Belegen. Das Modul zeigt für jedes offene Jahr, was drinsteckt, und erinnert vor dem 31. 12., bevor ein Jahr endgültig verfällt. Das ist bares Geld, das sonst schlicht verjährt.

Muster über Jahre

Weil Verträge über Jahre laufen, erkennt die App Wiederkehrendes: „Die Heizungswartung hast du 2023 und 2024 abgesetzt, für 2025 fehlt sie noch." Ein klassisches Steuerprogramm startet jedes Jahr bei null — deine Datenlage ist hier objektiv besser.

5Die Ersparnis-Schätzung

Heikel, aber nützlich — wenn wir ehrlich damit umgehen. Zwei Sorten Abzug, die sich völlig unterschiedlich auswirken:

Den Grenzsteuersatz fragen wir einmal im Profil ab (Schieberegler 0–45 %, mit Erklärung). Jede Zahl wird als „≈" ausgegeben und trägt den Hinweis „Schätzung, keine Berechnung".

Was ich nicht tun würde: eine echte Steuerberechnung mit Grundtabelle, Splitting und Progressionsvorbehalt. Das wirkt exakt, ist es aber nie — und genau daran würdest du dich orientieren. Eine ehrliche grobe Schätzung ist besser als eine falsche Genauigkeit.

6Bedienung

Sieben Reiter, alles nach Steuerjahr. Oben rechts wählst du Jahr und Status.

ReiterWofür
ÜbersichtKennzahlen und alle Töpfe mit Auslastung. Erster Blick: wo steht das Jahr?
VorschlägeWas das Regelwerk in Verträgen und Belegen gefunden hat. Übernehmen legt einen Posten an, Passt nicht blendet den Vorschlag dauerhaft aus. Steht dort ein Eingabefeld, kennt nur deine Rechnung den zählenden Betrag — etwa den Lohnanteil.
TöpfeAlle Posten je Topf. Hier änderst du Status, löschst Posten oder legst welche von Hand an. Ganz unten: „Alles als war schon abgegeben markieren" für rückwirkende Jahre.
BelegeOrdnet Belege aus den Akten den Posten zu. Die Zahl im Reiter zeigt, wie viele Posten noch ohne Nachweis sind. Unten stehen Belege des Jahres, die zu keinem Posten gehören — dort steckt manchmal Übersehenes.
AbgabeSteuermappe als PDF (je Topf eine Tabelle mit Paragraph, ELSTER-Zeile, Belegen und Summe) und CSV für den Steuerberater.
Profil & LohnDie Angaben, die entscheiden, welche Tipps zu dir passen — plus die Zahlen der Lohnsteuerbescheinigung.
WissenDieses Handbuch und der vollständige Tipp-Katalog, direkt aus dem Regelwerk erzeugt.

7Die Lohndaten — warum sie so viel ändern

Die Zahlen der Lohnsteuerbescheinigung (einmal im Jahr vom Arbeitgeber, die Nummern in der App sind die Zeilennummern auf dem Ausdruck) sind der Schlüssel zu drei Dingen, die das Modul sonst nur raten kann:

WasOhne LohndatenMit Lohndaten
GrenzsteuersatzSchieberegler, den du raten musstaus der Tarifformel des § 32a EStG geschätzt, per Klick ins Profil übernehmbar
Zumutbare Belastungnicht rechenbar — Krankheitskosten blieben deshalb außerhalb der Schätzunggestaffelt nach § 33 Abs. 3, du siehst ab welchem Betrag Sammeln lohnt
Sonstige Vorsorgenur die pauschale Warnung „meist ausgeschöpft"Kranken- und Pflegebeiträge füllen den 1.900-€-Topf sichtbar; die App sagt konkret, wie viel noch frei ist
Einbehaltene SteuerunbekanntLohnsteuer + Soli + Kirchensteuer als Bezugsgröße in der Steuermappe
Der Grenzsteuersatz kommt aus der amtlichen Tarifformel und bleibt trotzdem eine Näherung: Splitting, Freibeträge, Progressionsvorbehalt und Kirchensteuer bleiben außen vor. Er beantwortet „was bringt ein zusätzlicher abgesetzter Euro ungefähr" — nicht „wie viel Steuer zahle ich".

8Rückwirkende Jahre

Freiwillig abgeben geht vier Jahre zurück, jeweils bis zum 31. 12. des vierten Folgejahres. Die App bietet fünf Jahre und warnt, wenn für ein Jahr weniger als 120 Tage bleiben.

Weil du vieles davon vermutlich längst eingereicht hast, gibt es drei Wege, das kenntlich zu machen:

WegWirkung
Jahresstatus auf Abgegeben / Bescheid daModul rechnet weiter mit, drängelt aber nicht mehr; Fristwarnung verstummt
Je Posten „war schon abgegeben"zählt nicht mehr in die Summen, bleibt als Nachschlagewerk sichtbar
„Alles als war schon abgegeben"setzt beides für das ganze Jahr in einem Schritt

9Katalog pflegen

Die Regeln stehen in steuer-regeln.json neben der App. Bearbeiten, auf den Server kopieren, fertig — kein SQL, kein Neustart. Das Feld stand oben wird in der App angezeigt. Eine neue Regel ist ein weiterer Eintrag in regeln, ein neuer Topf einer in toepfe.

Genau dafür liegt der Katalog als Textdatei und nicht in der Datenbank: Steuerrecht bewegt sich jedes Jahr, und eine Datei zu tauschen ist billiger als eine Migration.

10Was bewusst fehlt

Stand des Regelwerks und alle Beträge siehst du oben in der App. Fällt dir eine Regel auf, die danebenliegt, oder fehlt dir ein Tipp — sag Bescheid, der Katalog ist schnell geändert.