feat: add standalone controlplane support

internal/controlplane/types.go

@@ -0,0 +1,85 @@
+package controlplane
+
+import (
+	"context"
+
+	"github.com/cedar2025/xboard-node/internal/model"
+)
+
+type EventType string
+
+const (
+	EventSyncConfig    EventType = "sync.config"
+	EventSyncUsers     EventType = "sync.users"
+	EventSyncUserDelta EventType = "sync.user.delta"
+	EventSyncDevices   EventType = "sync.devices"
+)
+
+type Event struct {
+	Type        EventType
+	Config      *model.NodeSpec
+	Users       []model.UserSpec
+	DeltaAction string
+	DeltaUsers  []model.UserSpec
+	DeviceUsers map[int][]string
+}
+
+type StatusChange struct {
+	Connected bool
+}
+
+type APIMetrics struct {
+	Success uint64
+	Failure uint64
+}
+
+type Bootstrap struct {
+	PushInterval int
+	PullInterval int
+	Push         PushClient
+	Config       *model.NodeSpec
+	Users        []model.UserSpec
+}
+
+type Snapshot struct {
+	Config *model.NodeSpec
+	Users  []model.UserSpec
+}
+
+type ReportPayload struct {
+	Traffic map[int][2]int64
+	Alive   map[int][]string
+	Online  map[int]int
+	CPU     float64
+	Mem     [2]uint64
+	Swap    [2]uint64
+	Disk    [2]uint64
+	Metrics map[string]interface{}
+}
+
+type PushClient interface {
+	Run(ctx context.Context)
+	IsConnected() bool
+	SendDeviceReport(devices map[int][]string)
+}
+
+type Source interface {
+	Initial(ctx context.Context, metricsFn func() map[string]interface{}, events chan<- Event, statuses chan<- StatusChange) (Bootstrap, error)
+	Poll(ctx context.Context) (Snapshot, error)
+	Discover(ctx context.Context, metricsFn func() map[string]interface{}, events chan<- Event, statuses chan<- StatusChange) (PushClient, error)
+	Metrics() APIMetrics
+	SupportsPolling() bool
+	SupportsDiscovery() bool
+}
+
+type Sink interface {
+	Report(payload ReportPayload) error
+	ReportDevices(push PushClient, devices map[int][]string)
+	SupportsReporting() bool
+	SupportsDeviceReports() bool
+}
+
+type ControlPlane interface {
+	Source
+	Sink
+}