Contribuer

evcc est développé par la communauté. La plupart des façons d’aider ne demandent aucune ligne de code.

Commencer petit

Ne commencez pas par la grande fonctionnalité qui vous tient à cœur, même si les agents d’IA rendent cela incroyablement simple et tentant. Lisez d’abord les discussions et les issues pour vous faire une idée du fonctionnement de la communauté. Votre idée a probablement déjà été évoquée, alors recherchez-la et rejoignez la conversation existante. Commencez par quelque chose de petit et progressez à partir de là. Les changements plus importants doivent faire l’objet d’un accord dans une issue ou une discussion avant de passer à l’implémentation et à une pull request.

Aider les autres

Beaucoup de questions dans les discussions peuvent être résolues par quelqu’un qui possède le même appareil ou a eu le même problème. Le tri aide aussi : reproduire les bugs signalés, demander les journaux manquants et signaler les doublons. Signaler un problème explique ce que contient une issue utile.

Tester les nouvelles versions

La version nightly contient tout ce qui a été fusionné depuis la dernière version publiée. Tous les guides d’installation (p. ex. Linux, Docker ou Home Assistant) expliquent comment y passer. Sauvegardez votre installation avant de changer de version. Les nouvelles fonctionnalités sont souvent d’abord expérimentales et doivent être activées dans Configuration → Expérimental.

Pour une pull request, les mainteneurs peuvent publier un build de test avec des binaires et une image Docker evcc/evcc:pr-<number>. Un court rapport de test de quelqu’un qui dispose du matériel correspondant est souvent ce qui permet de fusionner une modification. Si une pull request n’a pas encore de build de test mais que vous pourriez la tester, n’hésitez pas à en demander un dans la pull request.

Pour essayer en avant-première les nouvelles versions de l’app iOS et Android, consultez la section bêta de l’app.

Vos propres appareils

Les meilleures premières contributions viennent de votre propre installation. Vous possédez un onduleur, une batterie domestique, un véhicule ou un chargeur que les mainteneurs ne peuvent pas tester. Confirmez que des corrections fonctionnent ou améliorez les instructions d’un modèle d’appareil. Votre appareil n’est pas encore pris en charge ? Configurez-le d’abord comme appareil personnalisé puis, une fois qu’il fonctionne, transformez-le en modèle d’appareil pour tout le monde.

Traduire

L’interface est traduite sur Weblate. Ajoutez une nouvelle langue ou vérifiez et améliorez une traduction existante, sans aucun outil de développement.

Améliorer la documentation

Chaque page comporte en bas un lien Modifier cette page qui vous mène à sa source sur GitHub. La documentation est rédigée en anglais et en allemand. Si vous ne parlez qu’une de ces deux langues, indiquez-le dans votre pull request et nous vous aiderons pour l’autre.

Écrire du code

Le guide de contribution couvre les règles de base, l’environnement de développement et la manière de tester en local. Les sujets généraux de développement sont discutés sur Slack.

Développer autour d’evcc

Les tableaux de bord, écrans, utilitaires ou gadgets matériels qui aident d’autres utilisateurs sont aussi des contributions. L’API REST et l’API MQTT vous donnent accès à toutes les données de votre instance evcc. Présentez votre projet dans les discussions et ajoutez-le aux autres projets géniaux.

Vue d’ensemble des projets

Dépôt	Description	Technologies
evcc-io/evcc	Cœur, interface web et modèles d’appareils	Go, Vue
evcc-io/app	App iOS et Android	React Native
evcc-io/optimizer	Service de l’optimiseur	Python
evcc-io/docs	Cette documentation	Astro, Markdown
evcc-io/images	Images Linux pour Raspberry Pi et d’autres cartes	Armbian
evcc-io/hassio-addon	App Home Assistant	Docker
evcc-io/evcc.io	Site web	Hugo

Signaler un problème indique à quel dépôt appartient un problème.

Jetons de contributeur

Le projet vit des contributions de nombreuses personnes : code, modèles, documentation, traductions, réponses dans les discussions ou rapports de test détaillés.

Vous avez déjà pas mal contribué ? Envoyez-nous un court e-mail avec votre nom d’utilisateur GitHub et nous vous attribuerons un jeton de parrain illimité.