Quelldokument (EN, vollständig):
docs/prd/prd-8w-finance.mdDiese Seite zeigt eine Zusammenfassung. Das vollständige Dokument enthält detaillierte technische Spezifikationen.
Hauptspezifikation: 8w-finance (v0.4.10)
1. Zweck
8w-finance ist eine lokale Buchhaltungs- und Steueranwendung für drei verbundene UG-Gesellschaften. Die Anwendung ersetzt die Notwendigkeit eines externen Steuerberaters für die laufende Buchhaltung und stellt gleichzeitig 100% Genauigkeit für offizielle Einreichungen sicher.
2. Gesellschaften
| Gesellschaft | Kürzel | Rolle | Status |
|---|---|---|---|
| 8wonder holding UG | 8wh | Muttergesellschaft | Aktiv |
| 8wonder apps UG | 8wa | 100% Tochter | Zur Liquidation (siehe prd-liquidation.md) |
| 8wonder Berlin UG | 8wb | 100% Tochter | Zur Liquidation (siehe prd-liquidation.md) |
3. Kern-Anforderungen
- Genauigkeit: Alle Berechnungen müssen 100% korrekt sein - nicht verhandelbar
- Rechtliche Konformität: Muss deutschem Steuerrecht entsprechen (EStG, KStG, GewStG, HGB)
- Nur Lokal: Anwendung läuft lokal; keine Cloud-Speicherung von Finanzdaten
- Unveränderliche Archive: Finale Berichte müssen nach Einreichung unveränderlich sein
4. 2022 Referenzjahr
2022 ist das absolute Referenzjahr. Alle Daten stammen vom Steuerberater und gelten als unveränderliche Grundwahrheit.
Die Quelldaten-Kette für 2022 ist vollständig verifiziert:
data/input/source/- Originaldokumente vom Steuerberater (PDF)seed-opening-balances- Eröffnungssalden-Seed aus den Quelldokumenten- Bilanz-Generator - Erzeugt Berichte aus der Datenbank
Verifizierte Bilanzsummen (Aktiva = Passiva)
| Gesellschaft | Bilanzsumme 2022 | Status |
|---|---|---|
| 8wh | 14.654,29 EUR | Verifiziert |
| 8wa | 1.964,33 EUR | Verifiziert |
| 8wb | 1.640,13 EUR | Verifiziert |
5. Aktueller Stand
Stand: April 2026
Funktioniert
- Bilanz-Generierung fur 2022 (alle drei Gesellschaften verifiziert)
- GuV-Generierung fur 2023+ aus LIVE-Buchungen mit expliziter 2022-Nullbasis (RFC-005 abgeschlossen)
- Bilanz für 2023+ rechnet jetzt Schlusssalden aus Eröffnungssalden + LIVE-Journalbewegungen (RFC-006 abgeschlossen)
- Jahresabschluss-Workflow mit
db:close-year, explizitemFiscalYearCloseund Fortschreibung ist implementiert (RFC-006 abgeschlossen) - Datenbank-Schema mit Prisma/Supabase
- Seed-Skript fur Eröffnungssalden
- Automatisierte Golden Tests fur Decimal, Bilanz 2022 und GuV-Nullbasis 2022 (RFC-002 abgeschlossen)
- Live-Domain-Registry für Gesellschaften, Konten und Berichts-Datenzugriff zentralisiert (RFC-003 abgeschlossen)
- CSV-Import-Pipeline mit Normalisierung, Mapping, ImportBatch-Auditierung und REFERENCE_ONLY-Scope für 2022 implementiert (RFC-004 abgeschlossen)
- E-Bilanz-Archivexport für 2022-2024 mit Taxonomie 6.5/6.6/6.7, XBRL/PDF-Artefakten und read-only Download-Routen ist implementiert (RFC-011 abgeschlossen)
- SSR-first Layout ohne altes
AppShell, ausgelagerte Bilanz/GuV-Report-Blöcke und prosa-spezifische Doku-Tabellenstile sind umgesetzt (RFC-009 abgeschlossen) - Steuerseiten für KSt, GewSt und USt mit persistierten Overlay-Eingaben, API-Routen und PDF-Archivpfad sind implementiert (RFC-012 abgeschlossen)
- Prüfungsseiten (diese Seiten)
In Arbeit / Offen
- Keine Live-Geschäftsjahre verarbeitet - die CSV-Quelldaten liegen unter
data/transactions/, aber 2023/2024 wurden noch nicht importiert - Kein reales Geschäftsjahr wurde bisher im aktuellen Datenbestand abgeschlossen, obwohl der Workflow implementiert ist
- GoBD-Durchsetzung wird über
db:gobd, DB-Trigger, Prisma-Schreibschutz und Stornobuchung verifiziert (RFC-007 abgeschlossen) - Keine live archivierten E-Bilanzen für 2023/2024, weil diese Geschäftsjahre im aktuellen Datenbestand noch nicht verarbeitet wurden
- Keine live archivierten Steuererklärungen für 2023/2024, weil diese Geschäftsjahre im aktuellen Datenbestand noch nicht verarbeitet und abgeschlossen wurden
- Taxonomie-Folgearbeit für 2025+ bleibt zurückgestellt
- Umsatzsteuer bleibt in v1 eingabe- und overlay-basiert, bis die Buchungslogik belastbare MwSt-Provenienz auf Rechnungsebene speichert
6. Validierungsstrategie (Export-First)
Vor dem Import neuer Daten für 2023+ muss die Export-/Berichtslogik als korrekt bewiesen werden:
- 2022-Daten manuell erfassen → Bekannte 2022-Schlusssalden in Supabase eingeben
- 2022-Berichte generieren → Bilanz, GuV, E-Bilanz aus erfassten Daten
- Mit Quell-PDFs vergleichen → Generierte Berichte müssen bestehenden 2022-Dokumenten entsprechen
- Mit Golden Tests absichern → Automatisierte Regressionstests sperren die 2022-Referenzwerte
- Erst dann: Import-Funktionalität anwenden und 2023-Daten verarbeiten
7. Kern-Funktionen
| Funktion | Priorität | Beschreibung |
|---|---|---|
| Supabase-Datenbank | P0 | PostgreSQL mit Prisma; GoBD-Trigger werden über db:gobd installiert und mit db:validate geprüft |
| Bilanz-Generierung | P0 | Bilanz nach HGB/E-Bilanz |
| GuV-Generierung | P0 | Gewinn- und Verlustrechnung (GKV) |
| E-Bilanz Export | P0 | Archivgestütztes XBRL/PDF für 2022-2024 nach Taxonomie 6.5/6.6/6.7 |
| 2022 Export-Validierung | P0 | Validierung gegen bekannte 2022-Daten |
| Doppelte Buchführung | P0 | Volle Buchführung mit SKR03/04 |
| Körperschaftsteuer | P1 | KSt-Berechnung |
| Gewerbesteuer | P1 | GewSt-Berechnung |
| CSV-Transaktionsimport | P1 | CSV-Bankexporte in auditierbare Buchungen überführen |
8. Technologie-Stack
| Schicht | Technologie |
|---|---|
| Frontend | Next.js 16 + React 19 |
| Styling | Tailwind CSS 4 |
| Datenbank | Supabase PostgreSQL (EU Frankfurt) |
| ORM | Prisma mit PostgreSQL-Adapter |
| XBRL | Eigene Generierung nach Taxonomie |
9. Eröffnungssalden (aus 2022)
8wh Eröffnungssaldo 01.01.2023
| Konto | Soll | Haben |
|---|---|---|
| Immaterielle VG | 1,00 € | - |
| Finanzanlagen | 2.600,00 € | - |
| Vorräte | 7.910,00 € | - |
| Forderungen USt | 298,60 € | - |
| Bank | 3.844,69 € | - |
| Gezeichnetes Kapital | - | 4.000,00 € |
| Gesetzliche Rücklage | - | 2.514,42 € |
| Gewinnvortrag | - | 3.958,50 € |
| Rückstellungen | - | 2.100,00 € |
| Verbindlichkeiten L+L | - | 731,37 € |
| Sonstige Verbindlichkeiten | - | 1.350,00 € |
8wa Eröffnungssaldo 01.01.2023
| Konto | Soll | Haben |
|---|---|---|
| Bank | 685,53 € | - |
| Nicht gedeckter Fehlbetrag | 1.278,80 € | - |
| Gezeichnetes Kapital | - | 1.300,00 € |
| Rückstellungen | - | 180,00 € |
| Verbindlichkeiten L+L | - | 566,68 € |
| Sonstige Verbindlichkeiten | - | 917,65 € |
8wb Eröffnungssaldo 01.01.2023
| Konto | Soll | Haben |
|---|---|---|
| Forderungen | 20,06 € | - |
| Bank | 727,18 € | - |
| Nicht gedeckter Fehlbetrag | 892,89 € | - |
| Gezeichnetes Kapital | - | 1.300,00 € |
| Rückstellungen | - | 300,00 € |
| Sonstige Verbindlichkeiten | - | 1.340,13 € |
10. Implementierungsphasen
- Phase 0: Stabilisierung (abgeschlossen)
- Build, Lint und Validierung stabilisiert (RFC-001 abgeschlossen)
- 2022-Baseline mit Golden Tests abgesichert (RFC-002 abgeschlossen)
- Domain-Logik zentralisiert (RFC-003 abgeschlossen)
- Phase 1: Daten-Import
- Transaktions-CSV-Import (RFC-004 abgeschlossen)
- Journalgetriebene GuV mit Warnstatus und 2022-Schutz (RFC-005 abgeschlossen)
- Phase 2: Kern-Berichte
- Jahresabschluss-Workflow mit Fortschreibung, UG-Rücklage und geschützten Folgejahren (RFC-006 abgeschlossen)
- Phase 3: Compliance
- GoBD-Durchsetzung (RFC-007 abgeschlossen)
- Sicherheit & Zugriffsschutz (RFC-008 abgeschlossen)
- Phase 4: UI & Architektur
- UI-Architektur, Lade-/Fehlergrenzen und SSR-first Shell (RFC-009 abgeschlossen)
- Berichtsarchiv mit Prüfsummen und Versionierung (RFC-010 abgeschlossen)
- Phase 5: E-Bilanz & Steuer
- E-Bilanz XBRL-Export für 2022-2024 mit read-only Archivseite (RFC-011 abgeschlossen)
- Steuererklärungen KSt/GewSt/USt mit Archivpfad und USt-Overlay-Modell (RFC-012 abgeschlossen)
- Phase 6: Erweiterungen
- Liquidation 8wa/8wb (siehe prd-liquidation.md)
- 2025-Anforderungen (siehe prd-2025-requirements.md)
11. RFC-Index
| RFC | Titel | Phase |
|---|---|---|
| RFC-001 | Build, Lint und Validierung stabilisiert | 0 |
| RFC-002 | 2022-Baseline sichern | 0 |
| RFC-003 | Domain-Logik zentralisiert | 0 |
| RFC-004 | Transaktions-Import (abgeschlossen) | 1 |
| RFC-005 | Journal & GuV-Überarbeitung (abgeschlossen) | 1-2 |
| RFC-006 | Jahresabschluss (abgeschlossen) | 2 |
| RFC-007 | GoBD-Durchsetzung | 3 |
| RFC-008 | Sicherheit (abgeschlossen) | 3 |
| RFC-009 | UI-Architektur (abgeschlossen) | 4 |
| RFC-010 | Berichtsarchiv (abgeschlossen) | 4 |
| RFC-011 | E-Bilanz XBRL (abgeschlossen) | 5 |
| RFC-012 | Steuererklärungen (abgeschlossen) | 5 |
12. Prüfungsergebnisse April 2026
Zusammenfassung der Prüfungsergebnisse
- Bilanz 2022 für alle drei Gesellschaften korrekt generiert und verifiziert
- Quelldaten-Kette (PDF → Seed → Datenbank → Bericht) vollständig nachvollziehbar
- Build-Pipeline stabilisiert - RFC-001 ist abgeschlossen
- Automatisierte Golden Tests für 2022 aktiv - RFC-002 ist abgeschlossen
- Gesellschaften, Konten und gemeinsamer Berichts-Datenzugriff zentralisiert - RFC-003 ist abgeschlossen
- CSV-Import-Grundlage mit Dry-Run-Klassifikation und ImportBatch-Auditierung ist aktiv - RFC-004 ist abgeschlossen
- Jahresabschluss-Workflow mit explizitem Close-State, Fortschreibung und Bilanz-Rollforward ist implementiert - RFC-006 ist abgeschlossen
- GoBD-Trigger, Prisma-Schreibschutz für finalisierte Buchungen und Stornobuchung sind implementiert - RFC-007 ist abgeschlossen
- Root-Layout rendert die Shell wieder SSR-first, Bilanz/GuV verwenden gemeinsame Report-Komponenten, und Doku-Tabellenstile greifen nicht mehr in Finanz-Tabellen ein - RFC-009 ist abgeschlossen
- Berichtsarchiv mit append-only Versionierung, Prüfsummen und Archiv-Downloads ist implementiert - RFC-010 ist abgeschlossen
- E-Bilanz-Export mit Taxonomie 6.5/6.6/6.7, Überleitungsdaten, Anlagenspiegel und XBRL-Archiv-Downloads ist implementiert - RFC-011 ist abgeschlossen
- Steuerseiten für KSt, GewSt und USt mit persistierten Overlay-Eingaben, Steuerübersicht und PDF-Archivierung sind implementiert - RFC-012 ist abgeschlossen
- Keine Geschäftsjahre 2023/2024 verarbeitet
13. Verwandte Dokumente
docs/prd/prd-2025-requirements.md- 2025-spezifische Anforderungendocs/prd/prd-liquidation.md- Liquidationsunterstützung für 8wa/8wbdocs/legal-analysis-self-managed-ug.md- Rechtliche Analysedocs/submission-methods.md- Einreichungswege