Zum Inhalt

App Platform

🧠 Zusammenfassung

Fincoplan ist die ultimative Finanz-, Controlling und Planungssoftware, welches jedes seriöse Unternehmen verwenden sollte.

🎯 Zweck

Eine Software einerseits um für unser Unternehmen finanziell sicher planen zu können, und andererseits um immer den Überblick über die Finanzen zu behalten.

📦 Kontext

-

🧩 Details

Im Aufbau - als erstes soll eine Marktstudie durchgeführt werden. Danach sollen die wesentlichen Features refined werden und anschliessend in der Entwicklung umgesetzt.

Die bisher getroffenen Architekturentscheidungen finden sich in Architektur-Entscheidungen zur App Plattform.

Roadmap

Phase 0: Fundament

Epic Inhalt Abhängig von
E0.1 Repo und Tooling Nx, Node 22+, TypeScript 6, ESLint/Prettier, Modulgrenzen, Commit-Konventionen –
E0.2 Dev-Umgebung Docker Compose (Postgres, Keycloak, Mailpit, S3-kompatibler Speicher), Seed-Daten, .env-Konzept
E0.3 Backend-Skeleton NestJS, TypeORM, Migrationen, Config, Logging, Fehlerformat, OpenAPI, Health-Check
E0.4 Frontend-Skeleton Angular 22 Shell, lazy Routing, PWA-Grundlage, mobile-first Layout, API-Client-Generierung
E0.5 CI Gitea Actions Runner, Lint, Test, Build, DB im Testlauf, E2E-Smoke
E0.6 Agenten-Workflow AGENTS.md, Story-Template v2, Kanboard-CLI-Anleitung, PR-Regeln, Referenzmodul als Vorlage
E0.7 ADRs und Spikes Keycloak-Bestätigung, UI-Ansatz (Angular Aria, eigenes Design-System oder Bibliothek)
E0.8 Pilot 2-3 echte Stories an den Agenten, Auswertung, Leitplanken nachschärfen

Vorschlag der KI: E0.1-E0.6 gemeinsam interaktiv bauen und nicht per Agent. Dieses Skeleton ist die Vorlage für alles Spätere, Fehler darin vervielfachen sich.

Phase 1: Core-Plattform

Epic Inhalt Abhängig von
E1.1 Identität Keycloak-Realm, OIDC-Login, Token-Validierung, User-Sync, Passwort-Reset, MFA/Passkeys
E1.2 Organisationen Anlegen, Mitgliedschaften, Einladungen, Wechsel zwischen Organisationen, konfigurierbare Bezeichnungen
E1.3 Rechte Permission-Registry pro Modul, Rollen, Zuweisung, Backend-Guards, Frontend-Direktive
E1.4 Mandantenisolation Request-Kontext, zentrales Scoping, RLS, AccessGrant, Isolationstest-Suite
E1.5 Module und Entitlements Modul-Registry, Buchung pro Organisation, dynamische Navigation
E1.6 Design-System und Shell Mobile-first Komponenten, Bottom-Navigation, Theming, rollenabhängige Layouts, Formulare, Dark Mode
E1.7 Audit-Log Wer hat wann was geändert, abfragbar
E1.8 Dateiablage S3-kompatibel, Präfix pro Organisation, Upload- und Kamera-Komponente
E1.9 Jobs und Benachrichtigungen Queue, Scheduler, E-Mail, Web-Push, In-App (Basis für Immo-Erinnerungen)
E1.10 KI-Gateway Provider-Abstraktion (Ollama), Queue, strukturierte Ausgaben, Prompt-Registry, Nutzungslog, Konfiguration pro Organisation
E1.11 Plattform-Admin Backoffice: Organisationen, Entitlements, Support-Funktionen
E1.12 DSGVO-Basis Consent, Datenexport, Löschung

Phase 1 endet mit einem Walking Skeleton: Login, Organisation anlegen, Modul “Finanzen” buchen, leere Finanz-Seite am Handy sehen, mit grünem Isolationstest. Danach startet das Finanztool auf einem sauberen Fundament.

Phase 2: Finanztool MVP

Ziel: Das aktuelle Excel wird durch ein Tool ersetzt, das Buchungen verwaltet, Cashflow, GuV und Steuerwerte berechnet und den Steuerberater besser unterstützt.

Epic Inhalt Abhängig von
Datenmodell und Stammdaten Buchungen (Brutto, Netto, USt/VSt, Steuerrelevanz), Zuordnung, Sparte, Konto, Status, Steuerjahr. Abgeleitete Werte (Quartal, Monat, Cashflow) werden berechnet statt gespeichert
Import CSV-Import von Bankdaten mit Mapping, Dublettenerkennung, einmalige Übernahme der bestehenden Excel-Daten
Erfassung und Pflege Buchungsliste (Karten am Handy), Bearbeiten, Storno, Filter, Massenbearbeitung
Cashflow Ist-Cashflow, geplanter Cashflow, einfache Forecasts
Auswertungen GuV, Umsatzsteuer-Überblick, Steuerberechnung, Quartals- und Jahresansicht
Prüfungen und Exporte Vollständigkeitsprüfungen (z. B. fehlende Zuordnung oder Steuerangaben), Exporte für Steuerberater
KI Tag- und Kategorievorschläge über das KI-Gateway (Vorschlag, Mensch bestätigt, Lernen aus Bestätigungen)

V2 (später): Belegerkennung und bessere Forecasts.

Aktuell noch offen:

  • Eine anonymisierte Excel-Beispieldatei und der Kontenplan. Ohne sie bleibt das Datenmodell geraten.
  • Bedeutung von Zuordnung, Sparte, Konto, Hauptkonto und Spesenkonto. Wie hängen sie zusammen?
  • Die Steuerlogik: Wie werden aktuell Steuer und GuV (Ist- oder Soll-Versteuerung, Steuersätze, Besonderheiten) berechnet? Welche Steuerarten sollen berechnet werden?
  • Das Exportformat für den Steuerberaters (z. B. BMD, RZL oder CSV).
  • Das CSV-Format der unterstützten Bank(en).
  • Ob Mehrfachfirmen (mehrere Organisationen pro Benutzer) und ein externer Zugang für Steuerberater (per AccessGrant, nur Lesen) von Anfang an dazugehören.

Phase 3: Immobilienverwaltung MVP

Ziel: Hausverwaltungen und Eigentümer verwalten Objekte, Dokumente und Instandhaltung, Mieter bekommen ein Portal.

Epic Inhalt Abhängig von
Objektmodell Objekte, Einheiten, Eigentümer, Mieter (Lessee), Mietverhältnisse
Mandantenbeziehung Eigentümer und Hausverwaltung als Organisationen, Zugriff über AccessGrant (baut auf E1.4 auf)
Dokumentenverwaltung Ablage pro Objekt und Einheit, Kategorien, Berechtigungen
Bauwerksbuch Strukturierte Erfassung von Bauwerksdaten und Änderungen
Instandhaltungsbuch Wartungen, Mängel, Maßnahmen, Historie
Erinnerungen Wiederkehrende Fristen (Thermenwartung, Rauchfangkehrer usw.) über Jobs und Benachrichtigungen (E1.9)
Kommunikation Nachrichten zwischen Verwaltung, Eigentümern und Mietern
Mieterportal Eigene Einheit, Dokumente, Meldungen (Schäden), Kommunikation

V2 (später): Mietvorschreibung und Betriebskostenabrechnung. Diese sind in Österreich stark rechtlich geprägt (aktuell nicht bewertet).

Fehlt noch:

  • Was genau das Bauwerksbuch enthalten soll (Pflichtfelder, rechtliche Vorgabe, Vorlage)? Die Anforderungen je nach Objekt und Bundesland unterschiedlich sein können.
  • Welche Objektarten (Zinshaus, Eigentumswohnungen mit WEG, Einfamilienhaus)? Das beeinflusst das Datenmodell.
  • Wie viele Objekte und Beteiligte werde realistisch erwartet, und ob eine Hausverwaltung mit vielen Eigentümern der Hauptfall ist.
  • Der Kommunikationskanal: nur in der App, oder auch E-Mail und Push?
  • Welche Fristenarten und Vorlaufzeiten es für Erinnerungen geben soll.

Phase 4: Fitness/Life (grob)

Ziel: Mahlzeiten, Workouts und Befinden erfassen, mit KI als Personal Trainer und Ernährungsberater.

Epic Inhalt Abhängig von
Erfassung Mahlzeiten, Workouts, Befinden, Schlaf
Lebensmitteldaten Nährwertquelle, Mengen, eigene Rezepte
KI-Coach Lokale Modelle über das KI-Gateway, Auswertungen und Empfehlungen
Fotoanalyse Essensfotos erkennen (später, wie von dir angeregt)
Auswertungen Verläufe und Ziele
Datenschutz Einwilligungen und lokale Verarbeitung für Gesundheitsdaten (ADR-009, ADR-013)

Fehlt noch (kann warten): Quelle der Nährwertdaten, Wearable-Anbindung (Apple Health, Health Connect), welche Ziele und Pläne der Coach kennen soll.

  • https://www.wko.at/gruendung/finanzplanungs-software-plan4you

⚠ Hinweise / Notizen

-