activity

Platforma pre evidenciu aktivít, mentoring a komunikáciu v slovenskom športe — športovci, tréneri, rozhodcovia, lekári, fanúšikovia a podporovatelia v jednom systéme.

Tento web obsahuje kompletnú technickú a produktovú dokumentáciu projektu activity. Dokumentácia je verejná, prístupná bez prihlásenia.

activity je klient projektu sportup.sk (opens in a new tab) — využíva jeho registre osôb a organizácií ako autoritatívny zdroj a pridáva nad nimi aktivitnú a komunikačnú vrstvu.

Pre koho je dokumentácia

• Vývojári — implementačné detaily, schémy, API, deployment
• Produktoví ľudia — workflow per kategória používateľa, UI vzory
• Dizajnéri — princípy, mockupy, prepojenie na doménový model
• Manažéri projektov — prehľad architektúry, integrácia, otvorené otázky
• Auditori — ACL matice, GDPR, retencia, security

Štruktúra

Dokumentácia je organizovaná do siedmich vrstiev:

1. Úvodná vrstva

• Prehľad — kategórie používateľov, kľúčové entity, princípy
• Architektúra — technologický stack, MCP servery, multi-tenancy

2. Doménová vrstva

• Doménový model — Zod schémy, MongoDB indexy, kompletné dátové štruktúry

3. Technická vrstva (API)

• MCP servery — kompletná špecifikácia troch MCP serverov
• Integrácia s sportup.sk — väzba na ltksolutions/sportup.sk projekt

4. Featurová vrstva

• Mentoring — kompletný mentoring subsystém
• Courier — chat a komunikácia
• Polymorfné komentáre — generický komentárový subsystém
• Rodičovský proxy — zastupovanie maloletých

5. ACL matice

• ACL pre komentáre
• ACL pre Courier

6. Workflows per kategória používateľa

• Športovec
• Tréner
• Rozhodca
• Lekár, fyzio, mentálny kouč
• Fanúšik
• Podporovateľ

7. Prevádzka a UI

• Deployment
• Retencia a GDPR
• Rate limity
• Database migrations
• Atlas Search
• Dizajnové princípy
• UI Mockups

A na zaver:

• Slovník pojmov — referenčný slovník

Technologický stack

• MongoDB Atlas — primárna databáza, native driver + Zod schémy
• Node.js + Fastify — backend MCP servery
• Next.js 15 — frontend (web aplikácia, admin)
• MCP (Model Context Protocol) — primárne API rozhranie
• Redis — pub/sub, cache, rate limiting
• Vercel — hosting Next.js apps
• Cloud Run / k8s — hosting MCP serverov
• Cloudflare — CDN a DDoS ochrana
• Caddy — on-demand TLS pre custom domény organizácií

Verzia dokumentácie

Táto dokumentácia popisuje MVP fázu projektu. Niektoré features sú označené ako TBD (To Be Done) — plánované pre budúce iterácie.

Otvorené otázky a feedback

Otázky a poznámky k dokumentácii prosím zasielajte cez GitHub issues v projekte ltksolutions/activity (opens in a new tab).