Zum Hauptinhalt springen

Setup

Diese Anleitung führt dich durch das lokale Setup des Projekts.

Prerequisites​

Stelle sicher, dass folgende Software installiert ist:

  • Node.js (v18 oder höher)
  • pnpm (empfohlen) oder npm
  • Git
  • PostgreSQL (oder Neon Account)
  • Vercel Account (für Blob Storage)

Installation​

1. Repository klonen​

Das Projekt ist ein Monorepo (school-sync). Die Hauptanwendung liegt im Verzeichnis webapp/.

git clone https://github.com/your-org/school-sync.git
cd school-sync/webapp

2. Dependencies installieren​

pnpm install

3. Environment-Variablen einrichten​

Es existiert keine .env.example-Vorlage. Lege die Datei webapp/.env manuell an und trage die benötigten Variablen ein (die App lädt .env, nicht .env.local):

# Datei webapp/.env anlegen und befüllen

Siehe Environment Variables für die vollständige Liste aller Variablen.

4. Datenbank einrichten​

# Prisma Client generieren
npx prisma generate

# Datenbank-Migrationen ausführen
npx prisma migrate dev

# Optional: Seed-Daten einfügen
npx prisma db seed

5. Development Server starten​

pnpm dev

Die App läuft jetzt auf http://localhost:3000

Nächste Schritte​

Troubleshooting​

Port bereits in Verwendung​

# Anderen Port verwenden
pnpm dev -p 3001

Prisma-Fehler​

# Prisma Client neu generieren
npx prisma generate

# Bei Migration-Problemen
npx prisma migrate reset

Node-Module-Probleme​

# Node-Modules löschen und neu installieren
rm -rf node_modules
pnpm install