add-ideas/govoplan-core
1
0
Fork 0
Code Issues 45 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
30c11a6dcfc97e34b8cd8cfac9630d02ece0d29d
govoplan-core/README.md

1.5 KiB
Raw Blame History

govoplan-core

Reusable core components for the Government Operational Platform GovOPlaN.

This repository owns platform-level contracts and infrastructure that should not be coupled to a consuming product module:

  • backend module manifests and registry validation
  • server runner integration for routes, metadata and module availability
  • database session/base primitives and module migration registration
  • tenant/access/RBAC models and permission evaluation
  • stable principal DTOs, token helpers and tenant datastore abstractions
  • shared WebUI package @govoplan/core-webui for API/CSRF/auth helpers, core types, generic UI components, login UI and shell layout primitives

Modules register backend routes, permissions, nav items, frontend package metadata, SQLAlchemy metadata and migration locations through their govoplan.modules manifest. The core runner aggregates those contributions and exposes the combined platform.

Development

Install the backend core and module checkouts through the core development environment:

cd /mnt/DATA/git/govoplan-core
./.venv/bin/python -m pip install -r requirements-dev.txt

Install WebUI dependencies from the core WebUI runner, which links the module WebUI packages from the neighboring module repositories:

cd /mnt/DATA/git/govoplan-core/webui
PATH=/home/zemion/.nvm/versions/node/v22.22.3/bin:$PATH /home/zemion/.nvm/versions/node/v22.22.3/bin/npm install

Production deployments should use tagged git dependencies or published package versions, not runtime file copying.