Skip to content
StrudelcodePublic

Latest commit

 

History

428 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SOCDOF

Strudel's Organization, Commerce & Documentation Offline Flow
Eine offline-first Windows-ERP-Desktopsuite und Produktivitäts-Arbeitsplatz für Betriebe, Praxen, Freelancer und Handel.

GitHub Release Discord Offline First License Languages


🌟 Überblick

SOCDOF bringt die Leistungsfähigkeit eines ERP-Systems in eine vertraute, Windows-11-inspirierte Desktop-Oberfläche.

Ob Kundenverwaltung, Rechnungen, Lagerbestand, ein Restaurant-Kassensystem mit Tischplan, Therapie-Dokumentation oder das Fahrtenbuch: SOCDOF deckt diese Aufgaben ab, zu 100 % offline, ohne Pflicht-Cloud-Konto und ohne Abo.

Alle Daten liegen lokal auf deinem Rechner in einer IndexedDB-Datenbank (Dexie.js). Dazu kommen schnelle Suche, Kundenakten und Ein-Klick-Backups als JSON.


🚀 Funktionen & Module

🪟 Windows-Desktop-Erlebnis

  • Mehrfenster-Arbeitsfläche: Fenster öffnen, verschieben, skalieren, andocken, minimieren und maximieren.
  • Startmenü & Taskleiste: Angeheftete Apps, Suche, Systemstatus und Benutzerwechsel.
  • Mehrere Monitore: Arbeitsbereiche auf mehrere Bildschirme erweitern und Fenster abtrennen.
  • Nachtmodus: Warme Farbtemperatur (1500 K – 5500 K) gegen Augenbelastung.
  • Personalisierung: Hintergrundbilder, Mica-Effekt, Akzentfarben und eigene Profilbilder.
  • Systemmodus beim Start: Hell, dunkel oder dem System folgend. Die Ersteinrichtung folgt direkt dem System.

👥 Kontakte & CRM (Kundenbuch)

  • Zentrales Adressbuch für Kunden, Lieferanten, Partner und Interessenten.
  • Kundenauswahl überall: Live-Suche und Neuanlage direkt aus jedem Modul.
  • 360°-Kundenakte: Rechnungen, Angebote, Therapieprotokolle und Zahlungen pro Kontakt.

🧾 Rechnungen & Abrechnung

  • DIN-5008-Layouts für Rechnungen, Angebote, Lieferscheine und Gutschriften.
  • EPC-QR-Code (GiroCode) für Überweisungen per Smartphone.
  • Steuern: Regelsteuersatz, ermäßigter Satz, Kleinunternehmerregelung (§ 19 UStG) und Steuerbefreiung für Therapie (§ 4 Nr. 14 UStG).
  • Zahlungsverfolgung: Offene, bezahlte und überfällige Posten mit Zahlungserinnerungen.

🏥 Therapie- & Praxisverwaltung (TheraPsy Suite)

  • Klienten direkt aus dem Kundenbuch auswählen, ohne doppelte Eingabe.
  • Sitzungsdokumentation mit Verlaufsnotizen, Methoden und Dauer-Vorlagen (30, 50, 60, 90 Minuten).
  • Abrechnung mit Praxis-Briefkopf und Synchronisation in die Hauptbuchhaltung.
  • Fahrtenbuch: Start- und Endkilometer, automatische Strecke und EStG-Erstattung (0,30 €, 0,38 €, 0,42 €/km).
  • Auswertung: Umsatz- und Sitzungsdiagramme mit KPI-Karten.

📦 Lager, Produkte & Warenbewegungen

  • Bestandsführung mit Artikelnummern, Barcodes, Einkaufs- und Verkaufspreisen sowie Mindestbeständen.
  • Bewegungsprotokoll für Umlagerungen, Lieferungen, Verluste und Wareneingänge.
  • Warnungen bei Unterschreitung des Mindestbestands.

🍽️ Kasse (POS) & Gastronomie

  • Tischplan-Editor mit Drag-and-Drop für Tische, Plätze und Räume.
  • Bestellungen am Tisch oder zum Mitnehmen mit Varianten und Notizen.
  • Küchen- und Barbildschirm mit Bestellstatus.
  • Rechnung teilen nach Person oder Artikel, Bar- oder Kartenzahlung.

📊 Buchhaltung & Auswertung

  • Auswertungen: Umsatz, Ausgaben und Margen.
  • Steuerberichte: BWA, EÜR, UStVA und tägliche Kassenberichte (Z-Bon).

🌐 Vier Sprachen von Anfang an

Alle Oberflächentexte gibt es in Deutsch, Englisch, Französisch und Spanisch. Die Sprache wird bei der ersten Einrichtung gewählt.


🛡️ Stabilität & Betrieb

  • Sitzungsprotokolle: Die Desktop-Version schreibt Sitzungslogs, auch bei Abstürzen. Die letzten 20 Sitzungen bleiben erhalten.
  • Startbildschirm: Ein Splash-Screen erscheint bei jedem Start.
  • Selbst-Update der portablen Version: Die portable EXE kann sich selbst aktualisieren. Auf anderen Arbeitsplätzen erscheint ein Hinweis zum Update.

🔒 Datenschutz & Offline-First

Deine Geschäftsdaten gehören dir.

  • Keine Cloud-Pflicht: Läuft vollständig lokal auf dem Desktop oder im Browser. Keine Konten und keine Telemetrie.
  • IndexedDB & Dexie.js: Transaktionale Speicherung im Browser, geeignet für zehntausende Datensätze.
  • Lokale JSON-Backups: Gesamte Datenbank als Datei exportieren und auf jedem Rechner wiederherstellen.
  • Sicheres Zurücksetzen: Mehrstufiger Assistent, um den lokalen Stand beim Gerätewechsel zu löschen.

📥 Installation & Downloads

Fertige Windows-Versionen gibt es auf den GitHub Releases:

  1. Setup-Installer (SOCDOF Setup ... .exe): Installation mit Desktop-Verknüpfung, Startmenü und Auto-Updater.
  2. Portable Version (SOCDOF ... .exe): Eine einzelne EXE ohne Installation, mit Selbst-Update.
  3. Web-App: Im Browser ausführen oder als statische Progressive Web App (PWA) bereitstellen.

🛠️ Lokale Entwicklung

Voraussetzungen

  • Node.js (v18 oder neuer)
  • npm (v9 oder neuer)

Schnellstart

# 1. Repository klonen
git clone https://github.com/Strudelcode/SOCDOF.git
cd SOCDOF

# 2. Abhängigkeiten installieren
npm install

# 3. Entwicklungsserver starten (Port 3000)
npm run dev

# 4. TypeScript- und Syntaxprüfung
npm run lint

# 5. Produktionsbuild (Web-Bundle)
npm run build

Windows-Electron-App bauen

# NSIS-Installer und portable EXE erstellen
npm run build:exe

📂 Projektstruktur

SOCDOF/
├── electron/              # Electron-Hauptprozess, IPC-Handler, Fensterverwaltung, Splash & Sitzungslogs
├── src/
│   ├── components/        # UI-Module (Rechnungen, Kasse, Lager, Therapie, Einstellungen usw.)
│   │   └── therapy/       # Therapie-Untermodule (Dashboard, Abrechnung, Fahrtenbuch, Klienten)
│   ├── lib/               # Datenbank (Dexie.js), Übersetzungen (i18n), Sound, Displays, Versionierung
│   ├── types/             # TypeScript-Typen für alle Geschäftsobjekte
│   ├── App.tsx            # Hauptsteuerung der Arbeitsfläche
│   └── main.tsx           # React-Einstiegspunkt
├── todo/                  # Offene Aufgaben (todo.md) und Archiv (completed_todo.md)
├── versions/              # Detaillierte Versionshinweise je Versionsreihe
└── package.json           # App-Metadaten, Abhängigkeiten und Build-Skripte

🤝 Community & Support


Entwickelt von Strudel / Yuri in Südtirol, Italien.

Dieses Projekt wird mithilfe von KI programmiert.

Releases

Packages

Contributors

Languages