mark/steve-reporting
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

code update, readme added

Browse Source
This commit is contained in:
Mark Kors
2025-10-29 15:56:53 +01:00
parent 57a681ae79
commit 58409ba783
2 changed files with 337 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

305
README.md Normal file
View File

@@ -0,0 +1,305 @@
# SteVe Transaction Report Generator
Python script voor het genereren van gedetailleerde rapporten van laadtransacties uit je SteVe OCPP backoffice.
## Installatie
### Vereisten
- Python 3
- MySQL Connector voor Python
### Installeer MySQL Connector
**Optie 1: Via pip (aanbevolen)**
```bash
pip3 install mysql-connector-python --break-system-packages
```
**Optie 2: Via apt**
```bash
sudo apt update
sudo apt install python3-mysql-connector
```
### Script installeren
```bash
# Maak een directory voor het script
mkdir -p ~/reports
# Plaats het script in de directory
# Upload steve_transaction_report.py naar ~/reports/
# Maak het uitvoerbaar
chmod +x ~/reports/steve_transaction_report.py
```
## Gebruik
### Standaard: Alle transacties gedetailleerd
Zonder specifieke opties toont het script de laatste transacties met volledige details:
```bash
python3 steve_transaction_report.py \
--host 192.168.178.201 \
--port 3307 \
--password 'JOUW_WACHTWOORD'
```
Dit toont standaard de laatste 10 transacties met volledige details inclusief verbruik per uur.
### Aantal transacties aanpassen
```bash
# Laatste 5 transacties gedetailleerd
python3 steve_transaction_report.py \
--host 192.168.178.201 \
--port 3307 \
--password 'JOUW_WACHTWOORD' \
--limit 5
# Laatste 20 transacties gedetailleerd
python3 steve_transaction_report.py \
--host 192.168.178.201 \
--port 3307 \
--password 'JOUW_WACHTWOORD' \
--limit 20
```
### Compact overzicht (tabel format)
Voor een snel overzicht zonder details:
```bash
python3 steve_transaction_report.py \
--host 192.168.178.201 \
--port 3307 \
--password 'JOUW_WACHTWOORD' \
--list
# Met meer transacties
python3 steve_transaction_report.py \
--host 192.168.178.201 \
--port 3307 \
--password 'JOUW_WACHTWOORD' \
--list --limit 20
```
### Specifieke transactie
```bash
python3 steve_transaction_report.py \
--host 192.168.178.201 \
--port 3307 \
--password 'JOUW_WACHTWOORD' \
--transaction 1
```
### Eenvoudig rapport (zonder uurdetails)
```bash
python3 steve_transaction_report.py \
--host 192.168.178.201 \
--port 3307 \
--password 'JOUW_WACHTWOORD' \
--transaction 1 \
--simple
```
## Parameters
| Parameter | Default | Verplicht | Beschrijving |
|-----------|---------|-----------|--------------|
| --host | localhost | Nee | Database server IP of hostname |
| --port | 3306 | Nee | MySQL/MariaDB poort |
| --database | stevedb | Nee | Database naam |
| --user | steve | Nee | Database gebruikersnaam |
| --password | - | **Ja** | Database wachtwoord |
| --list | - | Nee | Toon compact overzicht (tabel) |
| --transaction | - | Nee | Specifieke transactie ID |
| --limit | 10 | Nee | Aantal transacties |
| --simple | - | Nee | Zonder uurdetails |
## Rapport Inhoud
### Gedetailleerd rapport bevat:
- Laadpaal informatie
- Gebruiker en RFID tag
- Start en stop tijden
- Duur van de laadsessie
- Totaal verbruik in kWh
- **Verbruik per uur** met meterwaarden
- Statistieken:
- Aantal actieve laaduren
- Gemiddeld verbruik per uur
- Piekuur (meeste verbruik)
- Geschatte kosten
### Compact overzicht bevat:
- Transactie ID
- Start datum/tijd
- Duur
- Totaal kWh
- Laadpaal
- RFID tag
## Alias maken (aanbevolen)
Voor gemakkelijk gebruik maak je een alias aan:
```bash
# Voeg toe aan ~/.bashrc
echo "alias steve-report='python3 ~/reports/steve_transaction_report.py --host 192.168.178.201 --port 3307 --user steve --password \"JOUW_WACHTWOORD\"'" >> ~/.bashrc
# Herlaad bashrc
source ~/.bashrc
```
Nu kun je simpel gebruik maken van:
```bash
steve-report # Laatste 10 transacties gedetailleerd
steve-report --list # Compact overzicht
steve-report --limit 5 # Laatste 5 transacties
steve-report --transaction 3 # Specifieke transactie
```
## Voorbeelden
### Voorbeeld 1: Dagelijks overzicht
```bash
steve-report --limit 1
```
### Voorbeeld 2: Wekelijks overzicht
```bash
steve-report --list --limit 50
```
### Voorbeeld 3: Export naar bestand
```bash
steve-report --transaction 5 > laadrapport_$(date +%Y%m%d).txt
```
### Voorbeeld 4: Automatisch dagelijks rapport via cron
```bash
# Voeg toe aan crontab (crontab -e)
# Elke dag om 08:00 uur
0 8 * * * python3 ~/reports/steve_transaction_report.py --host 192.168.178.201 --port 3307 --password 'XXX' --limit 1 > ~/laadrapport_$(date +\%Y\%m\%d).txt
```
### Voorbeeld 5: Rapport via email
```bash
# Installeer mailutils
sudo apt install mailutils
# Voeg toe aan crontab
0 8 * * * python3 ~/reports/steve_transaction_report.py --host 192.168.178.201 --port 3307 --password 'XXX' --transaction 1 | mail -s "Laadrapport" jouw@email.nl
```
## Output Voorbeeld
```
================================================================================
LAADSESSIE RAPPORT - Transactie #1
================================================================================
Laadpaal: VAN_01971
Alfen Single S-Line thuis
Connector: 1
RFID Tag: 04BB29EAFD0F94
Gebruiker: kors
Start: 28-10-2025 18:27:42
Einde: 29-10-2025 06:12:43
Duur: 11u 45m
Start meterstand: 5518.267 kWh
Eind meterstand: 5540.121 kWh
Totaal geladen: 21.85 kWh
================================================================================
VERBRUIK PER UUR:
--------------------------------------------------------------------------------
Uur Start (kWh) Eind (kWh) Geladen (kWh)
--------------------------------------------------------------------------------
28-10 18:27 5518.267 5518.796 0.529
29-10 01:12 5520.027 5522.945 2.918
29-10 02:12 5525.658 5529.181 3.523
29-10 03:12 5531.738 5539.881 8.143
--------------------------------------------------------------------------------
TOTAAL 5518.267 5540.121 21.854
================================================================================
STATISTIEKEN:
--------------------------------------------------------------------------------
Actieve laaduren: 4
Gemiddeld per actief uur: 3.78 kWh
Piekuur: 29-10 03:00 (8.14 kWh)
Geschatte kosten (€0.30/kWh): €6.56
Geschatte kosten (€0.10/kWh): €2.19
================================================================================
```
## Troubleshooting
### "Access denied" error
- Controleer of het wachtwoord correct is (gebruik enkele quotes: `'wachtwoord'`)
- Controleer of de gebruiker toegang heeft tot de database
- Test de verbinding: `mysql -h 192.168.178.201 -P 3307 -u steve -p`
### "Can't connect to MySQL server"
- Controleer of host en poort correct zijn
- Controleer of de database server draait
- Controleer firewall instellingen
### "No module named 'mysql.connector'"
Installeer de MySQL connector:
```bash
pip3 install mysql-connector-python --break-system-packages
```
### Geen transacties gevonden
- Controleer of er transacties in de database staan
- Controleer of de database naam correct is (standaard: stevedb)
- Test met: `mysql -h HOST -P PORT -u USER -p -e "SELECT COUNT(*) FROM stevedb.transaction"`
### Speciale tekens in wachtwoord
Gebruik altijd enkele quotes rond het wachtwoord:
```bash
--password 'Mijn$Wachtw00rd!'
```
## Database Structuur
Het script maakt gebruik van de volgende SteVe database tabellen:
- `transaction` - Hoofd transactie gegevens
- `connector_meter_value` - Meterwaarden per tijdstip
- `connector` - Connector informatie
- `charge_box` - Laadpaal informatie
- `user` - Gebruikers
- `ocpp_tag` - RFID tags
- `user_ocpp_tag` - Koppeling tussen gebruikers en tags
## Toekomstige Features
Mogelijke uitbreidingen:
- [ ] Echte prijzen integratie vanuit prijzen database
- [ ] CSV export functionaliteit
- [ ] Grafische weergave van verbruik
- [ ] Vergelijking tussen transacties
- [ ] Maandelijkse/jaarlijkse samenvattingen
- [ ] CO2 besparing berekening
## Support
Voor vragen of problemen:
1. Controleer eerst de troubleshooting sectie
2. Test de database verbinding handmatig
3. Controleer of alle parameters correct zijn
## Licentie
Open source - vrij te gebruiken en aan te passen voor persoonlijk gebruik.
## Versie
Versie 1.1 - Oktober 2025
- Verbeterde prijsberekening
- Standaard gedrag: alle transacties tonen
- --limit werkt overal
- Betere voorbeelden en documentatie

52
steve_transaction_report.py
View File

@@ -244,9 +244,9 @@ class SteVeReporter:
print(f"Piekuur: {max_time.strftime('%d-%m %H:00')} "
f"({max_hour['consumption']:.2f} kWh)")
# Bereken geschatte kosten (indicatief)
print(f"\nGeschatte kosten (€0.30/kWh): €{total_consumption * 0.30:.2f}")
print(f"Geschatte kosten (€0.10/kWh): €{total_consumption * 0.10:.2f}")
# Bereken geschatte kosten (indicatief) - nu met correcte total_detailed
print(f"\nGeschatte kosten (€0.30/kWh): €{total_detailed * 0.30:.2f}")
print(f"Geschatte kosten (€0.10/kWh): €{total_detailed * 0.10:.2f}")
print("=" * 80)
@@ -295,16 +295,19 @@ def main():
epilog="""
Voorbeelden:
# Toon lijst van laatste 10 transacties
python3 steve_transaction_report.py --list
python3 steve_transaction_report.py --host 192.168.178.201 --port 3307 --password 'geheim' --list
# Toon gedetailleerd rapport van transactie 1
python3 steve_transaction_report.py --transaction 1
python3 steve_transaction_report.py --host 192.168.178.201 --port 3307 --password 'geheim' --transaction 1
# Toon laatste 20 transacties
python3 steve_transaction_report.py --list --limit 20
# Toon laatste 20 transacties in lijst
python3 steve_transaction_report.py --host 192.168.178.201 --port 3307 --password 'geheim' --list --limit 20
# Gebruik andere database credentials
python3 steve_transaction_report.py --host 192.168.1.100 --user steve --password geheim --transaction 1
# Toon alle transacties gedetailleerd (laatste 10)
python3 steve_transaction_report.py --host 192.168.178.201 --port 3307 --password 'geheim'
# Toon laatste 5 transacties gedetailleerd
python3 steve_transaction_report.py --host 192.168.178.201 --port 3307 --password 'geheim' --limit 5
"""
)
@@ -316,18 +319,13 @@ Voorbeelden:
parser.add_argument('--password', required=True, help='Database wachtwoord')
# Actie opties
parser.add_argument('--list', action='store_true', help='Toon overzicht van transacties')
parser.add_argument('--transaction', type=int, metavar='ID', help='Toon gedetailleerd rapport van transactie ID')
parser.add_argument('--limit', type=int, default=10, help='Aantal transacties bij --list (default: 10)')
parser.add_argument('--list', action='store_true', help='Toon compact overzicht van transacties (tabel format)')
parser.add_argument('--transaction', type=int, metavar='ID', help='Toon gedetailleerd rapport van specifieke transactie ID')
parser.add_argument('--limit', type=int, default=10, help='Aantal transacties (default: 10)')
parser.add_argument('--simple', action='store_true', help='Eenvoudig rapport zonder uurdetails')
args = parser.parse_args()
# Minimaal één actie nodig
if not args.list and not args.transaction:
parser.print_help()
sys.exit(1)
# Maak reporter object
reporter = SteVeReporter(
host=args.host,
@@ -340,16 +338,30 @@ Voorbeelden:
try:
reporter.connect()
if args.list:
reporter.list_transactions(limit=args.limit)
if args.transaction:
# Toon specifieke transactie
transactions = reporter.get_transactions(transaction_id=args.transaction)
if transactions:
reporter.print_transaction_report(transactions[0], detailed=not args.simple)
else:
print(f"✗ Transactie {args.transaction} niet gevonden")
sys.exit(1)
elif args.list:
# Toon compact overzicht
reporter.list_transactions(limit=args.limit)
else:
# Geen specifieke optie: toon alle transacties gedetailleerd
transactions = reporter.get_transactions(limit=args.limit)
if not transactions:
print("Geen transacties gevonden.")
else:
print(f"\n{'=' * 80}")
print(f"GEDETAILLEERDE RAPPORTEN VAN LAATSTE {len(transactions)} TRANSACTIES")
print(f"{'=' * 80}")
for i, trans in enumerate(transactions):
if i > 0:
print("\n\n")
reporter.print_transaction_report(trans, detailed=not args.simple)
except KeyboardInterrupt:
print("\n\nAfgebroken door gebruiker")