NOCTUA – Revisionssicheres Datenbuch
==========================================
NexisCare · GTK4 / C / SQLCipher

Was ist das?
------------
Noctua ist ein GoBD-konformes, verschlüsseltes Datenbuch für den
Mehrplatzbetrieb auf einem gemeinsamen (Netz-)Speicherort.

Editionen (Basis / Vollversion)
-------------------------------
Die Edition wird BEIM BAUEN festgelegt (tools/gen_edition.py -> edition.h):
  • Liegt eine Datei „kunde.info" im Projektverzeichnis vor  -> VOLLVERSION
  • Keine „kunde.info"                                        -> BASIS-VERSION

Einschränkungen der kostenlosen BASIS-Version:
  1. PDF-Ausdrucke erhalten ein großes, blasses Noctua-Wasserzeichen und
     einen Fußzeilen-Hinweis (nicht für amtliche Vorlagen geeignet).
  2. Maximal 10 Benutzer und genau 1 Abteilung.
  3. Keine Bild-Anhänge an Einträgen (ausgegraut).
  4. PDF-Export nur für die letzten 30 Tage.
Die Vollversion (mit kunde.info) hebt alle vier Einschränkungen auf.

Logos (immer vorhanden, nicht entfernbar):
  • Noctua-Logo: oben RECHTS auf jedem PDF, in „Über Noctua", am Login.
  • NexisCare-Logo: im Dialog „Copyright".
Kundenlogo (optional, assets/img/customer_logo.png|svg vor dem Build):
  • ersetzt das Login-Logo, erscheint oben LINKS auf PDFs und im „License".

Funktionsumfang – Version 1.0.0 (finale Erstveröffentlichung)
--------------------------------------------
  • Schlüsselspeicherung komplett überarbeitet (haftungsrelevant):
      - Das gemerkte DB-Masterpasswort liegt jetzt im OS-Schlüsselspeicher,
        gebunden an das angemeldete Benutzerkonto: libsecret/GNOME-Keyring
        bzw. KWallet (Linux), DPAPI (Windows), Keychain (macOS).
      - Fällt kein Schlüsselspeicher an (z. B. Server ohne Keyring), greift
        ein Fallback mit AES-256-GCM (OpenSSL), Schlüssel via PBKDF2-HMAC-
        SHA256 aus einer maschinenspezifischen Kennung. Kein Eigenbau-
        Verfahren mehr; Manipulation wird durch den GCM-Auth-Tag erkannt.
      - Bestehende (alt verschlüsselte) Konfigurationen werden weiterhin
        gelesen und beim nächsten Speichern automatisch migriert.
      - Die DB-Datei selbst bleibt per SQLCipher (AES-256) verschlüsselt.
      - Neue Abhängigkeiten: OpenSSL und (nur Linux) libsecret-1.
  • Menüpunkt „License" (unter Info, neben „Copyright"): zeigt im selben
    Design wie „Copyright" den Lizenztext an. Liegt beim Bauen eine Datei
    „kunde.info" im Projektverzeichnis, wird deren Inhalt FEST in die Binary
    eingebettet (kein externer Klartext zur Laufzeit) und hier angezeigt;
    sonst der zentrale Standard-Lizenztext (branding.h).
  • Umfirmierung: Alle sichtbaren Hinweise auf „dataNet" wurden durch
    „NexisCare" ersetzt (Copyright, Support, Impressum, Herausgeber-Logo).
  • Zentrale Branding-Datei: src/branding.h ist jetzt die EINE Stelle für
    Firmenname, Copyright, Kontaktdaten, Standard-Lizenztext und die
    Logo-Dateinamen. Zum Umbranden nur dort anpassen und neu bauen.
  • Logos werden ausschließlich VOR dem Build festgelegt und mitgebaut:
    assets/img/client_logo.(svg|png) = Produktlogo (Noctua),
    assets/img/nexiscare_logo.png / nexiscare_fixed.svg = Herausgeberlogo.
    Der frühere Laufzeit-Logo-Dialog entfällt.
  • Build robuster: fehlt libsecret-1, bricht der Build nicht mehr ab,
    sondern nutzt den AES-256-GCM-Fallback (mit Hinweis). OpenSSL ist
    Pflicht; build.sh prüft die Abhängigkeiten vorab und nennt den
    passenden apt-Befehl.
  • Umbenennung: Ein „Buch" heißt in der gesamten Oberfläche jetzt
    „Datensatz" (der Produktname „Revisionssicheres Datenbuch" bleibt).
  • Datensatz-Beschreibung: beim Anlegen frei beschreibbar; über
    „Verwaltung → Datensätze → Bearbeiten" jederzeit änderbar.
  • Sortierung der Einträge wird EINMALIG beim Anlegen des Datensatzes
    festgelegt (Neueste zuerst / Älteste zuerst). Der frühere Menüpunkt
    „Sortierung…" entfällt.
  • Neuer Eintrag: optionales Datum über einen Kalender-Auswähler (nur in
    die Vergangenheit, nie in die Zukunft) plus Uhrzeit und „Leeren".
    Liegt der Zeitpunkt mehr als 12 Stunden zurück, wird der Eintrag
    gemäß den gesetzlichen Vorgaben (GoBD) automatisch als „Nachtrag"
    deklariert – Hinweis wird eingeblendet und das Feld „Grund" mit
    „Nachtrag" vorbelegt. Vor dem Speichern lässt sich das Datum wieder
    leeren, danach ist der Eintrag unveränderlich.
  • Lesebestätigung: Ein Datensatz kann als „Lesebestätigung erforderlich"
    angelegt werden. Dann tragen nur Leitungen/Admins ein; Mitarbeiter
    lesen und bestätigen per Knopf (mit Kürzel + Zeitstempel). Einzelne
    Felder können als „Schreibrecht" markiert werden – nur dort dürfen
    Mitarbeiter vor dem Bestätigen Anmerkungen (mit Zeitstempel) hinzufügen.
  • Bild-Anhang je Eintrag: pro Datensatz einstellbar, ob Bilder erlaubt
    sind und ob auch Mitarbeiter anhängen dürfen. Bilder werden in der
    (verschlüsselten) Datenbank gespeichert; in der Ansicht erscheint ein
    Bild-Symbol, das das Bild öffnet.
  • Leitungen dürfen eigene Mitarbeiter verwalten: „Verwaltung →
    Mitarbeiter…" zeigt einer Leitung nur die eigene Abteilung; neu
    angelegte Mitarbeiter werden automatisch dieser Abteilung zugeordnet
    (ohne Leitungs-/Adminrechte).
  • Nach dem Login erscheint bei ungelesenen Nachrichten ein Hinweis mit
    direktem Sprung ins Postfach.
  • Fenstergröße: Login/Verbinden wird nur in der benötigten Größe
    angezeigt; der Datensatz-Arbeitsbereich öffnet im Vollbild (maximiert).
    Nach dem Abmelden wird das Fenster wieder kompakt.
  • „Deaktivieren/Sperren/Löschen/Archivieren"-Schaltflächen sind jetzt
    durchgehend satt ROT und gut lesbar (auch im deaktivierten Zustand).
  • „Daten drucken" ist in zwei Kategorien gegliedert: „Datensätze"
    (Datensatz + Zeitraum) und „Mitarbeiter" (mit Abteilungsfilter
    „Alle Abteilungen" / einzelne Abteilung).
  • In der Datensatz-Ansicht steht unter dem Kürzel klein die Position
    des eintragenden Mitarbeiters in Klammern.

Architektur (Aufbau des Projekts)
-------------------------------------------
Die Oberfläche wurde strikt in LOGIK (C) und DESIGN (UI + CSS) getrennt:

  • JEDE Ansicht hat jetzt eine eigene .ui-Datei (GtkBuilder-XML) unter
    ui/. Nichts wird mehr in C "zusammengebaut"; die Controller laden die
    .ui, verdrahten Signale und füllen nur noch die dynamischen Teile
    (Tabellen, Listen, Feldzeilen) in benannte Platzhalter.
  • ALLE Farben/Abstände liegen in EINER gemeinsamen Datei: ui/style.css.
    Helles und dunkles Design stehen zusammen in dieser Datei; umgeschaltet
    wird zur Laufzeit über die CSS-Klasse ".theme-dark" am Fenster
    (Menü „Info → Design umschalten"). Die frühere zweite Datei
    style-dark.css entfällt.
  • Der frühere Absturz ("Speicherzugriffsfehler") beim Buch-Anlegen ist
    behoben; ein eingebauter Selbsttest (./noctua --selftest) spielt den
    kompletten Buch-Anlege-Pfad und lädt jede Ansicht einmal headless durch
    (Rückgabewert 0 = alles in Ordnung).
  • ALLE Texte stehen zentral in src/texts.h (ein Makro je Text). Die
    .ui-Dateien enthalten nur {{TOKEN}}; der Build setzt die Texte ein
    (tools/gen_ui.py). Text ändern = in texts.h anpassen und neu bauen.
  • Logo-/Icon-GRÖSSEN (Breite & Höhe je Logo) und die GRAFIK-PFADE stehen
    zentral in src/branding.h. Alle Grafiken liegen unter assets/img/.
  • App-Icon (Eule/Mond, Platzhalter) in der Titelleiste UND als Desktop-
    Icon. Zum Tauschen: assets/img/noctua_icon.svg ersetzen und
    ./tools/render_icons.sh ausführen (erzeugt PNG-Größen + noctua.ico neu).
  • Desktop-Icon wird bei der Installation angelegt:
      - Linux: freedesktop-.desktop + Icon-Theme (hicolor) – von GNOME, KDE,
        XFCE, LXDE/LXQt unter X11 UND Wayland gleichermaßen genutzt; das
        .deb aktualisiert per postinst die Icon-/Desktop-Datenbank.
      - Windows: NSIS legt Start-menü- und Desktop-Verknüpfung mit Icon an.
  • "Nachtwachen/Nachtwachenbuch" wurde überall durch "Datenbuch" ersetzt.
  • Gate (Login/Verbinden): Logo steht jetzt LINKS neben dem Formular/Titel
    (kompakter, ruhiger).
  • Postfach: Umschalter "Posteingang / Gesendet" – gesendete Nachrichten
    sind jetzt sichtbar (mit Empfängerangabe).
  • Einzel-Eintrag drucken (nur Admin): in jeder Datenbuch-Zeile ein
    "Drucken"-Knopf. Erzeugt eine A4-Seite mit dem Eintrag, (falls
    storniert/gelöscht) den Änderungsinfos, den Ersteller-Daten (Datum,
    Vorname, Nachname, Kürzel) und dem Druck-Nachweis (wer/wann, Anzahl).
    Jeder Druck wird revisionssicher in der DB protokolliert (Tabelle
    print_log).
  • Verwaltung: Einzelpunkte "Mitarbeiterliste/Datenbuch als PDF" ersetzt
    durch EINEN Punkt "Daten drucken…": dort Typ (Datenbuch/Mitarbeiter-
    liste), Buch und Monat wählen; das PDF wird erzeugt und direkt zur
    Ansicht/zum Drucken geöffnet.

Architektur (Trennung Logik/Design)
-----------------------------------
  src/     Logik + UI-Controller (C)
    branding.h     ZENTRAL: Logo-/Icon-Größen (B x H) + Grafik-Pfade
    texts.h        ZENTRAL: ALLE Oberflächentexte (ein Makro je Text)
    main.c         Einstieg, Konfiguration, Ressourcen, CSS, Theme, Timer
    util.c         Zeit, Krypto-Primitive (SHA-256/PBKDF2), minimales JSON
    crypto.c       Hardware-Binding + versiegelte lokale Schlüsselablage
    database.c     SQLite/SQLCipher: Schema, Write-Lock, Audit-Trail, CRUD
    shell.c        Koordinator: Hauptfenster, App-Chrome, Menü, Navigation
    view_gate.c    Intro-Animation + Login/Einrichten
    view_book.c    Datenbuch, neuer Eintrag, Stornieren/Löschen
    view_mail.c    Internes Postfach + Nachricht verfassen
    view_admin.c   Benutzer, Passwort, Bücher (Buch-Editor), Sortierung
    view_export.c  PDF-Export (Mitarbeiterliste, Datenbuch)
    about.c        "Copyright", "Über Noctua", "Support" (eigene Fenster)
    export_pdf.c   PDF-Export (Tabellen mit Logo), cairo + pango
    netinfo_*.c    Netzwerk-Infos (plattformgetrennt Linux/Windows)
  ui/      Design (ein .ui je Ansicht + EINE gemeinsame CSS)
    window_main.ui    Hauptfenster (Titelleiste + Stack)
    view_app.ui       App-Chrome (Menü-/Inhalts-/Statusbereich)
    menu.ui           Menümodelle (Admin / Mitarbeiter)
    view_gate.ui      Intro/Logo + Formular-Host
    form_login.ui     Anmeldeformular
    form_setup.ui     Einrichten/Verbinden-Formular
    view_book.ui      Datenbuch-Ansicht
    view_entry.ui     Neuer Eintrag
    view_reason.ui    Stornieren/Löschen (Grund)
    view_postfach.ui  Postfach
    view_compose.ui   Nachricht verfassen
    view_users.ui     Benutzerverwaltung
    view_newuser.ui   Neuer Mitarbeiter
    view_resetpw.ui   Passwort zurücksetzen
    view_changepw.ui  Passwort ändern
    view_books.ui     Bücherverwaltung
    view_newbook.ui   Neues Buch (Feld-Editor)
    view_sort.ui      Sortierung
    view_print.ui     Daten drucken (Datenbuch/Mitarbeiterliste)
    window_about.ui   "Copyright"
    window_productinfo.ui  "Über Noctua"
    window_support.ui "Support"
    style.css         EINE gemeinsame Stylesheet-Datei (hell + dunkel)
  assets/  Medien (via GResource gebündelt)
    client_logo.svg     AUSTAUSCHBAR – Kundenlogo (White-Labeling)
    nexiscare_fixed.svg  Herausgeberlogo (NexisCare) für Copyright/License
    resources.gresource.xml
  packaging/  Debian-Control + Windows-NSIS-Installer
  build.sh    Build (--deb | --win | --all | --run)
  CMakeLists.txt  Plattformunabhängige Build-Konfiguration

Umgesetzte Funktionen (unverändert, 1:1)
----------------------------------------
  • EIN Programmfenster für alles (Intro, Login/Einrichten, Datenbuch,
    Postfach, Verwaltung, Formulare). Nur die Info-Dialoge sind separat.
  • Helles Standard-Design; dunkles Design optional (Info -> Design)
  • Rahmenlose, abgerundete, verschiebbare Fenster mit Schatten
  • Mehrere frei definierbare Bücher mit eigenen Feldern + Pflichtfeldern
  • Eintrag mit unveränderlicher Eintragszeit; Uhrzeit optional (max 24 h)
  • Stornieren (durchgestrichen) und Löschen (nur Admin sichtbar), je mit
    Grund – nur durch Verfasser oder Admin
  • Sortierung umschaltbar (nur Admin)
  • Benutzer anlegen, sperren/aktivieren (nie löschen), Passwort-Reset,
    Pflichtwechsel beim 1. Login
  • SQLCipher-verschlüsselte DB; Masterpasswort hardware-gebunden lokal
  • Write-Locking + 30s-Polling; internes Postfach
  • PDF-Export (nur Admin): Mitarbeiterliste (Hochformat) und Datenbuch
    (komplett/monatsweise, Querformat) – wird nach Export direkt geöffnet
  • White-Labeling: Kundenlogo + Intro-Video austauschbar

Bauen
-----
  Linux:    ./build.sh --deb       (oder: cmake -B build && cmake --build build)
  Windows:  ./build.sh --win       (mingw-w64 + GTK4/SQLCipher-Runtime + NSIS)
  Start:    ./build.sh --run
  Selbsttest (headless): ./build/noctua --selftest   # 0 = OK

Grafik-Ordner & Werkzeuge
-------------------------
  assets/img/              alle Grafiken (Logos, noctua_icon.svg, icons/, .ico)
  tools/gen_ui.py          setzt texts.h-Texte in die .ui ein (Build-Schritt)
  tools/render_icons.sh    erzeugt PNG-Größen + noctua.ico aus dem SVG neu

Benötigte Build-Pakete (Debian/Ubuntu)
--------------------------------------
  sudo apt-get install libgtk-4-dev libsqlcipher-dev pkg-config \
                       build-essential cmake python3 librsvg2-bin
  # Laufzeit für SVG-Logos empfohlen: librsvg2-common
