README.md aktualisiert: Neue Features und Version 1.0.1 dokumentiert
This commit is contained in:
274
README.md
274
README.md
@@ -1,229 +1,107 @@
|
|||||||
# medisoftware Kundensuche
|
# medisoftware Kundensuche
|
||||||
|
|
||||||
Eine Flask-basierte Webanwendung zur Suche in Kundendaten aus einer CSV-Datei.
|
Eine Webanwendung zur Suche in Kundendaten der medisoftware.
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
- Live-Suche während der Eingabe
|
- Live-Suche in Kundendaten
|
||||||
- Spezifische Suchfelder für:
|
- Spezifische Suchfelder für:
|
||||||
- Kundennummer
|
- Name
|
||||||
- Name (Vor- und Nachname)
|
|
||||||
- Fachrichtung
|
|
||||||
- Ort
|
- Ort
|
||||||
|
- Kundennummer
|
||||||
|
- Fachrichtung
|
||||||
|
- Telefonnummer
|
||||||
- Allgemeine Suche über alle Felder
|
- Allgemeine Suche über alle Felder
|
||||||
- Klickbare Links für:
|
- Klickbare Telefonnummern
|
||||||
- Telefonnummern (tel:)
|
- Klickbare E-Mail-Adressen
|
||||||
- E-Mail-Adressen (mailto:)
|
- Google Maps Integration für Adressen
|
||||||
- Adressen (Google Maps)
|
- Share-Funktion für Suchergebnisse
|
||||||
- Kundennummern (KKBefe-System)
|
- Trefferzähler
|
||||||
- Teilen-Funktion für einzelne Suchergebnisse
|
- Reset-Funktion für alle Suchfelder
|
||||||
- Responsive Design mit Bootstrap
|
|
||||||
- Docker-Container-Unterstützung
|
|
||||||
|
|
||||||
## Technische Details
|
|
||||||
|
|
||||||
### Technologie-Stack
|
|
||||||
|
|
||||||
- **Backend**: Python 3.11 mit Flask
|
|
||||||
- **Frontend**: HTML, CSS, JavaScript, Bootstrap 5
|
|
||||||
- **Datenverarbeitung**: pandas, numpy
|
|
||||||
- **Container**: Docker
|
|
||||||
|
|
||||||
### Projektstruktur
|
|
||||||
|
|
||||||
```
|
|
||||||
medi-customers/
|
|
||||||
├── app.py # Flask-Anwendung
|
|
||||||
├── templates/ # HTML-Templates
|
|
||||||
│ └── index.html # Hauptseite
|
|
||||||
├── spezexpo.csv # Kundendaten
|
|
||||||
├── requirements.txt # Python-Abhängigkeiten
|
|
||||||
├── Dockerfile # Docker-Konfiguration
|
|
||||||
├── docker-compose.yml # Docker Compose Konfiguration
|
|
||||||
└── .dockerignore # Docker-Ignore-Datei
|
|
||||||
```
|
|
||||||
|
|
||||||
### Datenformat
|
|
||||||
|
|
||||||
Die Anwendung erwartet eine CSV-Datei (`spezexpo.csv`) mit folgenden Spalten:
|
|
||||||
- Nummer (Kundennummer)
|
|
||||||
- Vorname
|
|
||||||
- Nachname
|
|
||||||
- Fachrichtung
|
|
||||||
- Strasse
|
|
||||||
- PLZ
|
|
||||||
- Ort
|
|
||||||
- Tel
|
|
||||||
- mail
|
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
### Lokale Entwicklung
|
1. Repository klonen:
|
||||||
|
```bash
|
||||||
1. Python 3.11 installieren
|
git clone https://gitea.elpatron.me/elpatron/medi-customers.git
|
||||||
2. Virtuelle Umgebung erstellen und aktivieren:
|
cd medi-customers
|
||||||
```bash
|
|
||||||
python -m venv venv
|
|
||||||
source venv/bin/activate # Linux/Mac
|
|
||||||
venv\Scripts\activate # Windows
|
|
||||||
```
|
|
||||||
3. Abhängigkeiten installieren:
|
|
||||||
```bash
|
|
||||||
pip install -r requirements.txt
|
|
||||||
```
|
|
||||||
4. Anwendung starten:
|
|
||||||
```bash
|
|
||||||
python app.py
|
|
||||||
```
|
|
||||||
|
|
||||||
### Docker-Container
|
|
||||||
|
|
||||||
1. Docker installieren
|
|
||||||
2. Container mit Docker Compose starten:
|
|
||||||
```bash
|
|
||||||
docker-compose up --build
|
|
||||||
```
|
|
||||||
Die Anwendung ist dann unter `http://localhost:5001` erreichbar.
|
|
||||||
|
|
||||||
## API-Endpunkte
|
|
||||||
|
|
||||||
### GET /
|
|
||||||
- Rendert die Hauptseite
|
|
||||||
|
|
||||||
### GET /search
|
|
||||||
- Sucht nach Kunden basierend auf verschiedenen Parametern
|
|
||||||
- Parameter:
|
|
||||||
- `name`: Suche nach Vor- oder Nachname
|
|
||||||
- `ort`: Suche nach Ort
|
|
||||||
- `kundennummer`: Suche nach Kundennummer
|
|
||||||
- `fachrichtung`: Suche nach Fachrichtung
|
|
||||||
- `q`: Allgemeine Suche über alle Felder
|
|
||||||
- Returns: JSON-Array mit gefundenen Kunden
|
|
||||||
|
|
||||||
#### API-Beispiele
|
|
||||||
|
|
||||||
1. Suche nach Namen:
|
|
||||||
```bash
|
|
||||||
curl "http://localhost:5001/search?name=Schmidt"
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Suche nach Ort:
|
|
||||||
```bash
|
|
||||||
curl "http://localhost:5001/search?ort=Berlin"
|
|
||||||
```
|
|
||||||
|
|
||||||
3. Suche nach Kundennummer:
|
|
||||||
```bash
|
|
||||||
curl "http://localhost:5001/search?kundennummer=12345"
|
|
||||||
```
|
|
||||||
|
|
||||||
4. Suche nach Fachrichtung:
|
|
||||||
```bash
|
|
||||||
curl "http://localhost:5001/search?fachrichtung=Allgemeinmedizin"
|
|
||||||
```
|
|
||||||
|
|
||||||
5. Kombinierte Suche:
|
|
||||||
```bash
|
|
||||||
curl "http://localhost:5001/search?name=Schmidt&ort=Berlin&fachrichtung=Allgemeinmedizin"
|
|
||||||
```
|
|
||||||
|
|
||||||
6. Allgemeine Suche:
|
|
||||||
```bash
|
|
||||||
curl "http://localhost:5001/search?q=Schmidt"
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Beispiel-Response
|
|
||||||
```json
|
|
||||||
[
|
|
||||||
{
|
|
||||||
"Nummer": "12345",
|
|
||||||
"Vorname": "Max",
|
|
||||||
"Nachname": "Schmidt",
|
|
||||||
"Fachrichtung": "Allgemeinmedizin",
|
|
||||||
"Strasse": "Hauptstraße 1",
|
|
||||||
"PLZ": "10115",
|
|
||||||
"Ort": "Berlin",
|
|
||||||
"Tel": "030-123456",
|
|
||||||
"mail": "max.schmidt@example.com"
|
|
||||||
}
|
|
||||||
]
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Frontend-Funktionen
|
2. Python-Abhängigkeiten installieren:
|
||||||
|
```bash
|
||||||
|
pip install -r requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
### Suchfunktion
|
3. CSV-Datei in das `data`-Verzeichnis kopieren:
|
||||||
- Live-Suche mit 300ms Debounce
|
```bash
|
||||||
- Spezifische Suchfelder für präzise Suche
|
mkdir data
|
||||||
- Allgemeine Suche für breite Suche
|
cp spezexpo.csv data/customers.csv
|
||||||
- Kombinierbare Suchkriterien
|
```
|
||||||
- Trefferzähler für jedes Suchfeld
|
|
||||||
|
|
||||||
### Link-Generierung
|
4. Anwendung starten:
|
||||||
- `createPhoneLink()`: Erstellt tel:-Links mit führender 0
|
|
||||||
- `createEmailLink()`: Erstellt mailto:-Links
|
|
||||||
- `createAddressLink()`: Erstellt Google Maps-Links
|
|
||||||
- `createCustomerLink()`: Erstellt KKBefe-System-Links
|
|
||||||
|
|
||||||
### Teilen-Funktion
|
|
||||||
- Individueller Teilen-Button für jedes Suchergebnis
|
|
||||||
- Kopiert einen direkten Link zum spezifischen Kunden
|
|
||||||
- Visuelles Feedback beim Kopieren
|
|
||||||
|
|
||||||
## Fehlerbehandlung
|
|
||||||
|
|
||||||
- Logging für Backend-Fehler
|
|
||||||
- Benutzerfreundliche Fehlermeldungen im Frontend
|
|
||||||
- Graceful Degradation bei fehlenden Daten
|
|
||||||
|
|
||||||
## Entwicklung
|
|
||||||
|
|
||||||
### Debug-Modus
|
|
||||||
Die Anwendung läuft standardmäßig im Debug-Modus:
|
|
||||||
```bash
|
```bash
|
||||||
python app.py
|
python app.py
|
||||||
```
|
```
|
||||||
|
|
||||||
### Logging
|
Die Anwendung ist dann unter `http://localhost:5001` erreichbar.
|
||||||
- Backend-Logs werden mit Python's logging-Modul erstellt
|
|
||||||
- Log-Level: DEBUG
|
|
||||||
- Logs werden in der Konsole ausgegeben
|
|
||||||
|
|
||||||
## Wartung
|
## API-Beispiele
|
||||||
|
|
||||||
### Container-Verwaltung
|
Die Such-API unterstützt folgende Parameter:
|
||||||
|
|
||||||
|
### Spezifische Suche
|
||||||
```bash
|
```bash
|
||||||
# Container stoppen
|
# Nach Name suchen
|
||||||
docker-compose down
|
curl "http://localhost:5001/search?name=Schmidt"
|
||||||
|
|
||||||
# Container starten
|
# Nach Ort suchen
|
||||||
docker-compose up
|
curl "http://localhost:5001/search?ort=Berlin"
|
||||||
|
|
||||||
# Container im Hintergrund starten
|
# Nach Kundennummer suchen
|
||||||
docker-compose up -d
|
curl "http://localhost:5001/search?kundennummer=12345"
|
||||||
|
|
||||||
# Container-Logs anzeigen
|
# Nach Fachrichtung suchen
|
||||||
docker-compose logs -f
|
curl "http://localhost:5001/search?fachrichtung=Allgemeinmedizin"
|
||||||
|
|
||||||
|
# Nach Telefonnummer suchen
|
||||||
|
curl "http://localhost:5001/search?telefon=030"
|
||||||
|
|
||||||
|
# Kombinierte Suche
|
||||||
|
curl "http://localhost:5001/search?name=Schmidt&ort=Berlin&fachrichtung=Allgemeinmedizin"
|
||||||
```
|
```
|
||||||
|
|
||||||
### Datenaktualisierung
|
### Allgemeine Suche
|
||||||
1. CSV-Datei aktualisieren
|
```bash
|
||||||
2. Container neu bauen und starten:
|
# Suche in allen Feldern
|
||||||
```bash
|
curl "http://localhost:5001/search?q=Schmidt"
|
||||||
docker-compose down
|
```
|
||||||
docker-compose up --build
|
|
||||||
```
|
|
||||||
|
|
||||||
## Sicherheit
|
### Beispiel-Response
|
||||||
|
```json
|
||||||
|
[
|
||||||
|
{
|
||||||
|
"Vorname": "Max",
|
||||||
|
"Nachname": "Mustermann",
|
||||||
|
"Nummer": "12345",
|
||||||
|
"Ort": "Berlin",
|
||||||
|
"Fachrichtung": "Allgemeinmedizin",
|
||||||
|
"Tel": "030123456",
|
||||||
|
"Email": "max@example.com"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
- Alle externen Links öffnen sich in neuen Tabs
|
## Versionen
|
||||||
- Sicherheitsattribute für externe Links (noopener, noreferrer)
|
|
||||||
- Input-Validierung im Backend
|
|
||||||
- Fehlerbehandlung für ungültige Daten
|
|
||||||
|
|
||||||
## Browser-Kompatibilität
|
### v1.0.1
|
||||||
|
- Telefonnummer-Suchfeld hinzugefügt
|
||||||
|
- Reset-Icons für alle Suchfelder
|
||||||
|
- Verbesserte Positionierung der UI-Elemente
|
||||||
|
- Optimierte Suchlogik
|
||||||
|
- CSV-Datei in data-Verzeichnis verschoben
|
||||||
|
|
||||||
Die Anwendung wurde getestet mit:
|
### v1.0.0
|
||||||
- Chrome (neueste Version)
|
- Erste Version
|
||||||
- Firefox (neueste Version)
|
- Grundlegende Suchfunktionalität
|
||||||
- Edge (neueste Version)
|
- Klickbare Links für Telefon, E-Mail und Adressen
|
||||||
- Safari (neueste Version)
|
- Share-Funktion für Suchergebnisse
|
||||||
Reference in New Issue
Block a user