IPA Noten Rechner

Eine Web-Applikation zur Selbstbewertung anhand des offiziellen IPA Kriterienkatalogs.

Features

• 📋 Vollständiger Kriterienkatalog mit allen Bewertungskriterien
• 📊 Live-Notenberechnung mit Fortschrittsanzeige
• 💾 Hybride Datenspeicherung (LocalStorage oder Datenbank)
• 🔐 Optionale Authentifizierung
• 📤 Export/Import Funktionalität
• 🎯 Unterstützung für Agile und Lineare Projektmethoden

Quick Start

# Repository klonen
git clone https://github.com/jannismilz/ipa-noten-rechner
cd ipa-noten-rechner

# Dependencies installieren
npm --prefix ./frontend install ./frontend
bun install --cwd ./backend

# Umgebungsvariablen konfigurieren
cp frontend/.env.example frontend/.env
cp backend/.env.example backend/.env

# Datenbank einrichten
cd backend && bun run migrate

# Server starten
bun run dev          # Backend (Port 3001)
cd ../frontend && npm run dev  # Frontend (Port 5173)

Für detaillierte Anweisungen siehe CONTRIBUTING.md.

Dokumentation

Dokument	Beschreibung
CONTRIBUTING.md	Setup, Development, API Endpoints
Kriterienkatalog Spezifikation	JSON-Format des Kriterienkatalogs
Backend README	Backend-spezifische Dokumentation

Projektstruktur

├── backend/          # Express.js API mit Bun
├── frontend/         # React + Vite
├── shared/           # Geteilte Logik (Notenberechnung)
├── docs/             # Dokumentation
└── criterias.json    # Kriterienkatalog

Tech Stack

• Frontend: React, Vite, Lucide Icons
• Backend: Express.js, Bun, PostgreSQL
• Testing: Bun Test, Vitest, Playwright
• CI/CD: GitHub Actions, Docker