yakpanel-core/panel-api/README.md

YakPanel Control Plane API (Laravel)

This folder defines the 2026 Laravel control plane boundary.

Purpose

• API gateway for UI and third-party integrations.
• Tenant/RBAC enforcement before any execution request.
• Workflow orchestration and audit trail for system operations.

Initial modules

• app/Modules/Server: inventory and server lifecycle metadata.
• app/Modules/Agents: enrollment tokens, agent sessions, heartbeat updates.
• app/Modules/Jobs: command orchestration and execution state tracking.
• app/Modules/Auth: login/refresh/me/logout boundaries.
• app/Modules/Tenant: tenant lifecycle and membership boundaries.
• app/Modules/Rbac: role/permission/scope checks.
• routes/api_v1: versioned route groups.

Integration contract

• Never execute privileged shell operations directly in Laravel.
• Dispatch immutable command envelopes to Go execution plane.
• Persist all requests as jobs for visibility and replay-safe recovery.