Skip to content

notariat8/NaC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

212 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

NaC: Notariat as Code

NaC ist ein öffentliches Referenz- und Produktkern-Repository für den AI-first-Betrieb notarieller Vorgangsarten. Ein Notariat soll dieses Repository klonen, prüfen und als Vorlage für einen privaten, eigenen Betriebs-Fork nutzen können.

Der Kern ist einfach: KI hilft beim Strukturieren, Menschen entscheiden, Git dokumentiert, Python prüft, und echte Mandatsdaten bleiben außerhalb dieses öffentlichen Repositories.

NaC ist zugleich als Grundlage für ein auditierbares Qualitätsmanagementsystem gedacht: Die QMS-/ISO-9001-Schicht ordnet Prozesse, Rollen, Qualitätsziele, interne Audits, Abweichungen und Nachweise so, dass ein Notariat daraus eine spätere ISO-9001-Prüfung vorbereiten kann.

Herausgeber und Maintainer: ofunk. Weitere Einordnung steht in HERAUSGEBER.md.

Deutsch ist repo-weit die führende Sprache für menschlich lesbare Inhalte. Englisch ist Pflichtsprache für lokalisierte Spiegel, aber nur Übersetzung oder Orientierung. Für deutsches Recht und notarielle Usecases ist Deutsch führend und rechtlich bindend. Die verbindliche Sprachregel steht in policies/language-policy.yaml und wird mit scripts/validate_language_parity.py geprüft.

Für Wen

Zielgruppe Einstieg Worum es geht
Notariat und fachliche Entscheidung docs/de/notar-start.md Nutzen, Grenzen, Datenschutz, erster Prüflauf und Entscheidung, ob ein privater Fork sinnvoll ist.
Office-Admin und IT-Betrieb docs/de/betriebsstart.md Klonen, lokale Checks, private Betriebsumgebung, Rollen, Arbeitsplatz- und Plugin-Voraussetzungen.
Fachsystem- und Integrationsseite docs/de/integration-start.md Wie bestehende Fachsysteme, lokale Middleware, Portale und Connectoren an NaC angebunden werden können.
Prüfung, QMS und Standardisierung docs/de/pruefung-standardisierung-start.md Wie Kontroll-, Nachweis-, ISO-9001-, Zertifizierungs- und Standardisierungsfragen am Repo nachvollzogen werden.
Entwicklung und Maintainer docs/de/START_HERE.md Verbindlicher Arbeitsstart für Code, Policies, Plugins, Workflows, Usecases und Agenten.

Schnelle Orientierung für Nicht-Technik: NaC-CLI, Ausführungsmodell, QMS-/ISO-9001-Schicht, Reifegrad, Regelarchitektur, Glossar und Beispiel Immobilienkaufvertrag.

Englische Orientierung: docs/en/notar-start.md, docs/en/betriebsstart.md, docs/en/integration-start.md, docs/en/pruefung-standardisierung-start.md.

Was Dieses Repo Leistet

  • Es beschreibt notarielle Vorgangsarten als versionierte, prüfbare Usecases.
  • Es trennt öffentliche Muster, private Notariatsdaten und lokale Fachsysteme.
  • Es stellt Plugins, Workflow-Verträge und deterministische Python-Prüfungen für AI-first-Betrieb bereit.
  • Es bereitet eine QMS-/ISO-9001-Schicht vor, die Qualitätsziele, Rollen, Prozesslandkarte, interne Audits und Nachweise versioniert greifbar macht.
  • Es macht Freigaben, offene Fragen, technische Readiness, Datenschutzgrenzen und Nachweise nachvollziehbar.
  • Es verhindert im Musterrepo echte personenbezogene Daten, Secrets, PINs, Registerauszüge oder Mandatsdokumente.

Was Es Bewusst Nicht Leistet

  • NaC ersetzt kein vorgeschriebenes Fachsystem und keine berufsrechtliche Verantwortung.
  • NaC ist keine automatische Rechtsberatung und keine autonome Beurkundung.
  • Öffentliche Repository-Dateien sind keine Ablage für echte Akten, Ausweisdaten, Registerauszüge, Zahlungsdaten oder Signaturgeheimnisse.
  • Produktive Nutzung braucht einen privaten Fork, lokale Rollen, Freigaben, Datenschutzklärung und einen geprüften Arbeitsplatz.

Produktstruktur

Dieses Repository trennt vier Produktbereiche:

  • plugins/: installierbare Plugin-Artefakte für GPT-Store-Prüfung, Workspace-Installation oder lokale Integration.
  • workflows/: wiederverwendbare Notariats-Workflows, getrennt nach installierbaren Skills, Workflow-Verträgen und deterministischer Python-Ausführung.
  • usecases/: konkrete notarielle Vorgangsarten wie Online-GmbH-Gründung, Immobilienkaufvertrag, Handelsregisteranmeldung oder Testament. Jeder Usecase besitzt seine eigene statische KG/DB für offene Fragen, Dokumente, Entscheidungen, Gates und Nachweisreferenzen.
  • qms/: QMS-/ISO-9001-Schicht mit Qualitätspolitik, Qualitätszielen, Prozesslandkarte, Rollen, Auditprogramm, Abweichungsschema und Managementbewertung.

Weitere Dokumentation:

Erster Blick Nach Dem Klonen

NaC soll zuerst als lokale Büroarbeitsfläche verständlich werden. Der schnellste Einstieg ist deshalb die Operator-Webapp:

python scripts/nac.py operator --open

Sie öffnet eine lokale Oberfläche mit Vorgangsauswahl, Checklisten, BPMN-Abläufen, Bearbeitungsansicht und Arbeitsplatztests. Wer die Webapp nicht öffnen kann, findet eine bebilderte Erklärung unter docs/de/webapp-ohne-zugriff.md.

Wenn Python noch nicht eingerichtet ist, zuerst docs/de/minimum-requirements.md lesen.

Bedienmodell

NaC wird als ausführbare lokale Software entwickelt. Für das Notariat ist die sichtbare Bedienung die lokale Bürooberfläche. Die technische Steuer- und Prüfschicht dahinter heißt nac.

Nutzerfrage Einstieg
Ich will sehen, wie ein Vorgang aussieht. python scripts/nac.py operator --open
Ich will prüfen, ob das Repo gesund ist. python scripts/nac.py doctor --profile strict
Ich will wissen, welche Modelle und Usecases vorhanden sind. python scripts/nac.py status
Ich will BPMN, KG oder Anbindungen automatisiert prüfen. python scripts/nac.py bpmn validate, python scripts/nac.py kg status, python scripts/nac.py plugins status, python scripts/nac.py plugins actions
Ich will Akten-/Demo-Daten getrennt vom Produktrepo schreiben und lesen. nac tenant status --repo ../demo8notariat, nac tenant write-sample-akte --repo ../demo8notariat, nac tenant list-akten --repo ../demo8notariat, nac tenant show-akte --repo ../demo8notariat --akten-id UVZ-2026-0001
Ich will ISO-9001/QMS-Nachweise vorbereiten. python scripts/nac.py qms status, python scripts/nac.py qms evidence --repo ../demo8notariat

Nach einer lokalen Installation aus dem Repo kann statt python scripts/nac.py auch der kurze Befehl nac verwendet werden.

Wichtig: Die Webapp und spätere Buttons sind die Oberfläche. nac bleibt die prüfbare Ausführungsschicht, damit dieselben Aktionen lokal, in Tests, in Codex und später in CI nachvollziehbar bleiben. Alte Skriptnamen dürfen intern weiter existieren; Produktdokumentation und neue Funktionen sollen aber über verständliche Webapp-Flächen oder nac erreichbar sein.

Die Operator-Webapp bindet standardmäßig nur an 127.0.0.1. Lokale Arbeitsplatztests dürfen freigegebene Prüfskripte ausführen, speichern aber keine PINs, Kartenrohdaten, Zugangsdaten oder Mandatsdaten.

Das aktive Build-Board wird in roadmap/BUILD_NOW.md gepflegt.

Lizenz Und Attribution

NaC ist maximal offen und zugleich schützend lizenziert:

  • Code, Plugins, Workflows, Validatoren, Schemas und ausführbare Beispiele: AGPL-3.0-or-later
  • Dokumentation, Diagramme, Policies, Roadmap, Prompts und fachliche Usecases: CC-BY-4.0

Die verbindliche Zuordnung steht in LICENSES/README.md. Bitte bei Forks, öffentlichen Deployments, Präsentationen und abgeleiteten Unterlagen sichtbar nennen:

Based on NaC: Notariat as Code by funktion8 / ofunk (https://github.com/notariat8/NaC).

Weitere Hinweise: NOTICE, AUTHORS.md, CITATION.cff und TRADEMARK.md.

Push- Und Qualitätsregel

Jeder Push muss roadmap/GANTT.md aktualisieren. Änderungen unter plugins/, workflows/ oder usecases/ müssen zusätzlich das jeweilige Themen-Gantt aktualisieren.

Das strikte Quality Gate prüft Prozessdateien, Tests, Datenschutzregeln, Governance-Sync, Sprachregeln, Cloud-Runbook-Parität, Plugin-Manifeste, AI-SBOM-Stand, Gantt-Pflege, die usecase-lokalen statischen Knowledge Graphs und den KG-Editor-Vertrag.

About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors