Začíname s EOS Hub

Táto príručka vás prevedie rýchlym nastavením EOS Hub od klonovania repozitára po prvé prihlásenie.

Predpoklady

Pred inštaláciou sa uistite, že máte nainštalované:

• Node.js v20 alebo novší
• pnpm v9 alebo novší (odporúčaný package manager)
• PostgreSQL v15 alebo novší
• Git

Odporúčanie

Používajte pnpm pre konzistentnosť s projektovými lock súbormi. Nainštalujte ho pomocou corepack enable.

Rýchly štart

1. Klonovanie repozitára

git clone https://github.com/your-org/eos-hub.git
cd eos-hub

2. Inštalácia závislostí

pnpm install

3. Nastavenie prostredia

Skopírujte vzorový súbor s premennými prostredia:

cp .env.example .env

Upravte .env súbor s vašimi hodnotami:

DATABASE_URL="postgresql://user:password@localhost:5432/eos_hub"
NEXTAUTH_SECRET="vasa-nahodna-hodnota"
NEXTAUTH_URL="http://localhost:3000"

Dôležité

Nikdy necommitujte súbor .env do repozitára. Je automaticky zahrnutý v .gitignore.

4. Inicializácia databázy

pnpm db:push
pnpm db:seed

Príkaz db:push vytvorí všetky tabuľky podľa Prisma schémy. Príkaz db:seed naplní databázu vzorovými dátami.

5. Spustenie vývojového servera

pnpm dev

Aplikácia bude dostupná na http://localhost:3000.

Prvé prihlásenie

Po spustení aplikácie sa môžete prihlásiť:

1. Otvorte prehliadač na http://localhost:3000
2. Kliknite na Prihlásiť sa
3. Použite Google OAuth alebo testovacie prihlasovacie údaje zo seed dát

Testovacie účty

Seed dáta vytvárajú testovacie účty s rôznymi rolami. Pozrite si seed súbor pre konkrétne prihlasovacie údaje.

Štruktúra projektu

eos-hub/
├── src/
│   ├── app/            # Next.js App Router stránky
│   ├── components/     # React komponenty
│   ├── lib/            # Pomocné funkcie a konfigurácia
│   ├── server/         # Serverové akcie a API
│   └── messages/       # Jazykové súbory (en, sk)
├── prisma/
│   ├── schema.prisma   # Databázová schéma
│   └── seed.ts         # Seed dáta
├── docs/               # Táto dokumentácia
├── public/             # Statické súbory
└── .env.example        # Vzorové env premenné

Ďalšie kroky

• Detailná inštalácia -- pokročilé nastavenie
• Konfigurácia -- všetky konfiguračné možnosti
• Organizácie a tímy -- pochopenie štruktúry
• Roly a oprávnenia -- nastavenie prístupu