Setup-Assistent - Anleitung für Administratoren

Überblick

Der Setup-Assistent hilft Ihnen bei der Erstkonfiguration von energy logistics. Er wird automatisch beim ersten Start der Anwendung geöffnet und führt Sie durch alle notwendigen Einstellungen.

Automatischer Start

Beim ersten Start der Anwendung:

1. Öffnet sich automatisch Ihr Webbrowser
2. Der Setup-Assistent wird angezeigt
3. Sie werden durch die Konfiguration geführt
4. Nach erfolgreicher Einrichtung startet die Anwendung automatisch

Konfigurationsschritte

1. Datenbank-Konfiguration

Wählen Sie den Datenbanktyp für die Anwendung:

SQLite (empfohlen für kleine Installationen)

• Vorteile: Keine zusätzliche Software erforderlich, einfache Einrichtung
• Nachteile: Nicht für große Installationen oder Mehrbenutzer-Szenarien geeignet
• Dateiname: Standardmäßig energy_logistics.sqlite3

Microsoft SQL Server (empfohlen für Produktion)

• Vorteile: Hohe Performance, Mehrbenutzer-fähig, Backup-Funktionen
• Nachteile: Erfordert SQL Server Installation
• Erforderliche Angaben:
• Server: Hostname oder IP-Adresse des SQL Servers (z.B. localhost oder sql-server.firma.local)
• Datenbankname: Name der Datenbank (z.B. energy_logistics)
  • Die Datenbank wird automatisch erstellt, falls sie noch nicht existiert
• Benutzername: SQL Server Benutzername (z.B. meso oder sa)
• Passwort: SQL Server Passwort
• ODBC-Treiber: Wird automatisch erkannt (Standard: ODBC Driver 17 for SQL Server)

2. WinLine-Integration

Konfiguration der Verbindung zum WinLine ERP-System:

Pflichtangaben: - Mandant (MCOMP): Ihr WinLine-Mandant (z.B. 500M) - CWLDATEN-Datenbank: Name der WinLine-Datendatenbank (Standard: CWLDATEN) - CWLSYSTEM-Datenbank: Name der WinLine-Systemdatenbank (Standard: CWLSYSTEM)

Hinweis: Die WinLine-Datenbanken müssen auf demselben SQL Server wie in Schritt 1 konfiguriert liegen.

3. WebService-Konfiguration

Konfiguration des EWL-WebService für WinLine-Integration:

Pflichtangaben: - Service-URL: URL des EWL-WebService (z.B. http://server/ewlservice/) - Falls nicht angegeben, wird automatisch http://<Server>/ewlservice/ verwendet - Benutzername: WebService-Benutzername - Passwort: WebService-Passwort

Verbindungstests

Der Setup-Assistent testet automatisch alle eingegebenen Verbindungen:

Bei Fehlern werden klare Hinweise angezeigt, was zu tun ist.

Konfiguration später ändern

Methode 1: Setup-Assistent erneut ausführen

1. Anwendung beenden
2. Folgende Dateien löschen: - settings.toml - .setup_complete
3. Anwendung neu starten
4. Setup-Assistent öffnet sich automatisch

Methode 2: Manuelle Bearbeitung

1. Datei settings.toml im Anwendungsverzeichnis öffnen
2. Gewünschte Einstellungen ändern
3. Datei speichern
4. Anwendung neu starten

Achtung: Bei manueller Bearbeitung wird keine Validierung durchgeführt!

Sicherheitshinweise

Passwörter in settings.toml

Die Datei settings.toml enthält Passwörter im Klartext:

Empfohlene Maßnahmen: - Zugriff auf die Datei beschränken (nur Administratoren) - Datei nicht in Versionsverwaltung (Git) einchecken

Netzwerk-Sicherheit

Empfehlungen: - SQL Server nur im internen Netzwerk erreichbar machen - Firewall-Regeln: Zugriff nur von energy logistics-Server erlauben - Starke Passwörter verwenden (mindestens 12 Zeichen, gemischt)

Support

Bei Problemen mit dem Setup-Assistenten:

1. Log-Ausgaben prüfen: - Konsole anzeigen (falls im Hintergrund gestartet) - Log-Dateien im Anwendungsverzeichnis prüfen

2. Verbindung manuell testen: - SQL Server Management Studio: Verbindung zum Server testen - WinLine: Manuell starten und prüfen ob Zugriff möglich

3. Kontakt: - Support: support@newenergy-bremen.de - Bei der Anfrage angeben:

   • Fehlermeldung aus dem Setup-Assistenten
   • SQL Server Version
   • WinLine Version
   • Windows Version

Erweiterte Einstellungen

Nach der Erstinstallation können weitere Einstellungen in settings.toml vorgenommen werden:

E-Mail-Konfiguration

EMAIL_HOST = 'smtp.firma.local'
EMAIL_PORT = 587
EMAIL_HOST_USER = 'anwendung@firma.local'
EMAIL_HOST_PASSWORD = 'passwort'
EMAIL_USE_TLS = true
DEFAULT_FROM_EMAIL = 'energy-logistics@firma.local'

Session-Einstellungen

SESSION_EXPIRE_AT_BROWSER_CLOSE = false  # true: Logout beim Schließen
SESSION_COOKIE_AGE = 1209600              # Sekunden (14 Tage)

Debug-Modus (nur für Entwicklung!)

DEBUG = true  # NIEMALS in Produktion aktivieren!

Performance-Einstellungen

AUTOMATIC_HUEY_JOB_CONSUMING = true      # Hintergrund-Tasks automatisch starten
EXCLUDE_NOTES_BY_DATE  = 2023-09-30      # Schließt Belege älter als dieses Datum vom Belegabruf aus

Produkionsaufträge zur Kommissionierung anlegen

FEATURE_CREATE_PROD_ORDER_AS_DELIVERY_NOTE = true

Diese Einstellungen erfordern einen Neustart der Anwendung.