169 lines
3.6 KiB
Markdown
169 lines
3.6 KiB
Markdown
# medisoftware Kundensuche
|
|
|
|
Eine Flask-basierte Webanwendung zur Suche in Kundendaten aus einer CSV-Datei.
|
|
|
|
## Features
|
|
|
|
- Live-Suche während der Eingabe
|
|
- Suche nach:
|
|
- Kundennummer
|
|
- Name (Vor- und Nachname)
|
|
- Fachrichtung
|
|
- Ort
|
|
- Klickbare Links für:
|
|
- Telefonnummern (tel:)
|
|
- E-Mail-Adressen (mailto:)
|
|
- Adressen (Google Maps)
|
|
- Kundennummern (KKBefe-System)
|
|
- 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
|
|
└── .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
|
|
|
|
### Lokale Entwicklung
|
|
|
|
1. Python 3.11 installieren
|
|
2. Virtuelle Umgebung erstellen und aktivieren:
|
|
```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 bauen:
|
|
```bash
|
|
docker build -t medi-customers .
|
|
```
|
|
3. Container starten:
|
|
```bash
|
|
docker run -d -p 5000:5000 --name medi-customers medi-customers
|
|
```
|
|
|
|
## API-Endpunkte
|
|
|
|
### GET /
|
|
- Rendert die Hauptseite
|
|
|
|
### GET /search
|
|
- Sucht nach Kunden basierend auf dem Query-Parameter
|
|
- Parameter: `q` (Suchbegriff)
|
|
- Returns: JSON-Array mit gefundenen Kunden
|
|
|
|
## Frontend-Funktionen
|
|
|
|
### Suchfunktion
|
|
- Live-Suche mit 300ms Debounce
|
|
- Minimale Suchlänge: 2 Zeichen
|
|
- Suche wird bei Enter-Taste sofort ausgeführt
|
|
|
|
### Link-Generierung
|
|
- `createPhoneLink()`: Erstellt tel:-Links mit führender 0
|
|
- `createEmailLink()`: Erstellt mailto:-Links
|
|
- `createAddressLink()`: Erstellt Google Maps-Links
|
|
- `createCustomerLink()`: Erstellt KKBefe-System-Links
|
|
|
|
## 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
|
|
python app.py
|
|
```
|
|
|
|
### Logging
|
|
- Backend-Logs werden mit Python's logging-Modul erstellt
|
|
- Log-Level: DEBUG
|
|
- Logs werden in der Konsole ausgegeben
|
|
|
|
## Wartung
|
|
|
|
### Container-Verwaltung
|
|
```bash
|
|
# Container stoppen
|
|
docker stop medi-customers
|
|
|
|
# Container starten
|
|
docker start medi-customers
|
|
|
|
# Container-Logs anzeigen
|
|
docker logs medi-customers
|
|
|
|
# Container entfernen
|
|
docker rm medi-customers
|
|
```
|
|
|
|
### Datenaktualisierung
|
|
1. CSV-Datei aktualisieren
|
|
2. Container neu bauen und starten:
|
|
```bash
|
|
docker stop medi-customers
|
|
docker build -t medi-customers .
|
|
docker run -d -p 5000:5000 --name medi-customers medi-customers
|
|
```
|
|
|
|
## Sicherheit
|
|
|
|
- Alle externen Links öffnen sich in neuen Tabs
|
|
- Sicherheitsattribute für externe Links (noopener, noreferrer)
|
|
- Input-Validierung im Backend
|
|
- Fehlerbehandlung für ungültige Daten
|
|
|
|
## Browser-Kompatibilität
|
|
|
|
Die Anwendung wurde getestet mit:
|
|
- Chrome (neueste Version)
|
|
- Firefox (neueste Version)
|
|
- Edge (neueste Version)
|
|
- Safari (neueste Version) |