Návod pro instalaci projektu

1. Klonování repozitáře

git clone git@github.com:matakom/bible-memorization.git
cd bible-memorization

2. Server (NestJS)

Backend běží v Docker kontejnerech, které spravují databázi PostgreSQL a API logiku.

Instalace závislostí

cd nestjs_server
npm install

Konfigurace prostředí (.env)

Vytvořte soubor .env ve složce nestjs_server a vyplňte následující proměnné:

DB_HOST=postgres
DB_PORT=5432
DB_USERNAME=vase_jmeno
DB_PASSWORD=vase_heslo
DB_DATABASE=bible_db
FB_PROJECT_ID=vas_firebase_projekt

Spuštění serveru

# Spuštění kontejnerů s databází a API
npm run docker:up

# Výpis logů serveru
npm run docker:logs

3. Vystavení serveru (Cloudflare Tunnel a DNS)

Aby mohla mobilní aplikace komunikovat se serverem (zejména pokud běží na reálném zařízení mimo lokální síť), je nutné server zpřístupnit do internetu.

Cloudflare Tunnel: Nainstalujte a nakonfigurujte cloudflared. Vytvořte tunel, který přesměruje vnější provoz na lokální port vašeho běžícího NestJS serveru (např.) http://localhost:3000.
Nastavení DNS: V administraci vaší domény (např. v rozhraní Cloudflare) vytvořte CNAME záznam pro vybranou subdoménu (např.)api.vasedomena.czTento záznam musí směřovat na adresu vašeho Cloudflare tunelu (končící na)..cfargotunnel.com

4. Konfigurace Google Přihlášení a Firebase

Pro funkční přihlašování je nutné správně nastavit Firebase a Google Cloud Console.

Testovací uživatelé: V Google Cloud Console (v sekci OAuth consent screen) musíte přidat svůj Google účet do seznamu "Test users", jinak se při lokálním vývoji nepřihlásíte.
SHA klíče: Vygenerujte si lokální SHA-1 a SHA-256 certifikát vašeho vývojového prostředí a vložte jej do nastavení Android aplikace ve vaší Firebase konzoli.
Konfigurační soubor: Stáhněte si soubor google-services.json z Firebase a umístěte jej do složky flutter_app/android/app/.

5. Mobilní aplikace (Flutter)

Instalace závislostí

cd flutter_app
flutter pub get

Konfigurace prostředí (.env)

V kořenové složce flutter_app vytvořte soubor .env a doplňte adresy a klíče (BASE_URL musí odpovídat adrese z vašeho nastavení DNS z kroku 3):

BASE_URL=https://api.vasedomena.cz
GOOGLE_WEB_CLIENT_ID=vas_google_web_client_id
SERVER_CLIENT_ID=vas_server_client_id

Generování kódu

Aplikace vyžaduje jednorázové vygenerování kódu pro lokální databázi (Drift) a datové modely:

just gen-build

Spuštění aplikace

Připojte k počítači telefon s operačním systémem Android a povolte ladění přes USB (USB debugging).

# Spuštění ve vývojovém režimu
just run

# Spuštění v produkčním režimu
just run prod