belegt

mcp
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: AGPL-3.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Basarisiz
  • spawnSync — Synchronous process spawning in deploy/app-rolle.test.ts
  • process.env — Environment variable access in deploy/app-rolle.test.ts
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Self-hosted document archive with GoBD mode: emails, e-invoices (ZUGFeRD, XRechnung), scans with OCR and any file, immutable until retention ends. Selbst gehostetes, revisionssicheres Dokumentenarchiv nach GoBD mit Prüferzugang, Hash-Kette und RFC-3161-Zeitstempel.

README.md

Belegt: Dokumentenarchiv mit GoBD-Modus, selbst gehostet

Belegt ist, was du beweisen kannst.

Mails, E-Rechnungen, Scans und beliebige Dokumente an einem Ort, durchsuchbar, auf deinem Server. Was aufbewahrt
werden muss, bleibt bis Fristende unverändert, und danach löschst du es nachweisbar.

Status: Beta
CI
Lizenz: AGPL-3.0
Doku
GoBD
E-Rechnung
RFC 3161
MCP
TypeScript
Bun
Hono
PostgreSQL

Rundgang in Bildern •
Warum? •
Funktionen •
Schnellstart •
FAQ •
Entwicklung

English: self-hosted document archive with a GoBD mode for German businesses: mails (IMAP, JMAP, Microsoft 365, Google, SMTP journal, PST), e-invoices (ZUGFeRD, XRechnung), scans with OCR and any other file, immutable until the end of the legal retention period, with auditor access and the data medium for tax audits. The app is in German and English; the documentation is in German.

Startseite von Belegt: Eingang, Archiv, offener Löschantrag, Sperre und Speicher, Fristen, Quellen, Zustand der Hash-Kette und eine gespeicherte Ansicht

[!WARNING]
Beta: Belegt wird noch stark weiterentwickelt. Vor jedem Update sichern
(Sichern); Migrationen lassen sich nicht zurückspielen.

Warum Belegt?

Wer ein Unternehmen führt, muss Rechnungen, Kontoauszüge und Geschäftsbriefe sechs, acht oder zehn Jahre aufbewahren,
unverändert und auffindbar, und der Betriebsprüfung zeigen können. Ein Ordner auf dem Server oder ein
Dokumentenmanagement reicht dafür selten: Dateien lassen sich ändern, und niemand weiß, wann was gelöscht werden darf.

  • Unveränderbar, wo es zählt: Siegel und Hash-Kette liegen in PostgreSQL, nicht nur in der App; auf Wunsch S3 mit
    Object Lock bis Fristende und ein täglicher Zeitstempel nach RFC 3161
  • Fristen statt Bauchgefühl: Belegt rechnet die Frist nach § 147 AO, sperrt bis dahin und lässt danach nur mit
    einer zweiten Person löschen; der Nachweis bleibt
  • Alles an einem Ort: Mails aus Postfach, Journal oder Outlook-Datei, E-Rechnungen, Scans mit Texterkennung und
    beliebige Dateien, durchsuchbar
  • Bereit für die Prüfung: Prüferzugang mit Zeitraum, Datenträger nach dem Beschreibungsstandard, Prüfbericht und
    eine Verfahrensdokumentation, die sich selbst aktuell hält
  • Offen für andere Programme: REST-API, Webhooks, MCP für KI-Assistenten, Anmeldung über OpenID Connect und
    Einbetten in ein Portal
  • Deine Daten bleiben bei dir: eigener Server, Geheimnisse verschlüsselt, KI-Vorschläge nur mit einem Modell auf
    deinem Server

Funktionen

Kurz je Bereich; die Details stehen auf der verlinkten Seite, alles auf einen Blick unter
Alle Funktionen.

Bereich Was Belegt kann
📥 Eingang Hochladen, Foto mit dem Handy, Teilen an die installierte App, Scanner per FTP mit Trennblättern, Postfächer per IMAP, JMAP, Microsoft 365 und Google, SMTP-Journal, EML, MBOX und PST
🔎 Suche Volltext in PDFs, Office-Dateien, Mails und Scans (Texterkennung), fortlaufende Archivnummer
🏷️ Ordnung Korrespondenten, Tags, Dokumenttypen und eigene Felder, Zuordnungsregeln und gelernte Vorschläge, gespeicherte Ansichten
🧾 E-Rechnungen XRechnung und ZUGFeRD erkannt, als Vorschlag zur Einordnung, auf Wunsch mit dem KoSIT-Validator geprüft
⏳ Fristen und Löschen Fristen nach § 147 AO, Sperren bei Außenprüfung oder Rechtsstreit, Löschen nach Fristende mit zweiter Person
🔒 Prüfung Siegel und Hash-Kette in PostgreSQL, Prüfbericht, Prüferzugang (Z1), Datenträger mit index.xml (Z3), Zeitstempel nach RFC 3161
📘 Verfahrensdokumentation Aus dem tatsächlichen Stand erzeugt, mit deinen Angaben und den Lücken, die noch fehlen
⚙️ Workflows Tags, Typ, Felder, Notiz, Webhook oder Original an eine Adresse, wenn ein Dokument ankommt oder eingeordnet wird
🔌 Schnittstellen REST-API mit OpenAPI, API-Tokens, signierte Webhooks, MCP für Claude und andere Assistenten
🔐 Zugänge Inhaber, Steuerberatung, Prüfer und Mitarbeiter mit Sichtbereich, zweiter Faktor, OpenID Connect und Einbetten, Teilen per Link
📦 Umzug Aus Paperless-ngx über die API oder einen Export, mit Tags, Feldern und Notizen
🌍 Oberfläche Deutsch und Englisch, hell, dunkel oder nach dem Gerät, als App installierbar, gegen WCAG 2.2 AA geprüft

Screenshots

Archiv mit der Suche nach „Rechnung“: Mail, XRechnung, Rechnung des Holzhandels und Stromrechnung mit Korrespondent, Typ, Tags und Frist
Suche: Volltext mit Filtern und Tags
ZUGFeRD-Rechnung mit PDF-Vorschau, Nummer, Datum, Verkäufer, Gesamtbetrag, Prüfung gültig und Vorschlag zur Einordnung
E-Rechnung: erkannt, geprüft und vorgeschlagen
Fristen nach § 147 AO mit einem offenen Löschantrag, der auf die zweite Person wartet
Fristen: Löschen mit zweiter Person
Prüfung: Kette intakt, Prüfbericht mit Prüfwert und Datenträger für die Betriebsprüfung
Prüfung: Prüfbericht und Datenträger (Z3)

Mehr im Rundgang in Bildern.

Schnellstart

Belegt läuft als Container (tristanteu/belegt, amd64 und arm64) neben PostgreSQL; ein zweiter Container aus demselben
Image ruft Postfächer ab, liest Text und stellt Webhooks zu. Du brauchst einen Server mit Docker oder Podman. Die
Images erscheinen mit dem ersten Release auf Docker Hub und GHCR.

mkdir belegt && cd belegt
curl -O https://raw.githubusercontent.com/Speicherstadt/belegt/main/deploy/compose.yml
curl -o .env https://raw.githubusercontent.com/Speicherstadt/belegt/main/deploy/compose.env.example
chmod 600 .env

Trag in .env die Geheimnisse ein (POSTGRES_PASSWORD, APP_DB_PASSWORD, BETTER_AUTH_SECRET,
BELEGT_SCHLUESSEL); die App arbeitet dann mit einer eigenen Datenbankrolle, die keine Sperre abschalten kann. Dann:

docker compose up -d
docker compose logs server

Mit dem Einrichtungscode aus dem Log legst du unter BELEGT_URL (Port 3000) das erste Konto an, den Inhaber. Weitere
Dienste sind Profile (docker compose --profile <name> up -d): https (Caddy), backup (tägliche Sicherung mit
Test-Restore), journal (SMTP-Journal), ftp (für Scanner), validator (E-Rechnungen prüfen), vorschau
(Office-Dateien als PDF) und ki (Sprachmodell). S3, Zeitstempel, Microsoft 365, Google und OpenID Connect stehen in
Installation und Betrieb.

[!IMPORTANT]
Sichere BELEGT_SCHLUESSEL zusätzlich an einem zweiten Ort. Ohne ihn lassen sich Postfach-Passwörter,
Refresh-Tokens und Webhook-Geheimnisse nach einer Wiederherstellung nicht mehr lesen.

FAQ

Ist Belegt GoBD-konform?

Belegt setzt die technischen Anforderungen um: Unveränderbarkeit per Datenbank, Hash-Kette, Fristen, Löschen mit
Nachweis, Prüferzugang und Datenträger. Zur Ordnungsmäßigkeit gehören außerdem dein Betrieb (Sicherung, Zugänge,
Abläufe) und deine Verfahrensdokumentation. Ein Testat für die Software gibt es nicht; was eine Prüfung braucht, steht
in Unterlagen für ein Testat.

Ist das ein Dokumentenmanagement wie paperless?

Es kann das Gleiche (hochladen, Texterkennung, Suche, einordnen), aber mit einem anderen Ziel: Belegt beweist, dass ein
Dokument seit dem Eingang unverändert ist, und weiß, wie lange es aufbewahrt werden muss. Was nicht aufbewahrt werden
muss, legst du „frei“ ab und löschst es, wann du willst. Aus Paperless-ngx ziehst du mit allen Dokumenten, Tags,
Feldern und Notizen um, siehe Von Paperless-ngx zu Belegt.

Kann ich Mails aus Microsoft 365, Google oder Outlook archivieren?

Ja: Postfächer per OAuth (Microsoft 365, Google), IMAP oder JMAP abrufen, alle Mails per SMTP-Journal vom Mailserver
bekommen, oder eine PST-Datei aus Outlook importieren. Siehe
Eingang, Mails und Suche.

Wo liegen meine Dokumente, und was sieht eine KI?

Auf deinem Server, im Dateisystem oder in deinem S3-Bucket. Vorschläge eines Sprachmodells gibt es nur, wenn du eines
einrichtest, und es gehört auf deinen eigenen Server (etwa Ollama); die Verfahrensdokumentation nennt Modell, Server
und was es bekommt.

Kann meine Steuerberatung oder die Betriebsprüfung damit arbeiten?

Ja, über eine Einladung: Die Steuerberatung liest und bestätigt Löschungen als zweite Person; ein Prüfer sieht nur
Dokumente seines Zeitraums und lädt den Datenträger herunter. Mitarbeiter sehen nur Dokumente bestimmter Tags, Typen
oder Korrespondenten und ordnen sie auf Wunsch ein. Siehe Prüfung, Z1 und Z3
und Zugänge.

Kann ich Claude oder andere Programme anbinden?

Ja: per MCP suchen und lesen KI-Assistenten im Archiv, mit dem Recht „schreiben“ nehmen sie auch auf und ordnen ein;
löschen kann keiner. Für eigene Programme gibt es REST-API, Webhooks und API-Tokens. Siehe
Schnittstellen.

Was kostet Belegt?

Die Software ist kostenlos (AGPL-3.0). Du brauchst nur einen Server.

Entwicklung

Voraussetzungen: Bun 1.4.4, PostgreSQL. Befehle, Tests und Umgebungsvariablen stehen in
Entwicklung, wie du mitmachst, in
CONTRIBUTING.md. Sicherheitslücken bitte privat melden, siehe SECURITY.md.

bun install
bun run dev:server   # Server auf Port 3000
bun run dev:app      # Oberfläche mit Vite
bun run test         # Vitest, mit TEST_DATABASE_URL auch gegen PostgreSQL
bun run e2e          # Playwright mit axe gegen einen echten Server

Belegt nutzt den GoBD-Kern (@firsttris/gobd-kern) aus Haben, der
Open-Source-Buchhaltung desselben Projekts.

Sterne im Verlauf

Verlauf der GitHub-Sterne von Belegt

⭐ Gefällt dir Belegt? Ein Stern auf GitHub hilft anderen, es zu finden.

🐛 Fehler melden · 💡 Idee vorschlagen · 🔒 Sicherheitslücke melden

Lizenz: AGPL-3.0 · © Tristan Teufel und Mitwirkende

Wer Belegt für andere betreibt, muss ihnen den Quellcode anbieten.

Belegt ist keine Steuer- oder Rechtsberatung. Aufbewahrung und Verfahrensdokumentation vor dem Echtbetrieb mit deiner Steuerberatung abgleichen.

Yorumlar (0)

Sonuc bulunamadi