FitBreak

FitBreak je webová aplikace, která uživatelům pravidelně připomíná přestávky během práce u počítače. Aplikace mluví na uživatele prostřednictvím TTS (Text-to-Speech), zobrazuje motivační hlášky a navrhuje cviky.

Jak funguje:

• Uživatel nastaví interval (10-120 minut)
• Po uplynutí intervalu se zobrazí přestávka s hláškou a volitelně cvikem
• Aplikace přečte hlášku zvoleným hlasem (prohlížeč, Azure nebo Google Cloud TTS)
• Pokud je připojen Google Calendar, přestávky se automaticky přizpůsobí rozvrhu
• Smart Break systém analyzuje kalendář a vybírá vhodné cviky podle typu aktivity

Architektura:

• Frontend: HTML5 / CSS3 / Vanilla JavaScript (SPA)
• Backend: PHP (API endpointy)
• Databáze: SQLite (data/fitbreak.db)
• Hosting: Běží na libovolném PHP serveru (WAMP, Apache, Nginx)

Google Cloud

1. Přejděte na Google Cloud Console
2. Vytvořte nový projekt nebo vyberte existující
3. Zapněte Google Calendar API a Cloud Text-to-Speech API v sekci APIs & Services
4. Vytvořte OAuth 2.0 credentials (Client ID a Client Secret) pro webovou aplikaci
5. Nastavte Authorized redirect URIs na: https://vasedomena.cz/api/calendar-callback.php
6. Pro Google TTS vytvořte API Key v sekci Credentials
7. Všechny klíče zadejte v sekci "API & Nastavení" tohoto admin panelu

Azure Speech

1. Přejděte na Azure Portal
2. Vytvořte nový resource typu "Speech" (Cognitive Services)
3. Vyberte region (doporučeno: westeurope)
4. Po vytvoření zkopírujte klíč z Keys and Endpoint
5. Zadejte klíč a region v sekci "API & Nastavení"

Stripe

1. Vytvořte účet na Stripe Dashboard
2. V sekci Developers > API Keys najdete Publishable key (pk_...) a Secret key (sk_...)
3. Pro testování použijte testovací klíče, pro produkci živé klíče
4. Zadejte oba klíče a cenu v sekci "API & Nastavení"

Role:

• admin - plný přístup k admin panelu, správě uživatelů a nastavení
• user - běžný uživatel s přístupem k aplikaci

Jak se platí:

• Aplikace je zdarma a bez omezení — žádná zkušební doba, žádný paywall
• Zdarma znamená s reklamou; platí se jen za její vypnutí
• Dva tarify: 100 Kč/měsíc nebo 1 000 Kč/rok (stejná výhoda, roční je levnější)
• Jde o opakované předplatné přes Stripe — uživatel ho může kdykoli zrušit a dojede do konce zaplaceného období

Kde se to spravuje:

• Reklama — zapnout/vypnout reklamy, publisher ID, jednotlivé pozice
• Předplatné — přehled aktivních předplatných, ceny tarifů, stav Stripe
• Vypnutí reklam má vždy i admin — na testování nepotřebuje platit

Podporované jazyky:

• CZ - Čeština (výchozí)
• EN - Angličtina
• DE - Němčina
• PL - Polština

Jak funguje přepínání:

• Uživatel vybere jazyk v hlavičce aplikace (vlajky)
• Jazyk se uloží do localStorage a na server (pokud je přihlášen)
• Stránka se automaticky přenačte s novým jazykem
• Všechny texty UI se přeloží přes i18n.js
• TTS hlasy se automaticky přefiltrují na zvolený jazyk

Datové soubory:

• data/messages.json - 1000 hlášek (CZ)
• data/messages_en.json - 1000 hlášek (EN)
• data/messages_de.json - 1000 hlášek (DE)
• data/messages_pl.json - 1000 hlášek (PL)
• data/exercises.json - 50 cviků (CZ), analogicky pro další jazyky

Analýza kalendáře:

• Po skončení události v kalendáři aplikace nabídne "chytrou přestávku"
• Typ aktivity se detekuje z názvu a popisu události (klíčová slova)
• Na základě typu aktivity se vyberou vhodné cviky a hlášky

Typy aktivit a klíčová slova:

• meeting - porada, schůzka, meeting, call
• focus - deep work, focus, soustředění, kódování
• presentation - prezentace, demo, workshop
• break - oběd, pauza, lunch

Výběr cviků:

• Po dlouhém sezení (meeting) - protahovací cviky, cviky na záda
• Po soustředěné práci (focus) - kardio, aktivní cviky
• Po prezentaci - relaxační cviky
• Logika je v souboru js/smart-break.js

Hlavní soubory:

• index.html - hlavní SPA aplikace (dashboard, nastavení, správa obsahu)
• admin.html - admin panel (API klíče, uživatelé, platby, dokumentace)
• manifest.json - PWA manifest

CSS:

• css/style.css - kompletní design systém (dark sport theme, CSS proměnné)

JavaScript:

• js/app.js - hlavní logika (timer, TTS, calendar, settings, UI)
• js/i18n.js - překlady a konfigurace jazyků (CZ, EN, DE, PL)
• js/cloud-tts.js - Azure a Google Cloud TTS klient
• js/account.js - registrace, přihlášení, Google OAuth, předplatné „bez reklam"
• js/ads.js - vykreslování reklamních pozic a lišta se souhlasem
• js/admin.js - CRUD správa hlášek a cviků
• js/smart-break.js - Smart Break logika (analýza kalendáře, výběr cviků)

PHP API:

• api/db.php - databázový helper, session management
• api/init-db.php - inicializace SQLite tabulek
• api/auth.php - autentizace (register, login, Google OAuth)
• api/billing.php - předplatné „bez reklam" (stav, checkout, zrušení)
• api/ads.php - konfigurace reklamních pozic pro frontend
• api/admin-api.php - admin API (settings, users, payments, stats)
• api/calendar.php - Google Calendar API (OAuth, events)
• api/calendar-callback.php - OAuth callback pro Calendar
• api/payment.php - Stripe platby
• api/tts-proxy.php - TTS proxy (skrývá API klíče)
• api/data.php - CRUD pro messages/exercises JSON soubory

Data:

• data/fitbreak.db - SQLite databáze (users, payments, admin_settings)
• data/messages*.json - hlášky pro každý jazyk
• data/exercises*.json - cviky pro každý jazyk

Tři zdroje hlasu:

• Browser (prohlížeč) - zdarma, využívá Web Speech API, kvalita závisí na OS a prohlížeči
• Azure Speech - vysoce kvalitní neurální hlasy, vyžaduje API klíč
• Google Cloud TTS - přirozené hlasy, vyžaduje API klíč

Jak to funguje:

• Uživatel si vybere hlas ze seznamu - provider se detekuje automaticky
• Browser hlasy se načítají z Web Speech API
• Cloud hlasy se zobrazí pouze pokud jsou nakonfigurovány klíče (sekce API & Nastavení)
• Cloud TTS se proxuje přes api/tts-proxy.php - klient nikdy nevidí API klíče

Režimy energie:

• Klidný - pomalá řeč, nízká výška, tichý hlas
• Normální - standardní parametry
• Energický - rychlejší řeč, vyšší výška, hlasitější
• Šílený - nejrychlejší řeč, nejvyšší výška, maximální hlasitost

OAuth flow s refresh tokenem:

1. Uživatel klikne "Připojit Google Kalendář" v nastavení
2. Aplikace přesměruje na api/calendar.php?action=auth-url
3. Server vygeneruje OAuth URL s access_type=offline pro refresh token
4. Uživatel autorizuje přístup na Google stránce
5. Google přesměruje zpět na api/calendar-callback.php
6. Server uloží access token a refresh token do databáze
7. Tokeny se automaticky obnovují pomocí refresh tokenu

Automatické přeskakování událostí:

• Aplikace pravidelně kontroluje nadcházející události
• Pokud probíhá událost, přestávka se automaticky přeskočí
• Tuto funkci lze vypnout v nastavení (toggle "Automaticky přeskakovat")

Smart break po skončení události:

• Po skončení události se nabídne okamžitá přestávka
• Typ cviku se přizpůsobí typu ukončené aktivity
• Kontextová zpráva informuje uživatele o důvodu přestávky

auth.php - Autentizace a správa uživatelů

• ?action=register (POST) - registrace nového uživatele
• ?action=login (POST) - přihlášení e-mailem a heslem
• ?action=google-login (POST) - přihlášení přes Google OAuth
• ?action=me (GET) - informace o přihlášeném uživateli
• ?action=save-settings (POST) - uložení uživatelských nastavení
• ?action=logout (GET) - odhlášení

admin-api.php - Admin operace (vyžaduje roli admin)

• ?action=get-settings (GET) - načtení admin nastavení (API klíče)
• ?action=save-settings (POST) - uložení admin nastavení
• ?action=users (GET) - seznam uživatelů (s paginací a vyhledáváním)
• ?action=user-update (POST) - úprava uživatele (is_paid, role)
• ?action=user-delete (POST) - smazání uživatele
• ?action=payments (GET) - seznam plateb
• ?action=stats (GET) - statistiky dashboardu

calendar.php - Google Calendar

• ?action=auth-url (GET) - vygenerování OAuth URL pro autorizaci
• ?action=callback (GET) - zpracování OAuth callback
• ?action=token (GET) - získání/obnovení access tokenu
• ?action=events (GET) - načtení nadcházejících událostí
• ?action=disconnect (POST) - odpojení kalendáře

payment.php - Stripe platby

• ?action=create-session (POST) - vytvoření Stripe checkout session
• ?action=verify (GET) - ověření platby po přesměrování
• ?action=config (GET) - veřejná konfigurace (public key, cena)

tts-proxy.php - Text-to-Speech proxy

• ?action=status (GET) - stav konfigurace TTS providerů
• ?action=speak (POST) - syntéza řeči (vrací audio)

data.php - CRUD pro hlášky a cviky

• GET /data.php?type=messages&lang=cs - načtení hlášek
• POST /data.php - přidání nové položky
• PUT /data.php - úprava existující položky
• DELETE /data.php?type=messages&id=123 - smazání položky