From 5049e7791f93fc75363389dbacb98999c4a107be Mon Sep 17 00:00:00 2001
From: Alexander Zielonka <n@2024.a>
Date: Mon, 5 Jan 2026 15:57:30 +0100
Subject: [PATCH] Update documentation for Factorio World Management
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add new components and service to directory structure
- Add Factorio World Management API endpoints
- Add feature description in Features section
- Mark feature as completed in todo.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 gsm.md  | 38 +++++++++++++++++++++++++++++++++++---
 todo.md |  1 +
 2 files changed, 36 insertions(+), 3 deletions(-)

diff --git a/gsm.md b/gsm.md
index 6f616c0..133d020 100644
--- a/gsm.md
+++ b/gsm.md
@@ -77,13 +77,14 @@ Frontend    Backend
 |   |   +-- ssh.js             # SSH-Verbindungen, Status, Uptime
 |   |   +-- rcon.js            # RCON-Kommunikation
 |   |   +-- prometheus.js      # Prometheus Queries
+|   |   +-- factorio.js        # Factorio Map-Gen Presets/Defaults
 |   |
 |   +-- middleware/
 |   |   +-- auth.js            # JWT Middleware
 |   |
 |   +-- db/
-|       +-- init.js            # DB-Schema, Whitelist-Cache
-|       +-- users.sqlite       # User-Datenbank
+|       +-- init.js            # DB-Schema, Caches, Templates
+|       +-- users.sqlite       # User-Datenbank (users, whitelist_cache, factorio_templates, factorio_world_settings)
 |
 +-- frontend/
     +-- src/
@@ -101,6 +102,8 @@ Frontend    Backend
     |   |   +-- LoginModal.jsx
     |   |   +-- SettingsModal.jsx
     |   |   +-- UserManagement.jsx
+    |   |   +-- FactorioWorldManager.jsx  # Factorio Save-Verwaltung
+    |   |   +-- WorldGenForm.jsx          # Map-Generation-Formular
     |   |
     |   +-- context/
     |       +-- UserContext.jsx
@@ -142,7 +145,7 @@ Frontend    Backend
 |--------|----------|------|--------------|
 | GET | /api/servers | optional | Alle Server mit Status/Metrics |
 | GET | /api/servers/:id | optional | Einzelner Server |
-| POST | /api/servers/:id/start | moderator | Server starten |
+| POST | /api/servers/:id/start | moderator | Server starten (body: `{save: "name"}` fuer Factorio) |
 | POST | /api/servers/:id/stop | moderator | Server stoppen |
 | POST | /api/servers/:id/restart | moderator | Server neustarten |
 | GET | /api/servers/:id/logs | moderator | Console Logs |
@@ -150,6 +153,21 @@ Frontend    Backend
 | GET | /api/servers/:id/whitelist | optional | Whitelist (gecached) |
 | GET | /api/servers/:id/metrics/history | optional | Prometheus History |
 
+### Factorio World Management
+
+| Method | Endpoint | Auth | Beschreibung |
+|--------|----------|------|--------------|
+| GET | /api/servers/factorio/saves | moderator | Liste aller Saves |
+| GET | /api/servers/factorio/current-save | JWT | Aktuell geladener Save |
+| GET | /api/servers/factorio/presets | moderator | Map-Gen Presets + Defaults |
+| GET | /api/servers/factorio/presets/:name | moderator | Einzelnes Preset |
+| GET | /api/servers/factorio/templates | moderator | Gespeicherte Templates |
+| POST | /api/servers/factorio/templates | moderator | Template speichern |
+| DELETE | /api/servers/factorio/templates/:id | moderator | Template loeschen |
+| POST | /api/servers/factorio/create-world | moderator | Neue Welt erstellen |
+| DELETE | /api/servers/factorio/saves/:name | moderator | Save loeschen |
+| GET | /api/servers/factorio/saves/:name/settings | moderator | Erstellungs-Settings einer Welt |
+
 ---
 
 ## Rollensystem
@@ -234,6 +252,20 @@ Frontend    Backend
 - Bearbeitung nur wenn Server online
 - Cache wird bei jeder Aenderung aktualisiert
 
+### Factorio World Management
+- **Worlds-Tab** in Server-Detail fuer Factorio-Server
+- **Gesperrte Verwaltung** wenn Server laeuft/startet/stoppt
+- **Save-Auswahl beim Start**: Klick auf "Start" bei einem Save startet den Server mit diesem Save
+- **Current-Save-Anzeige**: Im Overview-Tab wird angezeigt, welcher Save beim Starten geladen wird
+- **Neue Welt erstellen**:
+  - Vollstaendiges Map-Generation-Formular (Terrain, Ressourcen, Gegner, Evolution)
+  - Presets (Default, Rich Resources, Marathon, Death World, etc.)
+  - Templates speichern und laden
+  - Seed-Eingabe (optional)
+- **World Settings anzeigen**:
+  - Info-Button bei jeder Welt zeigt Erstellungs-Einstellungen
+  - Legacy-Fallback fuer Welten vor diesem Feature
+
 ### Navbar-Logo
 - Grau (navbarlogograuer.png) im Normalzustand
 - Weiss (navbarlogoweiss.png) bei Hover
diff --git a/todo.md b/todo.md
index b1a7d8b..5d6d3ad 100644
--- a/todo.md
+++ b/todo.md
@@ -58,3 +58,4 @@
 - [x] ~~Game-Logos in UI~~
 - [x] ~~Navbar-Logo mit Hover-Effekt~~
 - [x] ~~V Rising Server hinzugefuegt~~
+- [x] ~~Factorio World Management (Save-Auswahl, Welt erstellen, Templates, Settings anzeigen)~~