177 lines
5.2 KiB
Markdown
177 lines
5.2 KiB
Markdown
---
|
|
name: MySQL-Integration mit Admin-Konfiguration
|
|
overview: Erweitere das System um MySQL-Unterstützung mit einer Admin-Oberfläche zur Konfiguration. Die Datenbank wird in einer Konfigurationsdatei gespeichert und kann im Admin-Bereich geändert werden (erfordert Server-Neustart).
|
|
todos: []
|
|
---
|
|
|
|
# MySQL/MariaDB-Integration mit Admin-Konfiguration
|
|
|
|
## Übersicht
|
|
|
|
Erweitere das System um MySQL/MariaDB-Unterstützung neben SQLite3. Die Datenbank-Konfiguration wird in einer Konfigurationsdatei gespeichert und kann im Admin-Bereich verwaltet werden. Ein Wechsel erfordert einen Server-Neustart.
|
|
|
|
**Hinweis:** MariaDB ist vollständig MySQL-kompatibel und funktioniert mit derselben Schnittstelle (`mysql2` Package).
|
|
|
|
## Architektur
|
|
|
|
### Datenbank-Abstraktionsschicht
|
|
|
|
Erstelle eine Abstraktionsschicht, die sowohl SQLite als auch MySQL unterstützt:
|
|
|
|
1. **Neue Datei:** `database/db-adapter.js`
|
|
|
|
- Abstrahiert `db.get()`, `db.run()`, `db.all()` für beide Datenbanken
|
|
- Promise-basierte API (für bessere Kompatibilität)
|
|
- Automatische Fehlerbehandlung
|
|
- SQL-Dialekt-Anpassung (z.B. `AUTOINCREMENT` vs `AUTO_INCREMENT`)
|
|
|
|
2. **Neue Datei:** `database/sqlite-adapter.js`
|
|
|
|
- SQLite-spezifische Implementierung
|
|
- Wrapper um sqlite3
|
|
|
|
3. **Neue Datei:** `database/mysql-adapter.js`
|
|
|
|
- MySQL/MariaDB-spezifische Implementierung
|
|
- Verwendet `mysql2` Package (funktioniert mit MySQL und MariaDB)
|
|
|
|
4. **Anpassung:** `database.js`
|
|
|
|
- Lädt Konfiguration aus `config/database.json`
|
|
- Initialisiert entsprechenden Adapter
|
|
- Behält `initDatabase()` Funktion bei
|
|
|
|
### Konfigurationsdatei
|
|
|
|
**Neue Datei:** `config/database.json`
|
|
|
|
```json
|
|
{
|
|
"type": "sqlite",
|
|
"sqlite": {
|
|
"path": "./stundenerfassung.db"
|
|
},
|
|
"mysql": {
|
|
"host": "localhost",
|
|
"port": 3306,
|
|
"user": "root",
|
|
"password": "",
|
|
"database": "stundenerfassung",
|
|
"charset": "utf8mb4"
|
|
}
|
|
}
|
|
```
|
|
|
|
### Admin-Interface
|
|
|
|
**Anpassung:** `routes/admin.js`
|
|
|
|
- Neue Route `/admin/database/config` (GET/PUT)
|
|
- Zeigt aktuelle Datenbank-Konfiguration
|
|
- Formular zum Ändern der Datenbank-Einstellungen
|
|
- Warnung bei Wechsel (Server-Neustart erforderlich)
|
|
|
|
**Anpassung:** `views/admin.ejs`
|
|
|
|
- Neuer Abschnitt "Datenbank-Konfiguration"
|
|
- Formular für SQLite/MySQL/MariaDB-Auswahl
|
|
- Eingabefelder für MySQL/MariaDB-Verbindungsdaten
|
|
- Test-Verbindung Button
|
|
- Warnung bei Änderungen
|
|
- Hinweis: MariaDB funktioniert mit MySQL-Konfiguration
|
|
|
|
### SQL-Anpassungen
|
|
|
|
**Unterschiede zwischen SQLite und MySQL:**
|
|
|
|
- `INTEGER PRIMARY KEY AUTOINCREMENT` → `INT AUTO_INCREMENT PRIMARY KEY`
|
|
- `TEXT` → `VARCHAR(255)` oder `TEXT`
|
|
- `REAL` → `DOUBLE` oder `DECIMAL`
|
|
- `TEXT` (unbegrenzt) → `TEXT` oder `LONGTEXT`
|
|
- `DATETIME DEFAULT CURRENT_TIMESTAMP` → `DATETIME DEFAULT CURRENT_TIMESTAMP` (gleich)
|
|
- `INSERT OR IGNORE` → `INSERT IGNORE`
|
|
- `COLLATE NOCASE` → `COLLATE utf8mb4_general_ci` (für case-insensitive)
|
|
- Foreign Keys müssen in MySQL explizit aktiviert werden
|
|
|
|
**Anpassung:** `database.js` - `initDatabase()`
|
|
|
|
- SQL-Generierung basierend auf Datenbanktyp
|
|
- Separate CREATE TABLE Statements für SQLite und MySQL
|
|
- Migrationen anpassen (ALTER TABLE Syntax)
|
|
|
|
### Package-Abhängigkeiten
|
|
|
|
**Anpassung:** `package.json`
|
|
|
|
- `mysql2` hinzufügen (bessere Promise-Unterstützung als `mysql`, funktioniert mit MySQL und MariaDB)
|
|
|
|
### Services und Routes
|
|
|
|
Alle Dateien, die `db` verwenden, müssen angepasst werden:
|
|
|
|
- `routes/*.js` (7 Dateien)
|
|
- `services/*.js` (5 Dateien)
|
|
- `checkin-server.js`
|
|
|
|
**Änderungen:**
|
|
|
|
- Promise-basierte Queries verwenden (statt Callbacks)
|
|
- Oder: Callback-Wrapper in Adapter
|
|
|
|
### Initialisierung
|
|
|
|
**Anpassung:** `server.js`
|
|
|
|
- Prüft ob `config/database.json` existiert
|
|
- Erstellt Standard-Konfiguration falls nicht vorhanden
|
|
- Initialisiert Datenbank entsprechend Konfiguration
|
|
|
|
## Implementierungsschritte
|
|
|
|
1. **Datenbank-Abstraktionsschicht erstellen**
|
|
|
|
- `database/db-adapter.js` - Interface
|
|
- `database/sqlite-adapter.js` - SQLite-Implementierung
|
|
- `database/mysql-adapter.js` - MySQL-Implementierung
|
|
|
|
2. **Konfigurationssystem**
|
|
|
|
- `config/database.json` Template
|
|
- Konfigurations-Loader in `database.js`
|
|
|
|
3. **SQL-Anpassungen**
|
|
|
|
- `initDatabase()` für beide Datenbanken anpassen
|
|
- SQL-Dialekt-Unterschiede behandeln
|
|
|
|
4. **Admin-Interface**
|
|
|
|
- Route für Datenbank-Konfiguration
|
|
- View mit Konfigurationsformular
|
|
- Test-Verbindung Funktion
|
|
|
|
5. **Alle Queries anpassen**
|
|
|
|
- Callbacks zu Promises oder Callback-Wrapper
|
|
- SQLite-spezifische Syntax entfernen (z.B. `COLLATE NOCASE`)
|
|
|
|
6. **Dokumentation**
|
|
|
|
- README.md aktualisieren
|
|
- Konfigurationsanleitung
|
|
|
|
## Technische Details
|
|
|
|
- **MySQL/MariaDB-Package:** `mysql2` (bessere Promise-Unterstützung, funktioniert mit beiden)
|
|
- **Kompatibilität:** MariaDB ist vollständig MySQL-kompatibel, verwendet dieselbe Konfiguration
|
|
- **Fallback:** Bei Fehler in MySQL/MariaDB-Verbindung auf SQLite zurückfallen
|
|
- **Validierung:** Test-Verbindung vor Speichern der Konfiguration
|
|
- **Sicherheit:** MySQL/MariaDB-Passwörter verschlüsselt in Config speichern (optional)
|
|
|
|
## Dateien die angepasst werden müssen
|
|
|
|
- `database.js` → `database/` Ordner mit mehreren Dateien
|
|
- `routes/admin.js` - Datenbank-Konfiguration
|
|
- `views/admin.ejs` - Konfigurations-UI
|
|
- `package.json` - mysql2 Dependency
|
|
- `server.js` - Konfigurationspr |