Add example Claude sync request file

2025-10-13 16:03:52 +02:00
parent 77c0ad5e43
commit 6d1bc7db4d
1 changed files with 130 additions and 0 deletions
--- a/CLAUDE_SYNC_REQUEST_EXAMPLE.md
+++ b/CLAUDE_SYNC_REQUEST_EXAMPLE.md
@@ -0,0 +1,130 @@
+# Richiesta Sincronizzazione MATLAB → Python
+
+**Generato automaticamente da**: sync_server_file_enhanced.sh
+**Data**: 2025-10-13 16:45:23
+**File modificati**: 3
+
+---
+
+## 📋 File MATLAB Modificati
+
+```
+matlab_func/CalcoloBiax_TuL.m
+matlab_func/CalcoloRSN.m
+matlab_func/arot.m
+```
+
+---
+
+## 🎯 Moduli Python Interessati
+
+- **ATD Module** → `src/atd/`
+  - Files: elaboration.py, conversion.py, averaging.py, db_write.py, star_calculation.py
+- **RSN Module** → `src/rsn/`
+  - Files: elaboration.py, conversion.py, averaging.py, db_write.py
+- **Tilt Module** → `src/tilt/`
+  - Files: elaboration.py, conversion.py, averaging.py, geometry.py, db_write.py
+
+---
+
+## 📝 Preview Modifiche (prime 30 righe per file)
+
+### 📄 matlab_func/CalcoloBiax_TuL.m
+
+```diff
+@@ -45,7 +45,10 @@
+ % Calcolo correlazione Y
+-Yi = -Z_prev * az(ii);
+% Aggiunto fattore di correzione per mounting angle
+correction_factor = params.correction_factor;
+Yi = -Z_prev * az(ii) * correction_factor;
+
+ % Validazione range
+if abs(Yi) > max_displacement
+    Yi = max_displacement * sign(Yi);
+end
+```
+
+### 📄 matlab_func/CalcoloRSN.m
+
+```diff
+@@ -230,6 +230,8 @@
+ % Calcolo angolo inclinazione
+ angle = atan2(ay, ax);
+% Conversione in gradi e gestione valori negativi
+angle = angle * 180/pi;
+if angle < 0
+    angle = angle + 360;
+end
+```
+
+### 📄 matlab_func/arot.m
+
+```diff
+@@ -15,4 +15,8 @@
+ % Rotazione vettore
+ v_rot = q_mult(q_mult(q, [0; v]), q_conj);
+
+% Normalizzazione output
+if norm(v_rot(2:4)) > 0
+    v_rot(2:4) = v_rot(2:4) / norm(v_rot(2:4));
+end
+```
+
+---
+
+## ✅ Azione Richiesta
+
+Aggiornare il codice Python corrispondente ai file MATLAB modificati sopra.
+
+### Workflow Suggerito
+
+1. **Analizzare modifiche MATLAB**
+   - Leggere i file modificati
+   - Identificare cambiamenti negli algoritmi
+   - Verificare nuovi parametri o modifiche formule
+
+2. **Applicare modifiche Python**
+   - Aggiornare funzioni Python corrispondenti
+   - Mantenere coerenza con architettura esistente
+   - Aggiungere type hints e documentazione
+
+3. **Validare modifiche**
+   ```bash
+   # Test base
+   python -m src.main CU001 A
+
+   # Validazione completa vs MATLAB
+   python -m src.validation.cli CU001 A --output validation_report.txt
+
+   # Verifica report
+   cat validation_report.txt | grep "VALIDATION"
+   ```
+
+4. **Commit e tag**
+   ```bash
+   git add src/
+   git commit -m "Sync Python from MATLAB changes - 2025-10-13"
+   git tag python-sync-20251013
+   ```
+
+---
+
+## 📚 Riferimenti
+
+- **Mapping completo**: [MATLAB_SYNC_GUIDE.md](MATLAB_SYNC_GUIDE.md)
+- **Quick reference**: [sync_matlab_changes.md](sync_matlab_changes.md)
+- **Validation guide**: [README.md#validation](README.md#validation)
+
+---
+
+## 💡 Note
+
+- I file MATLAB sono già stati committati nel repository
+- Questo è un commit separato che richiede sync Python
+- Dopo sync Python, eseguire validazione per verificare equivalenza
+
+---
+
+*File generato automaticamente - Non modificare manualmente*
+*Timestamp: 2025-10-13 16:45:23*