feat: explain configured institutional architecture

webui/src/api/docs.ts

@@ -1,5 +1,42 @@
 import { apiFetch, type ApiSettings } from "@govoplan/core-webui";
 
+export type DocsModuleArchitecture = {
+  contract_version: string;
+  layer: string;
+  kind: string;
+  maturity: string;
+  evidence: Array<{ kind: string; reference: string; summary: string }>;
+  known_limits: string[];
+  supported_authority_modes: string[];
+  owned_concepts: string[];
+  non_owned_concepts: string[];
+  reference_packages: string[];
+  target_tested_providers: string[];
+  documentation: Record<string, string[]>;
+};
+
+export type DocsExternalProvider = {
+  id: string;
+  module_id: string;
+  label: string;
+  maturity: string;
+  operations: string[];
+  authority_modes: string[];
+  behavior?: Record<string, unknown>;
+  known_outage_behavior?: string | null;
+  runtime_state?: {
+    configured?: boolean;
+    active?: boolean;
+    authority_mode?: string | null;
+    authority_modes?: string[];
+    health?: string;
+    freshness?: string;
+    conflict?: string;
+    recovery?: string;
+    observed_at?: string;
+  } | null;
+};
+
 export type DocsModule = {
   id: string;
   name: string;
@@ -16,6 +53,9 @@ export type DocsModule = {
   capabilities: string[];
   documentation_count: number;
   documentation_provider_count: number;
+  architecture?: DocsModuleArchitecture | null;
+  external_provider_count: number;
+  external_providers: DocsExternalProvider[];
 };
 
 export type DocsRoute = {
@@ -168,6 +208,8 @@ export type DocsContext = {
   };
   summary: {
     module_count: number;
+    architecture_declared_module_count: number;
+    external_provider_count: number;
     visible_route_count: number;
     available_route_count: number;
     permission_count: number;

webui/src/features/docs/DocsPage.tsx

@@ -969,6 +969,8 @@ function ModuleTable({ modules }: { modules: DocsModule[] }) {
   if (!modules.length) return <p className="muted">i18n:govoplan-docs.no_configured_modules_found.f6f9ce24</p>;
   const columns: DataGridColumn<DocsModule>[] = [
     { id: "module", header: "i18n:govoplan-docs.module.b8ff0289", width: "minmax(220px, 1fr)", minWidth: 190, resizable: true, sortable: true, filterable: true, value: (module) => `${module.name} ${module.id} ${module.version}`, render: (module) => <div><strong>{module.name}</strong><span className="muted block">{module.id} {module.version}</span></div> },
+    { id: "architecture", header: "i18n:govoplan-docs.architecture.4ca303a3", width: "minmax(210px, .9fr)", minWidth: 190, resizable: true, sortable: true, filterable: true, value: (module) => module.architecture ? `${module.architecture.layer} ${module.architecture.kind} ${module.architecture.maturity}` : "undeclared", render: (module) => module.architecture ? <div><strong>{module.architecture.maturity}</strong><span className="muted block">{module.architecture.layer} · {module.architecture.kind}</span>{module.architecture.known_limits.length ? <span className="muted block">{module.architecture.known_limits.length} i18n:govoplan-docs.known_limits.31871a6b</span> : null}</div> : <span className="muted">i18n:govoplan-docs.staged_declaration_pending.7ce9c1a1</span> },
+    { id: "authority", header: "i18n:govoplan-docs.source_authority.0a863835", width: "minmax(260px, 1fr)", minWidth: 230, resizable: true, filterable: true, value: (module) => `${module.architecture?.supported_authority_modes.join(" ") ?? ""} ${module.external_provider_count} ${module.external_providers.map((provider) => `${provider.runtime_state?.health ?? "unobserved"} ${provider.runtime_state?.freshness ?? ""} ${provider.runtime_state?.conflict ?? ""} ${provider.runtime_state?.recovery ?? ""}`).join(" ")}`, render: (module) => <div>{module.architecture?.supported_authority_modes.length ? module.architecture.supported_authority_modes.join(", ") : "-"}<span className="muted block">{module.external_provider_count} i18n:govoplan-docs.external_providers.d618fc54</span>{module.external_providers.map((provider) => <span className="muted block" key={provider.id}>{provider.label}: {provider.runtime_state ? `${provider.runtime_state.health ?? "unknown"} · ${provider.runtime_state.freshness ?? "unknown"} · ${provider.runtime_state.conflict ?? "unknown"} · ${provider.runtime_state.recovery ?? "unknown"}` : "unobserved"}</span>)}</div> },
     { id: "routes", header: "i18n:govoplan-docs.routes.03730e58", width: 170, sortable: true, value: (module) => module.route_count, render: (module) => <>{module.route_count} i18n:govoplan-docs.route.200e2a66 {module.nav_count} nav</> },
     { id: "permissions", header: "i18n:govoplan-docs.permissions.d06d5557", width: 130, sortable: true, value: (module) => module.permission_count },
     { id: "frontend", header: "i18n:govoplan-docs.frontend.152d1cf2", width: "minmax(180px, .8fr)", minWidth: 160, resizable: true, sortable: true, filterable: true, value: (module) => module.frontend_package || "-", render: (module) => module.frontend_package || "-" },

webui/src/i18n/generatedTranslations.ts

@@ -9,6 +9,7 @@ export const generatedTranslations: PlatformTranslations = {
     "i18n:govoplan-docs.advanced.203a8d6b": "Advanced",
     "i18n:govoplan-docs.available_documentation.db8bcc42": "Available documentation",
     "i18n:govoplan-docs.available_routes.c2635868": "Available routes",
+    "i18n:govoplan-docs.architecture.4ca303a3": "Architecture",
     "i18n:govoplan-docs.basics.5fcebeef": "Basics",
     "i18n:govoplan-docs.capabilities.ca09c54b": "Capabilities",
     "i18n:govoplan-docs.common_tasks.9f825c48": "Common tasks",
@@ -25,10 +26,12 @@ export const generatedTranslations: PlatformTranslations = {
     "i18n:govoplan-docs.evidence.7ea014de": "Evidence",
     "i18n:govoplan-docs.field.7558c082": "Field",
     "i18n:govoplan-docs.frontend.152d1cf2": "Frontend",
+    "i18n:govoplan-docs.external_providers.d618fc54": "external providers",
     "i18n:govoplan-docs.granted_permissions.0a232e78": "Granted permissions",
     "i18n:govoplan-docs.guidance_for_the_functions_available_in_this_ins.723b7cad": "Guidance for the functions available in this installation.",
     "i18n:govoplan-docs.help_center.f3f3a34b": "Help Center",
     "i18n:govoplan-docs.loading_documentation_context.1c091645": "Loading documentation context...",
+    "i18n:govoplan-docs.known_limits.31871a6b": "known limits",
     "i18n:govoplan-docs.meaning.584d8aa0": "Meaning",
     "i18n:govoplan-docs.module.b8ff0289": "Module",
     "i18n:govoplan-docs.modules.04e9462c": "Modules",
@@ -74,6 +77,7 @@ export const generatedTranslations: PlatformTranslations = {
     "i18n:govoplan-docs.screen.c4878ec4": "Screen",
     "i18n:govoplan-docs.section.5e498158": "Section",
     "i18n:govoplan-docs.source.6da13add": "Source",
+    "i18n:govoplan-docs.source_authority.0a863835": "Source authority",
     "i18n:govoplan-docs.source_details.6dc79c75": "Source details",
     "i18n:govoplan-docs.inspect_source.bcc1739d": "Inspect source",
     "i18n:govoplan-docs.inspection.83dc17ca": "Inspection",
@@ -81,6 +85,7 @@ export const generatedTranslations: PlatformTranslations = {
     "i18n:govoplan-docs.visibility.80ab5798": "Visibility",
     "i18n:govoplan-docs.close.87b84f71": "Close",
     "i18n:govoplan-docs.status.bae7d5be": "Status",
+    "i18n:govoplan-docs.staged_declaration_pending.7ce9c1a1": "Staged declaration pending",
     "i18n:govoplan-docs.steps.6041435e": "Steps",
     "i18n:govoplan-docs.summary.d6b9936d": "Summary",
     "i18n:govoplan-docs.technical_documentation_for_the_modules_and_conf.267e739e": "Technical documentation for the modules and configuration active in this installation.",
@@ -106,6 +111,7 @@ export const generatedTranslations: PlatformTranslations = {
     "i18n:govoplan-docs.advanced.203a8d6b": "Fortgeschritten",
     "i18n:govoplan-docs.available_documentation.db8bcc42": "Verfügbare Dokumentation",
     "i18n:govoplan-docs.available_routes.c2635868": "Verfügbare Routen",
+    "i18n:govoplan-docs.architecture.4ca303a3": "Architektur",
     "i18n:govoplan-docs.basics.5fcebeef": "Grundlagen",
     "i18n:govoplan-docs.capabilities.ca09c54b": "Fähigkeiten",
     "i18n:govoplan-docs.common_tasks.9f825c48": "Häufige Aufgaben",
@@ -122,10 +128,12 @@ export const generatedTranslations: PlatformTranslations = {
     "i18n:govoplan-docs.evidence.7ea014de": "Evidence",
     "i18n:govoplan-docs.field.7558c082": "Feld",
     "i18n:govoplan-docs.frontend.152d1cf2": "Frontend",
+    "i18n:govoplan-docs.external_providers.d618fc54": "externe Anbieter",
     "i18n:govoplan-docs.granted_permissions.0a232e78": "Gewährte Berechtigungen",
     "i18n:govoplan-docs.guidance_for_the_functions_available_in_this_ins.723b7cad": "Anleitung für die in dieser Installation verfügbaren Funktionen.",
     "i18n:govoplan-docs.help_center.f3f3a34b": "Hilfezentrum",
     "i18n:govoplan-docs.loading_documentation_context.1c091645": "Dokumentationskontext wird geladen...",
+    "i18n:govoplan-docs.known_limits.31871a6b": "bekannte Einschränkungen",
     "i18n:govoplan-docs.meaning.584d8aa0": "Bedeutung",
     "i18n:govoplan-docs.module.b8ff0289": "Modul",
     "i18n:govoplan-docs.modules.04e9462c": "Module",
@@ -171,6 +179,7 @@ export const generatedTranslations: PlatformTranslations = {
     "i18n:govoplan-docs.screen.c4878ec4": "Ansicht",
     "i18n:govoplan-docs.section.5e498158": "Bereich",
     "i18n:govoplan-docs.source.6da13add": "Quelle",
+    "i18n:govoplan-docs.source_authority.0a863835": "Quellenhoheit",
     "i18n:govoplan-docs.source_details.6dc79c75": "Quelldetails",
     "i18n:govoplan-docs.inspect_source.bcc1739d": "Quelle anzeigen",
     "i18n:govoplan-docs.inspection.83dc17ca": "Prüfdaten",
@@ -178,6 +187,7 @@ export const generatedTranslations: PlatformTranslations = {
     "i18n:govoplan-docs.visibility.80ab5798": "Sichtbarkeit",
     "i18n:govoplan-docs.close.87b84f71": "Schließen",
     "i18n:govoplan-docs.status.bae7d5be": "Status",
+    "i18n:govoplan-docs.staged_declaration_pending.7ce9c1a1": "Deklaration steht noch aus",
     "i18n:govoplan-docs.steps.6041435e": "Schritte",
     "i18n:govoplan-docs.summary.d6b9936d": "Zusammenfassung",
     "i18n:govoplan-docs.technical_documentation_for_the_modules_and_conf.267e739e": "Technische Dokumentation für die in dieser Installation aktiven Module und Konfiguration.",