feat: wire API queue projection to Redis

server/cmd/control-plane/main.go

@@ -15,6 +15,7 @@ import (
 	"github.com/cosmic-clash/cosmic-clash/server/migrations"
 	"github.com/cosmic-clash/cosmic-clash/server/store"
 	_ "github.com/jackc/pgx/v5/stdlib"
+	"github.com/redis/go-redis/v9"
 )
 
 func main() {
@@ -22,6 +23,9 @@ func main() {
 	role := flag.String("role", "api", "control-plane role; currently api")
 	dsn := flag.String("dsn", os.Getenv("COSMIC_CLASH_POSTGRES_DSN"), "PostgreSQL connection string")
 	migrationDir := flag.String("migrations", "migrations", "directory containing numbered SQL migrations")
+	redisAddr := flag.String("redis-addr", os.Getenv("COSMIC_CLASH_REDIS_ADDR"), "optional Redis address for the candidate projection")
+	redisPrefix := flag.String("redis-prefix", envOrDefault("COSMIC_CLASH_REDIS_PREFIX", "cosmic-clash"), "Redis key prefix")
+	redisTTL := flag.Duration("redis-ttl", 60*time.Second, "TTL for transient candidate projection entries")
 	flag.Parse()
 	if *role != "api" {
 		fatalf("unsupported role %q (only api is implemented)", *role)
@@ -29,6 +33,9 @@ func main() {
 	if *dsn == "" {
 		fatalf("--dsn or COSMIC_CLASH_POSTGRES_DSN is required")
 	}
+	if *redisTTL <= 0 {
+		fatalf("--redis-ttl must be positive")
+	}
 	db, err := sql.Open("pgx", *dsn)
 	if err != nil {
 		fatalf("open PostgreSQL: %v", err)
@@ -42,7 +49,14 @@ func main() {
 	if err := migrations.Apply(startupCtx, db, *migrationDir); err != nil {
 		fatalf("apply migrations: %v", err)
 	}
-	server := &http.Server{Addr: *listen, Handler: newAPIHandler(db), ReadHeaderTimeout: 5 * time.Second}
+	var candidateIndex api.CandidateIndex
+	var redisClient *redis.Client
+	if *redisAddr != "" {
+		redisClient = redis.NewClient(&redis.Options{Addr: *redisAddr})
+		defer redisClient.Close()
+		candidateIndex = store.RedisCandidateIndex{Client: redisClient, Prefix: *redisPrefix, TTL: *redisTTL}
+	}
+	server := &http.Server{Addr: *listen, Handler: newAPIHandler(db, candidateIndex), ReadHeaderTimeout: 5 * time.Second}
 	serveErr := make(chan error, 1)
 	go func() { serveErr <- server.ListenAndServe() }()
 	ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
@@ -61,16 +75,28 @@ func main() {
 	}
 }
 
-func newAPIHandler(db *sql.DB) http.Handler {
+func newAPIHandler(db *sql.DB, indexes ...api.CandidateIndex) http.Handler {
+	var candidateIndex api.CandidateIndex
+	if len(indexes) > 0 {
+		candidateIndex = indexes[0]
+	}
 	return (&api.Service{
 		SessionBackend:  store.PostgresSessions{DB: db},
 		QueueBackend:    store.PostgresQueue{DB: db},
 		ProposalBackend: api.ProposalProviderFromStore(db),
 		Assignment:      api.AssignmentProviderFromStore(db),
+		CandidateIndex:  candidateIndex,
 		Now:             func() time.Time { return time.Now().UTC() },
 	}).Handler()
 }
 
+func envOrDefault(name, fallback string) string {
+	if value := os.Getenv(name); value != "" {
+		return value
+	}
+	return fallback
+}
+
 func fatalf(format string, args ...any) {
 	fmt.Fprintf(os.Stderr, "control-plane: "+format+"\n", args...)
 	os.Exit(1)