📖 Uživatelská příručka

Laický průvodce pro Martina (a každého, kdo nechce číst kód)

Verze 1.2 · aktualizováno 2026-06-10

Technické nastavení

Tato kapitola je pro správce serveru (nebo pro tebe, až budeš chtít šťourat do detailů).

Pro běžné používání stačí Telegram a web — nemusíš číst dál.


Kde co běží

Služba Adresa Účel
Second Brain brain.rawfuture.cz API, bot, web app
RAW Projects projects.rawfuture.cz Projekty, kalendář UI
Vault /srv/vault na serveru Soubory poznámek

Průvodce nastavením serveru

Podrobný postup (rsync vaultu, indexace, API token):

👉 Technický průvodce /guide

Tam najdeš Swagger (/docs) pro vývojáře.


Dokumentace pro vývojáře (v repozitáři)


Co nastavit, když něco nefunguje

Problém Kam koukat
Bot neodpovídá TELEGRAM_BOT_TOKEN, allowed user IDs
Garmin prázdný /srv/brain-secrets/garmin/, sync v logu
Penízky staré sync konektoru penizky
Kalendář prázdný GOOGLE_CALENDAR_ID + service account JSON
AI neodpovídá GEMINI_API_KEY nebo OpenRouter

Secrets jsou v /srv/brain-secrets/brain.envne v Dropbox .env pro produkci.


Aktualizace příručky

Příručka se píše postupně. Verze a datum najdeš v patičce. Nové funkce = nová podkapitola.

Chybí ti téma? Napiš si poznámku — doplníme.