pv-agent/wissensbasis/README.md

Wissensbasis Personalverrechnung (Lexis360-Exporte + WIKU Personal)

Kuratierte Wissensbasis aus zwei lizenzierten Quellcorpora — den LexisNexis-Briefings des Werks Lexis Briefings Personalrecht (Export aus Lexis 360) und den WIKU-Personal-Publikationen (Fachbroschüren, Arbeitsunterlagen, Casebooks, Fachzeitschrift „WIKU Personal aktuell“). Ein gemeinsamer Korpus: work-Feld unterscheidet die Quellen, ID-Räume lb-* (Lexis) und wk-* (WIKU) liegen auf derselben Cluster-Map. Zweck:

1. Entwicklungsreferenz neben personalverrechnung/RECHTSQUELLEN-*.md für die Personalverrechnungsmodule (l10n_at_hr_payroll*), und
2. Copilot-Korpus: Aufbau und Frontmatter sind retrieval-gerecht (stabile IDs, maschinenlesbares kb.json), damit künftig ein Frage-Antwort-Copilot darauf aufbauen kann.

Schichten (Lizenz-Entscheidung D1, 2026-09-10)

Schicht	Pfad	Versioniert?	Inhalt
PDF-Exporte	.lexis360/Lexis360_*.pdf · .wiku/*.pdf	nein (gitignored)	lizensierte Original-PDFs
Layer 1 — Volltexte	.lexis360/md/<slug>.md · .wiku/md/<slug>.md	nein (gitignored)	vollständiger Extraktionstext + Metadaten-Frontmatter
Katalog	.lexis360/md/_catalog.json · .wiku/md/_catalog.json	nein (gitignored)	geparste Metadaten aller Quellen (Slug ↔ ID ↔ Stand ↔ Cluster)
Layer 2 — kuratierte Einträge	dokumente/<slug>.md (Lexis) · dokumente/wiku_<slug>.md (WIKU)	ja	Kuratierung in eigenen Worten (Schema unten)
Registry	personalverrechnung/wissensbasis/kb.json	ja	generiert aus dem Layer-2-Frontmatter beider Quellen (--registry)

Volltexte sind lizenzierter Inhalt (LexisNexis- bzw. WIKU-Abonnement) und bleiben wie .firecrawl/ lokal + unversioniert. Nur die Kuratierung (eigene Worte, kurze Zitate mit Quellenachweis) wird committet. WIKU-Publikationen haben keine Lexis-Breadcrumbs: Metadaten (Slug, Cluster, Stand, work, Kapitel, Titel) werden beim Intake als WIKU_PINS-Eintrag im Tool festgenagelt (1 Publikation = 1 Eintrag; Granularitätsentscheidung 2026-09-10).

Frontmatter-Schema (Layer 2 — verbindlich)

id: lb-atz-07                 # stabil; lb-<cluster>-<nn> (Lexis) bzw. wk-<cluster>-<nn> (WIKU), eingefroren
batch: 1                      # Beschaffungs-Batch je Quelle (manuell je Import)
title: "Altersteilzeit - Überblick"
work: "Lexis Briefings Personalrecht"   # WIKU: exakter Publikationstyp („WIKU Fachbroschüre“, „WIKU Arbeitsunterlage“, „WIKU Casebook“, „WIKU Personal aktuell“)
chapter: "Beschäftigungsverhältnisse"   # Quell-Kapitel (WIKU: aus WIKU_PINS, idR der Publikationstitel)
topic: altersteilzeit          # ASCII-Cluster-Slug (s. Tabelle)
author: "Marek"               # WIKU: „Wilhelm Kurzböck“
stand: 2026-01                 # ISO-Monat des Quell-Stands (WIKU: Impressum/Dateiname, „Personal aktuell“: Heft-Monat)
source:
  pdf: ".lexis360/Lexis360_altersteilzeit_uberblick.pdf"   # WIKU: ".wiku/<dateiname>.pdf"
  text: ".lexis360/md/altersteilzeit_uberblick.md"         # WIKU: ".wiku/md/<slug>.md"
legal_bases: ["AlVG", "AZG § 19e"]      # nur im Quelltext genannte Normen
tags: [altersteilzeit, ams-foerderung]  # ASCII-Slugs, retrieval-freundlich
cross_refs: ["lb-atz-09"]     # verwandte KB-Einträge (lb↔wk erlaubt; dangling = Fehler)

Schlüsselkonvention (Entscheidung D2): strukturelle Schlüssel englisch (konsistent mit kv-catalog.json/chambers.json), Werte deutsch (UTF-8, Umlaute erlaubt). Zwei Ausnahmen: stand (österreichischer Fachbegriff, ISO-Wert YYYY-MM) und topic/tags als ASCII-Slugs. Die Frontmatter ist Single Source of Truth; kb.json wird daraus generiert und schema-validiert (build_lexis_kb.py --registry).

Cluster (Lexis Batch 1–9 + WIKU Batch 1)

topic-Slug	Name	ID-Präfix	IDs	n
altersteilzeit	Altersteilzeit	atz	lb-atz-01 … 15	15
lehrlinge	Lehrverhältnis / Lehrlinge	leh	lb-leh-01 … 16	16
jugendliche	Jugendarbeit / Jugendschutz	jug	lb-jug-01 … 08	8
ferialpraktikanten	Ferialpraktikanten, Volontäre, Au-pair	pra	lb-pra-01 … 04	4
beschaftigungsformen	Beschäftigungsformen & Abgrenzung	bes	lb-bes-01 … 08	8
teilzeit	Teilzeit & Bildungsteilzeit	tzb	lb-tzb-01 … 06	6
behinderte	Behinderte Arbeitnehmer	beh	lb-beh-01 … 04	4
entgelt	Entgelt: Anspruch & Abrechnung	ent	lb-ent-01 … 11	11
geschaftsfuhrer	Geschäftsführer	gsf	lb-gsf-01 … 05	5
leitende-angestellte	Leitende Angestellte	lei	lb-lei-01	1
pramien	Prämien & Provisionen	prm	lb-prm-01 … 07	7
sachbezuge	Sachbezüge & freiwillige Sozialleistungen	sac	lb-sac-01 … 21	21
vorstand	Vorstandsmitglieder (Vorstand)	vst	lb-vst-01 … 04	4
sonderzahlungen	Sonderzahlungen	son	lb-son-01 … 05	5
zuschlage	Zulagen und Zuschläge	zus	lb-zus-01 … 08	8
pendlerforderung	Pendlerförderung	pen	lb-pen-01 … 09	9
reisekosten	Dienstreise & Reisekosten	rei	lb-rei-01 … 09	9
vorsorgeleistungen	Vorsorgeleistungen (BMSVG, Betriebspension, Beteiligung)	vor	lb-vor-01 … 11	11
geschenke	Sachzuwendungen & Geschenke	ges	lb-ges-01 … 02	2
lohndumping	Bekämpfung von Lohn- und Sozialdumping (LSD-BG)	lsd	lb-lsd-01 … 13	13
gplb	GPLB	gpl	lb-gpl-01 … 07	7
lohnnebenkosten	Lohnnebenkosten (Dienstgeberbeiträge)	lnk	lb-lnk-01 … 07	7
lohnpfandung	Lohnpfändung	pfa	lb-pfa-01 … 14	14
lohnverrechnung	Lohnverrechnung (Meldewesen, Abrechnungsfragen)	lvr	lb-lvr-01 … 09	9
nachzahlungen	Nachzahlungen	naz	lb-naz-01 … 04	4
arbeitszeitgrenzen	Arbeitszeitgrenzen	azg	lb-azg-01 … 04	4
arbeitszeitmodelle	Arbeitszeitmodelle (Gleitzeit, Schicht, Kurzarbeit)	azm	lb-azm-01 … 07	7
meldepflichten	Melde- und Informationspflichten	mip	lb-mip-01 … 04	4
nachtschwerarbeit	Nachtschwerarbeit	nsc	lb-nsc-01 … 03	3
ruhezeiten	Ruhezeiten	rhz	lb-rhz-01 … 04	4
schwangerschaft	Schwangerschaft (Mutterschutz)	sch	lb-sch-01 … 08	7
uberstunden	Überstunden	ues	lb-ues-01 … 04	4
zeiterfassung	Zeiterfassung	zer	lb-zer-01 … 03	3
schwerarbeit	Schwerarbeit	swa	lb-swa-01 … 05	5
arbeitnehmerschutz	Arbeitnehmerschutz (ASchG)	asc	lb-asc-01 … 16	16
dienstnehmerhaftung	Dienstnehmerhaftung (Schadenersatz)	dnh	lb-dnh-01 … 07	7
gleichbehandlung	Gleichbehandlung & Diskriminierung	glb	lb-glb-01 … 07	7
mobbing	Mobbing	mob	lb-mob-01	1
firmeneigentum	Firmeneigentum & Sachnutzung	fir	lb-fir-01 … 06	6
weisungen	Weisungen an die Arbeitnehmer	wei	lb-wei-01 … 03	3
urlaub	Urlaub (Anspruch, Entgelt, Verbrauch)	url	lb-url-01 … 16	16
krankenstand	Krankenstand & Entgeltfortzahlung	krs	lb-krs-01 … 09	9
entsendung	Grenzüberschreitender Einsatz & Entsendung	grz	lb-grz-01 … 08	8
karenzsonderformen	Karenz-Sonderformen (Bildungs-, Hospiz-, Pflegekarenz)	kzs	lb-kzs-01 … 07	7
elternteilzeit	Elternteilzeit	elt	lb-elt-01 … 06	6
karenz	Karenz (Elternkarenz)	kar	lb-kar-01 … 06	6
kinderbetreuungsgeld	Kinderbetreuungsgeld & Beihilfen	kbg	lb-kbg-01 … 06	6
prasenzdienst	Präsenzdienst & Zivildienst	prd	lb-prd-01 … 06	6
telearbeit	Teleworking & Heimarbeit	tel	lb-tel-01 … 06	6
schutzfrist	Geburt, Schutzfrist & Wochengeld	msf	lb-msf-01 … 05	5
dienstverhinderung	Dienstverhinderungsgründe & Streik	dvh	lb-dvh-01 … 04	4
arbeitskrafteuberlassung	Arbeitskräfteüberlassung (AÜG)	aug	lb-aug-01 … 02	2
entgeltfortzahlung	Entgeltfortzahlung an Feiertagen	efz	lb-efz-01 … 02	2
familienzeit	Papamonat & Familienzeitbonus	pap	lb-pap-01 … 02	2
pflegefreistellung	Pflegefreistellung	pfl	lb-pfl-01 … 02	2
wiedereingliederung	Wiedereingliederung (Geld, Teilzeit)	wie	lb-wie-01 … 02	2
beendigungsarten	Beendigungsarten (Austritt, Entlassung, Kündigung)	bnd	lb-bnd-01 … 44	44
betriebsrat	Betriebsrat & Betriebsvereinbarungen	brt	lb-brt-01 … 36	35
endabrechnung	Beendigungsansprüche & Endabrechnung (Abfertigung, Vergleich, Stundenguthaben)	end	lb-end-01 … 26	25
insolvenz-betriebsubergang	Unternehmensauflösung & Betriebsübergang (Insolvenz)	ins	lb-ins-01 … 08	8
meldungen-verpflichtungen	Meldungen & Verpflichtungen (Beendigung, Datenschutz)	mel	lb-mel-01 … 08	8
beendigungsphase-sonstiges	Beendigungsphase – Sonstiges (Zeugnis, Konkurrenzklausel, Sozialplan, Postensuche)	bso	lb-bso-01 … 11	10
beitragsrecht-asvg	Sozialversicherungsrecht: Beitragsrecht ASVG (Beitragsgrundlagen, Beitragssätze)	sva	lb-sva-01 … 16	16
bauerliche-sozialversicherung	Bäuerliche Sozialversicherung (BSVG)	bsv	lb-bsv-01 … 18	18
gsvg-fsvg	GSVG/FSVG: Selbständige, neue Selbstständige, Abfertigung	gsv	lb-gsv-01 … 12	12
krankenversicherung	Krankenversicherung ASVG (Leistungen)	kvs	lb-kvs-01 … 04	4
pension	Pensionsversicherung (Pensionsarten, Pensionskonto)	pvs	lb-pvs-01 … 13	13
aktuell	WIKU Personal aktuell (Neuerungen, Urteile, Praxis)	akt	wk-akt-01 … 12	12
gewerbe	Gewerbebezogene Personalverrechnung (Güterbeförderung, Gastgewerbe)	gwe	wk-gwe-01 … 02	2

601 Einträge in 69 Clustern — Lexis: 571 Einträge in 67 Clustern (Batch 1: 55, Batch 2: 52, Batch 3: 44, Batch 4: 54, Batch 5: 31, Batch 6: 41, Batch 7: 97, Batch 8: 134, Batch 9: 63); WIKU: 30 Einträge in 18 Clustern (Batch 1: 13 Fachbroschüren, 3 Arbeitsunterlagen, 2 Casebooks, 12 Hefte „WIKU Personal aktuell“ 2026). Die WIKU-Publikationen liegen auf der bestehenden Cluster-Map (wk-pfa-01 neben lb-pfa-*) plus den beiden eigenen Clustern akt/gwe. Siebzehn Briefings-Kapitel: „Beschäftigungsverhältnisse“, „Entgelt: Anspruch & Abrechnung“, „Arbeitszeit“, „Arbeitnehmerschutz“, „Verhaltenspflichten“ (Batches 1–6), dazu „Urlaub & Karenzierung“, „Schwangerschaft & Elternkarenz“, „Krankenstand & Arbeitsunfall“, „Dienstverhinderung“ und „Außerhalb des Betriebsstandortes“ (Batch 7), „Beendigungsarten“, „Betriebsrat & Betriebsvereinbarungen“, „Beendigungsansprüche & Endabrechnung“, „Beendigungsphase - Sonstiges“, „Meldungen & Verpflichtungen“ und „Unternehmensauflösung & Betriebsübergang“ (Batch 8) sowie „Sozialversicherung“ (Batch 9) (chapter-Feld je aus dem Katalog übernehmen).

Frontmatter-topic = beschreibender ASCII-Slug (linke Spalte), das ID-Präfix (atz, leh, …) nur im id selbst; das Tool prüft die Konsistenz beider (--registry). Neue Cluster erweitern alle vier Strukturen im Tool (TOPIC_MAP, KEYWORDS, CLUSTERS, TOPIC_TO_PREFIX); tritt derselbe Thema-Slug unter zwei Kapiteln auf, zusätzlich CHAPTER_TOPIC_MAP.

IDs werden beim ersten --extract vergeben und danach eingefroren (load_previous_ids()); neue Dokumente hängen hinten an, Nummern ausscheidender Dokumente werden nie wiederverwendet. Dateiname eines Layer-2-Eintrags = Layer-1-Slug (Lexis-Export-Stil: Umlaute fallen, werden nicht transliteriert — uberblick, beschaftigung).

Kurationskonventionen (verbindlich)

1. Sprache: deutsch, Fachsprache wie im Original; Metadaten-Werte UTF-8. topic/tags ASCII.
2. Eigene Worte: Kuratierung ist keine Volltextkopie (Lizenz!). Wörtliche Zitate nur kurz und mit Stand gekennzeichnet.
3. Werte immer mit Stand. Stammt der Wert aus einem Briefing mit älterem Stand (z. B. Lehrlinge 2024-03, 2025-08), so ist „(Stand YYYY-MM)" am Wert zu führen. Niemals Werte aus Trainingswissen ergänzen — nur aus dem Quelltext oder aus neueren KB-Einträgen (dann mit ID belegt).
4. Statusmarken wie in RECHTSQUELLEN: ✅ verifiziert · ⚠ plausibel, Detailverifikation offen · ❓ bewusst offen. §-Zitate nur, wenn die Quelle sie nennt; sonst ⚠ mit Verifikationshinweis (RIS).
5. Dokumentstruktur: # <Titel> → Quellzeile (Werk, Autor, Stand, ID) → ## Zusammenfassung → ## Kernwerte & Fristen (Stand YYYY-MM) (Tabelle) → ## Rechtsgrundlagen → ## Payroll-Relevanz (Odoo) → ## Verweise.
6. Payroll-Relevanz benennt Odoo-19-Anknüpfungspunkte (hr_payroll-Engine, Work Entries, hr.rule.parameter, SV-BG-Handling, Meldewesen) als Hinweise für die Umsetzung, nicht als Spec.
7. Verweise: KB-IDs verwandter Briefings (Breadcrumb-Verweise der Quelle beachten) + Projektdateien (RECHTSQUELLEN-*.md).
8. Export-Artefakte ignorieren: Footer „Page n", „Erstellt von …", abgeschnittene Querverweise nicht rekonstruieren; vermerken, wenn eine Verweisstelle im Export unvollständig ist.
9. Vorbild/Qualitätsmaßstab: dokumente/altersteilzeit_uberblick.md.

Update-Zyklus (neue Batches — je Quelle)

Lexis360:

1. Neue PDFs nach .lexis360/ kopieren (Export-Namenskonvention Lexis360_<slug>.pdf beibehalten).
2. In tools/build_lexis_kb.py die Konstante BATCH_LEXIS hochsetzen, dann --extract --source lexis ausführen: Layer 1 + Katalog neu; bestehende IDs bleiben fix, neue Dokumente erhalten neue IDs + neue Batch-Nummer.

WIKU:

1. Neue PDFs nach .wiku/ kopieren (Dateinamen der Lieferung beibehalten; Stand aus „Stand YYYY-MM“/Heft-Monat, sonst Impressum).
2. Je PDF einen WIKU_PINS-Eintrag im Tool ergänzen (slug, cluster, stand, work, chapter, title) — ein PDF ohne Pin wird nicht extrahiert (harter Warning, nie Metadaten raten). Dann BATCH_WIKU hochsetzen und --extract --source wiku ausführen.

Beide Quellen gemeinsam:

3. Neue Layer-2-Einträge kuratieren (Konventionen oben; WIKU-Dateiname = wiku_<slug>.md).
4. --registry (generiert/validiert kb.json + INDEX.md über beide Quellen), danach --check --source all (Layer-1↔Layer-2- Vollständigkeit je Quelle, Quelldateien vorhanden).
5. personalverrechnung/RUNBOOK.md und .agents/MEMORY.md pflegen (INDEX.md wird generiert, nicht manuell editiert).

Copilot-Konsum

kb.json listet jeden Eintrag mit ID, Titel, Stand, Cluster, Rechtsgrundlagen, Tags und Pfaden auf Layer 1/Layer 2. Für Retrieval/Skills: Eintrag = Chunk-Einheit; id als Zitatchlüssel; stand für Aktualitätsfilter; cross_refs für Graph-Nachbarschaft. Die Volltexte (Layer 1) sind lokal vorhanden, aber nicht Teil des Versionskontroll-Korpus — ein Copilot-Deployment braucht daher einen separaten, lizenzkonformen Bereitstellungspfad für Layer 1 (❓ offen).