Skip to Content
Domov

Vitajte v Inventariu

Inventario je otvorená multi-tenant platforma pre evidenciu a vypožičiavanie majetku. Je určená pre športové zväzy, mestá, obce, kraje, kluby, školy a neziskové organizácie.

Tieto stránky obsahujú technickú dokumentáciu projektu — pre používateľský pohľad navštívte inventario.sportup.sk .

Čo nájdete v dokumentácii

  • Začíname — lokálny setup za 5 minút
  • Architektúra — multi-tenancy, tech stack, security model
  • REST API — endpoints, authentication, rate limiting
  • Deployment — 3 cesty nasadenia (cloud, privátna, self-host)
  • O projekte — história pivotu, tím, licencia

Pre koho je táto dokumentácia

Táto dokumentácia je určená pre technické publikum:

  • Developerov ktorí pracujú na Inventariu alebo ho integrujú
  • Sysadminov ktorí ho self-hostujú vo vlastnej organizácii
  • Audítorov ktorí kontrolujú bezpečnosť a GDPR compliance
  • Partnerov a kontribútorov ktorí chcú prispievať do projektu

Ak hľadáte používateľský návod (ako pridať majetok, schváliť výpožičku, atď.), pozrite si používateľskú príručku v aplikácii.

Hlavné vlastnosti

  • Open source pod EUPL-1.2  — oficiálne odporúčaná licencia Európskej komisie
  • Multi-tenant architektúra — jedna inštancia, mnoho organizácií, izolované dáta
  • Microsoft Entra ID SSO s JIT user provisioning
  • REUSE 3.3 compliant (175/175 súborov)
  • GDPR Article 30 audit log zachytí každú zmenu
  • TypeScript end-to-end — Fastify backend + Next.js frontend
  • MongoDB Atlas s transakciami pre dátovú konzistenciu

Quick start

Inventario môžete spustiť lokálne za 5 minút ak máte Node.js 22+ a MongoDB:

# Klonuj repo
git clone https://github.com/Slovensky-futbalovy-zvaz/Asset-Management.git
cd Asset-Management
 
# Nainštaluj dependencies (pnpm 9+)
pnpm install
 
# Nastav env premenné
cp .env.example .env.local
 
# Spusti backend
pnpm dev

Detaily v Začíname.

Prispievanie

Inventario je open-source projekt. Pull requesty sú vítané. Pozrite si CONTRIBUTING.md .

Kontakt

Last updated on
Začíname