Panel/docs/ARCHITECTURE.md

51 lines
1.6 KiB
Markdown

# GSP Architecture Overview
Workspace reference: [`GSP-WORKSPACE.md`](../../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.
## Brand relationship
- `GSP` is the control panel and orchestration product
- `Gameservers.World` is the public hosting and sales surface
- `Runlevel Systems` is the current company identity behind the development, engineering, integration, and infrastructure work
## 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.