diff --git a/docs/adr/0004-rechnungen-eigenbau.md b/docs/adr/0004-rechnungen-eigenbau.md new file mode 100644 index 0000000..8a891b3 --- /dev/null +++ b/docs/adr/0004-rechnungen-eigenbau.md @@ -0,0 +1,8 @@ +# ADR 0004: Rechnungen im Kundencenter selbst erzeugen (kein Invoice Ninja) +Status: angenommen (Entscheidung Björn, 26.09.2026; dokumentiert 06.10.2026) + +**Kontext:** Ursprünglich war Invoice Ninja als externes Rechnungssystem vorgesehen. Für ein kleines Hosting-/Lizenzgeschäft ist ein zweites System mit eigener Kunden- und Produktpflege doppelte Arbeit und eine zusätzliche Angriffsfläche. + +**Entscheidung:** Rechnungen entstehen im Modul `invoices` des Kundencenters (Entwurf → Ausstellen → bezahlt/Storno), fortlaufende Nummern, Snapshots von Absender/Empfänger, Storno statt Änderung, PDF, DATEV-Export, Abrechnungslauf aus Verträgen. + +**Folgen:** Rechts- und Steuerpflichten (Pflichtangaben, Archivierung/GoBD, E-Rechnung) liegen jetzt beim Kundencenter. Offene fachliche Freigaben und bekannte Lücken stehen in `docs/rechnungs-systemgrenze.md`; vor dem Versand an echte Kunden ist eine Prüfung durch Steuerberatung nötig. Ein externes System bleibt über Export/Connector später anbindbar. diff --git a/docs/offene-punkte.md b/docs/offene-punkte.md new file mode 100644 index 0000000..5fbb7d1 --- /dev/null +++ b/docs/offene-punkte.md @@ -0,0 +1,29 @@ +# Offene Punkte: Entscheidungen, Zugänge, Freigaben + +Stand: 06.10.2026. Nur **aktuelle** Punkte; Erledigtes steht in Plane (Projekt Kundencenter). Keine Geheimnisse in dieser Datei – Zugänge werden nur benannt, nie eingetragen. + +Überholt und entfernt: Invoice Ninja (Eigenbau-Rechnungen, #5), Zielhost/Domain (live unter kundencenter.flessinglabs.com), SMTP/IMAP/Discord (eingerichtet), Plesk-Connector (umgesetzt, #129–#131), KeyHelp-Verbindung (live), Lizenzsystem-Erweiterung um Health/Service-Token/Lifecycle (umgesetzt), Installationslizenz (hinterlegt, gültig). + +| # | Punkt | Verantwortlich | Abhängigkeit | Abschlusskriterium | Plane | +|---|---|---|---|---|---| +| 1 | Lizenzmodell der Installation: Planmatrix (Kunden-/Personal-Grenzen), Modul-IDs, Trial-Länge/-Einmaligkeit, Verhalten nach Ablauf | Björn | – | freigegebene Matrix im Ticket; danach Gates in API+Worker (#116) und Paketanzeige (#117) | #113 | +| 2 | Preise und Bundles der Installationslizenz | Björn | 1 | Preisliste/Bundles im Ticket | #117 | +| 3 | Zuordnung KC-Produkte → Produkt-IDs im Lizenzsystem, Freigabe von Testbestellungen | Björn | – | Mapping-Tabelle im Ticket, je Edition eine Testbestellung | #63 | +| 4 | Service-Token für die Licensing-Verbindung anlegen und eintragen | Björn (Secret) | – | Verbindung nutzt Bearer-Token, Lese-/Schreibprobe ok, Benutzer/Passwort entfernt | #60, #43 | +| 5 | KCS-Preisbasis (brutto/netto) mit einem Beleg bestätigen | Björn | – | eine Belegzeile centgenau nachgerechnet, Entscheidung im Ticket | #79 | +| 6 | KCS/supportdomain.de Reseller-API (Doku, Testzugang, Funktionen) | Björn → KCS | – | Anbieterdokumentation liegt vor; bis dahin CSV + manueller Status | #78 | +| 7 | Backup: Passwort/Schlüssel getrennt vom Server und Ziel verwahrt (Bestätigung) | Björn | – | Bestätigung im Ticket (ohne Wert); Serververlust-Szenario dokumentiert | #65 | +| 8 | Licensing-Backup/-Restore (KeyHelp-Backup umfasst DB + Signaturschlüssel?) | Björn / Codex | – | Restore-Nachweis im Licensing-Projekt | #66 | +| 9 | Zahlungsregeln: was gilt als bezahlt, Teilzahlung, Karenz, Kulanz, Überzahlung | Björn | – | Regeln im Ticket; danach Zahlungsprüfung vor Verlängerung | #56 | +| 10 | Editionswechsel: Preis-/Laufzeitregel, Downgrade, Aktivierungen | Björn | 3 | Regeln im Ticket | #58 | +| 11 | Zahlungsanbieter (Stripe/Mollie/PayPal/nur Überweisung) | Björn | 9 | Entscheidung im Ticket | #22 | +| 12 | Rechtliche/steuerliche Prüfung: Rechnungsangaben, E-Rechnung, Archiv/GoBD, Verbraucherrecht | Björn → Steuerberatung/Recht | – | je Zeile der Prüfliste (`docs/rechnungs-systemgrenze.md`) Freigabe mit Name/Datum | #26, #49 | +| 13 | KeyHelp-Testkonto für schreibende Grenzfalltests | Björn | – | Kontoname im Ticket | #4, #73 | +| 14 | Priorität KeyHelp-Zusatzfunktionen (DNS, Cron, Verzeichnisschutz, Zertifikat, Fail2Ban, Backup-Liste) | Björn | 13 | priorisierte Liste | #74 | +| 15 | Selbstregistrierung: gewünscht? Pflichtfelder, Freischaltung | Björn | – | Entscheidung im Ticket | #36 | +| 16 | Domainbestellung zusammen mit Hosting: Regeln (einzeln bestellbar? Laufzeit?) | Björn | 6 | Entscheidung im Ticket | #80 | +| 17 | Familytool-Add-on-IDs und Laufzeiten | Björn / Codex | – | IDs aus dem Familytool bestätigt | #57 | +| 18 | Forge: Token für Push/PR, Actions-Runner registrieren | Björn | – | Commits auf der Forge, CI-Läufe sichtbar | #96, #114 | +| 19 | Licensing-Source ↔ Forge synchronisieren (separates Repo, zweite Sitzung) | Codex / Björn | 18 | Server-Commit = Forge, INTEGRATION.md ohne Schlüssel | #114 | +| 20 | Connector-Ziele: Host-Allowlist (SSRF-Restrisiko) gewünscht? | Björn | – | Entscheidung; ggf. Allowlist je Verbindung | #10 | +| 21 | Automatischer Abrechnungslauf einschalten? | Björn | – | Schalter unter Einstellungen → Firma bewusst gesetzt | #50 | diff --git a/docs/rechnungen.md b/docs/rechnungen.md index e612eeb..9ddd005 100644 --- a/docs/rechnungen.md +++ b/docs/rechnungen.md @@ -40,10 +40,11 @@ vorhandenen Daten ableitbar (Rechnungsnummer, Datum, Leistungsbeschreibung, Entg Position, Steuernummer/USt-IdNr., Empfängeranschrift). **Keine rechtliche Prüfung durch einen Steuerberater/Anwalt hat stattgefunden** – vor dem ersten Versand an echte Kunden empfohlen. +## Abrechnungslauf (#50) +Fällige Vertragsperioden werden als **Entwürfe** angelegt (Rechnungen → Fällig → „Entwürfe anlegen“, optional automatisch alle 6 h über Einstellungen → Firma). Jede Periode genau einmal (`invoice_billing_periods`); gelöschter Entwurf gibt sie frei, Storno hält sie belegt bis „Perioden erneut abrechnen“. Details: `docs/rechnungs-systemgrenze.md`, `packages/platform/src/billing.ts`. + +## Versand +Beim Ausstellen geht eine Mail (Vorlage `invoice_issued`) mit Link an die Rechnungsadresse des Kunden; das PDF selbst wird nicht angehängt, sondern im Kundencenter abgerufen. + ## Offen / bewusst nicht gebaut -- Kein Zahlungsanbieter (SEPA-Lastschrift, Kartenzahlung, …) – Entscheidung steht aus. -- Keine automatische Rechnungsstellung aus Verträgen (wiederkehrend); es gibt nur - `GET /invoices/suggest-from-contract/:id` als Vorschlag für eine einzelne Position, die man von - Hand übernimmt. -- Kein E-Mail-Versand der Rechnung (liegt nur zum Abruf bereit, wie beim Lizenzschlüssel-Muster). -- Keine E-Rechnung (XRechnung/ZUGFeRD) – falls das für B2B mit Behörden nötig wird, gesondert klären. +Siehe Anforderungsmatrix und Prüfliste in `docs/rechnungs-systemgrenze.md` (u. a. Leistungsdatum als eigenes Feld, Reverse-Charge-Hinweis, Archivkonzept/GoBD, E-Rechnung, Zahlungsanbieter, Mahnstufen). Keine rechtliche Freigabe erfolgt. diff --git a/docs/rechnungs-systemgrenze.md b/docs/rechnungs-systemgrenze.md new file mode 100644 index 0000000..b1f7cdd --- /dev/null +++ b/docs/rechnungs-systemgrenze.md @@ -0,0 +1,56 @@ +# Rechnungen: Systemgrenze, Anforderungen und fachliche Prüfliste + +Stand: 06.10.2026. Bündelt Plane #5 (Systemgrenze), #26 (Anforderungen/Rechtsprüfliste) und #49 (rechtliche Prüfung Produkte/Verträge). Entscheidung: ADR 0004. Bedienung und Lebenszyklus: `docs/rechnungen.md`. + +> **Wichtig:** Dieses Dokument ist eine technische Bestandsaufnahme. Es enthält **keine** rechtliche oder steuerliche Freigabe. Jede Zeile mit „Freigabe offen“ braucht eine verantwortliche Person (Steuerberatung/Recht) mit Datum, bevor das Kundencenter echte Rechnungen an Kunden versendet bzw. Verträge mit Verbrauchern schließt. + +## 1. Systemgrenze + +| Liegt im Kundencenter | Liegt außerhalb | +|---|---| +| Rechnungserzeugung (Entwurf → Ausstellen), fortlaufender Nummernkreis | Buchhaltung/Finanzbuchhaltung (Übergabe per DATEV-Export) | +| Steuerberechnung je Position (Steuersatz aus Produkt/Katalog), Summen in Cent | Steuerliche Beurteilung einzelner Fälle (Steuerberatung) | +| Unveränderlichkeit ab Ausstellen, Storno als eigene Rechnung, Snapshots von Absender/Empfänger | Langzeitarchiv nach GoBD (revisionssicher, 8/10 Jahre) – **offen**, s. u. | +| PDF-Erzeugung, Mail mit Link an die Rechnungsadresse | E-Rechnung (XRechnung/ZUGFeRD) – **nicht umgesetzt** | +| Abrechnungslauf aus Verträgen (nur Entwürfe), Mahnüberblick | Zahlungsabwicklung (Zahlungsanbieter offen), Bankabgleich | +| DATEV-/CSV-Export, PDF-ZIP | Mahngebühren/Inkasso | + +Austauschbarkeit: Die Rechnungslogik liegt im Modul `invoices` und in `platform/billing.ts`; ein externes Rechnungssystem könnte später über einen Export/Connector angebunden werden, ohne Verträge/Bestellungen umzubauen. Invoice Ninja ist **keine** Voraussetzung mehr (überholt). + +## 2. Anforderungsmatrix (Ist-Stand mit Beleg) + +| Anforderung | Stand | Beleg | Fachliche Freigabe | +|---|---|---|---| +| Fortlaufende, einmalige Rechnungsnummer | umgesetzt, lückenlos über alle Jahre (`RE-1000…`), Vergabe erst beim Ausstellen | `invoices.test.ts` „Gleichzeitiges Ausstellen … keine Nummernlücke“ | offen (Nummernkreis-Konzept bestätigen) | +| Pflichtangaben § 14 Abs. 4 UStG: Name/Anschrift Leistender und Empfänger | umgesetzt (Snapshot beim Ausstellen) | `invoices.test.ts` „friert Firmen- und Kundendaten ein“ | offen | +| Steuernummer oder USt-IdNr. des Leistenden | umgesetzt (Pflicht vor dem Ausstellen) | `COMPANY_SETTINGS_INCOMPLETE` | offen | +| Ausstellungsdatum | umgesetzt | PDF | offen | +| **Zeitpunkt/Zeitraum der Leistung** | nur teilweise: Abrechnungslauf schreibt den Zeitraum in die Positionsbeschreibung; bei Handrechnungen kein eigenes Feld | `platform/billing.ts` | **offen – Lücke**: eigenes Feld „Leistungsdatum/-zeitraum“ oder Hinweis „Leistungsdatum = Rechnungsdatum“? | +| Menge/Art der Leistung, Entgelt nach Steuersätzen, Steuerbetrag | umgesetzt je Position und Summe | PDF, `invoices.test.ts` (Rabatt je Position) | offen | +| Hinweis Steuerbefreiung / Reverse Charge (§ 13b, EU-B2B) | **nicht umgesetzt** (0 % möglich, aber ohne Pflichthinweis) | – | **offen – Lücke**: kommen EU-B2B-Kunden vor? | +| Kleinbetragsrechnung / Kleinunternehmerregelung | nicht vorgesehen | – | offen (trifft vermutlich nicht zu) | +| Unveränderlichkeit, Storno statt Änderung | umgesetzt, auch bei Nebenläufigkeit | `invoices.test.ts` (#95) | offen | +| Aufbewahrung 8/10 Jahre, revisionssicher (GoBD) | Daten in MariaDB mit Backups; PDF wird bei Abruf neu erzeugt (aus Snapshots), **kein** separates unveränderliches Archiv, keine Verfahrensdokumentation | Backup/Restore-Test | **offen – Lücke**: Archivkonzept (PDF beim Ausstellen ablegen? WORM-Speicher? Verfahrensdokumentation) | +| E-Rechnung (Empfang Pflicht seit 2025, Versand B2B ab 2027/2028) | **nicht umgesetzt** | – | **offen**: ab wann Versand nötig (Umsatzgrenze), Format XRechnung oder ZUGFeRD | +| Zahlungszuordnung, Teilzahlung | nur „als bezahlt markieren“ | `invoices.test.ts` | offen (#56) | +| Mahnwesen | Überblick überfälliger Rechnungen, keine Mahnstufen/Gebühren | `/rechnungen/faellig` | offen (#56/#22) | +| Automatische Perioden aus Verträgen | umgesetzt als Entwürfe, je Periode genau einmal | `billing.test.ts` (#50) | offen (Schalter bewusst setzen) | +| DATEV-Export | umgesetzt (Buchungsstapel, SKR03/04) | Rechnungsexport | offen (mit Steuerberatung abstimmen: Konten, Festschreibung) | + +## 3. Rechtliche Prüfliste Produkte/Verträge (#49) + +| Thema | Technischer Stand | Zu klären / freizugeben | +|---|---|---| +| Verbraucherverträge (B2C): Laufzeit, Verlängerung, Kündigung | Verbraucherregel im Code: nach der Erstlaufzeit monatlich kündbar (`consumerTerms`), Kündigung jederzeit online (Kündigungsbutton), Erinnerung 30 Tage vor Laufzeitende | Freigabe der Texte und Fristen (§ 309 Nr. 9 BGB, § 312k BGB Kündigungsbutton) | +| Widerrufsrecht bei Online-Bestellung durch Verbraucher | **nicht abgebildet** (keine Widerrufsbelehrung, kein Muster-Widerrufsformular, kein Hinweis auf vorzeitigen Leistungsbeginn) | **Lücke** – Texte und Ablauf festlegen | +| Preisangaben gegenüber Verbrauchern (Brutto) | Preise je Produkt netto oder brutto pflegbar, Snapshot | Freigabe: Endpreise inkl. USt. im Bestellablauf | +| AGB, Datenschutzhinweise, Impressum im Kundencenter | **nicht vorhanden** – Fußzeile verlinkt nur flessinglabs.com | **Lücke** – Seiten/Links festlegen (Pflicht bei Kundenportal mit Bestellfunktion) | +| Auftragsverarbeitung (AVV) für Hosting-Kunden | nicht im System | Vorlage/Prozess klären | +| Domainpreise (Einkauf brutto/netto, Aufschlag) | Aufschlag 25 %, Basis brutto | Beleg (#79) | +| Lizenzverkauf (Software), Laufzeit/Verlängerung | über Licensing-Connector, Verlängerung ohne Zahlungsprüfung | Zahlungsregeln (#56), Editionswechsel (#58) | + +## 4. Nächste Schritte + +1. Björn übergibt Abschnitt 2 und 3 an Steuerberatung/Rechtsberatung; je Zeile Freigabe mit Name und Datum hier eintragen. +2. Lücken mit Entscheidung umsetzen: Leistungsdatum, Reverse-Charge-Hinweis (falls relevant), Archivkonzept, Widerrufsbelehrung. +3. E-Rechnung erst nach Entscheidung über Format und Zeitpunkt.