-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy path.cursorrules
85 lines (74 loc) · 2.29 KB
/
.cursorrules
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
# Cursor Rules für Modbus Manager
# Diese Regeln helfen bei der systematischen und qualitativen Entwicklung
# 1. Code-Änderungen
- Immer erst die komplette Verarbeitungskette verstehen, bevor Änderungen vorgenommen werden
- Keine voreiligen Annahmen treffen
- Maximal eine logische Änderung pro Commit
- Bei Fehlern: Erst analysieren, dann handeln
# 2. Validierung & Tests
- Jede Änderung muss validiert werden
- Fehlerbehandlung immer berücksichtigen
- Logging für wichtige Schritte implementieren
- Edge Cases dokumentieren und testen
# 3. Code-Struktur
- Klare Trennung von Validierung und Verarbeitung
- Einheitliche Fehlerbehandlung
- Konsistente Logging-Struktur
- Typisierung wo möglich
# 4. YAML Verarbeitung
## Register Definitionen
- Pflichtfelder prüfen: name, type
- Register-Typ gegen TYPE_CONVERTERS validieren
- Polling-Intervall setzen (default: normal)
## Berechnete Register
- Unterstützte Formate:
```yaml
# Format 1: calculation
calculation:
type: "sum"|"mapping"|"conditional"|"formula"
sources: [...] # für sum
source: "..." # für mapping/conditional
formula: "..." # für formula
map: "..." # für mapping
# Format 2: formula/variables
formula: "..."
variables:
- name: "..."
source: "..."
```
- Beide Formate unterstützen
- Bei Konvertierung Datenintegrität sicherstellen
# 5. Fehlerbehandlung
- Spezifische Fehlermeldungen
- Kontext in Logs:
- device
- register/calc_id
- relevante Werte
- traceback
- Graceful Degradation wo möglich
# 6. Performance
- Batch-Verarbeitung für Register
- Caching wo sinnvoll
- Asynchrone Verarbeitung
- Ressourcen-Monitoring
# 7. Wartbarkeit
- Klare Dokumentation
- Aussagekräftige Variablennamen
- Modulare Struktur
- Wiederverwendbare Komponenten
# 8. Vorgehen bei Änderungen
1. Analysiere den kompletten Datenfluss
2. Identifiziere betroffene Komponenten
3. Prüfe bestehende Tests/Validierung
4. Implementiere Änderungen schrittweise
5. Validiere jede Änderung
6. Dokumentiere Entscheidungen
# 9. Review-Checkliste
- [ ] Datenfluss verstanden?
- [ ] Alle Edge Cases berücksichtigt?
- [ ] Fehlerbehandlung implementiert?
- [ ] Logging ausreichend?
- [ ] Tests angepasst/erstellt?
- [ ] Dokumentation aktualisiert?
- [ ] Performance-Impact geprüft?
- [ ] Breaking Changes dokumentiert?