Konfigurácia

Podrobný prehľad všetkých konfiguračných možností EOS Hub.

Premenné prostredia

Povinné premenné

Premenná	Popis	Príklad
DATABASE_URL	Pripojovací reťazec pre PostgreSQL	postgresql://user:pass@localhost:5432/eos_hub
NEXTAUTH_SECRET	Tajný kľúč pre šifrovanie session	Náhodný 32+ znakový reťazec
NEXTAUTH_URL	URL adresa aplikácie	https://eos-hub.example.com
DATA_ENCRYPTION_KEY	Kľúč na šifrovanie uložených tajných údajov (base64 z 32 náhodných bajtov)	Výstup openssl rand -base64 32

Značka a pojmy

Premenná	Popis	Príklad
PRODUCT_NAME	Názov produktu (predvolene EOS Hub). Zobrazuje sa v aplikácii a je aj názvom vedľa loga značky, názvom v manifeste webovej aplikácie (plocha telefónu), v názve a inštrukciách MCP servera a názvom OAuth zdroja, ktorý ukazujú konektory AI asistentov. Pozri Značka.	Acme OS
DEFAULT_TERMINOLOGY	Pojmy pre organizácie, ktoré si nevybrali vlastné: eos (Rocks, L10 porady, V/TO…, predvolené) alebo neutral (Ciele, Týždenné porady, Vízia a stratégia…). Pozri Pojmy.	neutral

Šifrovanie

DATA_ENCRYPTION_KEY šifruje uložené tajné údaje, napríklad API kľúče AI poskytovateľov (AES-256-GCM). Hodnota musí byť base64 reťazec z 32 náhodných bajtov. Vygenerujete ju príkazom:

openssl rand -base64 32

DANGER

Kľúč DATA_ENCRYPTION_KEY nemeňte a zálohujte ho spolu s ostatnými tajnými údajmi. Ak sa stratí alebo zmení, uložené API kľúče sa už nedajú dešifrovať a treba ich znova zadať v Platforma > AI.

WARNING

V produkcii server odmietne naštartovať, ak DATA_ENCRYPTION_KEY chýba alebo nie je platný base64 kľúč s dĺžkou 32 bajtov.

Autentifikácia

Premenná	Popis	Povinné
GOOGLE_CLIENT_ID	Google OAuth Client ID	Nie (ak nepoužívate Google prihlásenie)
GOOGLE_CLIENT_SECRET	Google OAuth Client Secret	Nie

Nastavenie Google OAuth

1. Prejdite na Google Cloud Console
2. Vytvorte nový projekt alebo vyberte existujúci
3. Prejdite do APIs & Services > Credentials
4. Kliknite na Create Credentials > OAuth 2.0 Client ID
5. Nastavte Authorized redirect URIs na https://vasa-domena.sk/api/auth/callback/google
6. Skopírujte Client ID a Client Secret do .env

Voliteľné premenné

Premenná	Popis	Predvolená hodnota
PORT	Port aplikácie	3000
NODE_ENV	Prostredie (development, production)	development

Monitorovanie

Kontrola dostupnosti, logy a hlásenia chýb, napr. cez Better Stack (funguje aj iný nástroj kompatibilný so Sentry). Každá časť je vypnutá, kým je jej premenná prázdna.

Premenná	Popis
APP_ENV	Názov prostredia v hláseniach chýb a v logoch (napr. prod, dev; predvolene production)
SENTRY_DSN	DSN pre hlásenie chýb (Better Stack: Errors → Application → Data ingestion: https://<token>@<ingesting host>/<application id>). Hlásia sa chyby zo servera aj z prehliadača -- bez tracingu, bez nahrávania relácií, používatelia len cez ID. Číta sa za behu, nie pri builde.
HEARTBEAT_URL	Heartbeat URL monitora dostupnosti. Úloha na pozadí, ktorá ukončuje zabudnuté stretnutia, ju volá každých 5 minút (pri chybe …/fail), takže zastavená úloha vyvolá upozornenie.
BETTERSTACK_LOGS_HOST, BETTERSTACK_LOGS_TOKEN	Zdroj logov (ingesting host a token zdroja) pre službu logs v docker-compose.yml: s COMPOSE_PROFILES=logs posiela logy kontajnerov app a postgres (Vector, docker/vector.yaml).

Kontrola stavu: GET /api/health vracia 200 {"status":"ok","version":"…"}, kým aplikácia a jej databáza fungujú, inak 503 -- nasmerujte naň monitor dostupnosti. V produkcii server loguje jeden JSON riadok na záznam (level, msg a ID, nikdy obsah).

Konfigurácia databázy

Prisma schéma

Databázová schéma je definovaná v prisma/schema.prisma. Hlavné modely:

• User -- používatelia (vrátane osobného časového pásma)
• Organization -- organizácie (názov, časové pásmo, predvolený jazyk, stav)
• OrgMember -- členstvo v organizácii s rolou (Vlastník, Administrátor, Člen, Implementátor)
• Team -- tímy v rámci organizácií
• TeamMember -- členstvo v tíme s tímovou rolou
• Meeting -- L10 stretnutia
• Rock -- kvartálne priority
• Scorecard / Measurable -- ukazovatele
• Issue -- problémy na riešenie
• Todo -- úlohy

Migrácie databázy

Databázová schéma sa spravuje cez Prisma migrácie v priečinku prisma/migrations. Zmeny schémy sa dodávajú výlučne ako migrácie -- prisma db push sa už nepoužíva.

Vytvorenie novej migrácie po úprave schémy (len vo vývoji):

npx prisma migrate dev --name popis-zmeny

Aplikovanie migrácií v produkcii:

npx prisma migrate deploy

Vizuálne prezeranie dát:

npx prisma studio

Docker

Docker entrypoint spúšťa prisma migrate deploy pri každom štarte, takže netreba nič robiť ručne. Databázu vytvorenú pôvodným postupom cez db push (má tabuľky, ale nemá históriu migrácií) entrypoint rozpozná a pred aplikovaním migrácií ju automaticky označí základnou migráciou (baseline). Ak migrácia zlyhá, kontajner sa zastaví a nenaštartuje nad napoly zmigrovanou databázou.

WARNING

Pred aktualizáciou na novú verziu si zálohujte databázu -- migrácie môžu obsahovať aj migráciu dát.

Konfigurácia autentifikácie

EOS Hub podporuje dva spôsoby prihlásenia:

Google OAuth

Preferovaný spôsob pre produkciu. Vyžaduje nastavenie GOOGLE_CLIENT_ID a GOOGLE_CLIENT_SECRET.

Prihlásenie údajmi (Credentials)

Prihlásenie pomocou e-mailu a hesla. Vhodné pre vývojové prostredie a interné nasadenia.

Bezpečnosť

V produkcii odporúčame používať výlučne Google OAuth pre vyššiu bezpečnosť. Credential provider neimplementuje 2FA.

Konfigurácia jazykov

Predvolený jazyk a dostupné jazyky sa konfigurujú v src/lib/i18n.ts:

export const locales = ['en', 'sk'] as const;
export const defaultLocale = 'en';

Podrobnosti nájdete v časti Jazykové verzie.

Konfigurácia tém

Farebné schémy a predvolená téma sú konfigurovateľné. EOS Hub podporuje:

• Svetlý / tmavý režim -- automaticky podľa systému alebo manuálne
• 6 farebných schém -- rôzne farebné palety

Podrobnosti nájdete v časti Témy a farebné schémy.

Ďalšie kroky

• Organizácie a tímy -- nastavenie štruktúry
• Roly a oprávnenia -- správa prístupu