kommunalassist-core 0.5.0__tar.gz

kommunalassist_core-0.5.0/.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+
+# Test-Gate fuer jeden PR + main-Push: Ruff, Tests und makemigrations --check
+# gegen Postgres 16, damit ein Verpackungs-/Migrations-Fehler hier auffaellt
+# statt erst beim Adopter (vgl. publish-pypi.yml, dieselbe Postgres-Konvention).
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Ruff, Tests, makemigrations --check
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres:16-alpine
+        env:
+          POSTGRES_USER: test_user
+          POSTGRES_PASSWORD: test_pass
+          POSTGRES_DB: test_db
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    env:
+      POSTGRES_HOST: 127.0.0.1
+      POSTGRES_PORT: "5432"
+      POSTGRES_DB: test_db
+      POSTGRES_USER: test_user
+      POSTGRES_PASSWORD: test_pass
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: '3.12'
+      - name: Install package + dev deps
+        run: pip install -e ".[dev]" 'psycopg[binary]'
+      - name: ruff check
+        run: ruff check .
+      - name: ruff format --check
+        run: ruff format --check .
+      - name: pytest gegen Postgres
+        run: pytest -q
+      - name: makemigrations --check (keine fehlenden Migrationen)
+        run: python -m django makemigrations --check --settings=tests.settings

kommunalassist_core-0.5.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,168 @@
+name: Publish kommunalassist-core to PyPI
+
+# Triggert auf Git-Tags v*.*.*. Trusted Publishing (OIDC), kein API-Token-Secret.
+# Setup einmalig: pypi.org/manage/account/publishing/ → GitHub-Trust-Publisher
+#   Owner: iilgmbh
+#   Repository: iil-assist-core   # Repo-Name, NICHT der Projektname
+#   Workflow filename: publish-pypi.yml
+#   Environment name: pypi
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_USER: t
+          POSTGRES_PASSWORD: t
+          POSTGRES_DB: t
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: '3.12'
+      - name: Verify version matches tag
+        run: |
+          PKG_VERSION=$(grep '^version = ' pyproject.toml | head -1 | sed -E 's/^version = "([^"]+)".*/\1/')
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          echo "pyproject.toml: $PKG_VERSION"
+          echo "git tag:        $TAG_VERSION"
+          if [ "$PKG_VERSION" != "$TAG_VERSION" ]; then
+            echo "❌ Version-Mismatch"; exit 1
+          fi
+      - name: Install build tools
+        run: pip install --upgrade build
+      - name: Build wheel + sdist
+        run: python -m build
+      - name: Smoke test (gegen gebautes Wheel, nicht den Quellbaum)
+        run: |
+          # Gegen das WHEEL testen, nicht gegen src/: ein Verpackungsfehler faellt
+          # sonst erst beim Adopter auf. Das Muster stammt aus iil-klickdummy; dort
+          # prueft es zusaetzlich mitgelieferte Schema-Dateien. Dieses Paket hat
+          # keine package-data, deshalb bleibt der Importtest.
+          #
+          # ACHTUNG bei Uebernahme: Paketname (Bindestrich) und Modulname
+          # (Unterstrich) sind zwei verschiedene Zeichenketten. Genau daran ist der
+          # erste Lauf gescheitert -- `iil-klickdummy` war ersetzt, `iil_klickdummy`
+          # nicht.
+          pip install dist/*.whl 'psycopg[binary]>=3.2'
+          # ALLE Module importieren, nicht nur das Top-Level. Bis 0.1.2 zog
+          # ports/base.py `apps.adapters.dto` aus dem Herkunfts-Repo -- das Paket
+          # war ausserhalb von frist-hub gar nicht importierbar, und `import
+          # assist_core` allein hat das nicht gesehen.
+          python -c "
+          import importlib, django
+          from django.conf import settings
+          settings.configure(
+              INSTALLED_APPS=['django.contrib.contenttypes','django.contrib.auth','assist_core'],
+              DATABASES={'default':{'ENGINE':'django.db.backends.postgresql','NAME':'t',
+                                    'USER':'t','PASSWORD':'t','HOST':'127.0.0.1','PORT':'5432'}},
+              USE_TZ=True, DEFAULT_AUTO_FIELD='django.db.models.BigAutoField')
+          django.setup()
+          import assist_core
+          for m in ('assist_core.models','assist_core.mandant','assist_core.dto',
+                    'assist_core.ports','assist_core.regelkatalog'):
+              importlib.import_module(m)
+              print('  OK', m)
+          print('OK: alle Module importierbar, Version', assist_core.__version__)
+          "
+
+      # Ein Importtest sagt NICHT, ob die App benutzbar ist. Version 0.1.0 ging
+      # so durch, obwohl migrations/ nur __init__.py enthielt -- installierbar,
+      # aber ohne Tabellen. Gegen POSTGRES, nicht SQLite: Regelfreigabe fuehrt
+      # zwei JSONField, und SQLite ist bei jsonb und UniqueConstraint mit NULL
+      # nachsichtiger als die Zieldatenbank.
+      - name: migrate gegen Postgres (Wheel muss seine Tabellen anlegen koennen)
+        env:
+          PGHOST: 127.0.0.1
+          PGPORT: 5432
+        run: |
+          python -c "
+          import django
+          from django.conf import settings
+          settings.configure(
+              INSTALLED_APPS=['django.contrib.contenttypes','django.contrib.auth','assist_core'],
+              DATABASES={'default':{'ENGINE':'django.db.backends.postgresql','NAME':'t',
+                                    'USER':'t','PASSWORD':'t','HOST':'127.0.0.1','PORT':'5432'}},
+              USE_TZ=True, DEFAULT_AUTO_FIELD='django.db.models.BigAutoField')
+          django.setup()
+          from django.core.management import call_command
+          call_command('migrate', 'assist_core', verbosity=1)
+          from django.db import connection
+          with connection.cursor() as c:
+              c.execute(\"SELECT table_name FROM information_schema.tables WHERE table_schema='public'\")
+              tab = sorted(r[0] for r in c.fetchall() if not r[0].startswith('django_'))
+          assert tab, 'migrate hat keine Tabellen angelegt'
+          fremd = [t for t in tab if not t.startswith('assist_core_')]
+          assert not fremd, f'Fremde Tabellennamen im Paket: {fremd} (ADR-001)'
+          print('OK: Tabellen angelegt und korrekt benannt:', tab)
+          "
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI (Trusted Publishing / OIDC)
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
+        with:
+          packages-dir: dist/
+
+  github-release:
+    name: GitHub Release
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          name: dist
+          path: dist/
+      - uses: softprops/action-gh-release@3d0d9888cb7fd7b750713d6e236d1fcb99157228 # v3
+        with:
+          name: "kommunalassist-core ${{ github.ref_name }}"
+          body: |
+            **kommunalassist-core** Release `${{ github.ref_name }}`.
+
+            Install:
+            ```
+            pip install "kommunalassist-core>=${{ github.ref_name }}"
+            ```
+
+            Grundlage: `meiki:ADR-044` (Paket-Topologie) ·
+            `meiki:ADR-022` v1.1 (Termin-Engine im Kern) ·
+            `meiki:ADR-043` (Produkt- und Verwertungsschnitt)
+          files: dist/*
+          draft: false
+          prerelease: false

kommunalassist_core-0.5.0/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.py[cod]
+dist/
+build/
+*.egg-info/
+.venv/

kommunalassist_core-0.5.0/CHANGELOG.md

@@ -0,0 +1,129 @@
+# Changelog
+
+Alle nennenswerten Änderungen an `kommunalassist-core` (bis 0.4.0 `iil-assist-core`).
+
+Format nach [Keep a Changelog](https://keepachangelog.com/de/1.1.0/),
+Versionierung nach [Semantic Versioning](https://semver.org/lang/de/).
+
+## [0.5.0] — 2026-09-10
+
+**Nur der Verteilname aendert sich: `iil-assist-core` → `kommunalassist-core`.**
+Am Code aendert sich nichts.
+
+Der bisherige Name trug den des Anbieters, obwohl das Produkt in einer
+Kommunalverwaltung laeuft, und er kollidierte mit `iil-assist` — so heisst seit
+2026-09-10 auch der Plattform-Mechanismus aus `platform:KONZ-platform-058`. Der
+neue Name nennt den Markt statt des Anbieters, des einzelnen Hauses oder des
+Projekts MEiKI, das endet (Owner-Entscheid 2026-09-10, Variante V1 zu
+[meiki-hub#388](https://github.com/meiki-lra/meiki-hub/issues/388)).
+
+**Was ein Adopter tun muss:** eine Zeile in `requirements.txt`. Der Importname
+bleibt `assist_core`, App-Label und Tabellennamen (`assist_core_*`) bleiben
+ebenfalls — dort steht kein Anbietername, und eine Umbenennung haette
+Migrationen gekostet, ohne etwas zu loesen.
+
+**Was mit `iil-assist-core` passiert:** Die Fassungen bis 0.4.0 bleiben auf PyPI
+stehen. Sie zurueckzuziehen wuerde nur bestehende Installationen brechen; neue
+Arbeit laeuft unter dem neuen Namen.
+
+## [0.4.0] — 2026-09-10
+
+Tenancy-Basis, RLS-Erzeuger und Registries (KONZ-meiki-009 U3,
+iilgmbh/iil-assist-core#6 und #5).
+
+### Added
+
+- `assist_core.tenancy` — `TenantModel`/`TenantManager` fail-closed nach
+  platform:ADR-269: ohne aktiven Mandanten liefert der Manager `none()`.
+  Cross-Tenant gibt es nur über `all_tenants(grund=...)`, und der Zugriff landet
+  in der neuen append-only Tabelle `TenantAuditEintrag`. `tenant_context()` setzt
+  denselben Mandanten als Postgres-GUC `app.tenant_id` — **transaktionslokal**
+  (`set_config(..., true)`), nicht sessionweit.
+- `manage.py assist_rls --apply|--check [--app-rolle <name>]` — Policy je Tabelle
+  mit Mandanten-Spalte, `USING (spalte = NULLIF(current_setting('app.tenant_id',
+  true), '')::<cast>)` **ohne** OR-Ausweich-Zweige, plus `FORCE ROW LEVEL
+  SECURITY` und `DROP POLICY IF EXISTS` (idempotent). Der Cast kommt aus dem
+  Django-Feldtyp (bigint/uuid). `--check` bricht mit Exit ≠ 0 ab, wenn eine
+  Policy fehlt oder einen aufmachenden Zweig trägt; `--app-rolle` setzt
+  `NOBYPASSRLS` und entzieht der App-Rolle `UPDATE`/`DELETE` auf den
+  Audit-Tabellen — append-only wird Rechtelage statt Python-Konvention.
+- Registries als Tabellen: `Verfahren`, `Quellsystem`, `AdapterBindung`
+  (je Mandant, unique über `(tenant_id, kennung)` bzw. `(tenant_id, port)`) und
+  `Feiertagskalender` (Profil je Kennung, unique über `(kennung, jahr, datum)`).
+  Migration `0002_tenancy_registries_feiertage`.
+- `manage.py seed_feiertage --kennung BY --jahr 2026` — Startbestand aus
+  `engine.feiertage_bayern_benannt()` als **Daten**, keine YAML im Paket.
+- `assist_core.registry.pruefe_verfahren/pruefe_quellsystem` — Validierung an der
+  Grenze gegen die Registry-Tabelle des Mandanten, mit dokumentiertem Fallback
+  auf die `dto`-Enums, solange der Mandant keine Zeile gepflegt hat.
+- `assist_core.adapters.resolve(tenant_id, port)` — löst die `AdapterBindung`
+  über `importlib` auf, aber nur gegen `settings.ASSIST_ADAPTER_ALLOWLIST`
+  (Default leer). Der Kern liefert weiterhin keinen Adapter mit.
+- `engine.feiertage_fuer(tenant_id, jahr)` und `berechne_frist(...,
+  feiertage=...)` — der Mandanten-Kalender geht als Menge in die Rechnung.
+  `MandantEinstellung.feiertagskalender` (Default `"BY"`) sagt, welches Profil.
+
+### Changed
+
+- `regelkatalog.seed_entwuerfe(verfahren, pfad=None, tenant_id=None)` setzt
+  `tenant_scope_id` **beim Anlegen** und prüft Idempotenz je Mandant (#5). Der
+  Host-Workaround (`update()` nach dem Seed) entfällt: er machte die Entwürfe
+  kurzzeitig global sichtbar und ließ die Idempotenz-Prüfung eine vorhandene
+  globale Zelle für die Haus-Zelle halten.
+- `dto.Verfahren`/`dto.Quellsystem` bleiben als `StrEnum` erhalten, sind aber
+  nicht mehr der **Typ** der DTO-Felder — `InboundEvent.quellsystem`,
+  `InboundEvent.verfahren_hinweis` und `Vorgang.verfahren` sind jetzt `str`.
+  Weil `StrEnum`-Werte `str` sind, brechen bestehende Aufrufer nicht.
+- `ist_werktag()`/`naechster_werktag()` nehmen optional eine Feiertagsmenge;
+  ohne Angabe rechnen sie wie bisher mit dem BY-Kalender.
+- README: die bayerischen Feiertage sind nicht mehr als „Produktkonstante nach
+  meiki:ADR-043" beschrieben, sondern als Profil je Kennung (KONZ-009 § 3.2).
+
+### Hinweis für Konsumenten
+
+- `tenant_id` bleibt `BigIntegerField` (platform:ADR-109 Fix B-1, meiki:ADR-025).
+  Der Vorschlag, in der ganzen Familie auf UUID zu wechseln (KONZ-meiki-009
+  § 4.1, D-2), ist eine offene Owner-Entscheidung (meiki-hub#390) und wird hier
+  **nicht** vorweggenommen. Der Policy-Generator liest den Cast aus dem Feldtyp,
+  damit ein späterer Wechsel eine Feldmigration bleibt.
+- Wer die DB-Seite will, muss `tenant_context()` **innerhalb** von
+  `transaction.atomic()` betreten. Ohne offene Transaktion wird der GUC bewusst
+  nicht gesetzt (ein `set_config(..., true)` im Autocommit gälte nur für eine
+  Anweisung) und der Kontextmanager protokolliert eine Warnung.
+- Eine Katalog-Zeile mit `aenderbar_durch: niemand` lässt sich nicht
+  mandantengebunden seeden — `Regelfreigabe.clean()` weist das ab (§ 8.2).
+  Solche Kataloge werden ohne `tenant_id` importiert.
+- `MandantEinstellung` behält den Standard-Manager (sie wird gelesen, bevor ein
+  Mandanten-Kontext existiert), bekommt aber eine RLS-Policy.
+
+## [0.3.0] — 2026-09-10
+
+### Added
+
+- `assist_core.engine` — die Termin-Engine (`berechne_frist`, Feiertags-/
+  Werktagslogik für Bayern, Regel-Resolver) zieht aus `frist-hub` in den Kern
+  (KONZ-meiki-009 U1, B1). Signaturen unverändert, keine Verhaltensänderung.
+- `assist_core.engine.serie()` — neue Serien-Berechnung (monatlich/quartals-
+  weise/jährlich) für StatistikAssist-Meldetermine, inkl. Werktags-Verschiebung.
+- `assist_core.ports.base` — die fünf Ingress-Ports (`IdentityPort`,
+  `FachverfahrenPort`, `StatusPort`, `DmsPort`, `ClassificationPort`) ziehen aus
+  `frist-hub` in den Kern (KONZ-meiki-009 U1, B2), unverändert übernommen.
+
+### Changed
+
+- `assist_core.ports.base`-Docstring korrigiert: die Berechnung macht die
+  Engine im Kern (`assist_core.engine`), nicht mehr „der konsumierende Assist".
+
+### Hinweis für Konsumenten
+
+`frist-hub` muss ab `0.3.0` `berechne_frist` und die übrigen Engine-Funktionen
+aus `assist_core.engine` importieren statt aus `apps.fristen.services`, und die
+fünf Ports aus `assist_core.ports` statt aus `apps.adapters.ports`.
+
+## [0.2.0]
+
+Fachlogik raus, DTOs rein — das Paket wurde eigenständig (siehe Git-Historie).
+
+## [0.1.0]
+
+Erstbefüllung aus `frist-hub` (meiki-lra/frist-hub#142, M3).

kommunalassist_core-0.5.0/LICENSE

@@ -0,0 +1,16 @@
+Proprietäre Lizenz — IIL GmbH
+
+Copyright (c) 2026 IIL GmbH. Alle Rechte vorbehalten.
+
+Dieses Paket ist eine wiederverwendbare Komponente im Sinne von meiki:ADR-043.
+Die Rechte daran verbleiben bei der IIL GmbH.
+
+Den Partnern der Kooperationsvereinbarung MEiKI (Landkreis Traunstein,
+Hochschule Neu-Ulm, Technische Hochschule Rosenheim, Landkreis Günzburg) wird
+ein nicht ausschließliches, nicht übertragbares und unentgeltliches
+Nutzungsrecht für Zweck und Dauer des Verbundprojekts eingeräumt, nach dessen
+Ende ein ebensolches für eigene wissenschaftliche Zwecke in Forschung und Lehre.
+Weitergehende Nutzungsrechte werden zu marktüblichen Bedingungen eingeräumt.
+
+Maßgeblich ist die Vereinbarung zwischen IIL GmbH und der Hochschule Neu-Ulm
+nach § 7 Abs. 1 der Kooperationsvereinbarung MEiKI.

kommunalassist_core-0.5.0/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.5
+Name: kommunalassist-core
+Version: 0.5.0
+Summary: Kern der Kommunalassist-Familie: Mandant, Termin-Engine (BRMS-Regelwerk mit Freigabe-Workflow), Adapter-Ports
+Author-email: Achim Dehnert <achim.dehnert@iil.gmbh>
+License-Expression: LicenseRef-Proprietary
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: django<6.0,>=5.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: import-linter>=2.0; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-django; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# kommunalassist-core
+
+Der gemeinsame Kern der **Kommunalassist**-Familie: **Mandant**, **Termin-Engine**
+(Regelwerk mit Freigabe-Workflow) und die **Ports** zu Fachverfahren und DMS.
+
+> **Namenswechsel 2026-09-10.** Das Paket hiess bis 0.4.0 `iil-assist-core`. Der
+> Verteilname trug den Namen des Anbieters, obwohl das Produkt in einer
+> Kommunalverwaltung laeuft — und er kollidierte mit `iil-assist`, dem
+> Plattform-Mechanismus aus `platform:KONZ-platform-058`. **Der Importname
+> bleibt `assist_core`**, ebenso App-Label und Tabellennamen: dort steht kein
+> Anbietername, eine Umbenennung haette nur Migrationen gekostet und nichts
+> geloest. Aendern muss ein Adopter genau eine Zeile in `requirements.txt`.
+
+Grundlage: `meiki:ADR-044` (Paket-Topologie) · `meiki:ADR-022` v1.1 (die
+Termin-Engine gehört in den Kern) · `meiki:ADR-025` (Mandantenfähigkeit).
+
+## Warum es dieses Paket gibt
+
+Die Termin-Engine hat **zwei** Konsumenten: FristAssist führt Wiedervorlagen,
+StatistikAssist führt Meldetermine. Ein Meldetermin ist eine Frist mit Stichtag —
+dieselbe Rechnung, zwei Zwecke. Läge die Engine hinter FristAssist, bräuchte
+StatistikAssist FristAssist. Genau das schließt der Produktschnitt aus.
+
+## Was drin ist
+
+| Modul | Inhalt |
+|---|---|
+| `models` | `Regelfreigabe` (Regelwerk mit Zustandsmodell `entwurf → eingereicht → freigegeben → abgelehnt`), `RegelAuditEintrag`, `MandantEinstellung`, `TenantAuditEintrag`, Registries (`Verfahren`, `Quellsystem`, `AdapterBindung`, `Feiertagskalender`) |
+| `tenancy` | `TenantModel`/`TenantManager` (fail-closed), `tenant_context()`, GUC `app.tenant_id` |
+| `registry`/`adapters` | Validierung an der Grenze gegen die Registry-Tabelle; Adapter-Auflösung gegen eine Allowlist |
+| `mandant` | Hauspraxis als Konfiguration — ohne gepflegte Einstellung wird **nichts geraten**, die Renderer liefern `None` |
+| `regelkatalog` | einmaliger Import von Startbeständen. **Keine Betriebsquelle** — im Betrieb gilt allein die Tabelle |
+| `engine` | die Termin-Engine — `berechne_frist()`, Regel-Resolver, `serie()` |
+| `ports` | Schnittstellen zu Fachverfahren und DMS; die konkreten Adapter liegen beim Konsumenten |
+
+## Engine
+
+`assist_core.engine` ist die **eine Rechenstelle** für Termine (meiki:ADR-022
+v1.1) — zwei Konsumenten (FristAssist, StatistikAssist), eine Implementierung.
+`berechne_frist()` rechnet Fristen nach § 187/188/193 BGB mit Bekanntgabefiktion
+und Bayern-Kalender-Korrektur; `serie()` leitet daraus wiederkehrende
+Meldetermine (monatlich/quartalsweise/jährlich) für StatistikAssist ab. Die
+bayerischen Feiertage (`feiertage_bayern()`, inkl. Mariä Himmelfahrt) sind seit
+`0.4.0` **Startbestand statt Konstante**: Mariä Himmelfahrt gilt nur in Gemeinden
+mit katholischer Mehrheit, das Augsburger Friedensfest nur in Augsburg. Der
+Kalender ist deshalb ein Profil je Kennung (`Feiertagskalender`, Import über
+`seed_feiertage`), das ein Haus kopieren und abweichend pflegen kann
+(KONZ-meiki-009 § 3.2). Der Regel-Resolver liest Fristwerte
+aus der Governance-Tabelle `Regelfreigabe`, mit Code-Katalog-Fallback, solange
+keine Regel gepflegt ist.
+
+## Mandant
+
+Jede mandantengebundene Tabelle erbt von `assist_core.tenancy.TenantModel`
+(`tenant_id` als `BigIntegerField`, platform:ADR-109). Der Manager ist
+**fail-closed** — ohne aktiven Mandanten `none()`, nicht ungefiltert:
+
+```python
+with transaction.atomic(), tenant_context(4711):
+    Verfahren.objects.all()  # Manager + Policy filtern beide
+# Einziger Cross-Tenant-Pfad, schreibt TenantAuditEintrag:
+Verfahren.objects.all_tenants(grund="Statistik")
+```
+
+## RLS
+
+`manage.py assist_rls --apply [--app-rolle assist_app]` legt je Tabelle mit
+Mandanten-Spalte eine Policy an — `USING (tenant_id = NULLIF(current_setting(
+'app.tenant_id', true), '')::bigint)`, **ohne** OR-Ausweich-Zweige. Kein Mandant
+heißt keine Zeile; nur `Regelfreigabe` öffnet über `tenant_scope_id IS NULL` die
+globalen Regeln, nie fremde Mandanten. Der GUC ist transaktionslokal, Aufrufer
+brauchen also `transaction.atomic()`. `--app-rolle` setzt `NOBYPASSRLS` und
+entzieht `UPDATE`/`DELETE` auf den Audit-Tabellen; `--check` endet mit Exit ≠ 0,
+wenn eine Policy fehlt oder einen aufmachenden Zweig trägt.
+
+## Was **nicht** drin ist
+
+Kein Hausinhalt. Keine Regelwerke, keine Vorlagen, keine Mandantenwerte, keine
+Team- oder Fachbereichsbezeichnungen. Nach `meiki:ADR-044` ist alles, was sich je
+Haus unterscheidet, **eine Zeile in Postgres** — nicht Code, nicht YAML.
+
+Prüfbar: *ein zweites Haus geht durch Konfiguration und Uploads in Betrieb, nicht
+durch einen Commit.*
+
+## App-Label und Tabellennamen
+
+`assist_core`, also `assist_core_*`. Kein `db_table` auf die Namen des
+Herkunfts-Repos — siehe `docs/adr/ADR-001`.
+
+Entschieden am 2026-09-09 zugunsten eines **echten Renames** statt einer
+Zustands-Migration, weil es noch keinen produktiven Datenbestand gibt. Für das
+Repo, das die Tabellen heute hält (`meiki-lra/frist-hub`), bedeutet das beim
+Umstellen eine Umbenennungs-Migration — beim jetzigen Stand risikoarm, mit
+produktiven Daten wäre sie es nicht. **Das Zeitfenster ist begrenzt.**
+
+## CI
+
+Jeder PR und jeder Push auf `main` läuft gegen Postgres 16: `ruff check`,
+`ruff format --check`, `pytest` und `makemigrations --check` (siehe
+`.github/workflows/ci.yml`).
+
+## Stand
+
+`0.4.0` — Tenancy-Basis, RLS-Erzeuger, Registries (KONZ-meiki-009 U3). Noch von
+keinem Repo als Abhängigkeit gebunden. `tenant_id` bleibt `BigIntegerField`;
+der Vorschlag, in der ganzen Familie auf UUID zu wechseln (KONZ-meiki-009 § 4.1,
+D-2), ist offen und hier nicht vorweggenommen.

kommunalassist_core-0.5.0/README.md

@@ -0,0 +1,107 @@
+# kommunalassist-core
+
+Der gemeinsame Kern der **Kommunalassist**-Familie: **Mandant**, **Termin-Engine**
+(Regelwerk mit Freigabe-Workflow) und die **Ports** zu Fachverfahren und DMS.
+
+> **Namenswechsel 2026-09-10.** Das Paket hiess bis 0.4.0 `iil-assist-core`. Der
+> Verteilname trug den Namen des Anbieters, obwohl das Produkt in einer
+> Kommunalverwaltung laeuft — und er kollidierte mit `iil-assist`, dem
+> Plattform-Mechanismus aus `platform:KONZ-platform-058`. **Der Importname
+> bleibt `assist_core`**, ebenso App-Label und Tabellennamen: dort steht kein
+> Anbietername, eine Umbenennung haette nur Migrationen gekostet und nichts
+> geloest. Aendern muss ein Adopter genau eine Zeile in `requirements.txt`.
+
+Grundlage: `meiki:ADR-044` (Paket-Topologie) · `meiki:ADR-022` v1.1 (die
+Termin-Engine gehört in den Kern) · `meiki:ADR-025` (Mandantenfähigkeit).
+
+## Warum es dieses Paket gibt
+
+Die Termin-Engine hat **zwei** Konsumenten: FristAssist führt Wiedervorlagen,
+StatistikAssist führt Meldetermine. Ein Meldetermin ist eine Frist mit Stichtag —
+dieselbe Rechnung, zwei Zwecke. Läge die Engine hinter FristAssist, bräuchte
+StatistikAssist FristAssist. Genau das schließt der Produktschnitt aus.
+
+## Was drin ist
+
+| Modul | Inhalt |
+|---|---|
+| `models` | `Regelfreigabe` (Regelwerk mit Zustandsmodell `entwurf → eingereicht → freigegeben → abgelehnt`), `RegelAuditEintrag`, `MandantEinstellung`, `TenantAuditEintrag`, Registries (`Verfahren`, `Quellsystem`, `AdapterBindung`, `Feiertagskalender`) |
+| `tenancy` | `TenantModel`/`TenantManager` (fail-closed), `tenant_context()`, GUC `app.tenant_id` |
+| `registry`/`adapters` | Validierung an der Grenze gegen die Registry-Tabelle; Adapter-Auflösung gegen eine Allowlist |
+| `mandant` | Hauspraxis als Konfiguration — ohne gepflegte Einstellung wird **nichts geraten**, die Renderer liefern `None` |
+| `regelkatalog` | einmaliger Import von Startbeständen. **Keine Betriebsquelle** — im Betrieb gilt allein die Tabelle |
+| `engine` | die Termin-Engine — `berechne_frist()`, Regel-Resolver, `serie()` |
+| `ports` | Schnittstellen zu Fachverfahren und DMS; die konkreten Adapter liegen beim Konsumenten |
+
+## Engine
+
+`assist_core.engine` ist die **eine Rechenstelle** für Termine (meiki:ADR-022
+v1.1) — zwei Konsumenten (FristAssist, StatistikAssist), eine Implementierung.
+`berechne_frist()` rechnet Fristen nach § 187/188/193 BGB mit Bekanntgabefiktion
+und Bayern-Kalender-Korrektur; `serie()` leitet daraus wiederkehrende
+Meldetermine (monatlich/quartalsweise/jährlich) für StatistikAssist ab. Die
+bayerischen Feiertage (`feiertage_bayern()`, inkl. Mariä Himmelfahrt) sind seit
+`0.4.0` **Startbestand statt Konstante**: Mariä Himmelfahrt gilt nur in Gemeinden
+mit katholischer Mehrheit, das Augsburger Friedensfest nur in Augsburg. Der
+Kalender ist deshalb ein Profil je Kennung (`Feiertagskalender`, Import über
+`seed_feiertage`), das ein Haus kopieren und abweichend pflegen kann
+(KONZ-meiki-009 § 3.2). Der Regel-Resolver liest Fristwerte
+aus der Governance-Tabelle `Regelfreigabe`, mit Code-Katalog-Fallback, solange
+keine Regel gepflegt ist.
+
+## Mandant
+
+Jede mandantengebundene Tabelle erbt von `assist_core.tenancy.TenantModel`
+(`tenant_id` als `BigIntegerField`, platform:ADR-109). Der Manager ist
+**fail-closed** — ohne aktiven Mandanten `none()`, nicht ungefiltert:
+
+```python
+with transaction.atomic(), tenant_context(4711):
+    Verfahren.objects.all()  # Manager + Policy filtern beide
+# Einziger Cross-Tenant-Pfad, schreibt TenantAuditEintrag:
+Verfahren.objects.all_tenants(grund="Statistik")
+```
+
+## RLS
+
+`manage.py assist_rls --apply [--app-rolle assist_app]` legt je Tabelle mit
+Mandanten-Spalte eine Policy an — `USING (tenant_id = NULLIF(current_setting(
+'app.tenant_id', true), '')::bigint)`, **ohne** OR-Ausweich-Zweige. Kein Mandant
+heißt keine Zeile; nur `Regelfreigabe` öffnet über `tenant_scope_id IS NULL` die
+globalen Regeln, nie fremde Mandanten. Der GUC ist transaktionslokal, Aufrufer
+brauchen also `transaction.atomic()`. `--app-rolle` setzt `NOBYPASSRLS` und
+entzieht `UPDATE`/`DELETE` auf den Audit-Tabellen; `--check` endet mit Exit ≠ 0,
+wenn eine Policy fehlt oder einen aufmachenden Zweig trägt.
+
+## Was **nicht** drin ist
+
+Kein Hausinhalt. Keine Regelwerke, keine Vorlagen, keine Mandantenwerte, keine
+Team- oder Fachbereichsbezeichnungen. Nach `meiki:ADR-044` ist alles, was sich je
+Haus unterscheidet, **eine Zeile in Postgres** — nicht Code, nicht YAML.
+
+Prüfbar: *ein zweites Haus geht durch Konfiguration und Uploads in Betrieb, nicht
+durch einen Commit.*
+
+## App-Label und Tabellennamen
+
+`assist_core`, also `assist_core_*`. Kein `db_table` auf die Namen des
+Herkunfts-Repos — siehe `docs/adr/ADR-001`.
+
+Entschieden am 2026-09-09 zugunsten eines **echten Renames** statt einer
+Zustands-Migration, weil es noch keinen produktiven Datenbestand gibt. Für das
+Repo, das die Tabellen heute hält (`meiki-lra/frist-hub`), bedeutet das beim
+Umstellen eine Umbenennungs-Migration — beim jetzigen Stand risikoarm, mit
+produktiven Daten wäre sie es nicht. **Das Zeitfenster ist begrenzt.**
+
+## CI
+
+Jeder PR und jeder Push auf `main` läuft gegen Postgres 16: `ruff check`,
+`ruff format --check`, `pytest` und `makemigrations --check` (siehe
+`.github/workflows/ci.yml`).
+
+## Stand
+
+`0.4.0` — Tenancy-Basis, RLS-Erzeuger, Registries (KONZ-meiki-009 U3). Noch von
+keinem Repo als Abhängigkeit gebunden. `tenant_id` bleibt `BigIntegerField`;
+der Vorschlag, in der ganzen Familie auf UUID zu wechseln (KONZ-meiki-009 § 4.1,
+D-2), ist offen und hier nicht vorweggenommen.

kommunalassist_core-0.5.0/assist_core/__init__.py

@@ -0,0 +1,12 @@
+"""kommunalassist-core — der gemeinsame Kern der Kommunalassist-Familie.
+
+Was hier liegt, brauchen **mehrere** Assists: die Mandanten-Einstellung, die
+Termin-Engine mit ihrem Regelwerk und Freigabe-Workflow, und die Ports zu
+Fachverfahren und DMS.
+
+Grundlage: `meiki:ADR-044` (Paket-Topologie) und `meiki:ADR-022` v1.1 — die
+Termin-Engine hat zwei Konsumenten (FristAssist und StatistikAssist) und darf
+deshalb nicht hinter einem von beiden liegen.
+"""
+
+__version__ = "0.5.0"