FRAG Rechnungssoftware – technischer Starter
============================================

WICHTIG
- Dies ist ein MVP-/Starterprojekt, keine geprüfte, produktionsreife Buchhaltungssoftware.
- Vor produktiver Nutzung müssen Sicherheit, steuerliche Regeln, PDF-Archivierung und E-Mail-Versand getestet werden.
- Das initiale Passwort NICHT fest im Code hinterlegen. Nach Installation einen Admin über install/create_admin.php anlegen und sofort ein individuelles Passwort setzen.
- Dieses Paket verwendet die Browser-Druckfunktion für die erste PDF-Ausgabe (Drucken > Als PDF speichern). Der automatische SMTP-PDF-Anhang ist als nächste Ausbaustufe vorgesehen, weil dafür eine PDF-Bibliothek (z. B. Dompdf) und PHPMailer sauber installiert werden müssen.

Voraussetzungen
- Lima-City Webspace mit PHP 8.x und MySQL 8
- HTTPS aktiviert
- Datenbank und Datenbankbenutzer bereits in Lima-City angelegt

Einrichtung
1. Lege eine Datenbank und einen Datenbankbenutzer in der Lima-City-Verwaltung an.
2. Importiere database/schema.sql über phpMyAdmin.
3. Kopiere app/config.example.php nach app/config.php und trage Datenbankzugangsdaten ein.
4. Setze APP_BASE_URL auf die HTTPS-Adresse deiner Installation.
5. Lade FRAG-Logo als assets/frag-logo.svg hoch.
6. Stelle sicher, dass app/, storage/ und install/ nicht öffentlich erreichbar sind. Empfohlen: Webroot zeigt auf public/. Falls Lima-City nur einen anderen Dokumentenstamm erlaubt, sichere diese Verzeichnisse per .htaccess und teste die Sperre.
7. Öffne /install/create_admin.php einmalig, erstelle einen Admin und lösche danach den Ordner install vollständig.
8. Melde dich an, ändere das Startpasswort sofort und lege persönliche Benutzerkonten mit passenden Rollen an.

Rollen
- admin: vollständige Verwaltung
- finance: Kunden, Angebote, Rechnungen, Zahlungen
- viewer: nur lesender Zugriff (in dieser Starterversion noch nicht vollständig ausgebaut)

Sicherheit
- Passwörter werden mit password_hash() gespeichert.
- PDO prepared statements werden für Datenbankabfragen verwendet.
- CSRF-Token sind für schreibende Formulare vorgesehen.
- Verwende niemals dasselbe Konto für alle Personen.
- Speichere keine medizinischen Patientendaten in diesem Abrechnungssystem.
- Backups getrennt vom Webspace aufbewahren.
- Fehlerdetails nicht öffentlich ausgeben.

Steuern und Recht
- Steuerstatus ist als konfigurierbare Einstellung angelegt, standardmäßig „ungeklärt“.
- Keine Steuerregel aktivieren, bevor die steuerliche Behandlung des Vereins geklärt ist.
- Nummernkreis, Storno/Änderungsprotokoll und revisionssichere Archivierung müssen vor produktivem Einsatz weiterentwickelt und geprüft werden.

Designhinweis: Die Dokumentenvorlage wurde an die Referenz-PDF angelehnt: dunkler Kopfbereich, roter geschwungener Akzent, Absender links, FRAG-Logo rechts, Empfänger links, Dokumentdaten rechts, schlichte Positionsliste und kompakte Fußzeile. Für exakte Druckfarben im Browser beim Drucken 'Hintergrundgrafiken' aktivieren.