yakpanel-core/architecture/2026/04-server-plane-implementation.md

Server Plane Implementation (v1)

Implemented Components

• Laravel server registry routes and controllers under panel-api.
• Agent enrollment/capability/session endpoints in panel-api.
• Go command contract and dispatcher interface in control-plane-go.
• agent-gateway process entrypoint for session and heartbeat responsibilities.

End-to-End Control Flow

1. User creates server via POST /api/v1/servers.
2. User requests one-time enrollment token.
3. Agent enrolls with gateway, obtains persistent identity.
4. Laravel writes job and dispatches command envelope.
5. Go dispatcher publishes command to execution topic.
6. Agent executes command and streams results back.
7. Laravel updates job state and exposes real-time status to UI.

Next Implementation Edges

• Persist server/agent entities in Eloquent models.
• Add request validation and RBAC middleware to server routes.
• Implement Redis Streams/NATS queue adapter for dispatcher queue interface.
• Add gateway gRPC service and heartbeat/session persistence adapter.