From 2618fb9e4552fc671862dd15094cb35b4d9a6af8 Mon Sep 17 00:00:00 2001
From: IgorRachkov <89467086+igor04091968@users.noreply.github.com>
Date: Sun, 14 Jun 2026 14:33:58 +0300
Subject: [PATCH] docs(portal): document production runtime boundary

---
 adk-rust/crates/detmir-portal/src/production/mod.rs | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/adk-rust/crates/detmir-portal/src/production/mod.rs b/adk-rust/crates/detmir-portal/src/production/mod.rs
index 2ce4c30..3473dac 100644
--- a/adk-rust/crates/detmir-portal/src/production/mod.rs
+++ b/adk-rust/crates/detmir-portal/src/production/mod.rs
@@ -1,3 +1,14 @@
+//! Production-facing portal runtime support.
+//!
+//! This module groups the cross-cutting concerns that must stay consistent
+//! across all portal routes: health/readiness/version contracts, query and
+//! configuration limits, structured logging, Prometheus-style metrics and
+//! request correlation metadata.
+//!
+//! CONTRACT: keep this module free from role-specific business rendering. It is
+//! the operational boundary around the portal, not the workforce/security report
+//! implementation itself.
+
 pub(crate) mod health;
 pub(crate) mod limits;
 pub(crate) mod logging;