feat!: Environment Variable Konfigurationssystem implementieren #15

Merged

zenn merged 5 commits from adding-Environment-variables-to-the-project into devel

2025-09-14 10:00:41 +02:00

zenn commented

2025-09-11 14:24:37 +02:00

Owner

Übersicht

Diese PR führt ein umfassendes Environment Variable Konfigurationssystem ein, das die Flexibilität und Sicherheit der Anwendung in verschiedenen Deployment-Szenarien erheblich verbessert.

🚨 Breaking Changes

Datenbankinitialisierung: Verwendet jetzt Environment Variables anstelle von hardcodierten Verbindungen
Legacy-Funktionen entfernt: InitSQLiteDB, InitPostgresDB, und InitMySQLDB Funktionen wurden entfernt
Konfiguration erforderlich: Bestehende Deployments müssen entsprechende Environment Variables setzen

✨ Neue Features

Multi-Database-Support: Unterstützung für SQLite, PostgreSQL und MySQL
Automatische Fallbacks: Sinnvolle Standardwerte im Debug-Modus
Umfassende Konfiguration: Environment Variables für:
- Datenbankverbindungen
- JWT-Secrets
- Admin-Credentials
- Server-Konfiguration

🐛 Bugfixes

JWT Token-Verarbeitung: JWT Secret wird jetzt korrekt von String zu Byte Array konvertiert
Token-Signierung und -Validierung: Behebt Probleme mit der JWT-Library-Kompatibilität

📚 Dokumentation

Erweiterte Dokumentation: Umfassende Environment Variable Referenz
Deployment-Beispiele:
- systemd Service-Konfiguration
- Docker Deployment
- Produktions-Setup-Guides
Verschiedene Deployment-Szenarien abgedeckt

Commits

8fbc638 - feat!: add environment variable configuration system
d26d639 - docs: update configuration and deployment documentation
c3b202b - fix(jwt): convert JWT secret string to byte array

Migration Guide

Für bestehende Installationen:

Environment Variables setzen:

export DB_TYPE=sqlite
export DB_PATH=./app.db
export JWT_SECRET=your-secret-key
export ADMIN_USER=admin
export ADMIN_PASSWORD=secure-password

Docker-Umgebung:

environment:
  - DB_TYPE=postgres
  - DB_HOST=localhost
  - DB_PORT=5432
  - DB_NAME=myapp
  - DB_USER=user
  - DB_PASSWORD=password

Produktionsumgebung: Siehe erweiterte Dokumentation für vollständige Setup-Anleitungen

Testing

✅ SQLite-Konfiguration getestet
✅ PostgreSQL-Konfiguration getestet
✅ MySQL-Konfiguration getestet
✅ JWT Token-Generierung und -Validierung
✅ Fallback-Verhalten im Debug-Modus

Review Notes

Diese PR macht die Anwendung deployment-ready für verschiedene Umgebungen
Besondere Aufmerksamkeit auf die Breaking Changes bei der Code-Review
Dokumentation sollte vor dem Merge überprüft werden

## Übersicht Diese PR führt ein umfassendes Environment Variable Konfigurationssystem ein, das die Flexibilität und Sicherheit der Anwendung in verschiedenen Deployment-Szenarien erheblich verbessert. ## 🚨 Breaking Changes - **Datenbankinitialisierung**: Verwendet jetzt Environment Variables anstelle von hardcodierten Verbindungen - **Legacy-Funktionen entfernt**: `InitSQLiteDB`, `InitPostgresDB`, und `InitMySQLDB` Funktionen wurden entfernt - **Konfiguration erforderlich**: Bestehende Deployments müssen entsprechende Environment Variables setzen ## ✨ Neue Features - **Multi-Database-Support**: Unterstützung für SQLite, PostgreSQL und MySQL - **Automatische Fallbacks**: Sinnvolle Standardwerte im Debug-Modus - **Umfassende Konfiguration**: Environment Variables für: - Datenbankverbindungen - JWT-Secrets - Admin-Credentials - Server-Konfiguration ## 🐛 Bugfixes - **JWT Token-Verarbeitung**: JWT Secret wird jetzt korrekt von String zu Byte Array konvertiert - **Token-Signierung und -Validierung**: Behebt Probleme mit der JWT-Library-Kompatibilität ## 📚 Dokumentation - **Erweiterte Dokumentation**: Umfassende Environment Variable Referenz - **Deployment-Beispiele**: - systemd Service-Konfiguration - Docker Deployment - Produktions-Setup-Guides - **Verschiedene Deployment-Szenarien** abgedeckt ## Commits - `8fbc638` - feat!: add environment variable configuration system - `d26d639` - docs: update configuration and deployment documentation - `c3b202b` - fix(jwt): convert JWT secret string to byte array ## Migration Guide Für bestehende Installationen: 1. **Environment Variables setzen**: ```bash export DB_TYPE=sqlite export DB_PATH=./app.db export JWT_SECRET=your-secret-key export ADMIN_USER=admin export ADMIN_PASSWORD=secure-password ``` 2. **Docker-Umgebung**: ```yaml environment: - DB_TYPE=postgres - DB_HOST=localhost - DB_PORT=5432 - DB_NAME=myapp - DB_USER=user - DB_PASSWORD=password ``` 3. **Produktionsumgebung**: Siehe erweiterte Dokumentation für vollständige Setup-Anleitungen ## Testing - ✅ SQLite-Konfiguration getestet - ✅ PostgreSQL-Konfiguration getestet - ✅ MySQL-Konfiguration getestet - ✅ JWT Token-Generierung und -Validierung - ✅ Fallback-Verhalten im Debug-Modus ## Review Notes - Diese PR macht die Anwendung deployment-ready für verschiedene Umgebungen - Besondere Aufmerksamkeit auf die Breaking Changes bei der Code-Review - Dokumentation sollte vor dem Merge überprüft werden #5

zenn added the

Improvement

Feature

labels

2025-09-11 14:24:37 +02:00

zenn self-assigned this

2025-09-11 14:24:37 +02:00

zenn added 5 commits

2025-09-11 14:24:37 +02:00

feat!: add environment variable configuration system 8fbc63887c

Add comprehensive environment variable support for database connections,
JWT secrets, admin credentials, and server configuration. Supports
SQLite, PostgreSQL, and MySQL with automatic fallbacks to sensible
defaults in debug mode.

BREAKING CHANGE: database initialization now uses environment variables
instead of hardcoded connections. Legacy InitSQLiteDB, InitPostgresDB,
and InitMySQLDB functions removed.

docs: update configuration and deployment documentation d26d639b7f

Expand documentation with comprehensive environment variable reference,
deployment examples for various scenarios including systemd service
configuration, Docker deployment, and production setup guides.

feat(database): add user role change functionality ad5f360794

Add ChangeUserRoleById function to allow programmatic role updates
for user management operations.

fix(jwt): convert JWT secret string to byte array c3b202b5ec

Fix JWT token signing and validation by properly converting the JWT secret
environment variable from string to byte array as required by the jwt library.

rem: docs folder c571666b78