Add Stundenplan frontend scaffolding in studio-v2

Phase 3 — initial UI for the timetable scheduler:
  - app/stundenplan/page.tsx with tab navigation (Klassen / Lehrer /
    Faecher / Raeume / Zeitraster / Stundentafel / Lehrauftraege /
    Regeln) and a dev-mode JWT entry to authenticate against
    school-service until full auth is wired up.
  - app/stundenplan/_components/KlassenManager.tsx as the working
    prototype for one entity (list / create / delete). Pattern can be
    copied for the other 6 stammdaten + 15 constraint editors.
  - lib/stundenplan/api.ts exposing typed clients for all 22 endpoints
    (7 stammdaten + 15 constraint tables). Constraints use a factory
    to keep the file tight.
  - app/api/school/[...path]/route.ts proxies the browser through
    Next.js to school-service so HTTPS studio-v2 can reach the plain
    HTTP backend.
  - Sidebar.tsx gains a Stundenplan entry with 26-language labels.
  - docker-compose.yml exposes SCHOOL_SERVICE_URL to studio-v2 and
    declares the school-service dependency.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

studio-v2/app/api/school/[...path]/route.ts

@@ -0,0 +1,65 @@
+import { NextRequest, NextResponse } from 'next/server'
+
+/**
+ * Proxy for the school-service (Go/Gin, port 8084). The browser cannot call
+ * the backend directly because studio-v2 is served over HTTPS and the backend
+ * is plain HTTP; this Next.js route bridges them server-side.
+ */
+
+const BACKEND_URL = process.env.SCHOOL_SERVICE_URL || 'http://school-service:8084'
+
+async function proxyRequest(
+  request: NextRequest,
+  params: { path: string[] }
+): Promise<NextResponse> {
+  const path = params.path.join('/')
+  const url = `${BACKEND_URL}/api/v1/school/${path}`
+
+  try {
+    const headers: HeadersInit = { 'Content-Type': 'application/json' }
+    const authHeader = request.headers.get('authorization')
+    if (authHeader) headers['Authorization'] = authHeader
+
+    const fetchOptions: RequestInit = {
+      method: request.method,
+      headers,
+    }
+
+    if (['POST', 'PUT', 'PATCH'].includes(request.method)) {
+      fetchOptions.body = await request.text()
+    }
+
+    const response = await fetch(url, fetchOptions)
+    const contentType = response.headers.get('content-type')
+    const data = contentType?.includes('application/json')
+      ? await response.text()
+      : await response.arrayBuffer()
+
+    return new NextResponse(data, {
+      status: response.status,
+      headers: { 'Content-Type': contentType || 'application/json' },
+    })
+  } catch (error) {
+    console.error(`Failed to proxy ${request.method} ${url}:`, error)
+    return NextResponse.json(
+      { error: 'school-service nicht erreichbar', details: error instanceof Error ? error.message : 'Unknown error' },
+      { status: 502 },
+    )
+  }
+}
+
+export async function GET(request: NextRequest, context: { params: Promise<{ path: string[] }> }) {
+  return proxyRequest(request, await context.params)
+}
+
+export async function POST(request: NextRequest, context: { params: Promise<{ path: string[] }> }) {
+  return proxyRequest(request, await context.params)
+}
+
+export async function PUT(request: NextRequest, context: { params: Promise<{ path: string[] }> }) {
+  return proxyRequest(request, await context.params)
+}
+
+export async function DELETE(request: NextRequest, context: { params: Promise<{ path: string[] }> }) {
+  return proxyRequest(request, await context.params)
+}

studio-v2/app/stundenplan/_components/KlassenManager.tsx

@@ -0,0 +1,196 @@
+'use client'
+
+import { useState, useEffect, useCallback } from 'react'
+import { useTheme } from '@/lib/ThemeContext'
+import { classesApi } from '@/lib/stundenplan/api'
+import type { TimetableClass, CreateTimetableClass } from '@/app/stundenplan/types'
+
+export function KlassenManager() {
+  const { isDark } = useTheme()
+  const [classes, setClasses] = useState<TimetableClass[]>([])
+  const [loading, setLoading] = useState(true)
+  const [error, setError] = useState<string | null>(null)
+  const [showForm, setShowForm] = useState(false)
+  const [submitting, setSubmitting] = useState(false)
+  const [form, setForm] = useState<CreateTimetableClass>({
+    name: '',
+    grade_level: 5,
+    student_count: 0,
+    notes: '',
+  })
+
+  const load = useCallback(async () => {
+    setLoading(true)
+    setError(null)
+    try {
+      const data = await classesApi.list()
+      setClasses(data || [])
+    } catch (e) {
+      setError(e instanceof Error ? e.message : 'Laden fehlgeschlagen')
+    } finally {
+      setLoading(false)
+    }
+  }, [])
+
+  useEffect(() => { load() }, [load])
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault()
+    setSubmitting(true)
+    setError(null)
+    try {
+      await classesApi.create(form)
+      setForm({ name: '', grade_level: 5, student_count: 0, notes: '' })
+      setShowForm(false)
+      await load()
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Anlegen fehlgeschlagen')
+    } finally {
+      setSubmitting(false)
+    }
+  }
+
+  const handleDelete = async (id: string) => {
+    if (!confirm('Klasse wirklich loeschen?')) return
+    try {
+      await classesApi.remove(id)
+      await load()
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Loeschen fehlgeschlagen')
+    }
+  }
+
+  const cardClass = isDark
+    ? 'bg-white/10 border-white/20 text-white'
+    : 'bg-white/80 border-black/10 text-slate-900'
+  const inputClass = isDark
+    ? 'bg-white/10 border-white/20 text-white placeholder-white/40'
+    : 'bg-white border-slate-300 text-slate-900 placeholder-slate-400'
+
+  return (
+    <div className="space-y-4">
+      <div className="flex items-center justify-between">
+        <h2 className={`text-xl font-semibold ${isDark ? 'text-white' : 'text-slate-900'}`}>
+          Klassen ({classes.length})
+        </h2>
+        <button
+          onClick={() => setShowForm(s => !s)}
+          className={`px-4 py-2 rounded-xl font-medium transition-colors ${
+            isDark
+              ? 'bg-indigo-500 hover:bg-indigo-600 text-white'
+              : 'bg-indigo-600 hover:bg-indigo-700 text-white'
+          }`}
+        >
+          {showForm ? 'Abbrechen' : '+ Neue Klasse'}
+        </button>
+      </div>
+
+      {error && (
+        <div className="p-3 rounded-xl bg-red-500/20 border border-red-500/40 text-red-300">
+          {error}
+        </div>
+      )}
+
+      {showForm && (
+        <form
+          onSubmit={handleSubmit}
+          className={`p-4 rounded-2xl border backdrop-blur-xl ${cardClass}`}
+        >
+          <div className="grid grid-cols-1 md:grid-cols-4 gap-3">
+            <div>
+              <label className="block text-sm mb-1 opacity-70">Name</label>
+              <input
+                required
+                value={form.name}
+                onChange={e => setForm({ ...form, name: e.target.value })}
+                placeholder="z.B. 5a"
+                className={`w-full px-3 py-2 rounded-lg border ${inputClass}`}
+              />
+            </div>
+            <div>
+              <label className="block text-sm mb-1 opacity-70">Klassenstufe</label>
+              <input
+                type="number"
+                min={1}
+                max={13}
+                required
+                value={form.grade_level}
+                onChange={e => setForm({ ...form, grade_level: parseInt(e.target.value) || 0 })}
+                className={`w-full px-3 py-2 rounded-lg border ${inputClass}`}
+              />
+            </div>
+            <div>
+              <label className="block text-sm mb-1 opacity-70">Schueleranzahl</label>
+              <input
+                type="number"
+                min={0}
+                value={form.student_count}
+                onChange={e => setForm({ ...form, student_count: parseInt(e.target.value) || 0 })}
+                className={`w-full px-3 py-2 rounded-lg border ${inputClass}`}
+              />
+            </div>
+            <div className="flex items-end">
+              <button
+                type="submit"
+                disabled={submitting}
+                className="w-full px-4 py-2 rounded-lg bg-emerald-500 hover:bg-emerald-600 text-white font-medium disabled:opacity-50"
+              >
+                {submitting ? 'Speichert...' : 'Anlegen'}
+              </button>
+            </div>
+          </div>
+          <div className="mt-3">
+            <label className="block text-sm mb-1 opacity-70">Notizen (optional)</label>
+            <input
+              value={form.notes || ''}
+              onChange={e => setForm({ ...form, notes: e.target.value })}
+              className={`w-full px-3 py-2 rounded-lg border ${inputClass}`}
+            />
+          </div>
+        </form>
+      )}
+
+      {loading ? (
+        <div className={`text-center py-8 opacity-60 ${isDark ? 'text-white' : 'text-slate-700'}`}>
+          Laedt…
+        </div>
+      ) : classes.length === 0 ? (
+        <div className={`text-center py-8 opacity-60 ${isDark ? 'text-white' : 'text-slate-700'}`}>
+          Noch keine Klassen angelegt.
+        </div>
+      ) : (
+        <div className={`rounded-2xl border backdrop-blur-xl overflow-hidden ${cardClass}`}>
+          <table className="w-full">
+            <thead className={isDark ? 'bg-white/5' : 'bg-slate-100'}>
+              <tr>
+                <th className="text-left px-4 py-3 text-sm font-medium opacity-70">Name</th>
+                <th className="text-left px-4 py-3 text-sm font-medium opacity-70">Stufe</th>
+                <th className="text-left px-4 py-3 text-sm font-medium opacity-70">Schueler</th>
+                <th className="text-left px-4 py-3 text-sm font-medium opacity-70">Notizen</th>
+                <th className="px-4 py-3"></th>
+              </tr>
+            </thead>
+            <tbody>
+              {classes.map(c => (
+                <tr key={c.id} className={isDark ? 'border-t border-white/10' : 'border-t border-slate-200'}>
+                  <td className="px-4 py-3 font-medium">{c.name}</td>
+                  <td className="px-4 py-3">{c.grade_level}</td>
+                  <td className="px-4 py-3">{c.student_count}</td>
+                  <td className="px-4 py-3 text-sm opacity-70">{c.notes || '—'}</td>
+                  <td className="px-4 py-3 text-right">
+                    <button
+                      onClick={() => handleDelete(c.id)}
+                      className="text-red-400 hover:text-red-300 text-sm"
+                    >
+                      Loeschen
+                    </button>
+                  </td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </div>
+      )}
+    </div>
+  )
+}

studio-v2/app/stundenplan/page.tsx

@@ -0,0 +1,121 @@
+'use client'
+
+import { useState } from 'react'
+import { useTheme } from '@/lib/ThemeContext'
+import { Sidebar } from '@/components/Sidebar'
+import { ThemeToggle } from '@/components/ThemeToggle'
+import { LanguageDropdown } from '@/components/LanguageDropdown'
+import { KlassenManager } from './_components/KlassenManager'
+import { setStundenplanToken, getStundenplanToken } from '@/lib/stundenplan/api'
+
+type Tab = 'klassen' | 'lehrer' | 'faecher' | 'raeume' | 'periods' | 'curriculum' | 'assignments' | 'regeln'
+
+const TABS: { id: Tab; label: string }[] = [
+  { id: 'klassen', label: 'Klassen' },
+  { id: 'lehrer', label: 'Lehrer' },
+  { id: 'faecher', label: 'Faecher' },
+  { id: 'raeume', label: 'Raeume' },
+  { id: 'periods', label: 'Zeitraster' },
+  { id: 'curriculum', label: 'Stundentafel' },
+  { id: 'assignments', label: 'Lehrauftraege' },
+  { id: 'regeln', label: 'Regeln (Constraints)' },
+]
+
+export default function StundenplanPage() {
+  const { isDark } = useTheme()
+  const [tab, setTab] = useState<Tab>('klassen')
+  const [token, setToken] = useState(getStundenplanToken())
+
+  const handleSaveToken = () => {
+    setStundenplanToken(token)
+    alert('Token gespeichert. Seite neu laden um die Aenderung zu uebernehmen.')
+  }
+
+  return (
+    <div className={`flex min-h-screen p-4 gap-4 ${isDark ? 'bg-slate-900' : 'bg-slate-50'}`}>
+      <Sidebar selectedTab="stundenplan" />
+
+      <main className="flex-1 max-w-7xl mx-auto">
+        <header className="flex items-center justify-between mb-6">
+          <div>
+            <h1 className={`text-3xl font-bold ${isDark ? 'text-white' : 'text-slate-900'}`}>
+              Stundenplan
+            </h1>
+            <p className={`text-sm mt-1 ${isDark ? 'text-white/60' : 'text-slate-500'}`}>
+              Stammdaten und Regeln fuer den Solver
+            </p>
+          </div>
+          <div className="flex items-center gap-3">
+            <ThemeToggle />
+            <LanguageDropdown />
+          </div>
+        </header>
+
+        <div
+          className={`mb-4 p-3 rounded-xl border backdrop-blur-xl ${
+            isDark ? 'bg-amber-500/10 border-amber-500/30 text-amber-200' : 'bg-amber-50 border-amber-200 text-amber-900'
+          }`}
+        >
+          <details>
+            <summary className="cursor-pointer text-sm font-medium">
+              Dev: JWT-Token setzen (Anmeldung noch nicht integriert)
+            </summary>
+            <div className="mt-2 flex gap-2">
+              <input
+                type="password"
+                value={token}
+                onChange={e => setToken(e.target.value)}
+                placeholder="Bearer-Token"
+                className={`flex-1 px-3 py-1.5 rounded-lg text-sm ${
+                  isDark ? 'bg-white/10 border border-white/20 text-white' : 'bg-white border border-slate-300 text-slate-900'
+                }`}
+              />
+              <button
+                onClick={handleSaveToken}
+                className="px-3 py-1.5 rounded-lg bg-amber-500 hover:bg-amber-600 text-white text-sm font-medium"
+              >
+                Speichern
+              </button>
+            </div>
+          </details>
+        </div>
+
+        <nav className="flex flex-wrap gap-2 mb-6">
+          {TABS.map(t => (
+            <button
+              key={t.id}
+              onClick={() => setTab(t.id)}
+              className={`px-4 py-2 rounded-xl text-sm font-medium transition-colors ${
+                tab === t.id
+                  ? isDark
+                    ? 'bg-white/20 text-white'
+                    : 'bg-indigo-100 text-indigo-900'
+                  : isDark
+                    ? 'bg-white/5 text-white/70 hover:bg-white/10'
+                    : 'bg-white text-slate-700 hover:bg-slate-100 border border-slate-200'
+              }`}
+            >
+              {t.label}
+            </button>
+          ))}
+        </nav>
+
+        <section>
+          {tab === 'klassen' && <KlassenManager />}
+          {tab !== 'klassen' && (
+            <div
+              className={`rounded-2xl border backdrop-blur-xl p-8 text-center ${
+                isDark ? 'bg-white/5 border-white/10 text-white/60' : 'bg-white/80 border-black/10 text-slate-500'
+              }`}
+            >
+              <p className="text-lg">Noch nicht implementiert: {TABS.find(t => t.id === tab)?.label}</p>
+              <p className="text-sm mt-2">
+                Das Klassen-Modul ist der Prototyp. Die anderen Stammdaten und alle 15 Constraints folgen dem gleichen Muster.
+              </p>
+            </div>
+          )}
+        </section>
+      </main>
+    </div>
+  )
+}

studio-v2/app/stundenplan/types.ts

@@ -0,0 +1,226 @@
+// Mirror of school-service/internal/models/timetable*.go.
+// Field names in JSON come from the Go struct json:"…" tags.
+
+// ---------- Stammdaten (7) ----------
+
+export interface TimetableClass {
+  id: string
+  created_by_user_id: string
+  name: string
+  grade_level: number
+  student_count: number
+  notes?: string
+  created_at: string
+}
+
+export interface TimetablePeriod {
+  id: string
+  created_by_user_id: string
+  day_of_week: number
+  period_index: number
+  start_time: string
+  end_time: string
+  is_break: boolean
+  label?: string
+  created_at: string
+}
+
+export interface TimetableRoom {
+  id: string
+  created_by_user_id: string
+  name: string
+  room_type?: string
+  capacity: number
+  floor_level: number
+  has_elevator: boolean
+  notes?: string
+  created_at: string
+}
+
+export interface TimetableSubject {
+  id: string
+  created_by_user_id: string
+  name: string
+  short_code: string
+  color?: string
+  is_main_subject: boolean
+  required_room_type?: string
+  created_at: string
+}
+
+export interface TimetableTeacher {
+  id: string
+  created_by_user_id: string
+  first_name: string
+  last_name: string
+  short_code: string
+  employment_percentage: number
+  max_hours_week: number
+  notes?: string
+  created_at: string
+}
+
+export interface TimetableCurriculum {
+  id: string
+  class_id: string
+  subject_id: string
+  weekly_hours: number
+  created_at: string
+  subject_name?: string
+  class_name?: string
+}
+
+export interface TimetableAssignment {
+  id: string
+  teacher_id: string
+  class_id: string
+  subject_id: string
+  created_at: string
+  teacher_name?: string
+  class_name?: string
+  subject_name?: string
+}
+
+// Create-request DTOs
+
+export interface CreateTimetableClass {
+  name: string
+  grade_level: number
+  student_count?: number
+  notes?: string
+}
+
+export interface CreateTimetablePeriod {
+  day_of_week: number
+  period_index: number
+  start_time: string
+  end_time: string
+  is_break?: boolean
+  label?: string
+}
+
+export interface CreateTimetableRoom {
+  name: string
+  room_type?: string
+  capacity?: number
+  floor_level?: number
+  has_elevator?: boolean
+  notes?: string
+}
+
+export interface CreateTimetableSubject {
+  name: string
+  short_code: string
+  color?: string
+  is_main_subject?: boolean
+  required_room_type?: string
+}
+
+export interface CreateTimetableTeacher {
+  first_name: string
+  last_name: string
+  short_code: string
+  employment_percentage?: number
+  max_hours_week?: number
+  notes?: string
+}
+
+export interface CreateTimetableCurriculum {
+  class_id: string
+  subject_id: string
+  weekly_hours: number
+}
+
+export interface CreateTimetableAssignment {
+  teacher_id: string
+  class_id: string
+  subject_id: string
+}
+
+// ---------- Constraints (15) ----------
+
+interface ConstraintBase {
+  id: string
+  created_by_user_id: string
+  is_hard: boolean
+  weight: number
+  active: boolean
+  note?: string
+  created_at: string
+}
+
+export interface TeacherUnavailableDay extends ConstraintBase {
+  teacher_id: string
+  day_of_week: number
+}
+
+export interface TeacherUnavailableWindow extends ConstraintBase {
+  teacher_id: string
+  day_of_week: number
+  start_time: string
+  end_time: string
+}
+
+export interface TeacherMaxHoursDay extends ConstraintBase {
+  teacher_id: string
+  max_hours: number
+}
+
+export interface TeacherMaxHoursWeek extends ConstraintBase {
+  teacher_id: string
+  max_hours: number
+}
+
+export interface TeacherExcludedSubject extends ConstraintBase {
+  teacher_id: string
+  subject_id: string
+}
+
+export interface TeacherExcludedRoom extends ConstraintBase {
+  teacher_id: string
+  room_id: string
+}
+
+export interface SubjectMinDayGap extends ConstraintBase {
+  subject_id: string
+  min_gap_days: number
+}
+
+export interface SubjectMaxConsecutive extends ConstraintBase {
+  subject_id: string
+  max_consecutive: number
+}
+
+export interface SubjectContiguousWhenRepeated extends ConstraintBase {
+  subject_id: string
+}
+
+export interface SubjectPreferredPeriod extends ConstraintBase {
+  subject_id: string
+  period_from: number
+  period_to: number
+}
+
+export interface SubjectDoubleLesson extends ConstraintBase {
+  subject_id: string
+}
+
+export interface ClassMaxHoursDay extends ConstraintBase {
+  class_id: string
+  max_hours: number
+}
+
+export interface ClassNoGaps extends ConstraintBase {
+  class_id: string
+}
+
+export interface RoomRequiresType extends ConstraintBase {
+  subject_id: string
+  room_type: string
+}
+
+export interface RoomUnavailable extends ConstraintBase {
+  room_id: string
+  day_of_week: number
+  period_index: number
+}