Panel/docs/ARCHITECTURE.md
2026-06-08 16:09:54 -05:00

1.3 KiB

GSP Architecture Overview

Workspace reference: GSP-WORKSPACE.md

This repository is the control plane for the GSP ecosystem. It owns the Panel, the Website, shared documentation, and the modules that decide what actions should be taken for each hosted server.

How to read this repo

Start here:

  1. README.md
  2. docs/ARCHITECTURE.md
  3. docs/PANEL_ARCHITECTURE.md
  4. docs/AGENT_COMMUNICATION.md
  5. docs/REPOSITORY_STRUCTURE.md
  6. docs/COMMAND_FLOW.md
  7. docs/UPDATE_POLICY.md

Then use the deeper docs under docs/architecture/, docs/features/, docs/modules/, and docs/development/ for implementation details.

System boundary

GSP owns:

  • user and admin-facing web UI
  • server lifecycle orchestration
  • module routing and shared state
  • XML/configuration authoring
  • update policy and backup policy
  • documentation for the full ecosystem

GSP does not own the OS-level execution engine. That responsibility belongs to the Linux and Windows agent repositories.

Canonical runtime model

User action → Panel module → remote command generation → agent communication → Linux or Windows agent → OGP Perl agent → operating system → hosted game server

The Panel is authoritative for business logic. Agents should execute requests and report results.