Sync Repo-README from project files

2026-07-06 14:31:46 +02:00
commit d2f044245a

67
Repo-README.-.md Normal file

@@ -0,0 +1,67 @@
<!-- codex-wiki-sync:ee2a8545dd121548514a4904 -->
> Mirrored from `/mnt/DATA/git/govoplan-access/README.md`.
> Origin: `repository`.
> Active tasks and changing state belong in Gitea issues; this wiki page is durable project context.
---
# GovOPlaN Access
`govoplan-access` is the platform module for GovOPlaN identity,
authentication, sessions, API keys, RBAC, groups, users, and access
administration.
The repository contains the extracted access seed implementation under
`src/govoplan_access/backend`. Session, API-key, and password helper services,
interactive auth routes, and the legacy administration router are already
owned here and exposed through core compatibility imports while the staged
extraction continues. The legacy admin service/governance helpers are also
owned here, while legacy ORM models still reside in `govoplan-core` as
compatibility code. The staged extraction path is documented in:
- `/mnt/DATA/git/govoplan-core/docs/ACCESS_EXTRACTION_PLAN.md`
- `/mnt/DATA/git/govoplan-core/docs/MODULE_ARCHITECTURE.md`
## Initial Ownership
This module will own:
- accounts and login identity
- authentication routes and session lifecycle
- API keys
- legacy administration route contribution during the transition
- tenant-local users
- groups and memberships
- roles and role assignments
- principal resolution
- permission evaluation
- access administration backend routes
- access administration WebUI route contributions
- access-owned migrations
The kernel remains responsible for module discovery, route aggregation,
database/session lifecycle, migration orchestration, capability registry, and
stable contracts.
## Gitea Workflow
This repository uses the shared GovOPlaN Gitea issue workflow. Issue templates
are installed under `.gitea/`, and the shared label taxonomy is copied to
`docs/gitea-labels.json`.
From the core checkout, labels can be synced once a local `GITEA_TOKEN` is
available:
```bash
cd /mnt/DATA/git/govoplan-core
./scripts/gitea-sync-labels.py --root /mnt/DATA/git/govoplan-access --apply
```
## Development Install
From the core checkout:
```bash
cd /mnt/DATA/git/govoplan-core
./.venv/bin/python -m pip install -e ../govoplan-access
```