Files
govoplan-wiki/README.md
T
zemion 66c91351c9
Module Package Release / publish-packages (push) Successful in 12s
feat: implement governed wiki vertical slice
2026-08-22 13:08:12 +02:00

61 lines
2.5 KiB
Markdown

# GovOPlaN Wiki
<!-- govoplan-repository-type:start -->
**Repository type:** module (domain).
<!-- govoplan-repository-type:end -->
`govoplan-wiki` owns governed collaborative knowledge spaces and hierarchical,
revisioned pages. It is the native GovOPlaN alternative and integration target
for tools such as MediaWiki and BlueSpice.
The runtime module ID is `wiki`. The v0.1.20 vertical slice provides tenant-safe
spaces, hierarchical drafts, immutable revisions, optimistic concurrency,
publication and redirects, labels, typed links, append-only comments, access
inheritance, ACL-aware Search, DSAR participation export, and a focused WebUI.
## Boundary
Wiki owns spaces, pages, revisions, links, labels, page-level access, and
publishing state. It does not own binary file storage, formal records, product
documentation, workflow execution, or general-purpose collaborative document
editing.
## Runtime Surface
- `/api/v1/wiki/spaces` for governed spaces, access inheritance, publishing
mode, optimistic updates, and archival
- `/api/v1/wiki/pages` for page hierarchy, drafts, labels, references, redirects,
publication, and archival
- immutable page revision history and bounded unified-diff comparison
- append-only comments bound to the page revision under discussion
- `wiki.registry` for stable, authorization-checked cross-module references
- `wiki.pages` Search projection of the last published revision only
- `privacy.dsar.wiki` for exact-identifier, bounded participation export and
manual-review erasure planning
- `/wiki` tree/detail workspace built from shared Core layout, action-bar,
dialog, status, state, and selection primitives
Editing a published page creates a draft while the last published revision
remains visible to readers and Search. This prevents ordinary authoring from
silently withdrawing approved knowledge.
## Optional Integrations
Files and DMS own referenced binary content. Search discovers published pages.
Records can preserve a published revision as evidence. Projects, Cases, Tasks,
templates, and workflows can be linked without importing their lifecycles.
Connectors owns external Wiki discovery, credentials, transport,
reconciliation, and migration execution. Each absence leaves the native Wiki
usable and is documented as an explicit operational consequence.
See [docs/WIKI_DOMAIN_BOUNDARY.md](docs/WIKI_DOMAIN_BOUNDARY.md).
## Development
```bash
cd /mnt/DATA/git/govoplan-wiki
PYTHONPATH=src:/mnt/DATA/git/govoplan-core/src \
/mnt/DATA/git/govoplan/.venv/bin/python -m pytest -q
cd webui && node scripts/test-interface-pattern.mjs
```