docs: declare institutional architecture boundary

2026-08-01 17:48:39 +02:00
parent 13aebde940
commit 91e0ffe810
2 changed files with 42 additions and 1 deletions
@@ -0,0 +1,16 @@
+# GovOPlaN REST Connector Codex Guide
+
+## Scope
+
+This repository owns governed REST publication, HTTP binding, serialization, connector policy, throttling, and transport diagnostics.
+
+## Documentation Contract
+
+- Treat documentation as part of every behavior change. Update this module's manifest-driven `DocumentationTopic` contributions for affected user and administrator behavior.
+- Keep feature content here; `govoplan-docs` projects it without importing REST internals.
+- Maintain a static user/admin baseline and run `/mnt/DATA/git/govoplan/tools/checks/check-manifest-shapes.py` after behavior or manifest changes.
+
+## Boundaries
+
+- Published modules retain validation, authorization, idempotency, and side-effect ownership.
+- Never expose an unrestricted proxy to internal APIs.