yakpanel-core/architecture/2026/08-folder-structure.md

Suggested 2026 Folder Structure

Root Layout

YakPanel-master/
  panel-api/             # Laravel control plane
  panel-web/             # Next.js + Tailwind UI
  control-plane-go/      # Go execution services
  yak-agent/             # Go daemon on managed servers
  architecture/2026/     # Blueprint and contracts

Laravel (panel-api)

• app/Modules/Auth
• app/Modules/Tenant
• app/Modules/Rbac
• app/Modules/Server
• app/Modules/Agents
• app/Modules/Site
• app/Modules/Ssl
• app/Modules/Files
• app/Modules/Cron
• app/Modules/Firewall
• app/Modules/Backups
• app/Modules/Plugin
• app/Modules/Metrics
• routes/api_v1

Next.js (panel-web)

• src/app/(dashboard)
• src/features/server
• src/features/sites
• src/features/marketplace
• src/features/metrics
• src/lib/api
• src/lib/ws

Go control-plane (control-plane-go)

• cmd/agent-gateway
• cmd/engine-site
• cmd/engine-docker
• cmd/engine-db
• cmd/engine-security
• cmd/engine-backup
• cmd/engine-fileops
• internal/orchestration
• internal/webserver
• pkg/contracts
• pkg/proto

Go agent (yak-agent)

• cmd/agent
• internal/transport
• internal/executor
• internal/collectors
• internal/updater
• pkg/capabilities