Move platform admin services and models into owning modules #63
Closed
opened 2026-07-06 13:45:00 +02:00 by zemion
·
16 comments
No Branch/Tag Specified
main
v0.1.46
v0.1.45
v0.1.44
v0.1.43
v0.1.42
v0.1.41
v0.1.40
v0.1.39
v0.1.38
v0.1.37
v0.1.36
v0.1.35
v0.1.34
v0.1.33
v0.1.32
v0.1.31
v0.1.30
v0.1.29
v0.1.28
v0.1.27
v0.1.26
v0.1.25
v0.1.24
v0.1.23
v0.1.22
v0.1.21
v0.1.20
v0.1.19
v0.1.18
v0.1.17
v0.1.16
v0.1.15
v0.1.14
v0.1.13
v0.1.12
v0.1.11
v0.1.8
v0.1.7
v0.1.6
v0.1.4
v0.1.3
v0.1.2
v0.1.1
v0.1.0
Labels
Clear labels
area/api
area/auth
area/db
area/devex
area/docs
area/governance
area/marketing
area/migrations
area/module-system
area/rbac
area/release
area/security
area/tenancy
area/webui
audit/complexity
audit/duplication
audit/false-positive
audit/needs-design
audit/quick-fix
audit/structural
codex/needs-human
codex/ready
module/access
module/addresses
module/admin
module/appointments
module/approvals
module/audit
module/calendar
module/campaign
module/cases
module/committee
module/connectors
module/core
module/dashboard
module/dataflow
module/datasources
module/decisions
module/dist-lists
module/dms
module/docs
module/encryption
module/erp
module/evaluation
module/files
module/fit-connect
module/forms
module/forms-runtime
module/helpdesk
module/identity
module/identity-trust
module/idm
module/ledger
module/mail
module/mandates
module/notifications
module/ops
module/organizations
module/parties
module/payments
module/permits
module/policy
module/poll
module/portal
module/postbox
module/projects
module/quick-access
module/records
module/reporting
module/risk-compliance
module/scheduling
module/search
module/services
module/tasks
module/templates
module/tenancy
module/tickets
module/views
module/voting
module/wiki
module/workflow
module/workflow-engine
module/xoev
module/xrechnung
module/xta-osci
source/backlog-import
source/security-audit
source/todo-scan
HTTP API contracts, routers, schemas, or API smoke behavior.
Authentication, sessions, access bootstrap, or login behavior.
Database sessions, models, transactions, or persistence primitives.
Local developer workflow, scripts, tests, tooling, or release helpers.
Durable documentation and project guidance.
Governance policy, audit, privacy, retention, or compliance behavior.
Public website, product messaging, publication copy, or legal page content.
Alembic migrations, schema bootstrap, or persistence evolution.
Module discovery, manifests, capabilities, routing, or optional integrations.
Permissions, roles, delegation, or authorization policy.
Versioning, release locks, tags, packaging, or dependency pins.
Security posture, static analysis, supply-chain hardening, or vulnerability remediation.
Tenant boundaries, provisioning, or tenant-scoped data behavior.
Shared WebUI shell, frontend components, routing, or frontend tests.
Complexity finding from Radon, Xenon, or equivalent maintainability scans.
Duplicated-code finding from jscpd or equivalent similarity scans.
Audit finding reviewed as a narrow false positive or acceptable risk.
Audit finding that needs an architectural or product decision before implementation.
Audit finding that appears narrow and directly fixable.
Audit finding that needs design, refactoring, or behavior review.
Needs an explicit human decision before Codex should implement.
Suitable for Codex to pick up with the existing issue context.
GovOPlaN access, identity, authentication, RBAC, and administration behavior.
GovOPlaN Addresses module behavior or integration.
GovOPlaN Admin module behavior or integration.
GovOPlaN Appointments module behavior or integration.
GovOPlaN Approvals module behavior or integration.
GovOPlaN Audit module behavior or integration.
GovOPlaN Calendar module behavior or integration.
GovOPlaN campaign module behavior or integration.
GovOPlaN Cases module behavior or integration.
GovOPlaN Committee module behavior or integration.
GovOPlaN Connectors module behavior or integration.
GovOPlaN core runner, shared primitives, shell, or extension points.
GovOPlaN Dashboard module behavior or integration.
GovOPlaN Dataflow module behavior or integration.
GovOPlaN governed datasource contracts, catalogs, and integrations.
GovOPlaN formal Decisions module behavior or integration.
GovOPlaN Distribution Lists module behavior or integration.
GovOPlaN Dms module behavior or integration.
GovOPlaN Docs module behavior or integration.
GovOPlaN Encryption key custody, cryptographic policy, and E2EE integration.
GovOPlaN Erp module behavior or integration.
GovOPlaN Evaluation module behavior or integration.
GovOPlaN files module behavior or integration.
GovOPlaN Fit Connect module behavior or integration.
GovOPlaN Forms module behavior or integration.
GovOPlaN Forms Runtime module behavior or integration.
GovOPlaN Helpdesk module behavior or integration.
GovOPlaN Identity module behavior or integration.
GovOPlaN Identity Trust module behavior or integration.
GovOPlaN Idm module behavior or integration.
GovOPlaN Ledger module behavior or integration.
GovOPlaN mail module behavior or integration.
GovOPlaN Mandates, jurisdiction, responsibility, and authority behavior or integration.
GovOPlaN Notifications module behavior or integration.
GovOPlaN Ops module behavior or integration.
GovOPlaN Organizations module behavior or integration.
GovOPlaN procedure Parties, representation, and delivery-authority behavior or integration.
GovOPlaN Payments module behavior or integration.
GovOPlaN Permits module behavior or integration.
GovOPlaN Policy module behavior or integration.
GovOPlaN Poll module behavior or integration.
GovOPlaN Portal module behavior or integration.
GovOPlaN Postbox module behavior or integration.
GovOPlaN Projects module behavior or integration.
GovOPlaN configurable task-local Quick Access behavior and integrations.
GovOPlaN Records and eAkte lifecycle behavior or integration.
GovOPlaN Reporting module behavior or integration.
GovOPlaN Risk Compliance module behavior or integration.
GovOPlaN Scheduling module behavior or integration.
GovOPlaN Search module behavior or integration.
GovOPlaN versioned institutional Services behavior or integration.
GovOPlaN Tasks module behavior or integration.
GovOPlaN Templates module behavior or integration.
GovOPlaN Tenancy module behavior or integration.
GovOPlaN Tickets module behavior or integration.
GovOPlaN governed task views, interface projections, and workflow view integration.
GovOPlaN Voting module behavior or integration.
GovOPlaN Wiki module behavior or integration.
GovOPlaN Workflow module behavior or integration.
GovOPlaN Workflow Engine runtime, persistence, or integration.
GovOPlaN Xoev module behavior or integration.
GovOPlaN Xrechnung module behavior or integration.
GovOPlaN Xta Osci module behavior or integration.
priority
p0
Immediate stop-the-line priority.
priority
p1
High priority for the next focused work window.
priority
p2
Normal planned priority.
priority
p3
Low priority or opportunistic cleanup.
Imported from markdown backlog, roadmap, plan, or TODO files.
Created from a structured security or code-quality audit report.
Imported from inline TODO/FIXME/HACK markers by the Gitea TODO importer.
status
blocked
Cannot progress without a decision, dependency, credential, or external change.
status
in-progress
Currently being worked.
status
needs-info
Needs clarifying input before implementation can proceed safely.
status
ready
Ready for implementation.
status
triage
Needs review, ownership, priority, or acceptance criteria.
type
bug
A reproducible defect, regression, or incorrect behavior.
type
debt
Cleanup, refactoring, risk reduction, or deferred engineering work.
type
docs
Documentation, process, or developer workflow work.
type
feature
New user-visible behavior or platform capability.
type
task
Implementation, maintenance, migration, or operational work.
type
user-story
End-to-end user journey or real-world process story used to steer product slices.
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: GovOPlaN/govoplan-core#63
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Scope
Follow-up after the route-handler split. Route handlers now live in access, admin, tenancy, policy, and audit module routers; the remaining debt is that several service helpers, schemas kept for compatibility, and persistence models still live in the access/core compatibility layer.
Acceptance criteria
Out of scope
No table/data migration should be bundled blindly; persistence moves need explicit Alembic planning.
Codex State: progress
Summary
Changed Files
src/govoplan_core/admin/common.pysrc/govoplan_core/admin/settings.pysrc/govoplan_core/tenancy/service.pysrc/govoplan_core/core/runtime.pysrc/govoplan_access/backend/directory.pysrc/govoplan_tenancy/backend/capabilities.pyscripts/check_dependency_boundaries.pydocs/ACCESS_EXTRACTION_PLAN.mdVerification
./scripts/check-focused.sh: passedpython -m unittest tests.test_module_system tests.test_access_contracts: passedNext / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Changed Files
src/govoplan_core/core/access.pysrc/govoplan_access/backend/directory.pysrc/govoplan_files/backend/storage/access.pysrc/govoplan_files/backend/storage/files.pysrc/govoplan_files/backend/router.pyscripts/check_dependency_boundaries.pydocs/ACCESS_EXTRACTION_PLAN.mdVerification
./scripts/check-focused.sh: passedNext / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Changed Files
govoplan_core/core/campaigns.pygovoplan_core/core/access.pygovoplan_files/backend/router.pygovoplan_files/backend/storage/files.pygovoplan_mail/backend/mail_profiles.pygovoplan_mail/backend/db/models.pygovoplan_campaign/backend/capabilities.pygovoplan_campaign/backend/router.pydocs/MODULE_ARCHITECTURE.mddocs/ACCESS_EXTRACTION_PLAN.mdVerification
python -m compileall core/access/admin/tenancy/policy/audit/files/mail/campaign source trees: passedscripts/check_dependency_boundaries.py: passed (8 transitional exceptions tracked)python -m unittest tests.test_access_contracts tests.test_module_system: passedselected tests.test_api_smoke tests: passedempty SQLite migrate_database with full modules: passed, heads 2c3d4e5f7081 and 3d4e5f708192scripts/check-focused.sh: passed, including WebUI module permutation builds and mail/campaign UI focused testsNext / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Changed Files
src/govoplan_core/core/campaigns.pysrc/govoplan_core/celery_app.pysrc/govoplan_core/privacy/retention.pysrc/govoplan_core/db/bootstrap.pysrc/govoplan_core/server/default_config.pydocs/MODULE_ARCHITECTURE.mddocs/ACCESS_EXTRACTION_PLAN.mdVerification
./.venv/bin/python scripts/check_dependency_boundaries.py./.venv/bin/python -m unittest tests.test_access_contracts tests.test_module_system./.venv/bin/python -m unittest tests.test_api_smoke.ApiSmokeTests.test_system_governance_defaults_templates_and_central_accounts tests.test_api_smoke.ApiSmokeTests.test_policy_responses_include_source_provenance tests.test_api_smoke.ApiSmokeTests.test_health_schema_and_dev_mailbox_gates./.venv/bin/python -m unittest tests.test_database_migrations.DatabaseMigrationTests.test_repairs_create_all_schema_drift_and_upgrades_to_head tests.test_database_migrations.DatabaseMigrationTests.test_repairs_current_schema_stamped_at_file_folders./scripts/check-focused.shNext / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Changed Files
govoplan-access/webui/src/module.tsgovoplan-access/webui/src/features/admingovoplan-access/src/govoplan_access/backend/manifest.pygovoplan-core/webui/src/App.tsxgovoplan-core/webui/src/layout/IconRail.tsxgovoplan-core/webui/src/platform/modules.tsgovoplan-core/tests/test_module_system.pyVerification
npm run build: passed before cleanupnpm run test:module-permutations: passed, including access-only and full-productpython -m unittest tests.test_module_system tests.test_access_contracts: passedpython scripts/check_dependency_boundaries.py: passed with 0 transitional exceptionsNext / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Changed Files
govoplan-access/src/govoplan_access/backend/db/models.pygovoplan-access/src/govoplan_access/backend/db/base.pygovoplan-access/src/govoplan_access/backend/auth/roles.pygovoplan-core/src/govoplan_core/db/models.pygovoplan-core/src/govoplan_core/db/bootstrap.pygovoplan-core/tests/test_module_system.pygovoplan-core/docs/ACCESS_EXTRACTION_PLAN.mdVerification
python -m compileall core/access/admin/tenancy/audit/policy packages: passedpython -m unittest tests.test_module_system tests.test_access_contracts tests.test_database_migrations: passedpython -m unittest tests.test_api_smoke: passedpython scripts/check_dependency_boundaries.py: passed with 0 transitional exceptionsNext / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Changed Files
govoplan_core/db/models.pygovoplan_core/server/registry.pygovoplan_core/core/migrations.pygovoplan_core/docs/MODULE_ARCHITECTURE.mdgovoplan_core/docs/ACCESS_EXTRACTION_PLAN.mdgovoplan_access/backend/db/models.pygovoplan_tenancy/backend/db/models.pygovoplan_admin/backend/db/models.pygovoplan_audit/backend/db/models.pyVerification
python -m compileall core/access/admin/tenancy/audit/policy sources: passedpython -m unittest tests.test_module_system tests.test_access_contracts tests.test_database_migrations: 24 passedpython -m unittest tests.test_api_smoke: 39 passednpm run test:module-permutations: passedscripts/check_dependency_boundaries.py: passedNext / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Changed Files
govoplan_admin/backend/governance.pygovoplan_admin/backend/api/v1/routes.pygovoplan_admin/backend/api/v1/schemas.pygovoplan_access/backend/api/v1/routes.pygovoplan_access/backend/admin/governance.pygovoplan_core/api/v1/admin_schemas.pygovoplan_core/admin/governance.pydocs/MODULE_ARCHITECTURE.mddocs/ACCESS_EXTRACTION_PLAN.mdVerification
python -m compileall core/access/admin/tenancy/audit sources: passedpython -m unittest tests.test_module_system tests.test_access_contracts tests.test_database_migrations: 25 passedpython -m unittest tests.test_api_smoke: 39 passedscripts/check_dependency_boundaries.py: passedgit diff --check in core/access/admin: passedNext / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Changed Files
govoplan-core/webui/src/types.tsgovoplan-core/webui/src/platform/moduleLogic.tsgovoplan-core/webui/src/components/admin/govoplan-access/webui/src/features/admin/AdminPage.tsxgovoplan-admin/webui/src/Verification
npm run build passed in govoplan-core/webuinpm run test:module-permutations passed, including admin-only and access-with-adminpython3 scripts/check_dependency_boundaries.py passedNext / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Changed Files
govoplan-core/src/govoplan_core/db/models.pygovoplan-core/src/govoplan_core/access/govoplan-core/src/govoplan_core/api/v1/audit.pygovoplan-core/src/govoplan_core/auth/dependencies.pygovoplan-audit/src/govoplan_audit/backend/api/v1/routes.pygovoplan-admin/src/govoplan_admin/backend/govoplan-tenancy/src/govoplan_tenancy/backend/api/v1/routes.pyVerification
python3 -m compileall passed for core/access/admin/tenancy/audit/policy/files/mail/campaignpython3 scripts/check_dependency_boundaries.py passed; 4 explicit transitional exceptions tracked./.venv/bin/python -m unittest tests.test_module_system tests.test_access_contracts tests.test_database_migrations passed./.venv/bin/python -m govoplan_core.devserver --smoke --no-reload passedNext / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Changed Files
govoplan-core/src/govoplan_core/core/access.pygovoplan-core/scripts/check_dependency_boundaries.pygovoplan-access/src/govoplan_access/backend/auth/dependencies.pygovoplan-access/src/govoplan_access/backend/administration.pygovoplan-access/src/govoplan_access/backend/governance_materializer.pygovoplan-access/src/govoplan_access/backend/tenancy/provisioning.pygovoplan-admin/src/govoplan_admin/backend/governance.pygovoplan-admin/src/govoplan_admin/backend/api/v1/routes.pygovoplan-tenancy/src/govoplan_tenancy/backend/api/v1/routes.pygovoplan-audit/src/govoplan_audit/backend/api/v1/routes.pyVerification
python3 -m compileall -q src/govoplan_core ../govoplan-access/src/govoplan_access ../govoplan-admin/src/govoplan_admin ../govoplan-tenancy/src/govoplan_tenancy ../govoplan-audit/src/govoplan_audit ../govoplan-policy/src/govoplan_policy ../govoplan-files/src/govoplan_files ../govoplan-mail/src/govoplan_mail ../govoplan-campaign/src/govoplan_campaignpython3 scripts/check_dependency_boundaries.py./.venv/bin/python -m unittest tests.test_module_system tests.test_access_contracts tests.test_database_migrationsNext / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Verification
./.venv/bin/python -m govoplan_core.devserver --smoke --no-reloadNext / Blocked
Suggested status label:
status/in-progressCodex State: checked 2026-07-09
Most of the acceptance is now complete: route/model ownership has been split, module WebUI contributions are in place, and python3 scripts/check_dependency_boundaries.py passes with 0 transitional exceptions.
I would keep this open for the remaining strict ownership cleanup: tenant/policy/audit-specific service and UI pieces are not fully in their owning modules yet, and core tenancy/bootstrap/retention still directly touch access models in a few places. A good next slice is extracting tenant counts/governance helpers and remaining service calls behind tenancy/access capabilities, then reassessing closure.
Review 2026-07-10: keeping this open.
scripts/check_dependency_boundaries.pypasses with 0 transitional exceptions, but strict ownership is not complete yet. Current remaining examples: core bootstrap still imports access services/models (govoplan_core/db/bootstrap.py), core tenant summary counts still query accessUser/Group/ApiKey(govoplan_core/tenancy/service.py), and retention/audit plumbing still imports audit/access ORM models directly (govoplan_core/privacy/retention.py,govoplan_core/audit/logging.py). Admin still aggregates system settings, governance, tenant counts, and retention policy surfaces across module boundaries. Close path: replace the remaining cross-module service/model access with capabilities/providers/events, then keep direct SQL only inside the owning module.Progress 2026-07-10: implemented a focused ownership cleanup slice. Core no longer statically imports access ORM/admin/API-key services for tenant counts, user/group privacy settings, or dev bootstrap.
AccessAdministrationnow owns tenant counts and scoped user/group settings access;TenantAccessProvisionernow owns development admin/user/API-key bootstrap. Core audit logging no longer statically importsAuditLog; audit SQL recording and audit-detail retention are now audit-owned providers (audit.recorder,audit.retention). Boundary check still passes with 0 transitional exceptions. Keeping this open because policy retention service ownership still lives in core,govoplan_core.authremains a compatibility re-export of access auth, and the broader provider/event-contract inventory is intentionally deferred to #50.Completed the platform admin/service/model ownership cleanup targeted by this issue: audit persistence is behind audit capabilities, retention implementation moved to
govoplan-policywith a core compatibility facade, tenant counts/settings access use access capabilities, andgovoplan_core.authno longer importsgovoplan_access. Focused tests and dependency boundary checks pass. Closing; remaining historical migration and direct fallback SQL cleanup are tracked in #78/#50.