Zapojte se
evcc vzniká díky komunitě. Většina způsobů, jak pomoci, nevyžaduje žádný kód.
Začněte zlehka
Sekce “Začněte zlehka”Nezačínejte hned velkou funkcí, po které toužíte, i když to s AI agenty jde neuvěřitelně snadno a hodně to láká. Nejprve sledujte diskuse a issues a získejte představu o tom, jak komunita funguje. Váš nápad se pravděpodobně už objevil, takže ho vyhledejte a zapojte se do existující konverzace. Začněte něčím malým a postupně se propracujte k větším věcem. U větších změn se nejprve dohodněte v issue nebo diskusi a teprve pak se pusťte do implementace a pull requestu.
Pomáhejte ostatním
Sekce “Pomáhejte ostatním”Na mnoho dotazů v diskusích dokáže odpovědět někdo, kdo vlastní stejné zařízení nebo měl stejný problém. Pomáhá i třídění: reprodukujte nahlášené chyby, vyžádejte si chybějící logy a upozorněte na duplicity. Stránka Nahlásit problém vysvětluje, co má užitečné issue obsahovat.
Testujte nové verze
Sekce “Testujte nové verze”Nightly build obsahuje vše, co bylo začleněno od posledního vydání. Všechny instalační návody (např. Linux, Docker nebo Home Assistant) vysvětlují, jak na něj přejít. Před přechodem si svou instalaci zazálohujte. Nové funkce často začínají jako experimentální a je potřeba je zapnout v Konfigurace → Experimentální.
Pro pull request mohou správci zveřejnit testovací build s binárkami a Docker image evcc/evcc:pr-<number>.
Krátká zpráva z testu od někoho s odpovídajícím hardwarem často rozhodne o tom, zda se změna začlení.
Pokud pull request ještě nemá testovací build, ale vy byste ho mohli otestovat, klidně si o něj v pull requestu řekněte.
Chcete-li dříve vyzkoušet nové verze aplikace pro iOS a Android, podívejte se do sekce o betaverzi aplikace.
Vaše vlastní zařízení
Sekce “Vaše vlastní zařízení”Nejlepší první příspěvky vycházejí z vaší vlastní instalace. Vlastníte střídač, domácí baterii, vozidlo nebo nabíječku, které správci nemohou otestovat. Potvrzujte opravy nebo vylepšujte návody v šablonách. Vaše zařízení zatím není podporováno? Nejprve ho nastavte jako zařízení definované uživatelem a jakmile funguje, udělejte z něj šablonu pro všechny.
Překládejte
Sekce “Překládejte”Rozhraní se překládá na Weblate. Přidejte nový jazyk nebo zkontrolujte a vylepšete existující. Žádné vývojářské nástroje k tomu nepotřebujete.
Vylepšete dokumentaci
Sekce “Vylepšete dokumentaci”Každá stránka má dole odkaz Upravit stránku, který vás zavede k jejímu zdroji na GitHubu. Dokumentace se píše v angličtině a němčině. Pokud ovládáte jen jeden z těchto jazyků, uveďte to v pull requestu a s tím druhým vám pomůžeme.
Pište kód
Sekce “Pište kód”Pokyny pro přispěvatele popisují základní pravidla, nastavení vývojového prostředí a lokální testování. Obecná vývojářská témata se probírají na Slacku.
Vytvořte něco pro evcc
Sekce “Vytvořte něco pro evcc”Dashboardy, displeje, nástroje nebo hardwarové vychytávky, které pomáhají ostatním uživatelům, jsou také příspěvky. REST API a MQTT API vám dávají přístup ke všem datům vaší instance evcc. Představte svůj projekt v diskusích a přidejte ho na stránku Další skvělé projekty.
Přehled projektů
Sekce “Přehled projektů”| Repozitář | Co to je | Technologie |
|---|---|---|
| evcc-io/evcc | Jádro, webové rozhraní a šablony zařízení | Go, Vue |
| evcc-io/app | Aplikace pro iOS a Android | React Native |
| evcc-io/optimizer | Služba optimalizátoru | Python |
| evcc-io/docs | Tato dokumentace | Astro, Markdown |
| evcc-io/images | Linuxové image pro Raspberry Pi a další desky | Armbian |
| evcc-io/hassio-addon | Aplikace pro Home Assistant | Docker |
| evcc-io/evcc.io | Webové stránky | Hugo |
Stránka Nahlásit problém uvádí, do kterého repozitáře který problém patří.
Tokeny pro přispěvatele
Sekce “Tokeny pro přispěvatele”Projekt žije z příspěvků mnoha lidí, ať už jde o kód, šablony, dokumentaci, překlady, odpovědi v diskusích nebo podrobné zprávy z testování.
Už jste toho přispěli docela dost? Pošlete nám krátký e-mail se svým uživatelským jménem na GitHubu a my vám vystavíme neomezený sponzorský token.