Contribuire¶

Setup sviluppo¶

git clone https://github.com/sbobinator/sbobinator.git
cd sbobinator
python scripts\install_local.py
pip install -e ".[local,dev]"

Convenzioni¶

Aspetto	Regola
Python	3.12+, type hints dove possibile
Lint	`ruff` (line-length 100)
Script	Solo Python — no `.ps1`
Commit	Messaggi chiari in italiano o inglese
Scope	Diff minimi, niente refactor non richiesti

Aggiungere documentazione¶

Modifica file in docs/
Aggiorna nav in mkdocs.yml se nuova pagina
mkdocs serve per anteprima
Push su main → deploy automatico GitHub Pages

Aggiungere funzionalità¶

Leggi Architettura
Job → passa da jobs.py + pipeline.py
Modelli → sempre offline in models/
UI → non bloccare thread con NeMo (usa worker)

Segnalazione bug¶

Documenta in bug-fix/TRACCIAMENTO-BUG.md con:

Sintomo
Causa root
Fix o workaround
Come riprodurre

Roadmap¶

Vedi evolutive/ROADMAP-EVOLUTIVE.md per evoluzioni pianificate.

Licenza¶

Contribuendo codice o documentazione al repository, dichiari di avere i diritti necessari e accetti che il contributo, se accettato, sia integrato nel Software di proprietà di Antonio Trento secondo i termini della licenza in LICENSE. Per contributi significativi può essere richiesto un accordo scritto.