Page:
Repo docs COMPATIBILITY INVENTORY
Pages
Codex Project Index
Product govoplan govoplan concept dev
Product govoplan split concept action plan
Repo-README
Repo README
Repo docs ACCESS RBAC MODEL
Repo docs ACTION EFFECT AUTOMATION LAYER
Repo docs AUTOMATION CONTRACTS
Repo docs CODEX WORKFLOW
Repo docs COMPATIBILITY INVENTORY
Repo docs COMPATIBILITY POLICY
Repo docs CONFIGURATION PACKAGES
Repo docs CONTEXTUAL HELP CONTRACT
Repo docs DATAGRID SIZING CONTRACT
Repo docs DEPENDENCY AUDITS
Repo docs DEPLOYMENT OPERATOR GUIDE
Repo docs DOCUMENTATION MAP
Repo docs DURABLE RECOVERY OPERATIONS
Repo docs EVENTS AND AUDIT
Repo docs EXTERNAL REFERENCES AND INTEGRATION MATURITY
Repo docs GITEA ISSUES
Repo docs GOVERNANCE MODEL
Repo docs GOVOPLAN MASTER ROADMAP
Repo docs INFORMATION GOVERNANCE ADOPTION
Repo docs INSTITUTIONAL CONTEXT CONTRACT
Repo docs INTERFACE ETHICS AND DESIGN DOCTRINE
Repo docs INTERFACE PATTERN MIGRATION
Repo docs LOCALIZATION AND HELP QUALITY
Repo-docs-MODULE-ARCHITECTURE
Repo docs MODULE ARCHITECTURE
Repo docs MODULE LIFECYCLE RECOVERY
Repo docs POLICY CONTRACTS
Repo docs POSTBOX E2EE ARCHITECTURE
Repo docs PUBLIC SECTOR INTEGRATION STRATEGY
Repo docs RECORDS FILING CONTRACT
Repo-docs-RELEASE-DEPENDENCIES
Repo docs RELEASE DEPENDENCIES
Repo docs REMOTE WEBUI BUNDLES
Repo docs SEARCH EVENT INDEXING CONTRACT
Repo docs SECURITY AUDIT
Repo docs SELF HOSTED INSTALLABILITY
Repo docs STATE AND RECOVERY CONTRACT
Repo docs TABULAR SOURCE CONTRACT
Repo docs TEMPLATE CAPABILITY CONTRACT
Repo docs TEMPORAL DATA CONTEXT
Repo docs THEMING
Repo docs THROTTLING
Repo docs UI UX DECISION LEDGER
Repo docs WEBUI BUNDLE BUDGETS
Repo docs WEBUI MODULE PACKAGE LAYOUT
Repo docs audits 2026 07 09 dependency audit
Clone
2
Repo docs COMPATIBILITY INVENTORY
Albrecht Degering edited this page 2026-08-05 16:49:06 +02:00
Mirrored from
/mnt/DATA/git/govoplan-core/docs/COMPATIBILITY_INVENTORY.md. Origin:repository. Active tasks and changing state belong in Gitea issues; this wiki page is durable project context.
GovOPlaN Compatibility Inventory
This inventory classifies compatibility paths covered by
COMPATIBILITY_POLICY.md. It is intentionally limited to behavior that changes
accepted data, imports, permissions, or migration state. Operational fallbacks
such as Redis degradation and language fallback are not compatibility paths.
Database Bridges
| Path | Purpose | Retention | Removal |
|---|---|---|---|
govoplan_core.db.migrations.reconcile_legacy_create_all_schema |
Reconciles databases created before Alembic ownership was recorded. | At least one major release after runtime aliases are removed. | Review after 1.0; keep release-baseline tests. |
Migration table/column aliases in govoplan_core.db.migrations |
Detect and reconcile pre-split table ownership and migration tracks. | All tagged 0.1.x upgrade origins plus one major release cycle. |
Remove only after the corresponding baseline leaves support. |
| Access and module migration backfills for legacy permission names | Converts persisted role assignments without dropping authority. | Same as the database upgrade origin that contains the old role. | Keep migrations immutable; remove only runtime expansion at 0.2. |
Portable-Schema Readers
| Path | Purpose | Retention | Removal |
|---|---|---|---|
govoplan_core.mail.config.normalize_split_transport_credentials |
Reads pre-split SMTP/IMAP credentials and emits the split representation. | Current and previous two configuration schema versions. | Version-gate once Mail writes an explicit current schema version; reject inputs older than the two-version window. |
ImapServerConfig.discard_legacy_enabled |
Reads the former nested IMAP enabled field without writing it. |
Current and previous two configuration schema versions. | Remove with the oldest accepted Mail configuration schema. |
govoplan_core.core.configuration_packages readers |
Reads explicitly versioned configuration-package manifests. | Current and previous two schema versions. | Retire individual readers as their version leaves the window. |
Runtime And API Aliases
| Path | Purpose | Retention | Removal |
|---|---|---|---|
govoplan_core.security.scope_aliases.LEGACY_SCOPE_ALIASES |
Expands pre-granular permission names. | Tagged 0.1.x runtime/API window. |
Remove at 0.2 after role backfills and migration notes are verified. |
govoplan_core.security.module_permissions.LEGACY_TO_MODULE_SCOPES |
Maps pre-module-split scopes to canonical owning-module scopes. | Tagged 0.1.x runtime/API window. |
Remove at 0.2; keep database migration evidence for one major cycle. |
govoplan_core.privacy.retention |
Stable import facade delegating policy-owned behavior through a capability. | Tagged 0.1.x import window. |
Remove at 0.2 after all in-tree callers use the policy contract and release notes name the replacement. |
| Legacy tenant aliases in API response schemas | Preserves active-tenant response fields used by 0.1.x clients. |
Tagged 0.1.x API window. |
Remove at 0.2 with response-schema migration notes. |
| Optional fields in Poll response references | Accepts providers built against the earlier Poll contract. | Tagged 0.1.x runtime contract window. |
Remove or require a new interface version at 0.2. |
| Legacy single-tenant summary providers | Allows modules without the batch provider introduced in 0.1.x. |
Tagged 0.1.x module contract window. |
Remove at 0.2 after manifests advertise the batch provider contract. |
WebUI react-router-dom build alias |
Resolves tagged 0.1.x module source imports to Core's single react-router runtime so one composition never loads two router contexts. |
Tagged 0.1.x WebUI source window. |
Remove at 0.2 after every supported module tag imports react-router directly. |
Removed Paths
| Path | Reason | Removed |
|---|---|---|
govoplan_core.core.module_installer._run_restart_command_legacy |
Private wrapper had no callers and never represented a persisted or published contract. | Current development line |
Retired govoplan_core.api.admin and pre-split core model imports |
In-tree callers and module packages use their owning modules; regression tests prohibit reintroduction. | Before 0.1.10 |
Every new compatibility path must be added here with its classification, diagnostic, test owner, and planned removal release.