Admin Panel - Technische Dokumentation

SuperAdmin Panel - Monitoring, Verwaltung & Konfiguration Stand: Februar 2026 | Framework: Next.js 16 | Port: 3002

---

Was ist das Admin Panel?

Das Admin Panel ist die zentrale Verwaltungsoberfläche der ChainBETs-Plattform. Es bietet SuperAdmin-Zugang zu Benutzer-, Settlement-, Voucher- und Konfigurationsverwaltung sowie Echtzeit-Monitoring von Blockchain-State, Worker-Prozessen und Systemgesundheit.

┌──────────────────────────────────────────────────┐
│                Admin Panel (Port 3002)            │
│                                                   │
│  ┌──────────┐  ┌──────────┐  ┌────────────────┐  │
│  │Verwaltung│  │Monitoring│  │  Konfiguration │  │
│  │Users,    │  │Watchdog, │  │  bo_config,    │  │
│  │Vouchers, │  │Workers,  │  │  Contracts,    │  │
│  │Winners   │  │Seeds     │  │  Maintenance   │  │
│  └────┬─────┘  └────┬─────┘  └────────┬───────┘  │
│       │              │                 │           │
│       ▼              ▼                 ▼           │
│  ┌──────────────────────────────────────────────┐ │
│  │    PostgreSQL          Blockchain (RPC)       │ │
│  └──────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────┘

---

Dokumentationsübersicht

Architektur & Security

Dokument	Beschreibung
Systemarchitektur	Tech-Stack, Verzeichnisstruktur, Abhängigkeiten
Authentifizierung	JWT-Login, Session-Management, Middleware

Verwaltungsbereiche

Dokument	Beschreibung
Dashboard	Übersichtsseite mit Echtzeit-Metriken
Benutzerverwaltung	User-Liste, Detail, Bonus-Vergabe
Settlements	Tägliche Abrechnungen, Pipeline-Status
Kaufabsichten	Buy-Intent-Tracking und Fehleranalyse
Gutscheine	Voucher-Verwaltung und Bonus-Vergabe
Affiliates & Gewinner	Referral-Beziehungen, Gewinn-Auszahlungen
Charity Voting	Spendenabstimmungs-System

Monitoring & Infrastruktur

Dokument	Beschreibung
Contract-Monitoring	On-Chain-Salden, Contract-Registry
System-Monitoring	Watchdog, Workers, Seeds, Fehler-Tracking
Konfiguration	bo_config, Maintenance-Mode
API-Referenz	Alle 25 API-Endpoints
UI-Komponenten	Design-System, wiederverwendbare Komponenten
Betrieb & Deployment	Environment, Deployment, Sicherheit

---

Schnellreferenz

Seitenübersicht (Sidebar)

Seite	Pfad	Funktion
Dashboard	/dashboard	Echtzeit-Plattform-Metriken
Users	/users	Benutzerverwaltung
Settlements	/settlements	Settlement-Historie
Intents	/intents	Kaufabsichten-Tracking
Vouchers	/vouchers	Gutschein-Verwaltung
Affiliates	/affiliates	Referral-Beziehungen
Winners	/winners	Gewinner-Auszahlungen
Charity	/charity	Spendenabstimmungen
Config	/config	Plattform-Konfiguration
Contracts	/contracts	Smart-Contract-Salden
Errors	/errors	Fehler-Monitoring
Workers	/workers	Cron-Job-Status
Seeds	/seeds	VRF/Drand-Monitoring
Watchdog	/watchdog	System-Health-Checks
Test Players	/testplayers	Bulk-Buy-Test-Logs

Kritische Dateien

Datei	Funktion
proxy.ts	Middleware: Route-Whitelist + JWT-Auth
app/lib/auth.ts	JWT-Authentifizierung + bcrypt
app/lib/db.ts	PostgreSQL-Connection-Pool
app/api/contracts/route.ts	Contract-Registry + On-Chain-Abfragen
app/api/config/route.ts	CRUD für bo_config
app/api/watchdog/route.ts	System-Health-Monitoring