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.

internal/scheduler/run.go

@@ -26,17 +26,15 @@ type Deps struct {
 	HTTP     *http.Client
 }
 
-// Run blocks until ctx is cancelled. When deps is nil or incomplete, falls back to connect-only stub logging.
+// Run blocks until ctx is cancelled. Misconfigured deps terminate the process (no idle fallback).
 func Run(ctx context.Context, deps *Deps) {
 	cfg := config.Load()
 	broker.LogConnect(ctx, cfg.BrokerURL)
 	if deps == nil || deps.Store == nil {
-		runStub(ctx)
-		return
+		log.Fatalf("evobgp-scheduler: missing store (pass scheduler.Deps with Store from BootstrapWorkers or evobgp-all)")
 	}
 	if deps.Jobs == nil && (strings.TrimSpace(deps.APIBase) == "" || strings.TrimSpace(deps.APIToken) == "") {
-		runStub(ctx)
-		return
+		log.Fatalf("evobgp-scheduler: need either in-process Jobs (evobgp-all) or both EVOBGP_CONTROL_PLANE_URL and EVOBGP_SCHEDULER_BEARER")
 	}
 	t := time.NewTicker(30 * time.Second)
 	defer t.Stop()
@@ -125,17 +123,3 @@ func postModuleRefresh(ctx context.Context, deps *Deps, moduleID, idempotencyKey
 	b, _ := io.ReadAll(io.LimitReader(resp.Body, 4096))
 	return fmt.Errorf("%s: %s", resp.Status, strings.TrimSpace(string(b)))
 }
-
-func runStub(ctx context.Context) {
-	t := time.NewTicker(60 * time.Second)
-	defer t.Stop()
-	log.Printf("evobgp-scheduler: idle stub (no store/jobs: pass scheduler.Deps from evobgp-all or bootstrap worker)")
-	for {
-		select {
-		case <-ctx.Done():
-			log.Printf("evobgp-scheduler: stopped")
-			return
-		case <-t.C:
-		}
-	}
-}