Nirodan
20cdbd69eb
Functional fixes: - Add isDirtyRef to distinguish user edits from note selection; auto-save now only fires after the user actually modifies content, not on every click - Add selected and isNew to auto-save effect deps so the closure is never stale when switching between notes (previously could save to the wrong note) - Double-check isDirtyRef inside the debounce callback to handle rapid note switches within the 1-second window - Reset isDirtyRef to false after every successful save (manual and auto) CSS fixes: - Add button.ghost and button.ghost.danger styles to buttons.css; delete button was invisible/identical to the save button because .ghost was never defined - Add select element styling to base.css to match input/textarea theming; language picker was unstyled browser-default in both dark and light mode - Add .error class (red text) to base.css; error messages had no colour - Add .notes-layout grid class with responsive media query (stacks below 680px); remove inline gridTemplateColumns that overflowed on small screens Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Docker-Webplattform: React + Flask + externe MariaDB
Vollständig dockerisierte Webanwendung mit React-Frontend und Flask-Backend in einem einzigen Container. Verbindet sich mit einer externen MariaDB-Datenbank und bietet Setup-System, Login, Rollenverwaltung und modulare Tools.
Screenshot
Setup-Anleitung
Voraussetzungen
- Docker & Docker Compose installiert
- Externe MariaDB/MySQL-Datenbank erreichbar (z.B. auf Unraid, NAS oder anderem Server)
1. Repository klonen
git clone https://github.com/Nirodan/Tools.git
cd Tools
2. Umgebungsvariablen konfigurieren
cp .env.example .env
Dann .env öffnen und SECRET_KEY durch einen sicheren zufälligen Wert ersetzen:
# Sicheren Key generieren:
python -c "import secrets; print(secrets.token_hex(32))"
3. Container starten
docker compose -f docker-compose.dev.yml up -d
4. Datenbank einrichten (Erststart)
Beim ersten Start öffnet sich automatisch die Setup-Seite unter http://localhost:5050/setup.
Dort die MariaDB-Verbindungsdaten eintragen:
| Feld | Beispiel |
|---|---|
| Host | 192.168.1.100 |
| Port | 3306 |
| User | tools_user |
| Password | geheimes_pw |
| Database | tools_db |
Nach dem Speichern wird automatisch ein Admin-Account angelegt:
- Benutzername:
admin - Passwort:
admin(bitte sofort im Admin-Dashboard ändern)
5. Anwendung aufrufen
http://localhost:5050
Was der Container macht
- Startet automatisch Flask + React in einer Umgebung
- Bei Erststart: Setup-Webseite zum Eintragen der DB-Verbindung
- Speichert die Konfiguration in einem Docker-Volume (
config/db_config.json) - Verbindet sich mit der externen MariaDB-Datenbank
- Erstellt automatisch ein
admin-Benutzerkonto - Liefert das React-Frontend direkt über Flask aus (keine extra Node-Instanz)
Projektstruktur
Tools/
├── backend/
│ ├── app.py # Flask-Einstiegspunkt
│ ├── admin.py # Admin-API (Nutzer- und Websitenverwaltung)
│ ├── auth/ # Login, Logout, Token-Verifikation
│ ├── tools/ # Modulare Tools (MD5 etc.)
│ └── util/ # DB-Pool, Konfiguration, Logger, Rate-Limiter
├── frontend/
│ └── src/
│ ├── App.jsx
│ ├── components/ # React-Komponenten
│ └── services/api.js # Axios-Instanz mit Auth-Interceptor
├── docker-compose.dev.yml
├── Dockerfile
├── .env.example # Vorlage für Umgebungsvariablen
└── README.md
Sicherheitshinweise
SECRET_KEYniemals im Klartext in der Versionskontrolle speichern – immer.envverwenden- Standard-Admin-Passwort (
admin) nach dem Erststart sofort ändern - MD5 ist kryptografisch unsicher – nicht für Passwort-Hashing verwenden
Lizenz
Dieses Projekt steht unter der Creative Commons BY-NC 4.0 Lizenz. Du darfst es verwenden, verändern und teilen – aber nicht kommerziell nutzen. Volltext: https://creativecommons.org/licenses/by-nc/4.0
Author: Nirodan – https://github.com/Nirodan