Contribuisci

evcc è sviluppato dalla community. La maggior parte dei modi per aiutare non richiede codice.

Comincia dalle piccole cose

Non partire dalla grande funzione che ti sta più a cuore, anche se gli agenti AI la rendono incredibilmente facile e allettante. Prima segui le discussioni e le issue per farti un’idea di come funziona la community. Probabilmente la tua idea è già stata proposta, quindi cercala e partecipa alla conversazione esistente. Comincia con qualcosa di piccolo e poi procedi per gradi. Le modifiche più grandi richiedono un accordo in una issue o in una discussione prima di passare all’implementazione e a una pull request.

Aiuta gli altri

A molte domande nelle discussioni può rispondere chi possiede lo stesso dispositivo o ha avuto lo stesso problema. Anche il triage aiuta: riproduci i bug segnalati, chiedi i log mancanti e indica i duplicati. Segnala un problema spiega cosa contiene una issue utile.

Testa le nuove versioni

La build nightly contiene tutto ciò che è stato integrato dall’ultima release. Tutte le guide di installazione (ad es. Linux, Docker o Home Assistant) spiegano come passare alla build nightly. Fai un backup della tua installazione prima di passare. Le nuove funzioni spesso nascono come sperimentali e vanno attivate in Configurazione → Sperimentale.

Per una pull request, i maintainer possono pubblicare una build di test con i binari e un’immagine Docker evcc/evcc:pr-<number>. Spesso basta un breve resoconto di test da parte di chi ha l’hardware corrispondente perché una modifica venga integrata. Se una pull request non ha ancora una build di test ma potresti testarla, chiedila pure nella pull request.

Per provare in anteprima le nuove versioni dell’app per iOS e Android, consulta la sezione beta dell’app.

I tuoi dispositivi

I migliori primi contributi nascono dalla tua configurazione. Possiedi un inverter, una batteria domestica, un veicolo o un caricabatterie che i maintainer non possono testare. Conferma le correzioni o migliora le istruzioni di un template. Il tuo dispositivo non è ancora supportato? Configuralo prima come dispositivo definito dall’utente e, una volta che funziona, trasformalo in un template per tutti.

Traduci

L’interfaccia viene tradotta su Weblate. Aggiungi una nuova lingua oppure controlla e migliora una esistente, senza bisogno di strumenti per sviluppatori.

Migliora la documentazione

In fondo a ogni pagina c’è un link Modifica pagina che ti porta al suo sorgente su GitHub. La documentazione è scritta in inglese e in tedesco. Se parli solo una delle due lingue, indicalo nella tua pull request e ti aiuteremo con l’altra.

Scrivi codice

Le linee guida per i contributi coprono le regole di base, l’ambiente di sviluppo e come testare in locale. I temi generali di sviluppo si discutono su Slack.

Costruisci qualcosa attorno a evcc

Dashboard, display, strumenti o gadget hardware che aiutano altri utenti sono anch’essi contributi. La REST API e la MQTT API ti danno accesso a tutti i dati della tua istanza evcc. Presenta il tuo progetto nelle discussioni e aggiungilo a Altri progetti fantastici.

Panoramica dei progetti

Repository	Che cos’è	Tecnologia
evcc-io/evcc	Core, interfaccia web e template dei dispositivi	Go, Vue
evcc-io/app	App per iOS e Android	React Native
evcc-io/optimizer	Servizio ottimizzatore	Python
evcc-io/docs	Questa documentazione	Astro, Markdown
evcc-io/images	Immagini Linux per Raspberry Pi e altre schede	Armbian
evcc-io/hassio-addon	App di Home Assistant	Docker
evcc-io/evcc.io	Sito web	Hugo

Segnala un problema indica a quale repository appartiene un problema.

Token per chi contribuisce

Il progetto vive dei contributi di molte persone, sotto forma di codice, template, documentazione, traduzioni, risposte nelle discussioni o resoconti di test dettagliati.

Hai già contribuito parecchio? Scrivici una breve email con il tuo nome utente GitHub e ti rilasceremo un token sponsor illimitato.