Skip to content
This repository has been archived by the owner on Jan 5, 2024. It is now read-only.
/ audiozpravy Public archive

Audiozprávy jsou projekt Česko.Digital a Nadačního fondu nezávislé žurnalistiky, který má za cíl doručit skrze mobilní aplikaci s rekomendačním enginem žurnalistiku v krátkém formátu a v lehčeji konzumovatelné audio podobě. Pokud máte zájem aplikaci použít neváhejte nás kontakt pro support na jakub.bares@cesko.digital

License

Notifications You must be signed in to change notification settings

cesko-digital/audiozpravy

Repository files navigation

cesko.digital

🎧 Audiozprávy

Oficiální repozitář týmu Audiozpráv v projeku #run-inovace-zpravodajskeho-storytellingu na Česko.digital

🔎 Co je obsahem repozitáře?

/app - mobilní aplikace Audiozpráv

/backend - API / backend aplikace (rekomendační systém)

/infrastructure - Terraform definice cloudové infrastruktury

/pipeline - pipeline zpracování nových zpráv (RSS scrape, preprocessing, TTS)

🛠 Jak přispívat?

Jazyky:

  • Angličtina: Kód, komentáře, pull-requesty, commit zprávy
  • Čeština: README a Issues

Issues:

  • Název by měl obsahovat zda se jedná o vývoj na aplikaci, nebo backendu + výstižný popisek (např. APP: Home screen komponenta)
  • Issue by měl obsahovat snadno pochopitelné zadání, z kterého bude zřejmé co je výstupem
  • Pokud se jedná o issue na FE měl by obsahovat screenshot z Figmy + odkaz na Figmu
  • Jednodušší issues tagujeme "good first issue", abychom mohli lépe vybírat úkoly pro juniornější vývojáře
  • Jakmile se někdo issue ujme, je potřeba ho k němu přiřadit

Pull-requesty:

  • Vytváříme fork-branches s názvem {iniciály-developera}-{číslo-issue}-{krátký-popisek}, tedy např. jn-74-test-branch
  • Před vytvořením pull-requestu interactive rebase s jedním commitem, ostatní jako fixup (název commitu = název branche)
  • Název pull requestu = název branch
  • Každé issue by mělo projít code-review od tech-lead + v případě práce na FE i schválení ze projektové strany týmu / grafika

🚀 Setup mobilní aplikace

cd app - přesun do adresáře aplikace

yarn install - nainstalování dependencies

yarn start - spuštění dev prostředí

🏛 Struktura backend aplikace

🚀 Setup backendu

cd backend

pip install -r requirements.txt

curl --remote-name-all https://lindat.mff.cuni.cz/repository/xmlui/bitstream/handle/11234/1-1836{/czech-morfflex-pdt-161115.zip} - stažení Morphodity

unzip czech-morfflex-pdt-161115.zip - unzip souborů

rm czech-morfflex-pdt-161115.zip - odstranění původního souboru

python manage.py runserver - spuštění django backendu

Spuštění v Dockeru lokálně

Backend:

docker compose -f docker-compose.prod.yml up  --build

Testování

V hlavním adresáři stačí spustit příkaz pytest

☎️ Komu se mám ozvat?

Techlead: Jakub Bareš (bares.jakub@gmail.com, 603 557 076)

About

Audiozprávy jsou projekt Česko.Digital a Nadačního fondu nezávislé žurnalistiky, který má za cíl doručit skrze mobilní aplikaci s rekomendačním enginem žurnalistiku v krátkém formátu a v lehčeji konzumovatelné audio podobě. Pokud máte zájem aplikaci použít neváhejte nás kontakt pro support na jakub.bares@cesko.digital

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published