docs: update architecture and API documentation to clarify job processing, in-memory registry usage, and future broker integration plans. Enhance OpenAPI specifications for enrollment responses and refine quickstart instructions for Docker setups.

2026-04-05 18:36:32 +07:00
parent c6687b2c91
commit acc0608432
18 changed files with 110 additions and 96 deletions
@@ -1,4 +1,5 @@
-// Package broker stubs reference-profile message broker wiring (NATS JetStream / Redis; plan §2).
+// Package broker holds optional hooks for a future shared message bus (NATS JetStream / Redis).
+// См. docs/architecture.md: в текущей сборке очередь задач in-process в API; EVOBGP_BROKER_URL зарезервирован.
 package broker

 import (
@@ -7,12 +8,12 @@ import (
 	"strings"
 )

-// LogConnect logs a one-shot connection attempt when EVOBGP_BROKER_URL is set (full consumer/producer TBD).
+// LogConnect logs once when EVOBGP_BROKER_URL is set. Multi-process job delivery via a broker is not enabled in this build.
 func LogConnect(ctx context.Context, brokerURL string) {
 	u := strings.TrimSpace(brokerURL)
 	if u == "" {
 		return
 	}
-	log.Printf("broker: EVOBGP_BROKER_URL=%q (stub: no JetStream/Streams consumer in this binary yet)", u)
+	log.Printf("broker: EVOBGP_BROKER_URL=%q set; control plane still uses in-process jobs.Registry (no JetStream/Redis consumer in this binary)", u)
 	_ = ctx
 }