- docs/rechnungs-systemgrenze.md: Systemgrenze, Anforderungsmatrix mit Belegen (Tests) und offenen Freigaben, Prüfliste Verbraucher/Verträge. Benannte Lücken: Leistungsdatum, Reverse-Charge-Hinweis, Archiv/GoBD, E-Rechnung, Widerrufsbelehrung, AGB/Datenschutz/Impressum-Links. Keine rechtliche Freigabe behauptet. - ADR 0004 (Eigenbau statt Invoice Ninja), docs/rechnungen.md aktualisiert. - docs/offene-punkte.md: nur aktuelle Entscheidungen/Zugänge mit Verantwortlichem, Abhängigkeit, Abschlusskriterium und Plane-Verweis. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
parent
7ece71407b
commit
87e2a2038b
4 changed files with 100 additions and 6 deletions
8
docs/adr/0004-rechnungen-eigenbau.md
Normal file
8
docs/adr/0004-rechnungen-eigenbau.md
Normal file
|
|
@ -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.
|
||||
29
docs/offene-punkte.md
Normal file
29
docs/offene-punkte.md
Normal file
|
|
@ -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 |
|
||||
|
|
@ -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.
|
||||
|
|
|
|||
56
docs/rechnungs-systemgrenze.md
Normal file
56
docs/rechnungs-systemgrenze.md
Normal file
|
|
@ -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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue