Zum Inhalt springen

Projekt & Architektur

Last updated 21.11.2026 17:53:41 by Administrator

Projekt & Architektur

Repository-Layout

Echtwelt3/
├── server/server.cfg          # FXServer-Konfiguration
├── resources/[echtwelt]/      # eine Domäne = eine Ressource
│   ├── ew_core/               # Bootstrap, Session, Networking, Config-Loader
│   ├── ew_database/           # Migrationen, Seeds, Repositories
│   ├── ew_accounts/           # Login, Registrierung, Ban, Sessions
│   ├── ew_characters/         # Erstellung, Auswahl, Spawn
│   ├── ew_needs/              # Hunger, Durst, Stamina, Temperatur
│   ├── ew_economy/            # Konten, Transfers, Rechnungen, Steuern
│   ├── ew_illegal/            # kriminelle Karriereleiter
│   └── …
├── ui/                        # React-NUI-Frontend (Glassmorphism)
├── shared/                    # geteilte C#-Vertragstypen
├── sql/                       # Migrationen & Seeds
└── docs/                      # Vision, Analyse, ADRs, Whitelabel

Tech-Stack

Ebene Wahl
Plattform FiveM (Cfx.re), fxserver latest
Server-Sprache C# (.NET) via CitizenFX.Core
Datenbank MySQL 8 / MariaDB mit Dapper
UI React 18 + TypeScript + Vite, Tailwind, Glassmorphism
Voice pma-voice (Proximity, Radio, Telefon)
CI Build-Checks pro Commit

Architektur-Grundsätze

  1. Ressourcen-Trennung pro Domäne — keine Gott-Klasse. Jede Domäne ist eine eigene Ressource mit eigener fxmanifest.lua und eigenem config/-Ordner.
  2. Server-authoritativ — der Client ist nie vertrauenswürdig. Validierung serverseitig.
  3. Daten in der DB — alles Persistente liegt in MySQL; Migrationen sind nummerierte SQL-Skripte (ew_database/migrations/).
  4. Konfiguration statt Code — ein config/*.json pro Ressource.

Konsequenz-Ökonomie (Vision)

„Hyper-realistisch" bedeutet: Jede Handlung hinterlässt Spuren, jede Spur hat Folgen. Organe, Krankheiten, Wirtschaftskreisläufe, Beweismaß im Rechtssystem — Details in docs/ANALYSE.md des Repos.