Skip to content

adrian-13/cesta

Repository files navigation

🌱 Cesta

Terapeutický spoločník na ceste zotavovania zo závislosti.

5-fázový program s evidence-based metodikami (CBT, mindfulness, motivačné rozhovory, prevencia relapsu), bodovým systémom úsilia, odznakmi, denníkom myšlienok, kalendárom cesty a Zrkadlom — analytickým pohľadom na tvoje vlastné vzorce.

„Sila nie je v tom, že nikdy nepadneš. Sila je vstať zakaždým."


✨ Čo to obsahuje

Cesta 5 fáz

Začiatok (deň 0–7) · Stabilizácia (8–30) · Pochopenie (31–90) · Transformácia (91–180) · Integrácia (181+)

Nástroje sa odomykajú postupne podľa toho, kde si. Pri každom prechode do novej fázy ťa čaká celoobrazovková oslava s prehľadom toho, čo sa práve odomklo, a bonusom +50 bodov.

🆘 Krízový režim — 8 techník + linky pomoci

Tlačidlo „Potrebujem okamžitú pomoc" je dostupné z domovskej obrazovky aj zo spodnej navigácie.

  • Dýchanie 4-7-8 (s pred-štart obrazovkou, žiadne auto-spustenie)
  • 5-4-3-2-1 ukotvenie
  • Surfovanie chuti (mindfulness)
  • RAIN technika (Rozpoznať / Dovoliť / Preskúmať / Pohladiť)
  • Pretočiť film dopredu (predstava následkov)
  • HALT kontrola (hladný / nahnevaný / osamelý / unavený)
  • Pripomenutie tvojich dôvodov
  • 15-minútový časovač (chuť pominie)
  • Priame tel: odkazy na slovenské linky pomoci

🧠 9 terapeutických nástrojov v Ceste

Nástroj Fáza Popis
Denný check-in 1+ Nálada, intenzita chuti, poznámka
Denník myšlienok 1+ Voľné písanie · viac zápisov za deň · upraviteľné, mazateľné · voliteľná nálada
Záznam spúšťačov 2+ Sledovanie vzorcov, ktoré ťa spúšťajú
Týždenná reflexia 2+ Wins / Challenges / Lessons / Commitment / Intention (princípy motivačných rozhovorov)
CBT záznam myšlienok 3+ 8-krokový sprievodca s identifikáciou 8 kognitívnych skreslení
Plán prevencie relapsu 3+ Personalizovaná stratégia (rizikové situácie, signály, stratégie, podpora)
Listy sebe budúcemu 4+ Zapečatené listy s dátumom otvorenia · pole, nielen jeden · možno písať každý rok ako tradíciu
Listy od seba budúceho 4+ Imaginácia + 5-stupňová prompt sekvencia pred písaním
Kalendár cesty 1+ Mesačný grid s vizuálnymi značkami pre check-in (emoji nálady), denník, CBT, reflexie, pošmyknutia · klik na deň otvorí detail
História záznamov 1+ 4 taby: CBT, Reflexie, Check-iny, Slipy — chronologické čítanie s detailmi

CBT, Reflexia a Checkin majú aj kontextový link „Predošlé" priamo vo formulári — bez návratu do menu vidíš svoje predošlé záznamy.

⭐ Bodovanie, odznaky, úrovne

  • 6 úrovní (Začiatočník → Slobodný)
  • 16 odznakov za míľniky a aktivity
  • Body za: čisté dni, check-iny, denníkové zápisy, CBT, reflexie, spúšťače, krízové nástroje, listy, prechody fáz, výročné dni

🪞 Zrkadlo — pohľad do vlastných vzorcov

  • Graf nálady a chuti (14 dní)
  • Top spúšťače
  • Top kognitívne skreslenia z CBT záznamov
  • Vzor podľa dňa v týždni
  • Karta „Tvoj denník" (celkový počet, posledný týždeň, najčastejšia nálada pri písaní)
  • Automaticky generované postrehy zo skutočných dát
  • Odznaky + súhrnné štatistiky

🏠 Domov

  • Veľký counter čistých dní
  • Dnešné úlohy (quest-y) — klik na úlohu otvorí príslušný nástroj
  • Krízové tlačidlo
  • Úroveň, body, ušetrené peniaze
  • Myšlienka dňa — 38 afirmácií rotujúcich podľa fázy a dňa
  • Pripomienka — kuratovaná karta s tvojimi vlastnými slovami: starý denníkový zápis, vyvážená myšlienka z CBT, intencia z reflexie, alebo dôvod (deterministicky podľa dňa, zatvorí sa do zajtra)
  • Tvoje dôvody

🔒 Súkromie

Všetky tvoje dáta sa ukladajú lokálne v prehliadači (localStorage). Žiadne dáta neopúšťajú tvoje zariadenie. Žiadne účty, žiadne servery, žiadne sledovanie. Žiadne cookies, žiadne analytické nástroje.

V Profile máš:

  • Šifrovaná záloha (AES-GCM-256 + PBKDF2 200k iterácií) — stiahneš JSON súbor zabezpečený tvojím heslom. Bez hesla súbor neotvorí ani autor aplikácie.
  • Načítanie zálohy — prepíše aktuálne dáta zo súboru a hesla. Dostupné aj v úvodnom kroku onboardingu pre prenos na nové zariadenie.
  • Úprava profilu — meno, závislosť, dátum začiatku, denné/týždenné/mesačné náklady, dôvody.
  • Vymazanie všetkých dát s ponukou vytvoriť zálohu predtým.
  • Detailná Ochrana súkromia ako samostatná obrazovka.

Aplikácia funguje aj offline (PWA s service workerom). Dá sa nainštalovať na domovskú obrazovku mobilu (Android: automatický banner, iOS: hint „Pridať na plochu" v Safari). Pri novej verzii sa zobrazí upozornenie „Nová verzia · Obnoviť".


🚀 Spustenie

1. Inštaluj závislosti

npm install

2. Spusti vývojový server

npm run dev

Otvor http://localhost:5173 v prehliadači.

3. Build pre produkciu

npm run build

Hotový build je v priečinku dist/ (vrátane sw.js, manifest.webmanifest, ikony). Môžeš ho hostovať na čomkoľvek so statickými súbormi a HTTPS (Netlify, Vercel, GitHub Pages, Cloudflare Pages, vlastný server). HTTPS je potrebné, aby fungoval service worker a inštalácia ako PWA.


📞 Pomoc v kríze

Aplikácia nenahrádza odbornú pomoc. Tento disclaimer musí každý nový užívateľ potvrdiť v onboardingu. V kríze volaj:

  • Linka pomoci pre problémy s hraním: 0800 131 000 (NONSTOP, bezplatne, anonymne — OLÚP Predná Hora)
  • Linka dôvery Nezábudka: 0800 800 566 (Liga za duševné zdravie)
  • Tiesňová linka: 112
  • IPčko (chat pre mladých): ipcko.sk

🛠️ Technológie

  • React 18 + Vite 5
  • Tailwind CSS na štýlovanie
  • Lucide icons (line-art, sage zelené)
  • Fraunces (serif) + Plus Jakarta Sans z Google Fonts
  • localStorage na perzistenciu
  • WebCrypto API (natívne) pre šifrované zálohy — AES-GCM-256, PBKDF2 SHA-256, 200k iterácií
  • vite-plugin-pwa s Workbox — offline cache, autoupdate prompt, manifest, iOS meta-tagy
  • Žiadne externé runtime knižnice pre UI alebo state — len React + Lucide

📁 Štruktúra projektu

cesta-app/
├── index.html              # iOS PWA meta-tagy, theme color, ikony
├── package.json
├── vite.config.js          # vite-plugin-pwa konfigurácia (manifest + workbox)
├── tailwind.config.js
├── postcss.config.js
├── README.md
├── public/
│   └── icon.svg            # SVG ikona (sage zelený podklad + krémový list)
└── src/
    ├── main.jsx            # entry point
    ├── App.jsx             # celá aplikácia (~2900 riadkov, single-file zámerne)
    └── index.css           # Tailwind + base štýly

Celá logika je v jednom súbore App.jsx — zámerne, aby bolo všetko prehľadné a ľahko upraviteľné. Pri raste k ~3000+ riadkom je vhodný čas zvážiť rozdelenie do modulov, ale za daný účel (osobný projekt, jeden vývojár, žiadna tímová spolupráca) je single-file stále zvládnuteľný.


📝 Licencia

Pre osobné použitie. Ak chceš modifikovať, používať alebo zdieľať — daj na vedomie.

„Pokoj nie je absencia búrky, je to mier uprostred nej."

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages