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.
🔗 Externe Links (Human Only)¶
- https://www.wko.at/gruendung/finanzplanungs-software-plan4you
⚠ Hinweise / Notizen¶
-