Initial commit: Fusion->Blender->GLB pipeline + contract for ThreeJS bridge

README.md

@@ -0,0 +1,42 @@
+# syncro_multi_agente
+
+Pipeline **Autodesk Fusion 360 → Blender → GLB** + contratto di interfaccia per il viewer **Three.js**.
+
+Repository condiviso tra:
+- **Agent A** (questo repo) — produce `plotter.glb` e `joints.json` da Fusion.
+- **Agent B** (altro workspace) — consuma il GLB in un viewer web con `FusionRig.js`.
+
+## Contenuto
+
+| File | Scopo |
+|---|---|
+| [FUSION_GLB_CONTRACT.md](FUSION_GLB_CONTRACT.md) | **Fonte di verità.** Schema `joints.json`, convenzioni `userData` nel GLB, unità di misura, lista dei 5 driver pilotati. |
+| [BRIDGE_NOTES.md](BRIDGE_NOTES.md) | Risposte ai problemi `[OPEN]` del contratto e stato della checklist. |
+| [THREEJS_USAGE.md](THREEJS_USAGE.md) | Snippet copia-incolla per caricare e pilotare `plotter.glb` in Three.js. |
+| [AGENTS.md](AGENTS.md) | Regole operative per Copilot Chat (entrambi gli agent). |
+| `ExportKinematicGraph.py` | Add-in/script Fusion 360: produce `hierarchy.json` + `joints.json` + meshes OBJ. |
+| `build_glb_from_fusion_export.py` | Script Blender: importa la mesh, ricostruisce la gerarchia con `userData`, embedda il manifest, esporta `plotter.glb`. |
+| `build_glb.bat` | Wrapper Windows per lanciare Blender headless. |
+
+## Quick start (lato produttore)
+
+1. In **Fusion 360**: `Utilities → ADD-INS → Scripts → ExportKinematicGraph → Run`.
+2. Lo script chiede una cartella di output (default: `C:\Users\croce\OneDrive\Desktop\export`).
+3. Da PowerShell:
+   ```powershell
+   cd "C:\Users\croce\OneDrive\Desktop\export grafo fusion"
+   .\build_glb.bat "C:\Users\croce\OneDrive\Desktop\export"
+   ```
+4. Output: `plotter.glb` pronto per il viewer.
+
+## Lato consumatore (Three.js)
+
+Vedi [THREEJS_USAGE.md](THREEJS_USAGE.md) e [FUSION_GLB_CONTRACT.md §3-§5](FUSION_GLB_CONTRACT.md).
+
+## Convenzioni di lavoro
+
+Vedi [AGENTS.md](AGENTS.md) — in particolare le regole su branch, commit message e cosa NON committare.
+
+## Stato attuale
+
+Vedi sezione "Stato attuale dell'export" in [BRIDGE_NOTES.md](BRIDGE_NOTES.md).