new changes

architecture/2026/08-folder-structure.md

@@ -0,0 +1,58 @@
+# Suggested 2026 Folder Structure
+
+## Root Layout
+
+```text
+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`