# 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:

```bash
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:

```bash
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.