readme

README.md

@@ -1,20 +1,81 @@
-<div align="center">
-<img width="1200" height="475" alt="GHBanner" src="https://github.com/user-attachments/assets/0aa67016-6eaf-458a-adb2-6e31a0763ed6" />
-</div>
+# Obsidian | RP Plattform
 
-# Run and deploy your AI Studio app
+**Obsidian** ist ein modernes, webbasiertes Dashboard für Minecraft Roleplay-Server. Es dient als "Immersive Interface" für Spieler und Admins, um Charakterdaten, Inventare, Städte, Organisationen und wirtschaftliche Aktivitäten außerhalb des Spiels darzustellen.
 
-This contains everything you need to run your app locally.
+Das Projekt zielt darauf ab, die Lücke zwischen In-Game-Geschehen und Web-Präsenz zu schließen, ohne ein komplexes Backend (PHP/Python/Node) zwingend vorauszusetzen.
 
-View your app in AI Studio: https://ai.studio/apps/drive/1o1Z6erDhereYS10vVy3VaRuXeUPxu-Nh
+---
 
-## Run Locally
+## ✨ Features
 
-**Prerequisites:**  Node.js
+### 👤 Bürger & Charakterakten
+*   **Visuelles Inventar**: Darstellung von Items, Rüstung und NBT-Daten in einem Grid-Layout.
+*   **Story-Engine**: Markdown-Rendering für Charakter-Hintergrundgeschichten.
+*   **Identity Linking**: (Mockup) Discord-Login zur Verknüpfung von Spielern mit ihren RP-Charakteren.
 
+### 🏙️ Geopolitik & Organisationen
+*   **Städte-Profile**: Banner, Statistiken (Steuern, Verteidigung), Bewohnerlisten und politische Strukturen.
+*   **Wirtschaftssystem**: Spielergeführte Unternehmen mit integrierten Produkt- und Dienstleistungskatalogen.
+*   **Hierarchie**: Darstellung von Gilden, Firmen und Fraktionen.
 
-1. Install dependencies:
-   `npm install`
-2. Set the `GEMINI_API_KEY` in [.env.local](.env.local) to your Gemini API key
-3. Run the app:
-   `npm run dev`
+### 🛠️ Technische Tools (Simuliert)
+*   **Datapack Generator**: Erstellt automatisch `.mcfunction`-Dateien für den Minecraft-Server, um Daten sicher via "Item-Umbenennung" (Non-OP Input) zu erfassen.
+*   **SQL-Konsole**: Eine simulierte Datenbank-Oberfläche, um SQL-Queries auf den lokalen Datensätzen auszuführen (für Immersion und Admin-Feeling).
+*   **Telemetry Dashboard**: Echtzeit-ähnliche Statistiken über Server-Aktivitäten.
+
+---
+
+## 🚀 Installation & Start
+
+Da dieses Projekt auf modernen Web-Standards (ES Modules & React 19 via CDN) basiert, ist **kein Build-Prozess** (kein `npm run build`) zwingend erforderlich, um die Demo zu starten.
+
+### Voraussetzungen
+*   Ein moderner Browser (Chrome, Firefox, Edge).
+*   Ein lokaler Webserver (z.B. VS Code "Live Server", Python `http.server` oder `npx serve`).
+
+### Starten
+1.  Repository klonen oder herunterladen.
+2.  Öffne den Ordner im Terminal.
+3.  Starte einen statischen Server. Beispiel mit Python:
+    ```bash
+    python3 -m http.server 8000
+    ```
+4.  Öffne `http://localhost:8000` im Browser.
+
+---
+
+## ⚙️ Architektur & Datenfluss (Konzept)
+
+Obsidian ist als "Serverless"-Viewer konzipiert. In einer echten Produktionsumgebung funktioniert der Datenfluss wie folgt:
+
+1.  **Minecraft Server**: Ein Datapack (siehe Generator im Tool) exportiert Inventare und Spielerdaten in JSON-Formate in den Server-Log oder via Plugin.
+2.  **Sync-Script**: Ein einfaches Shell/Batch-Skript lädt diese JSON-Dateien per FTP auf den Webserver hoch.
+3.  **Frontend**: Obsidian liest die statischen JSON-Dateien (`fetch('/api/players.json')`) und stellt sie dar.
+
+*Aktueller Status:* In dieser Demo-Version werden alle Daten aus `constants.ts` und `MockDatabaseService.ts` geladen, um die Funktionalität ohne echten Server zu demonstrieren.
+
+---
+
+## 🎨 Tech Stack
+
+*   **Framework**: React 19 (via ESM Imports)
+*   **Styling**: Tailwind CSS (CDN Runtime für Demo / Buildless Setup)
+*   **Icons**: Custom SVG Set (Lucide-Style)
+*   **Type Safety**: TypeScript (JSDoc/Interfaces im Code)
+
+---
+
+## 📸 Projektstruktur
+
+*   `index.html`: Entry Point & Import Maps.
+*   `App.tsx`: Haupt-Routing und Layout-Logik.
+*   `pages/`: Einzelne Ansichten (Dashboard, Profile, SQL-Manager).
+*   `components/`: Wiederverwendbare UI-Elemente (InventoryGrid, Layout).
+*   `services/`: Simulierte Backend-Logik (Database, Auth).
+*   `constants.ts`: Mock-Daten für Spieler, Städte und Items.
+
+---
+
+## 📄 Lizenz
+
+Entwickelt als Konzeptstudie für immersive RP-Communities. Frei verwendbar.