odoo-at-payroll/.agents/MEMORY.md

Agent Memory — odoo-at-payroll

Current focus

KV-Library aufgebaut (2026-09-09): alle aktuellen Kollektivverträge maschinenlesbar in personalverrechnung/quellen/kv/ — ÖGB-Portal-Baseline (593 Varianten mit Volltexten), WKO als Main Source für WKO-Gewerbe (614 aktuelle Dokumente), Kammer-Registry + Crosscheck-Katalog (768 Einträge). Fortführung über personalverrechnung/RUNBOOK.md. Danach weiter wie zuvor: AP3 (Lohnsteuer) im Kern-Modul gemäß personalverrechnung/IMPLEMENTIERUNGSPLAN-Bgld.md (Abschnitt 4.2, Regel LSTL) — Implementierungsplan wartet weiterhin auf die Freigaben des Bgld.-Auftrags (AP0 zuerst).

Completed

• KV-Library (2026-09-09): tools/fetch_kv_portal.py (ÖGB-Portal: Sitemap/Dashboard/Structure/Slices/Topics-JSON-APIs, 593 Varianten, Catalog+Texte JSON/MD), tools/fetch_wko_kv.py (WKO-DB: 1.820 Übersichtsseiten, 614 aktuelle Dokumente, Match gegen Baseline), tools/build_kv_catalog.py (Merge, Kammer-Klassifikation, Crosscheck, manual-review-Listen), quellen/kv/chambers/chambers.json (Kammer-Quellen kuratiert, inkl. Lücken: GÖD member-only, RA/Notariat nicht öffentlich), personalverrechnung/RUNBOOK.md (Update-Zyklus). 407 WKO↔ÖGB-Paare, 30 Datumsdifferenzen geflaggt, 195 unklassifizierte (Einzenträger-KVs) zur manuellen Sichtung.
• Migration gem360 → odoo-at-payroll (2026-09-09): dev-payroll nach origin gepusht (Backup), History-Import per git filter-repo (Branch hier: main), Modul-Split (TASY/SV-Layer in den Kern), Model-Rename l10n.at.payroll.tasy.*, Skills/AGENTS/MEMORY neu aufgesetzt, Manifest-Beschreibung auf AP1+AP2-Stand korrigiert.
• Vorher (aus gem360-Historie): AP1 Katalogmodell (35 Gruppen/433 Werte 2026), AP2 Entgelt-Engine (13 Regeln, Structure GEMBG.BGLD), SV-Werte aus ÖGK TASY-LSWH; 3 Testsuiten (Katalog, Entgelt, TASY-Import).

Open issues / blockers

• KV-Library, manuell offen (2026-09-09): manual_review-Listen im kv-catalog.json (Match-Heuristik-Flüchtigungen, 30 Datumsdifferenzen, 195 unklassifizierte Einzelträger-KVs); Kammer-Scan-PDFs (RA Vbg, LÄK NÖ/OÖ/Bgld) ohne OCR nicht maschinenlesbar; Angestelltenärzte-KV nirgends öffentlich. Bibliothek inkl. Texte committed als 5b629a5 (lokaler main, noch nicht gepusht).
• gem360-seitig gilt: Branch dev-payroll dort vorerst erhalten, aber keine Payroll-Implementierung mehr in gem360 und kein Merge nach dev/va_module (Guardrails im gem360-Handoff). Die Brücke l10n_at_gemeinde_payroll_vrv (AP7) wird in gem360 gegen getaggte Releases dieses Repos gebaut.
• Runtime-Validierung offen (2026-09-09): Modul-Install und die 3 Testsuiten (Katalog, Entgelt, TASY-Import) sind auf der Workstation nicht lauffähig (kein lokaler PostgreSQL; Enterprise-Addons liegen im Geschwister-Checkout ../gem360). Auf dem Dev-Host nachholen: -i l10n_at_hr_payroll,l10n_at_gemeinde_payroll --test-tags /l10n_at_hr_payroll,/l10n_at_gemeinde_payroll. Statisch grün: py_compile + XML-Well-formedness über alle Addon-Dateien.
• Bgld.-Auftrag: AP0 offen (Bestandsaufnahme Pilotmandant, ELDA/FinOnl- Specs, VRV-Buchungsmatrix, offene RIS-Verifikationen) — IMPLEMENTIERUNGSPLAN-Bgld.md Abschnitt 8.
• Odoo-Upgrades künftig in beiden Repos (gem360 + dieses) gegen denselben Odoo-Pin validieren.

Decisions & conventions

• KV-Quellen-Architektur (2026-09-09): Main source je KV = die verantwortliche Arbeitgeberkammer; kollektivvertrag.at (ÖGB) immer als Crosscheck-Baseline (einziger vollständiger Korpus). WKO-DB deckt nur WKO-KVs ab (keine Arzt/Apotheke/RA/Notar/Land-Zweige). Lohntafel-PDFs nur verlinken, nicht downladen; im Text enthaltene Tabellen konvertieren. Historische Slices nur bei Bedarf (Default: aktuelle Version).
• SKILL.md braucht YAML-Frontmatter (name = Verzeichnisname, description, disable-model-invocation).
• Abhängigkeitsrichtung: gem360 → dieses Repo (nur die Brücke hängt an beiden), nie umgekehrt.
• Tests nur auf Wegwerf-DB (nie gem360_dev); je Änderung py_compile + XML-Well-formedness-Check.
• .firecrawl/ bleibt lokal unversioniert (Rechts-Rohquellen); bei Fehlen neu beschaffen — niemals aus Trainingswerten arbeiten.

Files that matter right now

• personalverrechnung/RUNBOOK.md — KV-Library pflegen (Update-Zyklus)
• personalverrechnung/quellen/kv/kv-catalog.json|.csv — der Crosscheck-Katalog
• personalverrechnung/quellen/kv/chambers/chambers.json — Kammer-Quellen-Registry
• personalverrechnung/tools/fetch_kv_portal.py / fetch_wko_kv.py / build_kv_catalog.py — Fetcher + Merge
• personalverrechnung/IMPLEMENTIERUNGSPLAN-Bgld.md — AP3+ (Freigabe-Gate)
• personalverrechnung/RECHTSQUELLEN-Bgld.md — verbindliche Rechtslage
• personalverrechnung/ANGEBOTS-KALKULATION-Bgld-Personalverrechnung.md — AP-Rahmen, Prämissen P1–P10
• addons/l10n_at_hr_payroll/ — Kern (SV/TASY; AP3 landet hier)
• addons/l10n_at_gemeinde_payroll/ — GemBG (AP1+AP2)