23 lines
1.0 KiB
Markdown
23 lines
1.0 KiB
Markdown
# 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.
|