Initial commit: FL-Akademie LMS mit Docker, Admin, Portal und Dokumentation.

Made-with: Cursor
2026-04-13 23:17:07 +02:00
commit d3367f0046
66 changed files with 3641 additions and 0 deletions
--- a/docs/HANDBUCH.md
+++ b/docs/HANDBUCH.md
@@ -0,0 +1,108 @@
+# Handbuch – FL-Akademie LMS
+
+Technische und organisatorische Dokumentation des **implementierten Stands**. Ergänzt [PLAN.md](PLAN.md) (Vision & Roadmap).
+
+---
+
+## 1. Rollen (NextAuth + Prisma)
+
+| Rolle (`Role`) | Zweck |
+|----------------|--------|
+| `LEARNER` | Standard-Lernende |
+| `INSTRUCTOR` | vorbereitet für spätere Dozenten-Features |
+| `ADMIN` | voller Zugriff auf `/admin` |
+
+Die Rolle liegt im **JWT** und wird über `middleware.ts` für `/admin` geprüft. `/portal` ist für **alle angemeldeten** Nutzer.
+
+---
+
+## 2. Öffentliche Website
+
+- **Startseite `/`:** Inhalte (Hero, CTAs, Vorteils-Kacheln) kommen aus der Tabelle **`LandingPage`** (`id = "default"`, Feld `content` als JSON). Fallback-Logik in `lib/landing.ts`, wenn keine oder ungültige Daten vorliegen.
+- **Kurse:** Veröffentlichte Kurse (`published = true`), Einschreibung über API nur bei **Preis 0** (kostenpflichtige Kurse: Hinweis in UI, Zahlung noch nicht angebunden).
+
+---
+
+## 3. Mitgliederbereich (`/portal`)
+
+- **Übersicht:** Eingeschriebene Kurse, Fortschrittsbalken (abgeschlossene vs. gesamte veröffentlichte Lektionen), Links zum Lernen, zum Kurrikulum, zum Zertifikat (falls vorhanden).
+- **Kurs wiederholen:** Link startet wieder bei der ersten Lektion; optional **„Fortschritt zurücksetzen“** (löscht `LessonProgress` und ggf. `Certificate` für diesen Kurs).
+- **Konto `/portal/account`:** Passwort ändern (`POST /api/portal/password` – aktuelles Passwort prüfen, neues hashen mit bcrypt).
+- **Zertifikate `/portal/certificates`:** Liste ausgestellter Urkunden mit Link zur öffentlichen Ansicht.
+
+---
+
+## 4. Administration (`/admin`)
+
+Nur mit Rolle **`ADMIN`** erreichbar (sonst Redirect nach `/portal`).
+
+| Route | Funktion |
+|-------|----------|
+| `/admin` | Übersicht mit Verweisen |
+| `/admin/courses` | Alle Kurse (inkl. Entwürfe), Link „Neuer Kurs“ |
+| `/admin/courses/new` | Neuanlage: Titel, Slug, Beschreibung, Autor-Name, Preis (EUR), Abo-Intervall, Veröffentlicht |
+| `/admin/courses/[id]/edit` | Stammdaten bearbeiten; **Module** und **Lektionen** hinzufügen (Lektion: optionaler Slug, HTML-Inhalt) |
+| `/admin/users` | Nutzerliste (ohne Passwort): E-Mail, Name, Rolle, Anzahl Einschreibungen & Zertifikate |
+| `/admin/landing` | Startseiten-Texte und bis zu 6 Vorteils-Kacheln; **Speichern wirkt sofort** auf `/` |
+
+---
+
+## 5. Zertifikate (Certificate of completion)
+
+- **Ausstellung:** Sobald ein Nutzer **alle veröffentlichten Lektionen** eines Kurses als abgeschlossen markiert hat, legt `lib/certificates.ts` (`syncCertificateForCourse`) einen **`Certificate`**-Datensatz mit eindeutigem **`code`** an (Format z. B. `FA-…`).
+- **Widerruf:** Entfernen einzelner Lektions-Abschlüsse oder „Fortschritt zurücksetzen“ löscht das Zertifikat wieder, sobald der Kurs nicht mehr vollständig ist.
+- **Öffentliche Seite:** `/zertifikat/[code]` – Name, Kurstitel, Datum, Verifikationscode; Drucklayout blendet Kopf-/Fußzeile aus (`@media print` in `app/globals.css`).
+
+Auslöser nach Abschluss: `POST /api/progress` ruft `syncCertificateForCourse` auf.
+
+---
+
+## 6. Datenmodell (Prisma)
+
+Wesentliche Modelle:
+
+- `User`, `Course`, `CourseModule`, `Lesson`, `Enrollment`, `LessonProgress`
+- `Category`, `CourseCategory` (Seed / spätere Filter)
+- **`LandingPage`** – eine Zeile `default` für Startseiten-JSON
+- **`Certificate`** – `@@unique([userId, courseId])`, `code` global eindeutig
+
+Migrationen unter `prisma/migrations/`.
+
+---
+
+## 7. Docker Compose
+
+| Service | Beschreibung |
+|---------|----------------|
+| `db` | `postgres:16-alpine`, Volume `postgres_data` |
+| `web` | Build aus `Dockerfile`, Entrypoint `scripts/docker-entrypoint.sh` |
+
+Umgebungsvariablen im Compose u. a. `NEXT_TELEMETRY_DISABLED=1`.
+
+**Befehle:**
+
+```bash
+docker compose up --build -d    # im Hintergrund
+docker compose logs -f web      # Logs
+docker compose down             # stoppen
+```
+
+---
+
+## 8. Sicherheitshinweise (Produktion)
+
+- `NEXTAUTH_SECRET` und `NEXTAUTH_URL` korrekt setzen.
+- Credentials-Login ist für Dev/MVP gedacht – für Produktion OAuth oder stärkere Passwortrichtlinien erwägen.
+- Admin-Oberfläche nicht ohne Absicherung (TLS, Netzwerk) exponieren.
+
+---
+
+## 9. Git-Remote
+
+Standard-Remote nach Klon/Push:
+
+```text
+https://git.loepperts.com/loepperts/FL-Akademie.git
+```
+
+Branch: `main` (empfohlen).