worshop work

docs/PANEL_ARCHITECTURE.md

@@ -0,0 +1,26 @@
+# GSP Panel Architecture
+
+Workspace reference: [`GSP-WORKSPACE.md`](../../GSP-WORKSPACE.md)
+
+The Panel is the orchestration layer for GSP. It handles authentication, routing, server lifecycle decisions, file/config management, Workshop/content workflows, status display, scheduling, and updates.
+
+## Responsibilities
+
+- load modules from `Panel/modules/`
+- read and write panel-side database state
+- generate requests for remote agents
+- validate server configuration and XML
+- render admin and customer workflows
+- coordinate backups, updates, and rollback
+
+## Important implementation areas
+
+- `Panel/includes/lib_remote.php` for agent communication
+- `Panel/modules/config_games/` for game XML definitions
+- `Panel/modules/update/` and update-related administration modules
+- `Panel/modules/gamemanager/` for server lifecycle and logs
+- `Panel/modules/addonsmanager/` for server content and Workshop flows
+
+## Design rule
+
+The Panel decides what should happen. It does not depend on agents to make business decisions, only to execute requests and report their status.