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"
DATA_ENCRYPTION_KEY="vystup-openssl-rand-base64-32"

Dôležité

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

4. Inicializácia databázy

npx prisma migrate dev
npx prisma db seed

Príkaz prisma migrate dev vytvorí všetky tabuľky aplikovaním Prisma migrácií. Príkaz prisma 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
• Navigácia -- pohyb medzi tímami a stránkami cez hornú lištu
• Roly a oprávnenia -- nastavenie prístupu