Chordbook

O projektu

Chordbook je multi-user webová aplikace pro muzikanty, která drží pohromadě osobní knihovnu akordů a zpěvník. Inspiroval se neckdiagrams.com a cílí na kytaru a ukulele.

Projekt běží v produkci na vlastní doméně a slouží jako prostor pro praktickou full-stack architekturu — od interaktivního UI přes doménové modelování hudby až po provoz přes Docker a CI/CD.

Frontend i backend žijí v jednom monorepu; infrastruktura (databáze, autentizace, úložiště, reverzní proxy) se zvedá přes Docker Compose a produkční multi-arch image se staví v GitHub Actions a publikují do GHCR.

Funkce

• Knihovna akordů s vlastním interaktivním editorem hmatů — klikání prstů, tažením přes struny barré, prázdné/tlumené struny, posun pražce a čísla prstů.
• Vestavěný katalog akordů (z open-source chords-db) i katalog písní z public-domain materiálu — vyhledávání, multi-výběr a import jedním klikem do vlastní sbírky.
• Zpěvník v ChordPro formátu s náhledem, transpozicí, tóninou, kapodastrem, tempem a doporučeným rytmem.
• Kolekce (pojmenované zpěvníky) s vlastním řazením písní, které řídí i pořadí při tisku.
• Tisk na straně klienta (A4) — celý zpěvník, jedna píseň, nebo mřížka akordových diagramů; lze i „Uložit jako PDF“.
• Autentizace přes Keycloak: in-app login a registrace proxované backendem, tokeny v httpOnly cookies, data izolovaná per uživatel.

Technologický stack

Focus

Full-stack architektura, autentizace přes Keycloak, doménové modelování hudby, produkční provoz