new changes

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

@@ -0,0 +1,22 @@
+# 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.