# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-02-08 (Help-Forensik)
# Nächste Prüfung: 2026-08-08

VENDOR - Externe Code-Quellen
==============================

STAND: 2026-02-06

BESCHREIBUNG
------------
Das _vendor/-Verzeichnis enthält Kopien von externem Code, der in
BACH-Services integriert wird. Jeder Vendor hat ein eigenes Verzeichnis
mit PROVENANCE.md (Herkunft, Commit, Lizenz).

SPEICHERORT
-----------
system/hub/_services/document/_vendor/

VERFÜGBARE VENDORS
-------------------

  anthropic_docx/     Word XML Pack/Unpack, Validate, Tracked Changes
                      Quelle: github.com/anthropics/skills (skills/docx)
                      Nutzen: Template-Debugging, Änderungsverfolgung

  anthropic_pdf/      PDF-Formular-Extraktion, Ausfuellung, Konvertierung
                      Quelle: github.com/anthropics/skills (skills/pdf)
                      Nutzen: Steuer-Belege, Formular-Ausfuellung
                      Integration: pdf_service.py (PDFProcessor)

  anthropic_xlsx/     Excel Recalc, Office XML Pack/Unpack/Validate
                      Quelle: github.com/anthropics/skills (skills/xlsx)
                      Nutzen: Finanz-Exports mit Formeln

  redaction_detector.py   Regex+Fuzzy+Blacklist Erkennung sensibler Daten
                          Quelle: DokuZentrum

  pdf_schwaerzer_pro.py   PDF-Schwaerzung + AES-256 Encryption
                          Quelle: PDFSchwaerzer Pro

NUTZUNG IM CODE
---------------

  # PDF-Verarbeitung (empfohlen: über Service-Layer)
  from hub._services.document.pdf_service import PDFProcessor

  PDFProcessor.extract_text("datei.pdf")
  PDFProcessor.get_metadata("datei.pdf")
  PDFProcessor.extract_form_fields("datei.pdf")
  PDFProcessor.fill_form("datei.pdf", {"feld": "wert"}, "out.pdf")
  PDFProcessor.to_images("datei.pdf", "output_dir/")
  PDFProcessor.check_fillable("datei.pdf")

  # Vendor-Module direkt (nur wenn Service-Layer nicht reicht)
  import sys
  sys.path.insert(0, str(vendor_dir))
  from extract_form_structure import extract_form_structure

VENDOR-KONVENTIONEN
-------------------

  1. Jeder Vendor bekommt ein eigenes Verzeichnis
  2. PROVENANCE.md ist Pflicht (Quelle, Commit, Datum, Lizenz)
  3. __init__.py als Python-Package
  4. Keine Änderungen am Vendor-Code (Verbatim Copy)
  5. Updates: Neuen Commit kopieren, PROVENANCE.md aktualisieren

VERWANDTE TOOLS
---------------

  tools/c_skill_init.py        Neuen Skill anlegen (Anthropic-Standard)
  tools/c_skill_validate.py    SKILL.md validieren
  tools/c_skill_package.py     Skill verpacken

SIEHE AUCH
----------
bach --help cookbooks          Anthropic Cookbooks Referenz
bach --help tools              Tool-Übersicht
_vendor/README.md              Vendor-Übersichtstabelle
